Panda3D
 All Classes Functions Variables Enumerations
Public Types | Public Member Functions | Static Public Member Functions | Friends | List of all members
PartGroup Class Reference

This is the base class for PartRoot and MovingPart. More...

#include "partGroup.h"

Inheritance diagram for PartGroup:
TypedWritableReferenceCount Namable TypedWritable ReferenceCount MemoryBase TypedObject MemoryBase MemoryBase MovingPartBase PartBundle MovingPart< SwitchType > MovingPart< ACMatrixSwitchType > MovingPart< ACScalarSwitchType > CharacterJointBundle MovingPartMatrix MovingPartScalar CharacterJoint CharacterSlider

Public Types

enum  HierarchyMatchFlags { HMF_ok_part_extra = 0x01, HMF_ok_anim_extra = 0x02, HMF_ok_wrong_root_name = 0x04 }
 

Public Member Functions

 PartGroup (PartGroup *parent, const string &name)
 Creates the PartGroup, and adds it to the indicated parent. More...
 
virtual bool apply_control (PandaNode *node)
 Specifies a node to influence this particular joint so that it will always hold the node's transform. More...
 
bool apply_freeze (const TransformState *transform)
 Freezes this particular joint so that it will always hold the specified transform. More...
 
virtual bool apply_freeze_matrix (const LVecBase3 &pos, const LVecBase3 &hpr, const LVecBase3 &scale)
 Freezes this particular joint so that it will always hold the specified transform. More...
 
virtual bool apply_freeze_scalar (PN_stdfloat value)
 Freezes this particular joint so that it will always hold the specified transform. More...
 
bool check_hierarchy (const AnimGroup *anim, const PartGroup *parent, int hierarchy_match_flags=0) const
 Walks the part hierarchy in tandem with the indicated anim hierarchy, and returns true if the hierarchies match, false otherwise. More...
 
virtual bool clear_forced_channel ()
 Undoes the effect of a previous call to apply_freeze() or apply_control(). More...
 
virtual int complete_pointers (TypedWritable **p_list, BamReader *manager)
 Takes in a vector of pointers to TypedWritable objects that correspond to all the requests for pointers that this object made to BamReader. More...
 
PartGroupcopy_subgraph () const
 Allocates and returns a new copy of this node and of all of its children. More...
 
virtual void determine_effective_channels (const CycleData *root_cdata)
 Should be called whenever the ChannelBlend values have changed, this recursively updates the _effective_channel member in each part. More...
 
virtual bool do_update (PartBundle *root, const CycleData *root_cdata, PartGroup *parent, bool parent_changed, bool anim_changed, Thread *current_thread)
 Recursively update this particular part and all of its descendents for the current frame. More...
 
virtual void do_xform (const LMatrix4 &mat, const LMatrix4 &inv_mat)
 Called by PartBundle::xform(), this indicates the indicated transform is being applied to the root joint. More...
 
PartGroupfind_child (const string &name) const
 Returns the first descendant found with the indicated name, or NULL if no such descendant exists. More...
 
virtual TypeHandle force_init_type ()
 
PartGroupget_child (int n) const
 Returns the nth child of the group. More...
 
PartGroupget_child_named (const string &name) const
 Returns the first child found with the indicated name, or NULL if no such child exists. More...
 
virtual AnimChannelBaseget_forced_channel () const
 Returns the AnimChannelBase that has been forced to this joint by a previous call to apply_freeze() or apply_control(), or NULL if no such channel has been applied. More...
 
int get_num_children () const
 Returns the number of child nodes of the group. More...
 
virtual TypeHandle get_type () const
 
virtual TypeHandle get_value_type () const
 Returns the TypeHandle associated with the ValueType we are concerned with. More...
 
virtual bool is_character_joint () const
 Returns true if this part is a CharacterJoint, false otherwise. More...
 
virtual PartGroupmake_copy () const
 Allocates and returns a new copy of the node. More...
 
 MAKE_SEQ (get_children, get_num_children, get_child)
 
void sort_descendants ()
 Sorts the children nodes at each level of the hierarchy into alphabetical order. More...
 
virtual void write (ostream &out, int indent_level) const
 Writes a brief description of the group and all of its descendants. More...
 
virtual void write_datagram (BamWriter *manager, Datagram &me)
 Function to write the important information in the particular object to a Datagram. More...
 
virtual void write_with_value (ostream &out, int indent_level) const
 Writes a brief description of the group, showing its current value, and that of all of its descendants. More...
 
- Public Member Functions inherited from TypedWritableReferenceCount
 TypedWritableReferenceCount (const TypedWritableReferenceCount &copy)
 
virtual ReferenceCountas_reference_count ()
 Returns the pointer cast to a ReferenceCount pointer, if it is in fact of that type. More...
 
void operator= (const TypedWritableReferenceCount &copy)
 
- Public Member Functions inherited from TypedWritable
 TypedWritable (const TypedWritable &copy)
 
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. More...
 
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. More...
 
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. More...
 
UpdateSeq get_bam_modified () const
 Returns the current bam_modified counter. More...
 
void mark_bam_modified ()
 Increments the bam_modified counter, so that this object will be invalidated and retransmitted on any open bam streams. More...
 
void operator= (const TypedWritable &copy)
 
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. More...
 
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. More...
 
- Public Member Functions inherited from TypedObject
 TypedObject (const TypedObject &copy)
 
TypedObjectas_typed_object ()
 Returns the object, upcast (if necessary) to a TypedObject pointer. More...
 
const TypedObjectas_typed_object () const
 Returns the object, upcast (if necessary) to a TypedObject pointer. More...
 
int get_best_parent_from_Set (const std::set< int > &) const
 
int get_type_index () const
 Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. More...
 
bool is_exact_type (TypeHandle handle) const
 Returns true if the current object is the indicated type exactly. More...
 
bool is_of_type (TypeHandle handle) const
 Returns true if the current object is or derives from the indicated type. More...
 
void operator= (const TypedObject &copy)
 
- Public Member Functions inherited from ReferenceCount
int get_ref_count () const
 Returns the current reference count. More...
 
WeakReferenceListget_weak_list () const
 Returns the WeakReferenceList associated with this ReferenceCount object. More...
 
bool has_weak_list () const
 Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise. More...
 
void local_object ()
 This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack. More...
 
void ref () const
 Explicitly increments the reference count. More...
 
bool test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus. More...
 
bool test_ref_count_nonzero () const
 Does some easy checks to make sure that the reference count isn't zero, or completely bogus. More...
 
virtual bool unref () const
 Explicitly decrements the reference count. More...
 
void weak_ref (WeakPointerToVoid *ptv)
 Adds the indicated PointerToVoid as a weak reference to this object. More...
 
void weak_unref (WeakPointerToVoid *ptv)
 Removes the indicated PointerToVoid as a weak reference to this object. More...
 
- Public Member Functions inherited from Namable
 Namable (const string &initial_name="")
 
 Namable (const Namable &copy)
 
void clear_name ()
 Resets the Namable's name to empty. More...
 
const string & get_name () const
 
bool has_name () const
 Returns true if the Namable has a nonempty name set, false if the name is empty. More...
 
Namableoperator= (const Namable &other)
 
void output (ostream &out) const
 Outputs the Namable. More...
 
void set_name (const string &name)
 

Static Public Member Functions

static TypeHandle get_class_type ()
 
static void init_type ()
 
static TypedWritablemake_PartGroup (const FactoryParams &params)
 Factory method to generate a PartGroup object. More...
 
static void register_with_read_factory ()
 Factory method to generate a PartGroup object. More...
 
- Static Public Member Functions inherited from TypedWritableReferenceCount
static TypeHandle get_class_type ()
 
static void init_type ()
 
static PT (TypedWritableReferenceCount) decode_from_bam_stream(const string &data
 
- Static Public Member Functions inherited from TypedWritable
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. More...
 
static TypeHandle get_class_type ()
 
static void init_type ()
 
- Static Public Member Functions inherited from TypedObject
static TypeHandle get_class_type ()
 
static void init_type ()
 This function is declared non-inline to work around a compiler bug in g++ 2.96. More...
 
- Static Public Member Functions inherited from ReferenceCount
static TypeHandle get_class_type ()
 
static void init_type ()
 
- Static Public Member Functions inherited from Namable
static TypeHandle get_class_type ()
 
static void init_type ()
 

Friends

class Character
 
class CharacterJointBundle
 
class PartBundle
 

Additional Inherited Members

- Public Attributes inherited from TypedWritableReferenceCount
static BamReaderreader = NULL)
 
- Static Public Attributes inherited from TypedWritable
static TypedWritable *const Null = (TypedWritable*)0L
 

Detailed Description

This is the base class for PartRoot and MovingPart.

It defines a hierarchy of MovingParts.

Definition at line 45 of file partGroup.h.

Constructor & Destructor Documentation

PartGroup::PartGroup ( PartGroup parent,
const string &  name 
)

Creates the PartGroup, and adds it to the indicated parent.

The only way to delete it subsequently is to delete the entire hierarchy.

Definition at line 39 of file partGroup.cxx.

Member Function Documentation

bool PartGroup::apply_control ( PandaNode node)
virtual

Specifies a node to influence this particular joint so that it will always hold the node's transform.

Returns true if this is a joint that can be so controlled, false otherwise.

This is normally only called internally by PartBundle::control_joint(), but you may also call it directly.

Reimplemented in MovingPartMatrix, and MovingPartScalar.

Definition at line 263 of file partGroup.cxx.

Referenced by PartBundle::control_joint().

bool PartGroup::apply_freeze ( const TransformState *  transform)

Freezes this particular joint so that it will always hold the specified transform.

Returns true if this is a joint that can be so frozen, false otherwise.

This is normally only called internally by PartBundle::freeze_joint(), but you may also call it directly.

Definition at line 213 of file partGroup.cxx.

References apply_freeze_matrix(), and apply_freeze_scalar().

Referenced by PartBundle::freeze_joint().

bool PartGroup::apply_freeze_matrix ( const LVecBase3 pos,
const LVecBase3 hpr,
const LVecBase3 scale 
)
virtual

Freezes this particular joint so that it will always hold the specified transform.

Returns true if this is a joint that can be so frozen, false otherwise.

This is normally only called internally by PartBundle::freeze_joint(), but you may also call it directly.

Reimplemented in MovingPartMatrix.

Definition at line 229 of file partGroup.cxx.

Referenced by apply_freeze(), and PartBundle::freeze_joint().

bool PartGroup::apply_freeze_scalar ( PN_stdfloat  value)
virtual

Freezes this particular joint so that it will always hold the specified transform.

Returns true if this is a joint that can be so frozen, false otherwise.

This is normally only called internally by PartBundle::freeze_joint(), but you may also call it directly.

Reimplemented in MovingPartScalar.

Definition at line 245 of file partGroup.cxx.

Referenced by apply_freeze(), and PartBundle::freeze_joint().

bool PartGroup::check_hierarchy ( const AnimGroup anim,
const PartGroup parent,
int  hierarchy_match_flags = 0 
) const

Walks the part hierarchy in tandem with the indicated anim hierarchy, and returns true if the hierarchies match, false otherwise.

If hierarchy_match_flags is 0, only an exact match is accepted; otherwise, it may contain a union of PartGroup::HierarchyMatchFlags values indicating conditions that will be tolerated (but warnings will still be issued).

Definition at line 352 of file partGroup.cxx.

References check_hierarchy(), Thread::consider_yield(), AnimGroup::get_child(), get_child(), AnimGroup::get_child_named(), get_child_named(), AnimGroup::get_num_children(), get_num_children(), AnimGroup::get_value_type(), and get_value_type().

Referenced by check_hierarchy(), and PartBundle::do_bind_anim().

bool PartGroup::clear_forced_channel ( )
virtual

Undoes the effect of a previous call to apply_freeze() or apply_control().

Returns true if the joint was modified, false otherwise.

This is normally only called internally by PartBundle::release_joint(), but you may also call it directly.

Reimplemented in MovingPartBase.

Definition at line 279 of file partGroup.cxx.

Referenced by PartBundle::release_joint().

int PartGroup::complete_pointers ( TypedWritable **  p_list,
BamReader manager 
)
virtual

Takes in a vector of pointers to TypedWritable objects that correspond to all the requests for pointers that this object made to BamReader.

Reimplemented from TypedWritable.

Reimplemented in PartBundle, MovingPartBase, and CharacterJoint.

Definition at line 757 of file partGroup.cxx.

References TypedWritable::complete_pointers().

Referenced by MovingPartBase::complete_pointers(), and PartBundle::complete_pointers().

PartGroup * PartGroup::copy_subgraph ( ) const

Allocates and returns a new copy of this node and of all of its children.

Definition at line 87 of file partGroup.cxx.

References copy_subgraph(), and make_copy().

Referenced by copy_subgraph(), and PartBundleNode::xform().

void PartGroup::determine_effective_channels ( const CycleData root_cdata)
virtual

Should be called whenever the ChannelBlend values have changed, this recursively updates the _effective_channel member in each part.

Definition at line 571 of file partGroup.cxx.

Referenced by PartBundle::clear_control_effects(), and PartBundle::do_bind_anim().

bool PartGroup::do_update ( PartBundle root,
const CycleData root_cdata,
PartGroup parent,
bool  parent_changed,
bool  anim_changed,
Thread current_thread 
)
virtual

Recursively update this particular part and all of its descendents for the current frame.

This is not really public and is not intended to be called directly; it is called from the top of the tree by PartBundle::update().

The return value is true if any part has changed, false otherwise.

Reimplemented in MovingPartBase.

Definition at line 532 of file partGroup.cxx.

Referenced by PartBundle::finalize(), PartBundle::force_update(), and PartBundle::update().

void PartGroup::do_xform ( const LMatrix4 mat,
const LMatrix4 inv_mat 
)
virtual

Called by PartBundle::xform(), this indicates the indicated transform is being applied to the root joint.

Reimplemented in CharacterJoint.

Definition at line 555 of file partGroup.cxx.

Referenced by CharacterJoint::do_xform(), and PartBundle::xform().

PartGroup * PartGroup::find_child ( const string &  name) const

Returns the first descendant found with the indicated name, or NULL if no such descendant exists.

This method searches the entire graph beginning at this PartGroup; see also get_child_named().

Definition at line 158 of file partGroup.cxx.

References find_child().

Referenced by PartBundle::control_joint(), find_child(), Character::find_joint(), Character::find_slider(), PartBundle::freeze_joint(), and PartBundle::release_joint().

PartGroup * PartGroup::get_child ( int  n) const

Returns the nth child of the group.

Definition at line 122 of file partGroup.cxx.

Referenced by check_hierarchy().

PartGroup * PartGroup::get_child_named ( const string &  name) const

Returns the first child found with the indicated name, or NULL if no such child exists.

This method searches only the children of this particular PartGroup; it does not recursively search the entire graph. See also find_child().

Definition at line 137 of file partGroup.cxx.

Referenced by check_hierarchy().

AnimChannelBase * PartGroup::get_forced_channel ( ) const
virtual

Returns the AnimChannelBase that has been forced to this joint by a previous call to apply_freeze() or apply_control(), or NULL if no such channel has been applied.

Reimplemented in MovingPartBase.

Definition at line 292 of file partGroup.cxx.

int PartGroup::get_num_children ( ) const

Returns the number of child nodes of the group.

Definition at line 111 of file partGroup.cxx.

Referenced by check_hierarchy().

TypeHandle PartGroup::get_value_type ( ) const
virtual

Returns the TypeHandle associated with the ValueType we are concerned with.

This is provided to allow a bit of run-time checking that joints and channels are matching properly in type.

Reimplemented in MovingPartBase, MovingPart< SwitchType >, MovingPart< ACScalarSwitchType >, and MovingPart< ACMatrixSwitchType >.

Definition at line 334 of file partGroup.cxx.

References TypeHandle::none().

Referenced by check_hierarchy().

bool PartGroup::is_character_joint ( ) const
virtual

Returns true if this part is a CharacterJoint, false otherwise.

This is a tiny optimization over is_of_type(CharacterType::get_class_type()).

Reimplemented in CharacterJoint.

Definition at line 65 of file partGroup.cxx.

Referenced by CharacterJoint::update_internals().

PartGroup * PartGroup::make_copy ( ) const
virtual

Allocates and returns a new copy of the node.

Children are not copied, but see copy_subgraph().

Reimplemented in PartBundle, CharacterJoint, and CharacterSlider.

Definition at line 76 of file partGroup.cxx.

Referenced by copy_subgraph().

TypedWritable * PartGroup::make_PartGroup ( const FactoryParams params)
static

Factory method to generate a PartGroup object.

Definition at line 774 of file partGroup.cxx.

Referenced by register_with_read_factory().

void PartGroup::register_with_read_factory ( )
static

Factory method to generate a PartGroup object.

Definition at line 790 of file partGroup.cxx.

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

void PartGroup::sort_descendants ( )

Sorts the children nodes at each level of the hierarchy into alphabetical order.

This should be done after creating the hierarchy, to guarantee that the correct names will match up together when the AnimBundle is later bound to a PlayerRoot.

Definition at line 192 of file partGroup.cxx.

void PartGroup::write ( ostream &  out,
int  indent_level 
) const
virtual

Writes a brief description of the group and all of its descendants.

Reimplemented in PartBundle, and MovingPartBase.

Definition at line 304 of file partGroup.cxx.

void PartGroup::write_datagram ( BamWriter manager,
Datagram me 
)
virtual

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

Reimplemented from TypedWritable.

Reimplemented in PartBundle, MovingPartBase, CharacterJoint, MovingPart< SwitchType >, MovingPart< ACScalarSwitchType >, and MovingPart< ACMatrixSwitchType >.

Definition at line 714 of file partGroup.cxx.

References Datagram::add_string(), Datagram::add_uint16(), and BamWriter::write_pointer().

Referenced by MovingPartBase::write_datagram(), and PartBundle::write_datagram().

void PartGroup::write_with_value ( ostream &  out,
int  indent_level 
) const
virtual

Writes a brief description of the group, showing its current value, and that of all of its descendants.

Reimplemented in MovingPartBase.

Definition at line 318 of file partGroup.cxx.

Referenced by Character::write_part_values().


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