Panda3D
Public Member Functions | Static Public Member Functions | Public Attributes | List of all members
CollisionSolid Class Reference

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). More...

Inheritance diagram for CollisionSolid:
CopyOnWriteObject CachedTypedWritableReferenceCount TypedWritableReferenceCount TypedWritable ReferenceCount TypedObject CollisionBox CollisionCapsule CollisionFloorMesh CollisionParabola CollisionPlane CollisionRay CollisionSegment CollisionSphere

Public Member Functions

 clearEffectiveNormal ()
 Removes the normal previously set by set_effective_normal(). More...
 
const BoundingVolume getBounds ()
 Returns the solid's bounding volume. More...
 
LPoint3 getCollisionOrigin ()
 
const LVector3 getEffectiveNormal ()
 Returns the normal that was set by set_effective_normal(). More...
 
bool getRespectEffectiveNormal ()
 See set_respect_effective_normal(). More...
 
bool hasEffectiveNormal ()
 Returns true if a special normal was set by set_effective_normal(), false otherwise. More...
 
bool isTangible ()
 Returns whether the solid is considered 'tangible' or not. More...
 
 output (Ostream out)
 
 setBounds (const BoundingVolume bounding_volume)
 Returns the solid's bounding volume. More...
 
 setEffectiveNormal (const LVector3 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. More...
 
 setRespectEffectiveNormal (bool respect_effective_normal)
 This is only meaningful for CollisionSolids that will be added to a traverser as colliders. More...
 
 setTangible (bool tangible)
 Sets the current state of the 'tangible' flag. More...
 
 write (Ostream out, int indent_level)
 
- Public Member Functions inherited from CopyOnWriteObject
 cacheRef ()
 
bool cacheUnref ()
 
- Public Member Functions inherited from CachedTypedWritableReferenceCount
 cacheRef ()
 Explicitly increments the cache reference count and the normal reference count simultaneously. More...
 
bool cacheUnref ()
 Explicitly decrements the cache reference count and the normal reference count simultaneously. More...
 
int getCacheRefCount ()
 Returns the current reference count. More...
 
bool testRefCountIntegrity ()
 Does some easy checks to make sure that the reference count isn't completely bogus. More...
 
- Public Member Functions inherited from TypedWritable
object __reduce__ ()
 
object __reduce_persist__ (object pickler)
 
VectorUchar encodeToBamStream ()
 Converts the TypedWritable object into a single stream of data using a BamWriter, and returns that data as a bytes object. More...
 
bool encodeToBamStream (VectorUchar data, BamWriter writer)
 Converts the TypedWritable object into a single stream of data using a BamWriter, and stores that data in the indicated string. More...
 
 fillin (DatagramIterator scan, BamReader manager)
 This internal function is intended to be called by each class's make_from_bam() method to read in all of the relevant data from the BamFile for the new object. More...
 
UpdateSeq getBamModified ()
 Returns the current bam_modified counter. More...
 
 markBamModified ()
 Increments the bam_modified counter, so that this object will be invalidated and retransmitted on any open bam streams. More...
 
- Public Member Functions inherited from TypedObject
TypeHandle getType ()
 
int getTypeIndex ()
 Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. More...
 
bool isExactType (TypeHandle handle)
 Returns true if the current object is the indicated type exactly. More...
 
bool isOfType (TypeHandle handle)
 Returns true if the current object is or derives from the indicated type. More...
 
- Public Member Functions inherited from ReferenceCount
int getRefCount ()
 Returns the current reference count. More...
 
 ref ()
 Explicitly increments the reference count. More...
 
bool testRefCountIntegrity ()
 Does some easy checks to make sure that the reference count isn't completely bogus. More...
 
bool testRefCountNonzero ()
 Does some easy checks to make sure that the reference count isn't zero, or completely bogus. More...
 
bool unref ()
 Explicitly decrements the reference count. More...
 

Static Public Member Functions

static TypeHandle getClassType ()
 
- Static Public Member Functions inherited from CopyOnWriteObject
static TypeHandle getClassType ()
 
- Static Public Member Functions inherited from CachedTypedWritableReferenceCount
static TypeHandle getClassType ()
 
- Static Public Member Functions inherited from TypedWritableReferenceCount
static TypedWritableReferenceCount decodeFromBamStream (VectorUchar data, BamReader reader)
 Reads the bytes created by a previous call to encode_to_bam_stream(), and extracts and returns the single object on those bytes. More...
 
static TypeHandle getClassType ()
 
- Static Public Member Functions inherited from TypedWritable
static TypeHandle getClassType ()
 
- Static Public Member Functions inherited from TypedObject
static TypeHandle getClassType ()
 
- Static Public Member Functions inherited from ReferenceCount
static TypeHandle getClassType ()
 

Public Attributes

ConstPointerToBoundingVolume bounds
 Returns the solid's bounding volume. More...
 
LPoint3 collision_origin
 
bool respect_effective_normal
 See set_respect_effective_normal(). More...
 
bool tangible
 Returns whether the solid is considered 'tangible' or not. More...
 
- Public Attributes inherited from CachedTypedWritableReferenceCount
int cache_ref_count
 Returns the current reference count. More...
 
- Public Attributes inherited from TypedObject
TypeHandle type
 Returns the TypeHandle representing this object's type. More...
 
- Public Attributes inherited from ReferenceCount
int ref_count
 The current reference count. More...
 

Detailed Description

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.

Member Function Documentation

◆ clearEffectiveNormal()

clearEffectiveNormal ( )

Removes the normal previously set by set_effective_normal().

◆ getBounds()

const BoundingVolume getBounds ( )

Returns the solid's bounding volume.

◆ getClassType()

static TypeHandle getClassType ( )
static

◆ getCollisionOrigin()

LPoint3 getCollisionOrigin ( )

◆ getEffectiveNormal()

const LVector3 getEffectiveNormal ( )

Returns the normal that was set by set_effective_normal().

It is an error to call this unless has_effective_normal() returns true.

◆ getRespectEffectiveNormal()

bool getRespectEffectiveNormal ( )

See set_respect_effective_normal().

◆ hasEffectiveNormal()

bool hasEffectiveNormal ( )

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

◆ isTangible()

bool isTangible ( )

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.

◆ output()

output ( Ostream  out)

◆ setBounds()

setBounds ( const BoundingVolume  bounding_volume)

Returns the solid's bounding volume.

◆ setEffectiveNormal()

setEffectiveNormal ( const LVector3  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.

◆ setRespectEffectiveNormal()

setRespectEffectiveNormal ( 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.

◆ setTangible()

setTangible ( 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.

◆ write()

write ( Ostream  out,
int  indent_level 
)

Member Data Documentation

◆ bounds

ConstPointerToBoundingVolume bounds

Returns the solid's bounding volume.

◆ collision_origin

LPoint3 collision_origin

◆ respect_effective_normal

bool respect_effective_normal

See set_respect_effective_normal().

◆ tangible

bool tangible

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.