ClipPlaneAttrib

class ClipPlaneAttrib

Bases: RenderAttrib

This functions similarly to a LightAttrib. It indicates the set of clipping planes that modify the geometry at this level and below. A ClipPlaneAttrib can either add planes or remove planes from the total set of clipping planes in effect.

Inheritance diagram

Inheritance diagram of ClipPlaneAttrib

enum Operation

This is the old, deprecated interface to ClipPlaneAttrib. Do not use any of these methods for new code; these methods will be removed soon.

enumerator O_set = 0
enumerator O_add = 1
enumerator O_remove = 2
ConstPointerTo<RenderAttrib> add_off_plane(NodePath const &plane) const

Returns a new ClipPlaneAttrib, just like this one, but with the indicated plane added to the list of planes disabled by this attrib.

ConstPointerTo<RenderAttrib> add_on_plane(NodePath const &plane) const

Returns a new ClipPlaneAttrib, just like this one, but with the indicated plane added to the list of planes enabled by this attrib.

ConstPointerTo<RenderAttrib> add_plane(PlaneNode *plane) const

Returns a new ClipPlaneAttrib, just like this one, but with the indicated plane added to the list of planes.

Deprecated: Use add_on_plane() or add_off_plane() instead.

ConstPointerTo<ClipPlaneAttrib> filter_to_max(int max_clip_planes) const

Returns a new ClipPlaneAttrib, very much like this one, but with the number of on_planes reduced to be no more than max_clip_planes. The number of off_planes in the new ClipPlaneAttrib is undefined.

static int get_class_slot(void)
static TypeHandle get_class_type(void)
int get_num_off_planes(void) const

Returns the number of planes that are disabled by the attribute.

int get_num_on_planes(void) const

Returns the number of planes that are enabled by the attribute.

int get_num_planes(void) const

Returns the number of planes listed in the attribute.

Deprecated: ClipPlaneAttribs nowadays have a separate list of on_planes and

off_planes, so this method no longer makes sense. Query the lists independently.

NodePath get_off_plane(int n) const

Returns the nth plane disabled by the attribute, sorted in arbitrary (pointer) order.

NodePath get_on_plane(int n) const

Returns the nth plane enabled by the attribute, sorted in render order.

Operation get_operation(void) const

Returns the basic operation type of the ClipPlaneAttrib. If this is O_set, the planes listed here completely replace any planes that were already on. If this is O_add, the planes here are added to the set of planes that were already on, and if O_remove, the planes here are removed from the set of planes that were on.

Deprecated: ClipPlaneAttribs nowadays have a separate list of on_planes and

off_planes, so this method no longer makes sense. Query the lists independently.

PlaneNode *get_plane(int n) const

Returns the nth plane listed in the attribute.

Deprecated: ClipPlaneAttribs nowadays have a separate list of on_planes and

off_planes, so this method no longer makes sense. Query the lists independently.

bool has_all_off(void) const

Returns true if this attrib disables all planes (although it may also enable some).

bool has_off_plane(NodePath const &plane) const

Returns true if the indicated plane is disabled by the attrib, false otherwise.

bool has_on_plane(NodePath const &plane) const

Returns true if the indicated plane is enabled by the attrib, false otherwise.

bool has_plane(PlaneNode *plane) const

Returns true if the indicated plane is listed in the attrib, false otherwise.

Deprecated: ClipPlaneAttribs nowadays have a separate list of on_planes and

off_planes, so this method no longer makes sense. Query the lists independently.

bool is_identity(void) const

Returns true if this is an identity attrib: it does not change the set of planes in use.

static ConstPointerTo<RenderAttrib> make(ClipPlaneAttrib::Operation op, PlaneNode *plane)
static ConstPointerTo<RenderAttrib> make(ClipPlaneAttrib::Operation op, PlaneNode *plane1, PlaneNode *plane2)
static ConstPointerTo<RenderAttrib> make(ClipPlaneAttrib::Operation op, PlaneNode *plane1, PlaneNode *plane2, PlaneNode *plane3)
static ConstPointerTo<RenderAttrib> make(ClipPlaneAttrib::Operation op, PlaneNode *plane1, PlaneNode *plane2, PlaneNode *plane3, PlaneNode *plane4)
static ConstPointerTo<RenderAttrib> make(void)

The following is the new, more general interface to the ClipPlaneAttrib.

Constructs a new ClipPlaneAttrib object that enables (or disables, according to op) the indicated plane(s).

Deprecated: Use add_on_plane() or add_off_plane() instead.

Constructs a new ClipPlaneAttrib object that turns on (or off, according to op) the indicate plane(s).

Deprecated: Use add_on_plane() or add_off_plane() instead.

Constructs a new ClipPlaneAttrib object that turns on (or off, according to op) the indicate plane(s).

Deprecated: Use add_on_plane() or add_off_plane() instead.

Constructs a new ClipPlaneAttrib object that turns on (or off, according to op) the indicate plane(s).

Deprecated: Use add_on_plane() or add_off_plane() instead.

Constructs a new ClipPlaneAttrib object that does nothing.

static ConstPointerTo<RenderAttrib> make_all_off(void)

Constructs a new ClipPlaneAttrib object that disables all planes (and hence disables clipping).

static ConstPointerTo<RenderAttrib> make_default(void)

Returns a RenderAttrib that corresponds to whatever the standard default properties for render attributes of this type ought to be.

ConstPointerTo<RenderAttrib> remove_off_plane(NodePath const &plane) const

Returns a new ClipPlaneAttrib, just like this one, but with the indicated plane removed from the list of planes disabled by this attrib.

ConstPointerTo<RenderAttrib> remove_on_plane(NodePath const &plane) const

Returns a new ClipPlaneAttrib, just like this one, but with the indicated plane removed from the list of planes enabled by this attrib.

ConstPointerTo<RenderAttrib> remove_plane(PlaneNode *plane) const

Returns a new ClipPlaneAttrib, just like this one, but with the indicated plane removed from the list of planes.

Deprecated: Use remove_on_plane() or remove_off_plane() instead.