D3DXBoxBoundProbe function
Determines whether a ray intersects the volume of a box's bounding box.
Syntax
BOOL D3DXBoxBoundProbe(
_In_ const D3DXVECTOR3 *pMin,
_In_ const D3DXVECTOR3 *pMax,
_In_ const D3DXVECTOR3 *pRayPosition,
_In_ const D3DXVECTOR3 *pRayDirection
);
Parameters
-
pMin [in]
-
Type: const D3DXVECTOR3*
Pointer to a D3DXVECTOR3 structure, describing the lower-left corner of the bounding box. See Remarks.
-
pMax [in]
-
Type: const D3DXVECTOR3*
Pointer to a D3DXVECTOR3 structure, describing the upper-right corner of the bounding box. See Remarks.
-
pRayPosition [in]
-
Type: const D3DXVECTOR3*
Pointer to a D3DXVECTOR3 structure, specifying the origin coordinate of the ray.
-
pRayDirection [in]
-
Type: const D3DXVECTOR3*
Pointer to a D3DXVECTOR3 structure, specifying the direction of the ray. This vector should not be (0,0,0) but does not need to be normalized.
Return value
Type: BOOL
Returns TRUE if the ray intersects the volume of the box's bounding box. Otherwise, returns FALSE.
Remarks
D3DXboxBoundProbe determines if the ray intersects the volume of the box's bounding box, not just the surface of the box.
The values passed to D3DXboxBoundProbe are xmin, xmax, ymin, ymax, zmin, and zmax. Thus, the following defines the corners of the bounding box.
xmax, ymax, zmax
xmax, ymax, zmin
xmax, ymin, zmax
xmax, ymin, zmin
xmin, ymax, zmax
xmin, ymax, zmin
xmin, ymin, zmax
xmin, ymin, zmin
The depth of the bounding box in the z direction is zmax - zmin, in the y direction is ymax - ymin, and in the x direction is xmax - xmin. For example, with the following minimum and maximum vectors, min (-1, -1, -1) and max (1, 1, 1), the bounding box is defined in the following manner.
1, 1, 1
1, 1, -1
1, -1, 1
1, -1, -1
-1, 1, 1
-1, 1, -1
-1, -1, 1
-1, -1, -l
Requirements
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|
See also