CollisionSolid

class CollisionSolid

Bases: CopyOnWriteObject

The abstract base class for all things that can collide with other things in the world, and all the things they can collide with (except geometry).

This class and its derivatives really work very similarly to the way BoundingVolume and all of its derivatives work. There’s a different subclass for each basic shape of solid, and double-dispatch function calls handle the subset of the N*N intersection tests that we care about.

Inheritance diagram

Inheritance diagram of CollisionSolid

void clear_effective_normal(void)

Removes the normal previously set by set_effective_normal().

ConstPointerTo<BoundingVolume> get_bounds(void) const

Returns the solid’s bounding volume.

static TypeHandle get_class_type(void)
virtual LPoint3 get_collision_origin(void) const = 0
LVector3 const &get_effective_normal(void) const

Returns the normal that was set by set_effective_normal(). It is an error to call this unless has_effective_normal() returns true.

bool get_respect_effective_normal(void) const

See set_respect_effective_normal().

bool has_effective_normal(void) const

Returns true if a special normal was set by set_effective_normal(), false otherwise.

bool is_tangible(void) const

Returns whether the solid is considered ‘tangible’ or not. An intangible solid has no effect in a CollisionHandlerPusher (except to throw an event); it’s useful for defining ‘trigger’ planes and spheres, that cause an effect when passed through.

virtual void output(std::ostream &out) const
void set_bounds(BoundingVolume const &bounding_volume)

Returns the solid’s bounding volume.

void set_effective_normal(LVector3 const &effective_normal)

Records a false normal for this CollisionSolid that will be reported by the collision system with all collisions into it, instead of its actual normal. This is useful as a workaround for the problem of an avatar wanting to stand on a sloping ground; by storing a false normal, the ground appears to be perfectly level, and the avatar does not tend to slide down it.

void set_respect_effective_normal(bool respect_effective_normal)

This is only meaningful for CollisionSolids that will be added to a traverser as colliders. It is normally true, but if set false, it means that this particular solid does not care about the “effective” normal of other solids it meets, but rather always uses the true normal.

void set_tangible(bool tangible)

Sets the current state of the ‘tangible’ flag. Set this true to make the solid tangible, so that a CollisionHandlerPusher will not allow another object to intersect it, or false to make it intangible, so that a CollisionHandlerPusher will ignore it except to throw an event.

virtual void write(std::ostream &out, int indent_level = 0) const