Panda3D
Classes | Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Static Public Attributes | Protected Member Functions | Static Protected Member Functions

CollisionBox Class Reference

A cuboid collision volume or object. More...

#include "collisionBox.h"

Inheritance diagram for CollisionBox:
CollisionSolid CopyOnWriteObject CachedTypedWritableReferenceCount TypedWritableReferenceCount TypedWritable ReferenceCount TypedObject MemoryBase MemoryBase

List of all members.

Classes

class  PointDef

Public Types

typedef pvector< PointDefPoints

Public Member Functions

 CollisionBox (const LPoint3f &center, float x, float y, float z)
 Create the Box by giving a Center and distances of of each of the sides of box from the Center.
 CollisionBox (float cx, float cy, float cz, float x, float y, float z)
 Center as three separate co-ordinate points.
 CollisionBox (const CollisionBox &copy)
 CollisionBox (const LPoint3f &min, const LPoint3f &max)
 Create the Box by Specifying the Diagonal Points.
bool apply_clip_plane (Points &new_points, const ClipPlaneAttrib *cpa, const TransformState *net_transform, int plane_no) const
 Clips the polygon by all of the clip planes named in the clip plane attribute and fills new_points up with the resulting points.
virtual ReferenceCountas_reference_count ()
 Returns the pointer cast to a ReferenceCount pointer, if it is in fact of that type.
TypedObjectas_typed_object ()
 Returns the object, upcast (if necessary) to a TypedObject pointer.
const TypedObjectas_typed_object () const
 Returns the object, upcast (if necessary) to a TypedObject pointer.
void cache_ref () const
 Explicitly increments the cache reference count and the normal reference count simultaneously.
bool cache_unref () const
 Explicitly decrements the cache reference count and the normal reference count simultaneously.
void calc_to_3d_mat (LMatrix4f &to_3d_mat, int plane) const
 Fills the indicated matrix with the appropriate rotation transform to move points from the 2-d plane into the 3-d (X, 0, Z) plane.
void clear_effective_normal ()
 Removes the normal previously set by set_effective_normal().
bool clip_polygon (Points &new_points, const Points &source_points, const Planef &plane, int plane_no) const
 Clips the source_points of the polygon by the indicated clipping plane, and modifies new_points to reflect the new set of clipped points (but does not compute the vectors in new_points).
virtual int complete_pointers (TypedWritable **p_list, BamReader *manager)
 Receives an array of pointers, one for each time manager->read_pointer() was called in fillin().
 CPT (BoundingVolume) get_bounds() const
float dist_to_polygon (const LPoint2f &p, const Points &points) const
 Returns the linear distance from the 2-d point to the nearest part of the polygon defined by the points vector.
void draw_polygon (GeomNode *viz_geom_node, GeomNode *bounds_viz_geom_node, const Points &points) const
bool encode_to_bam_stream (string &data, BamWriter *writer=NULL) const
 Converts the TypedWritable object into a single stream of data using a BamWriter, and stores that data in the indicated string.
string encode_to_bam_stream () const
 Converts the TypedWritable object into a single stream of data using a BamWriter, and returns that data as a string string.
virtual void finalize (BamReader *manager)
 Called by the BamReader to perform any final actions needed for setting up the object after all objects have been read and all pointers have been completed.
virtual TypeHandle force_init_type ()
virtual LPoint3f get_approx_center () const
UpdateSeq get_bam_modified () const
 Returns the current bam_modified counter.
int get_best_parent_from_Set (const std::set< int > &) const
int get_cache_ref_count () const
 Returns the current reference count.
const LPoint3fget_center () const
virtual LPoint3f get_collision_origin () const
 Returns the point in space deemed to be the "origin" of the solid for collision purposes.
const LVector3fget_effective_normal () const
 Returns the normal that was set by set_effective_normal().
virtual LPoint3f get_max () const
virtual LPoint3f get_min () const
int get_num_planes () const
 Returns 6: the number of faces of a rectangular solid.
int get_num_points () const
 Returns 8: the number of vertices of a rectangular solid.
Planef get_plane (int n) const
 Returns the nth face of the rectangular solid.
Points get_plane_points (int n)
 returns the points that form the nth plane
LPoint3f get_point (int n) const
 Returns the nth vertex of the OBB.
LPoint3f get_point_aabb (int n) const
 Returns the nth vertex of the Axis Aligned Bounding Box.
float get_radius () const
int get_ref_count () const
 Returns the current reference count.
bool get_respect_effective_normal () const
 See set_respect_effective_normal().
virtual PStatCollectorget_test_pcollector ()
 Returns a PStatCollector that is used to count the number of intersection tests made against a solid of this type in a given frame.
virtual TypeHandle get_type () const
int get_type_index () const
 Returns the internal index number associated with this object's TypeHandle, a unique number for each different type.
virtual PStatCollectorget_volume_pcollector ()
 Returns a PStatCollector that is used to count the number of bounding volume tests made against a solid of this type in a given frame.
WeakReferenceListget_weak_list () const
 Returns the WeakReferenceList associated with this ReferenceCount object.
bool has_effective_normal () const
 Returns true if a special normal was set by set_effective_normal(), false otherwise.
bool has_weak_list () const
 Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise.
bool is_exact_type (TypeHandle handle) const
 Returns true if the current object is the indicated type exactly.
bool is_of_type (TypeHandle handle) const
 Returns true if the current object is or derives from the indicated type.
bool is_tangible () const
 Returns whether the solid is considered 'tangible' or not.
LPoint3f legacy_to_3d (const LVecBase2f &point2d, int axis) const
void local_object ()
 This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack.
virtual CollisionSolidmake_copy ()
void mark_bam_modified ()
 Increments the bam_modified counter, so that this object will be invalidated and retransmitted on any open bam streams.
void operator delete (void *ptr, void *)
void operator delete (void *ptr)
void operator delete (void *ptr, void *)
void operator delete (void *ptr)
void operator delete[] (void *ptr)
void operator delete[] (void *ptr)
void operator delete[] (void *, void *)
void operator delete[] (void *, void *)
void * operator new (size_t size)
void * operator new (size_t size)
void * operator new (size_t size, void *ptr)
void * operator new (size_t size, void *ptr)
void * operator new[] (size_t size)
void * operator new[] (size_t size, void *ptr)
void * operator new[] (size_t size, void *ptr)
void * operator new[] (size_t size)
virtual void output (ostream &out) const
bool point_is_inside (const LPoint2f &p, const Points &points) const
 Returns true if the indicated point is within the polygon's 2-d space, false otherwise.
virtual PT (CollisionEntry) test_intersection(const CollisionEntry &entry) const
virtual PT (PandaNode) get_viz(const CullTraverser *trav
void rederive_to_3d_mat (LMatrix4f &to_3d_mat, int plane) const
 Fills the indicated matrix with the appropriate rotation transform to move points from the 2-d plane into the 3-d (X, 0, Z) plane.
void ref () const
 Explicitly increments the reference count.
virtual bool require_fully_complete () const
 Some objects require all of their nested pointers to have been completed before the objects themselves can be completed.
void set_bounds (const BoundingVolume &bounding_volume)
 Returns the solid's bounding volume.
void set_center (float x, float y, float z)
void set_center (const LPoint3f &center)
void set_effective_normal (const LVector3f &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.
Planef set_plane (int n) const
 Creates the nth face of the rectangular solid.
void set_respect_effective_normal (bool respect_effective_normal)
 This is only meaningful for CollisionSolids that will be added to a traverser as colliders.
void set_tangible (bool tangible)
 Sets the current state of the 'tangible' flag.
void setup_box ()
 Compute parameters for each of the box's sides.
void setup_points (const LPoint3f *begin, const LPoint3f *end, int plane)
 Computes the plane and 2d projection of points that make up this side.
bool test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus.
bool test_ref_count_nonzero () const
 Does some easy checks to make sure that the reference count isn't zero, or completely bogus.
LPoint2f to_2d (const LVecBase3f &point3d, int plane) const
 Assuming the indicated point in 3-d space lies within the polygon's plane, returns the corresponding point in the polygon's 2-d definition space.
virtual bool unref () const
 Explicitly decrements the reference count.
virtual void update_bam_nested (BamWriter *manager)
 Called by the BamWriter when this object has not itself been modified recently, but it should check its nested objects for updates.
void weak_ref (WeakPointerToVoid *ptv)
 Adds the indicated PointerToVoid as a weak reference to this object.
void weak_unref (WeakPointerToVoid *ptv)
 Removes the indicated PointerToVoid as a weak reference to this object.
virtual void write (ostream &out, int indent_level=0) const
virtual void write_datagram (BamWriter *manager, Datagram &me)
 Function to write the important information in the particular object to a Datagram.
virtual void xform (const LMatrix4f &mat)
 Transforms the solid by the indicated matrix.

Static Public Member Functions

static void compute_vectors (Points &points)
 Now that the _p members of the given points array have been computed, go back and compute all of the _v members.
static bool decode_raw_from_bam_stream (TypedWritable *&ptr, ReferenceCount *&ref_ptr, const string &data, BamReader *reader=NULL)
 Reads the string created by a previous call to encode_to_bam_stream(), and extracts the single object on that string.
static void flush_level ()
 Flushes the PStatCollectors used during traversal.
static TypeHandle get_class_type ()
static void init_type ()
static PT (TypedWritableReferenceCount) decode_from_bam_stream(const string &data
static void register_with_read_factory ()
 Factory method to generate a CollisionBox object.
static LPoint3f to_3d (const LVecBase2f &point2d, const LMatrix4f &to_3d_mat)
 Extrude the indicated point in the polygon's 2-d definition space back into 3-d coordinates.

Public Attributes

virtual const
CullTraverserData bool
bounds_only 
const
virtual const CullTraverserDatadata
static BamReaderreader = NULL)

Static Public Attributes

static TypedWritable *const Null = (TypedWritable*)0L

Protected Member Functions

 CollisionBox ()
 Creates an invalid Box.
void cache_unref_only () const
 Decrements the cache reference count without affecting the normal reference count.
Vertexf compute_point (float latitude, float longitude) const
 Returns a point on the surface of the sphere.
 CPT (RenderState) get_wireframe_bounds_viz_state()
 CPT (RenderState) get_other_bounds_viz_state()
 CPT (RenderState) get_solid_viz_state()
 CPT (RenderState) get_wireframe_viz_state()
 CPT (RenderState) get_other_viz_state()
 CPT (RenderState) get_solid_bounds_viz_state()
bool do_has_effective_normal () const
 Returns true if a special normal was set by set_effective_normal(), false otherwise.
bool do_is_tangible () const
 Returns whether the solid is considered 'tangible' or not.
bool do_test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus.
bool do_test_ref_count_nonzero () const
 Returns true if the reference count is nonzero, false otherwise.
virtual void fill_viz_geom ()
 Fills the _viz_geom GeomNode up with Geoms suitable for rendering this solid.
void fillin (DatagramIterator &scan, BamReader *manager)
 Function that reads out of the datagram (or asks manager to read) all of the data that is needed to re-create this object and stores it in the appropiate place.
void mark_internal_bounds_stale ()
 Should be called by a derived class to mark the internal bounding volume stale, so that recompute_internal_bounds() will be called when the bounding volume is next requested.
void mark_viz_stale ()
 Called internally when the visualization may have been compromised by some change to internal state and will need to be recomputed the next time it is rendered.
virtual PT (CollisionEntry) test_intersection_from_ray(const CollisionEntry &entry) const
virtual PT (BoundingVolume) compute_internal_bounds() const
virtual PT (CollisionEntry) test_intersection_from_box(const CollisionEntry &entry) const
 PT (GeomNode) _viz_geom
virtual PT (CollisionEntry) test_intersection_from_sphere(const CollisionEntry &entry) const
virtual PT (CopyOnWriteObject) make_cow_copy()
virtual PT (CollisionEntry) test_intersection_from_segment(const CollisionEntry &entry) const

Static Protected Member Functions

static TypedWritablemake_CollisionBox (const FactoryParams &params)
 Factory method to generate a CollisionBox object.
static void report_undefined_from_intersection (TypeHandle from_type)
 Outputs a message the first time an intersection test is attempted that isn't defined, and explains a bit about what it means.
static void report_undefined_intersection_test (TypeHandle from_type, TypeHandle into_type)
 Outputs a message the first time an intersection test is attempted that isn't defined, and explains a bit about what it means.

Detailed Description

A cuboid collision volume or object.

Definition at line 29 of file collisionBox.h.


Constructor & Destructor Documentation

CollisionBox::CollisionBox ( const LPoint3f center,
float  x,
float  y,
float  z 
) [inline]

Create the Box by giving a Center and distances of of each of the sides of box from the Center.

Definition at line 23 of file collisionBox.I.

References get_point_aabb(), set_plane(), and setup_box().

CollisionBox::CollisionBox ( float  cx,
float  cy,
float  cz,
float  x,
float  y,
float  z 
) [inline]

Center as three separate co-ordinate points.

Definition at line 63 of file collisionBox.I.

References CollisionBox().

CollisionBox::CollisionBox ( const LPoint3f min,
const LPoint3f max 
) [inline]

Create the Box by Specifying the Diagonal Points.

Definition at line 42 of file collisionBox.I.

References get_point_aabb(), set_plane(), and setup_box().

CollisionBox::CollisionBox ( ) [inline, protected]

Creates an invalid Box.

Only used when reading from a bam file.

Definition at line 75 of file collisionBox.I.

Referenced by CollisionBox(), and make_CollisionBox().


Member Function Documentation

bool CollisionBox::apply_clip_plane ( CollisionBox::Points &  new_points,
const ClipPlaneAttrib cpa,
const TransformState net_transform,
int  plane_no 
) const

Clips the polygon by all of the clip planes named in the clip plane attribute and fills new_points up with the resulting points.

The return value is true if the set of points is unmodified (all points are behind all the clip planes), or false otherwise.

Definition at line 677 of file collisionBox.cxx.

References clip_polygon(), compute_vectors(), PlaneNode::get_clip_effect(), ClipPlaneAttrib::get_num_on_planes(), ClipPlaneAttrib::get_on_plane(), PlaneNode::get_plane(), and NodePath::node().

ReferenceCount * TypedWritableReferenceCount::as_reference_count ( ) [virtual, inherited]

Returns the pointer cast to a ReferenceCount pointer, if it is in fact of that type.

Reimplemented from TypedWritable.

Definition at line 26 of file typedWritableReferenceCount.cxx.

TypedObject * TypedObject::as_typed_object ( ) [inline, inherited]

Returns the object, upcast (if necessary) to a TypedObject pointer.

Definition at line 99 of file typedObject.I.

const TypedObject * TypedObject::as_typed_object ( ) const [inline, inherited]

Returns the object, upcast (if necessary) to a TypedObject pointer.

Definition at line 110 of file typedObject.I.

void CachedTypedWritableReferenceCount::cache_ref ( ) const [inline, inherited]

Explicitly increments the cache reference count and the normal reference count simultaneously.

Reimplemented in RenderState, and TransformState.

Definition at line 147 of file cachedTypedWritableReferenceCount.I.

References ReferenceCount::ref(), and CachedTypedWritableReferenceCount::test_ref_count_integrity().

Referenced by CopyOnWritePointer::get_write_pointer().

bool CachedTypedWritableReferenceCount::cache_unref ( ) const [inline, inherited]

Explicitly decrements the cache reference count and the normal reference count simultaneously.

The return value is true if the new reference count is nonzero, false if it is zero.

Reimplemented in RenderState, and TransformState.

Definition at line 166 of file cachedTypedWritableReferenceCount.I.

References CachedTypedWritableReferenceCount::test_ref_count_integrity(), and ReferenceCount::unref().

void CachedTypedWritableReferenceCount::cache_unref_only ( ) const [inline, protected, inherited]

Decrements the cache reference count without affecting the normal reference count.

Intended to be called by derived classes only, presumably to reimplement cache_unref().

Definition at line 204 of file cachedTypedWritableReferenceCount.I.

References CachedTypedWritableReferenceCount::test_ref_count_integrity().

void CollisionBox::calc_to_3d_mat ( LMatrix4f to_3d_mat,
int  plane 
) const [inline]

Fills the indicated matrix with the appropriate rotation transform to move points from the 2-d plane into the 3-d (X, 0, Z) plane.

Definition at line 272 of file collisionBox.I.

References get_plane(), get_point(), and LMatrix4f::set_row().

Referenced by setup_points().

void CollisionSolid::clear_effective_normal ( ) [inline, inherited]

Removes the normal previously set by set_effective_normal().

Definition at line 78 of file collisionSolid.I.

bool CollisionBox::clip_polygon ( CollisionBox::Points &  new_points,
const Points &  source_points,
const Planef &  plane,
int  plane_no 
) const

Clips the source_points of the polygon by the indicated clipping plane, and modifies new_points to reflect the new set of clipped points (but does not compute the vectors in new_points).

The return value is true if the set of points is unmodified (all points are behind the clip plane), or false otherwise.

Definition at line 727 of file collisionBox.cxx.

References get_plane(), get_point(), and to_2d().

Referenced by apply_clip_plane().

int TypedWritable::complete_pointers ( TypedWritable **  p_list,
BamReader manager 
) [virtual, inherited]

Receives an array of pointers, one for each time manager->read_pointer() was called in fillin().

Returns the number of pointers processed.

This is the callback function that is made by the BamReader at some later point, after all of the required pointers have been filled in. It is necessary because there might be forward references in a bam file; when we call read_pointer() in fillin(), the object may not have been read from the file yet, so we do not have a pointer available at that time. Thus, instead of returning a pointer, read_pointer() simply reserves a later callback. This function provides that callback. The calling object is responsible for keeping track of the number of times it called read_pointer() and extracting the same number of pointers out of the supplied vector, and storing them appropriately within the object.

Reimplemented in CFDoCullCommand, AnimBundleNode, AnimChannelMatrixDynamic, AnimChannelScalarDynamic, AnimGroup, MovingPartBase, PartBundle, PartBundleNode, PartGroup, Character, CharacterJoint, CharacterJointEffect, CharacterVertexSlider, JointVertexTransform, CollisionNode, DataNodeTransmit, GeomVertexArrayData, GeomVertexArrayFormat, GeomVertexData, GeomVertexFormat, SliderTable, TextureStage, TransformBlendTable, TransformTable, PiecewiseCurve, ClipPlaneAttrib, FogAttrib, LensNode, LightAttrib, MaterialAttrib, PortalNode, RenderEffects, RenderState, TexGenAttrib, TexMatrixAttrib, TexProjectorEffect, TextureAttrib, BamCacheIndex, RecorderFrame, EggFile, ImageFile, PaletteGroup, PaletteGroups, PaletteImage, PalettePage, Palettizer, SourceTextureImage, TextureImage, TexturePlacement, TextureProperties, and TextureReference.

Definition at line 103 of file typedWritable.cxx.

Vertexf CollisionBox::compute_point ( float  latitude,
float  longitude 
) const [protected]

Returns a point on the surface of the sphere.

latitude and longitude range from 0.0 to 1.0. This is used by fill_viz_geom() to create a visible representation of the sphere.

Definition at line 1005 of file collisionBox.cxx.

void CollisionBox::compute_vectors ( Points &  points) [static]

Now that the _p members of the given points array have been computed, go back and compute all of the _v members.

Definition at line 1024 of file collisionBox.cxx.

Referenced by apply_clip_plane(), and setup_points().

bool TypedWritable::decode_raw_from_bam_stream ( TypedWritable *&  ptr,
ReferenceCount *&  ref_ptr,
const string &  data,
BamReader reader = NULL 
) [static, inherited]

Reads the string created by a previous call to encode_to_bam_stream(), and extracts the single object on that string.

Returns true on success, false on on error.

This variant sets the TypedWritable and ReferenceCount pointers separately; both are pointers to the same object. The reference count is not incremented; it is the caller's responsibility to manage the reference count.

Note that this method cannot be used to retrieve objects that do not inherit from ReferenceCount, because these objects cannot persist beyond the lifetime of the BamReader that reads them. To retrieve these objects from a bam stream, you must construct a BamReader directly.

If you happen to know that the particular object in question inherits from TypedWritableReferenceCount or PandaNode, consider calling the variant of decode_from_bam_stream() defined for those methods, which presents a simpler interface.

Definition at line 353 of file typedWritable.cxx.

References BamReader::init(), DatagramInputFile::open(), DatagramInputFile::read_header(), BamReader::read_object(), ReferenceCount::ref(), BamReader::resolve(), BamReader::set_source(), and ReferenceCount::unref().

float CollisionBox::dist_to_polygon ( const LPoint2f p,
const Points &  points 
) const

Returns the linear distance from the 2-d point to the nearest part of the polygon defined by the points vector.

The result is negative if the point is within the polygon.

Definition at line 815 of file collisionBox.cxx.

bool CollisionSolid::do_has_effective_normal ( ) const [inline, protected, inherited]

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

Assumes the lock is already held.

Definition at line 161 of file collisionSolid.I.

Referenced by CollisionSolid::get_effective_normal(), and CollisionSolid::has_effective_normal().

bool CollisionSolid::do_is_tangible ( ) const [inline, protected, inherited]

Returns whether the solid is considered 'tangible' or not.

Assumes the lock is already held.

Definition at line 149 of file collisionSolid.I.

Referenced by CollisionSolid::is_tangible().

bool CachedTypedWritableReferenceCount::do_test_ref_count_integrity ( ) const [protected, inherited]

Does some easy checks to make sure that the reference count isn't completely bogus.

Reimplemented from ReferenceCount.

Reimplemented in NodeCachedReferenceCount.

Definition at line 26 of file cachedTypedWritableReferenceCount.cxx.

Referenced by CachedTypedWritableReferenceCount::test_ref_count_integrity().

bool ReferenceCount::do_test_ref_count_nonzero ( ) const [protected, inherited]

Returns true if the reference count is nonzero, false otherwise.

Definition at line 56 of file referenceCount.cxx.

References ReferenceCount::do_test_ref_count_integrity().

Referenced by ReferenceCount::test_ref_count_nonzero().

string TypedWritable::encode_to_bam_stream ( ) const [inline, inherited]

Converts the TypedWritable object into a single stream of data using a BamWriter, and returns that data as a string string.

Returns empty string on failure.

This is a convenience method particularly useful for cases when you are only serializing a single object. If you have many objects to process, it is more efficient to use the same BamWriter to serialize all of them together.

Definition at line 86 of file typedWritable.I.

bool TypedWritable::encode_to_bam_stream ( string &  data,
BamWriter writer = NULL 
) const [inherited]

Converts the TypedWritable object into a single stream of data using a BamWriter, and stores that data in the indicated string.

Returns true on success, false on failure.

This is a convenience method particularly useful for cases when you are only serializing a single object. If you have many objects to process, it is more efficient to use the same BamWriter to serialize all of them together.

Definition at line 283 of file typedWritable.cxx.

References BamWriter::init(), DatagramOutputFile::open(), BamWriter::set_target(), DatagramOutputFile::write_header(), and BamWriter::write_object().

void CollisionBox::fill_viz_geom ( ) [protected, virtual]

Fills the _viz_geom GeomNode up with Geoms suitable for rendering this solid.

Reimplemented from CollisionSolid.

Definition at line 638 of file collisionBox.cxx.

References GeomVertexWriter::add_data3f(), get_point(), and GeomVertexFormat::get_v3().

void CollisionBox::fillin ( DatagramIterator scan,
BamReader manager 
) [protected, virtual]

Function that reads out of the datagram (or asks manager to read) all of the data that is needed to re-create this object and stores it in the appropiate place.

Reimplemented from CollisionSolid.

Definition at line 1101 of file collisionBox.cxx.

References DatagramIterator::get_float32(), DatagramIterator::get_uint16(), LVecBase2f::read_datagram(), LMatrix4f::read_datagram(), and LVecBase3f::read_datagram().

Referenced by make_CollisionBox().

void TypedWritable::finalize ( BamReader manager) [virtual, inherited]

Called by the BamReader to perform any final actions needed for setting up the object after all objects have been read and all pointers have been completed.

Reimplemented in PartBundle, Geom, GeomPrimitive, GeomVertexArrayData, GeomVertexArrayFormat, GeomVertexData, InternalName, GeomNode, LightAttrib, RenderAttrib, RenderEffect, RenderEffects, RenderState, PaletteGroup, and Palettizer.

Definition at line 145 of file typedWritable.cxx.

Referenced by BamReader::finalize_now().

void CollisionBox::flush_level ( ) [inline, static]

Flushes the PStatCollectors used during traversal.

Definition at line 107 of file collisionBox.I.

UpdateSeq TypedWritable::get_bam_modified ( ) const [inline, inherited]

Returns the current bam_modified counter.

This counter is normally incremented automatically whenever the object is modified.

Definition at line 66 of file typedWritable.I.

Referenced by BamWriter::consider_update(), and BamWriter::write_pointer().

int CachedTypedWritableReferenceCount::get_cache_ref_count ( ) const [inline, inherited]
LPoint3f CollisionBox::get_collision_origin ( ) const [virtual]

Returns the point in space deemed to be the "origin" of the solid for collision purposes.

The closest intersection point to this origin point is considered to be the most significant.

Implements CollisionSolid.

Definition at line 173 of file collisionBox.cxx.

const LVector3f & CollisionSolid::get_effective_normal ( ) const [inline, inherited]

Returns the normal that was set by set_effective_normal().

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

Definition at line 103 of file collisionSolid.I.

References CollisionSolid::do_has_effective_normal(), and LVector3f::zero().

int CollisionBox::get_num_planes ( ) const [inline]

Returns 6: the number of faces of a rectangular solid.

Definition at line 197 of file collisionBox.I.

int CollisionBox::get_num_points ( ) const [inline]

Returns 8: the number of vertices of a rectangular solid.

Definition at line 160 of file collisionBox.I.

Planef CollisionBox::get_plane ( int  n) const [inline]

Returns the nth face of the rectangular solid.

Definition at line 207 of file collisionBox.I.

Referenced by calc_to_3d_mat(), and clip_polygon().

CollisionBox::Points CollisionBox::get_plane_points ( int  n) [inline]

returns the points that form the nth plane

Definition at line 360 of file collisionBox.I.

LPoint3f CollisionBox::get_point ( int  n) const [inline]

Returns the nth vertex of the OBB.

Definition at line 170 of file collisionBox.I.

References LPoint3f::zero().

Referenced by calc_to_3d_mat(), clip_polygon(), fill_viz_geom(), set_plane(), and setup_box().

LPoint3f CollisionBox::get_point_aabb ( int  n) const [inline]

Returns the nth vertex of the Axis Aligned Bounding Box.

Definition at line 182 of file collisionBox.I.

References LPoint3f::zero().

Referenced by CollisionBox().

int ReferenceCount::get_ref_count ( ) const [inline, inherited]
bool CollisionSolid::get_respect_effective_normal ( ) const [inline, inherited]

See set_respect_effective_normal().

Definition at line 137 of file collisionSolid.I.

PStatCollector & CollisionBox::get_test_pcollector ( ) [virtual]

Returns a PStatCollector that is used to count the number of intersection tests made against a solid of this type in a given frame.

Reimplemented from CollisionSolid.

Definition at line 227 of file collisionBox.cxx.

int TypedObject::get_type_index ( ) const [inline, inherited]

Returns the internal index number associated with this object's TypeHandle, a unique number for each different type.

This is equivalent to get_type().get_index().

Definition at line 52 of file typedObject.I.

References TypeHandle::get_index().

PStatCollector & CollisionBox::get_volume_pcollector ( ) [virtual]

Returns a PStatCollector that is used to count the number of bounding volume tests made against a solid of this type in a given frame.

Reimplemented from CollisionSolid.

Definition at line 215 of file collisionBox.cxx.

WeakReferenceList * ReferenceCount::get_weak_list ( ) const [inline, inherited]

Returns the WeakReferenceList associated with this ReferenceCount object.

If there has never been a WeakReferenceList associated with this object, creates one now.

Definition at line 307 of file referenceCount.I.

Referenced by ReferenceCount::weak_ref().

bool CollisionSolid::has_effective_normal ( ) const [inline, inherited]

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

Definition at line 90 of file collisionSolid.I.

References CollisionSolid::do_has_effective_normal().

bool ReferenceCount::has_weak_list ( ) const [inline, inherited]

Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise.

In general, this will be true if there was ever a WeakPointerTo created for this object (even if there is not any for it now).

Definition at line 294 of file referenceCount.I.

Referenced by ReferenceCount::weak_unref().

bool TypedObject::is_exact_type ( TypeHandle  handle) const [inline, inherited]
bool TypedObject::is_of_type ( TypeHandle  handle) const [inline, inherited]

Returns true if the current object is or derives from the indicated type.

Definition at line 63 of file typedObject.I.

References TypeHandle::is_derived_from().

Referenced by EggSliderData::add_back_pointer(), EggJointData::add_back_pointer(), CIntervalManager::add_c_interval(), XFileNode::add_child(), CollisionTraverser::add_collider(), CollisionHandlerPhysical::add_collider(), EggXfmSAnim::add_data(), CharacterJointBundle::add_node(), NonlinearImager::add_screen(), EggGroupNode::apply_first_attribute(), EggGroupNode::apply_last_attribute(), DeferredNodeProperty::apply_to_node(), RecorderController::begin_playback(), NodePath::clear_clip_plane(), EggGroupNode::clear_connected_shading(), NodePath::clear_light(), EggBase::convert_paths(), NodePath::decode_from_bam_stream(), VrpnClient::disconnect_device(), PhysicsManager::do_physics(), GraphicsStateGuardian::fetch_specified_part(), EggRenderState::fill_state(), AnimBundleNode::find_anim_bundle(), EggGroupNode::find_coordsys_entry(), XFile::find_data_object(), Character::find_joint(), EggGroupNode::find_materials(), Character::find_slider(), XFile::find_template(), EggGroupNode::find_textures(), EggMaterialCollection::find_used_materials(), EggTextureCollection::find_used_textures(), EggGroupNode::force_filenames(), EggJointData::force_initial_rest_frame(), WindowFramework::get_aspect_2d(), EggPoolUniquifier::get_category(), EggGroupUniquifier::get_category(), EggGroupNode::get_connected_shading(), PandaFramework::get_mouse(), FactoryParams::get_param_of_type(), EggGroupNode::has_absolute_pathnames(), NodePath::has_clip_plane(), NodePath::has_clip_plane_off(), NodePath::has_light(), PandaFramework::hide_collision_solids(), x11GraphicsWindow::open_window(), eglGraphicsWindow::open_window(), EggNode::parse_egg(), CharacterMaker::part_to_node(), EggGroupNode::post_apply_flat_attribute(), EggBinner::prepare_node(), PortalClipper::prepare_portal(), NodePath::project_texture(), EggMatrixTablePointer::quantize_channels(), ParametricCurveCollection::r_add_curves(), SceneGraphReducer::r_collect_vertex_data(), EggGroupNode::r_load_externals(), EggGroupNode::rebuild_vertex_pools(), EggGroupNode::recompute_polygon_normals(), EggGroupNode::remove_invalid_primitives(), EggGroupNode::remove_unused_vertices(), EggLoader::reparent_decals(), EggMaterialCollection::replace_materials(), EggTextureCollection::replace_textures(), EggGroupNode::resolve_filenames(), EggGroupNode::reverse_vertex_ordering(), NodePath::set_clip_plane(), NodePath::set_clip_plane_off(), NodePath::set_light(), ProjectionScreen::set_projector(), NonlinearImager::set_source_camera(), EggXfmSAnim::set_value(), NonlinearImager::set_viewer_camera(), PandaFramework::show_collision_solids(), BamCache::store(), XFileToEggConverter::strip_nodes(), EggGroupNode::strip_normals(), DataGraphTraverser::traverse(), DataGraphTraverser::traverse_below(), EggGroupNode::triangulate_polygons(), EggGroupNode::unify_attributes(), EggNameUniquifier::uniquify(), NodeCullCallbackData::upcall(), PhysicsCollisionHandler::validate_target(), EggXfmSAnim::write(), EggGroup::write(), EggToDXFLayer::write_3d_face(), and EggToDXFLayer::write_entities().

bool CollisionSolid::is_tangible ( ) const [inline, inherited]

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.

Definition at line 47 of file collisionSolid.I.

References CollisionSolid::do_is_tangible().

Referenced by CollisionHandlerPhysical::add_entry(), CollisionHandlerFluidPusher::add_entry(), and CollisionHandlerEvent::throw_event_pattern().

void ReferenceCount::local_object ( ) [inline, inherited]

This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack.

This allows the object to be passed to functions that will increment and decrement the object's reference count temporarily, and it will prevent the object from being deleted (inappropriately), when the reference count returns to zero. It actually achieves this by setting a large positive value in the reference count field.

Definition at line 276 of file referenceCount.I.

Referenced by PGTop::cull_callback(), BoundingSphere::extend_by_hexahedron(), AsyncTaskManager::find_task(), AsyncTaskManager::find_tasks(), and AsyncTaskManager::find_tasks_matching().

TypedWritable * CollisionBox::make_CollisionBox ( const FactoryParams params) [static, protected]

Factory method to generate a CollisionBox object.

Definition at line 1082 of file collisionBox.cxx.

References CollisionBox(), and fillin().

Referenced by register_with_read_factory().

void TypedWritable::mark_bam_modified ( ) [inline, inherited]
void CollisionSolid::mark_internal_bounds_stale ( ) [inline, protected, inherited]

Should be called by a derived class to mark the internal bounding volume stale, so that recompute_internal_bounds() will be called when the bounding volume is next requested.

Definition at line 174 of file collisionSolid.I.

Referenced by CollisionDSSolid::recalc_internals(), CollisionSegment::set_from_lens(), CollisionRay::set_from_lens(), CollisionParabola::set_parabola(), CollisionParabola::set_t1(), CollisionParabola::set_t2(), CollisionSphere::xform(), CollisionParabola::xform(), and xform().

void CollisionSolid::mark_viz_stale ( ) [inline, protected, inherited]

Called internally when the visualization may have been compromised by some change to internal state and will need to be recomputed the next time it is rendered.

Definition at line 188 of file collisionSolid.I.

Referenced by CollisionDSSolid::recalc_internals(), CollisionSegment::set_from_lens(), CollisionRay::set_from_lens(), CollisionParabola::set_parabola(), CollisionParabola::set_t1(), CollisionParabola::set_t2(), CollisionSphere::xform(), CollisionParabola::xform(), and xform().

bool CollisionBox::point_is_inside ( const LPoint2f p,
const Points &  points 
) const

Returns true if the indicated point is within the polygon's 2-d space, false otherwise.

Definition at line 978 of file collisionBox.cxx.

void CollisionBox::rederive_to_3d_mat ( LMatrix4f to_3d_mat,
int  plane 
) const [inline]

Fills the indicated matrix with the appropriate rotation transform to move points from the 2-d plane into the 3-d (X, 0, Z) plane.

This is essentially similar to calc_to_3d_mat, except that the matrix is rederived from whatever is stored in _to_2d_mat, guaranteeing that it will match whatever algorithm produced that one, even if it was produced on a different machine with different numerical precision.

Definition at line 301 of file collisionBox.I.

References LMatrix4f::invert_from().

void ReferenceCount::ref ( ) const [inline, inherited]

Explicitly increments the reference count.

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

Definition at line 179 of file referenceCount.I.

References ReferenceCount::test_ref_count_integrity().

Referenced by CachedTypedWritableReferenceCount::cache_ref(), TypedWritable::decode_raw_from_bam_stream(), NodeCachedReferenceCount::node_ref(), NodeReferenceCount::node_ref(), BamCacheRecord::set_data(), CullableObject::set_draw_callback(), and ModelRoot::set_reference().

void CollisionBox::register_with_read_factory ( ) [static]

Factory method to generate a CollisionBox object.

Definition at line 1038 of file collisionBox.cxx.

References BamReader::get_factory(), make_CollisionBox(), and Factory< Type >::register_factory().

void CollisionSolid::report_undefined_from_intersection ( TypeHandle  from_type) [static, protected, inherited]

Outputs a message the first time an intersection test is attempted that isn't defined, and explains a bit about what it means.

Definition at line 382 of file collisionSolid.cxx.

void CollisionSolid::report_undefined_intersection_test ( TypeHandle  from_type,
TypeHandle  into_type 
) [static, protected, inherited]

Outputs a message the first time an intersection test is attempted that isn't defined, and explains a bit about what it means.

Definition at line 354 of file collisionSolid.cxx.

bool TypedWritable::require_fully_complete ( ) const [virtual, inherited]

Some objects require all of their nested pointers to have been completed before the objects themselves can be completed.

If this is the case, override this method to return true, and be careful with circular references (which would make the object unreadable from a bam file).

Reimplemented in GeomVertexData, ClipPlaneAttrib, and RenderEffects.

Definition at line 118 of file typedWritable.cxx.

void CollisionSolid::set_bounds ( const BoundingVolume bounding_volume) [inherited]

Returns the solid's bounding volume.

Definition at line 108 of file collisionSolid.cxx.

void CollisionSolid::set_effective_normal ( const LVector3f effective_normal) [inline, inherited]

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.

Definition at line 65 of file collisionSolid.I.

Planef CollisionBox::set_plane ( int  n) const [inline]

Creates the nth face of the rectangular solid.

Definition at line 218 of file collisionBox.I.

References get_point().

Referenced by CollisionBox(), and xform().

void CollisionSolid::set_respect_effective_normal ( bool  respect_effective_normal) [inline, inherited]

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.

Definition at line 120 of file collisionSolid.I.

void CollisionSolid::set_tangible ( bool  tangible) [inline, inherited]

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.

Definition at line 27 of file collisionSolid.I.

void CollisionBox::setup_box ( )

Compute parameters for each of the box's sides.

Definition at line 71 of file collisionBox.cxx.

References get_point(), and setup_points().

Referenced by CollisionBox(), and xform().

void CollisionBox::setup_points ( const LPoint3f begin,
const LPoint3f end,
int  plane 
)

Computes the plane and 2d projection of points that make up this side.

Definition at line 89 of file collisionBox.cxx.

References calc_to_3d_mat(), compute_vectors(), and LMatrix4f::invert_from().

Referenced by setup_box().

bool CachedTypedWritableReferenceCount::test_ref_count_integrity ( ) const [inline, inherited]
bool ReferenceCount::test_ref_count_nonzero ( ) const [inline, inherited]

Does some easy checks to make sure that the reference count isn't zero, or completely bogus.

Returns true if ok, false otherwise.

Definition at line 252 of file referenceCount.I.

References ReferenceCount::do_test_ref_count_nonzero().

Referenced by CopyOnWritePointer::test_ref_count_nonzero().

LPoint2f CollisionBox::to_2d ( const LVecBase3f point3d,
int  plane 
) const [inline]

Assuming the indicated point in 3-d space lies within the polygon's plane, returns the corresponding point in the polygon's 2-d definition space.

Definition at line 259 of file collisionBox.I.

Referenced by clip_polygon().

LPoint3f CollisionBox::to_3d ( const LVecBase2f point2d,
const LMatrix4f to_3d_mat 
) [inline, static]

Extrude the indicated point in the polygon's 2-d definition space back into 3-d coordinates.

Definition at line 312 of file collisionBox.I.

bool ReferenceCount::unref ( ) const [inline, virtual, inherited]

Explicitly decrements the reference count.

Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic.) However, see the helper function unref_delete().

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

The return value is true if the new reference count is nonzero, false if it is zero.

Reimplemented in GeomVertexArrayFormat, GeomVertexFormat, InternalName, RenderAttrib, RenderEffects, RenderState, and TransformState.

Definition at line 214 of file referenceCount.I.

References ReferenceCount::test_ref_count_integrity().

Referenced by CachedTypedWritableReferenceCount::cache_unref(), TypedWritable::decode_raw_from_bam_stream(), RenderEffect::finalize(), NodeCachedReferenceCount::node_unref(), NodeReferenceCount::node_unref(), TransformState::unref(), RenderState::unref(), RenderEffects::unref(), RenderAttrib::unref(), InternalName::unref(), GeomVertexFormat::unref(), and GeomVertexArrayFormat::unref().

void TypedWritable::update_bam_nested ( BamWriter manager) [virtual, inherited]

Called by the BamWriter when this object has not itself been modified recently, but it should check its nested objects for updates.

Reimplemented in CFDoCullCommand, and PandaNode.

Definition at line 77 of file typedWritable.cxx.

void ReferenceCount::weak_ref ( WeakPointerToVoid ptv) [inline, inherited]

Adds the indicated PointerToVoid as a weak reference to this object.

Definition at line 321 of file referenceCount.I.

References WeakReferenceList::add_reference(), and ReferenceCount::get_weak_list().

void ReferenceCount::weak_unref ( WeakPointerToVoid ptv) [inline, inherited]

Removes the indicated PointerToVoid as a weak reference to this object.

It must have previously been added via a call to weak_ref().

Definition at line 334 of file referenceCount.I.

References WeakReferenceList::clear_reference(), and ReferenceCount::has_weak_list().

void CollisionBox::write_datagram ( BamWriter manager,
Datagram me 
) [virtual]

Function to write the important information in the particular object to a Datagram.

Reimplemented from CollisionSolid.

Definition at line 1049 of file collisionBox.cxx.

References Datagram::add_float32(), Datagram::add_uint16(), LMatrix4f::write_datagram(), and LVecBase3f::write_datagram().

void CollisionBox::xform ( const LMatrix4f mat) [virtual]

Transforms the solid by the indicated matrix.

Reimplemented from CollisionSolid.

Definition at line 149 of file collisionBox.cxx.

References CollisionSolid::mark_internal_bounds_stale(), CollisionSolid::mark_viz_stale(), set_plane(), and setup_box().


The documentation for this class was generated from the following files:
 All Classes Functions Variables Enumerations