Microsoft DirectX 8.0 (Visual Basic)

D3DX8.BoxBoundProbe

レイがボックスの境界ボックスのボリュームに当たるかどうかを判定する。

object.BoxBoundProbe( _ 
    MinVert As D3DVECTOR, _ 
    MaxVert As D3DVECTOR, _ 
    RayPosition As D3DVECTOR, _ 
    Raydirection As D3DVECTOR) As Boolean

指定項目

object
D3DX8 オブジェクトを表すオブジェクト式。
MinVert
境界ボックスの左下隅を記述する、D3DVECTOR 型。「注意」を参照すること。
MaxVert
境界ボックスの右上隅を記述する、D3DXVECTOR 型。「注意」を参照すること。
RayPosition
レイの始点座標を指定する D3DXVECTOR 型。
Raydirection
レイの方向を指定する D3DXVECTOR 型。

戻り値

レイがボックスの境界ボックスのボリュームに当たる場合は、TRUE を返す。それ以外の場合は FALSE を返す。

注意

D3DX8.BoxBoundProbe は、レイがボックスのサーフェスだけではなく、ボックスの境界ボックスのボリュームに当たるかどうかを判定する。

D3DX8.BoxBoundProbe に渡される D3DXVECTOR の値は、xmin、xmax、ymin、ymax、zmin、zmax である。したがって、境界ボックスの角の定義は次のようになる。

xmax, ymax, zmax
xmax, ymax, zmin
xmax, ymin, zmax
xmax, ymin, zmin
xmin, ymax, zmax
xmin, ymax, zmin
xmin, ymin, zmax
xmin, ymin, zmin

境界ボックスの深度は、z 方向が zmax - zmin、y 方向が ymax - ymin、そして x 方向が xmax - xmin である。たとえば、最小ベクトルが min (-1, -1, -1)、最大ベクトルが (1, 1, 1) の場合、境界ボックスの定義は次のようになる。

 1,  1,  1
 1,  1, -1
 1, -1,  1
 1, -1, -1
-1,  1,  1
-1,  1, -1
-1, -1,  1
-1, -1, -1

エラー コード

失敗した場合はエラーが発生し、Err.NumberD3DERR_INVALIDCALL が設定される。

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。