x-YAW
y-PITCH (negative=looking down / positive=looking up)
z-ROLL

Note

If we are looking along the z-axis, its not possible to specify the x and z-angle.

x-YAW
y-PITCH (negative=looking down / positive=looking up)
z-ROLL (its not possile to extract a "roll" from a view-vector)

Note

If we are looking along the z-axis, its not possible to specify the rotation about the z-axis.

< Check if unit vector.

< Check if nonzero.

This function builds a 3x3 orientation matrix using YPR-angles Rotation order for the orientation-matrix is Z-X-Y. (Zaxis=YAW / Xaxis=PITCH / Yaxis=ROLL)

COORDINATE-SYSTEM
z-axis
 ^
 |
 |  y-axis
 |  /
 | /
 |/
 +--------------->   x-axis

Example: Matrix33 orientation=CCamera::CreateOrientationYPR( Ang3(1,2,3) );

< Zaxis = YAW.

< Xaxis = PITCH.

< Yaxis = ROLL.

x=yaw
y=pitch
z=roll (we ignore this element, since its not possible to convert the roll-component into a vector)

< all angles need to be in range between -pi and +pi

< YAW

< PITCH

< calculate the view-direction

get far-plane vertices

Get far-plane vertices.

Parameters

pVerts

pointer to array of 8 elements

Returns

frustum vertices in world space

get near-plane vertices

Get near-plane vertices.

This function checks if an AABB and the camera-frustum overlap. The AABB is assumed to be in world-space. This test can reject even such AABBs that overlap a frustum-plane far outside the view-frustum. IMPORTANT: This function is only useful if you really need exact-culling. It's about 30% slower then "IsAABBVisible_F(aabb)" Example: int InOut=camera.IsAABBVisible_E(aabb);

Return values

CULL_EXCLUSION	AABB outside of frustum (very fast rejection-test).
CULL_OVERLAP	AABB either intersects the borders of the frustum or is totally inside.

Improved approach to check if an AABB and the camera-frustum overlap, or if the AABB is totally inside the camera-frustum. The AABB is assumed to be in world-space. This test can reject even such AABBs that overlap a frustum-plane far outside the view-frustum. IMPORTANT: This function is only useful if you really need exact-culling. It's about 30% slower then "IsAABBVisible_FH(aabb)" Example: int InOut=camera.IsAABBVisible_EH(aabb);

Return values

CULL_EXCLUSION	AABB outside of frustum (very fast rejection-test).
CULL_OVERLAP	AABB intersects the borders of the frustum, further checks necessary.
CULL_INCLUSION	AABB is complete inside the frustum, no further checks necessary.

Improved approach to check if an AABB and the camera-frustum overlap, or if the AABB is totally inside the camera-frustum. The AABB is assumed to be in world-space. This test can reject even such AABBs that overlap a frustum-plane far outside the view-frustum. IMPORTANT: This function is only useful if you really need exact-culling. It's about 30% slower then "IsAABBVisible_FH(aabb)" Example: int InOut=camera.IsAABBVisible_EH(aabb);

Return values

CULL_EXCLUSION	AABB outside of frustum (very fast rejection-test).
CULL_OVERLAP	AABB intersects the borders of the frustum, further checks necessary.
CULL_INCLUSION	AABB is complete inside the frustum, no further checks necessary.

Makes culling taking into account presence of m_pMultiCamera. If m_pMultiCamera exists - object is visible if at least one of cameras see's it

Returns

true if aabb is visible, false otherwise.

Makes culling taking into account presence of m_pMultiCamera. If m_pMultiCamera exists - object is visible if at least one of cameras see's it

Returns

true if aabb is visible, false otherwise.

Fast.

Simple approach to check if an AABB and the camera-frustum overlap. The AABB is assumed to be in world-space. This is a very fast method, just one single dot-product is necessary to check an AABB against a plane. Actually there is no significant speed-different between culling a sphere or an AABB. Example: bool InOut=camera.IsAABBVisible_F(aabb);

Return values

CULL_EXCLUSION	AABB is outside the frustum (very fast rejection-test).
CULL_OVERLAP	AABB either intersects the borders of the frustum, or is totally inside.

Hierarchical approach to check if an AABB and the camera-frustum overlap, or if the AABB is totally inside the camera-frustum. The AABB is assumed to be in world-space. Example: int InOut=camera.IsAABBVisible_FH(aabb);

Return values

CULL_EXCLUSION	AABB outside of frustum (very fast rejection-test).
CULL_OVERLAP	AABB intersects the borders of the frustum, further checks necessary.
CULL_INCLUSION	AABB is complete inside the frustum, no further checks necessary.

Hierarchical approach to check if an AABB and the camera-frustum overlap, or if the AABB is totally inside the camera-frustum. The AABB is assumed to be in world-space. Example: int InOut=camera.IsAABBVisible_FH(aabb);

Return values

CULL_EXCLUSION	AABB outside of frustum (very fast rejection-test).
CULL_OVERLAP	AABB intersects the borders of the frustum, further checks necessary.
CULL_INCLUSION	AABB is complete inside the frustum, no further checks necessary.

Makes culling taking into account presence of m_pMultiCamera. If m_pMultiCamera exists - object is visible if at least one of cameras see's it

Returns

true if aabb is visible, false otherwise.

This function checks if an OBB and the camera-frustum overlap. This test can reject even such OBBs that overlap a frustum-plane far outside the view-frustum. IMPORTANT: It is about 10% slower then "IsOBBVisibleFast(obb)" Example: int InOut=camera.IsOBBVisible_E(OBB);

Return values

CULL_EXCLUSION	OBB outside of frustum (very fast rejection-test).
CULL_OVERLAP	OBB intersects the borders of the frustum or is totally inside.

Improved approach to check if an OBB and the camera-frustum intersect, or if the OBB is totally inside the camera-frustum. The bounding-box of the OBB is assumed to be in world-space. This test can reject even such OBBs that intersect a frustum-plane far outside the view-frustum. Example: int InOut=camera.IsOBBVisible_EH(obb);

Return values

CULL_EXCLUSION	OBB outside of frustum (very fast rejection-test)
CULL_OVERLAP	OBB intersects the borders of the frustum, further checks necessary
CULL_INCLUSION	OBB is complete inside the frustum, no further checks necessary

Fast check if an OBB and the camera-frustum overlap, using the separating-axis-theorem (SAT). The center of the OOBB is assumed to be in world-space.

Note

Even if the OBB is totally inside the frustum, this function returns CULL_OVERLAP. For hierarchical frustum-culling this function is not perfect. Example: bool InOut=camera.IsOBBVisible_F(obb);

Return values

CULL_EXCLUSION	OBB outside of frustum (very fast rejection-test)
CULL_OVERLAP	OBB and frustum intersects or OBB in totally inside frustum

Check if a point lies within camera's frustum.

Check if a point lies within camera's frustum. Example: u8 InOut=camera.IsPointVisible(point);

Returns

CULL_INTERSECT = point inside of frustum, or CULL_EXCLUSION if point is outside of frustum.

Conventional method to check if a sphere and the camera-frustum overlap The center of the sphere is assumed to be in world-space. Example: u8 InOut=camera.IsSphereVisible_F(sphere);

Returns

CULL_EXCLUSION if sphere outside of frustum (very fast rejection-test), or CULL_INTERSECT if sphere and frustum intersect (or sphere is completely inside frustum).

This is going to be the exact version of sphere-culling.

Conventional method to check if a sphere and the camera-frustum overlap, or if the sphere is completely inside the camera-frustum. The center of the sphere is assumed to be in world-space. Example: u8 InOut=camera.IsSphereVisible_FH(sphere);

Return values

CULL_EXCLUSION	Sphere outside of frustum (very fast rejection-test).
CULL_INTERSECT	Sphere intersects the borders of the frustum, further checks necessary.
CULL_INCLUSION	Sphere is complete inside the frustum, no further checks necessary.

Parameters

p	World space position.
result	Screen space pos.

Returns

true if visible on screen.

Z-Buffer ranges. This values are defining near/far clipping plane, it only used to specify z-buffer range. Use it only when you want to override default z-buffer range. Valid values for are: 0 <= zrange <= 1

Updates all parameters required by the render-engine: 3D-view-frustum and all matrices.

Calculate the six frustum-planes using the fustum edges in world-space.