CrystalSpace

Public API Reference

CS::RenderViewClipper Class Reference

Helper to clip in the context of a render view. More...

#include <cstool/rviewclipper.h>

List of all members.

Static Public Member Functions

static void CalculateClipSettings (csRenderContext *ctxt, uint32 frustum_mask, int &clip_portal, int &clip_plane, int &clip_z_plane)
 Given a frustum_mask, calculate the clip settings.
static bool CullBBox (const csRenderContext *ctxt, const csPlane3 *planes, uint32 &frustum_mask, const csBox3 &obox, int &clip_portal, int &clip_plane, int &clip_z_plane)
 Check if the object space bounding box of an object is visible in this render view.
static bool CullBSphere (csRenderContext *ctxt, const csSphere &cam_sphere, const csSphere &world_sphere, int &clip_portal, int &clip_plane, int &clip_z_plane)
 Check if the given bounding sphere (in camera and world space coordinates) is visibile for the render context.
static void SetupClipPlanes (csRenderContext *ctxt)
 Setup the clip planes for the current context and camera (in world space).
static void SetupClipPlanes (csRenderContext *ctxt, const csReversibleTransform &tr_o2c, csPlane3 *planes, uint32 &frustum_mask)
 Setup clipping planes in object space.
static bool TestBSphere (csRenderContext *ctxt, const csReversibleTransform &w2c, const csSphere &sphere)
 Test if the given bounding sphere (in world space coordinates) is visible for the render context.

Detailed Description

Helper to clip in the context of a render view.

This class is mostly useful for mesh object implementors.

Definition at line 35 of file rviewclipper.h.


Member Function Documentation

static void CS::RenderViewClipper::CalculateClipSettings ( csRenderContext ctxt,
uint32  frustum_mask,
int &  clip_portal,
int &  clip_plane,
int &  clip_z_plane 
) [static]

Given a frustum_mask, calculate the clip settings.

static bool CS::RenderViewClipper::CullBBox ( const csRenderContext ctxt,
const csPlane3 planes,
uint32 &  frustum_mask,
const csBox3 obox,
int &  clip_portal,
int &  clip_plane,
int &  clip_z_plane 
) [static]

Check if the object space bounding box of an object is visible in this render view.

If true is returned (visible) then clip_plane, clip_z_plane, and clip_portal will be set to the right value depending on wether or not clipping is wanted. This function also does far plane clipping. Use SetupClipPlanes() to get the clipping planes for this function. The frustum_mask will be modified according to all clip planes that were relevant for the given box. That can be used to hierarchically cull smaller objects.

static bool CS::RenderViewClipper::CullBSphere ( csRenderContext ctxt,
const csSphere cam_sphere,
const csSphere world_sphere,
int &  clip_portal,
int &  clip_plane,
int &  clip_z_plane 
) [static]

Check if the given bounding sphere (in camera and world space coordinates) is visibile for the render context.

If the sphere is visible this function will also initialize the clip_plane, clip_z_plane, and clip_portal fields which can be used for the renderer.

static void CS::RenderViewClipper::SetupClipPlanes ( csRenderContext ctxt  )  [static]

Setup the clip planes for the current context and camera (in world space).

static void CS::RenderViewClipper::SetupClipPlanes ( csRenderContext ctxt,
const csReversibleTransform tr_o2c,
csPlane3 planes,
uint32 &  frustum_mask 
) [static]

Setup clipping planes in object space.

The input arrays for planes should each be able to hold 10 planes. Returns a mask that you can use for the csIntersect3::BoxFrustum() function.

Deprecated:
Use CS::RenderViewClipper::SetupClipPlanes() instead.
static bool CS::RenderViewClipper::TestBSphere ( csRenderContext ctxt,
const csReversibleTransform w2c,
const csSphere sphere 
) [static]

Test if the given bounding sphere (in world space coordinates) is visible for the render context.

The optional will transform world to camera space.


The documentation for this class was generated from the following file:

Generated for Crystal Space 2.1 by doxygen 1.6.1