Panda3D
|
The collection of all the joints and sliders in the character. More...
#include "characterJointBundle.h"
Public Types | |
enum | BlendType { BT_linear, BT_normalized_linear, BT_componentwise, BT_componentwise_quat } |
typedef pmap< AnimControl *, float > | ChannelBlend |
enum | HierarchyMatchFlags { HMF_ok_part_extra = 0x01, HMF_ok_anim_extra = 0x02, HMF_ok_wrong_root_name = 0x04 } |
Public Member Functions | |
CharacterJointBundle (const string &name="") | |
Normally, there is no need to create a CharacterJointBundle directly. | |
virtual bool | apply_control (PandaNode *node) |
Specifies a node to influence this particular joint so that it will always hold the node's transform. | |
bool | apply_freeze (const TransformState *transform) |
Freezes this particular joint so that it will always hold the specified transform. | |
virtual bool | apply_freeze_matrix (const LVecBase3f &pos, const LVecBase3f &hpr, const LVecBase3f &scale) |
Freezes this particular joint so that it will always hold the specified transform. | |
virtual bool | apply_freeze_scalar (float value) |
Freezes this particular joint so that it will always hold the specified transform. | |
virtual ReferenceCount * | as_reference_count () |
Returns the pointer cast to a ReferenceCount pointer, if it is in fact of that type. | |
TypedObject * | as_typed_object () |
Returns the object, upcast (if necessary) to a TypedObject pointer. | |
const TypedObject * | as_typed_object () const |
Returns the object, upcast (if necessary) to a TypedObject pointer. | |
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. | |
void | clear_anim_preload () |
Removes any AnimPreloadTable associated with the PartBundle. | |
void | clear_control_effects () |
Sets the control effect of all AnimControls to zero (but does not "stop" the AnimControls). | |
virtual bool | clear_forced_channel () |
Undoes the effect of a previous call to apply_freeze() or apply_control(). | |
void | clear_name () |
Resets the Namable's name to empty. | |
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. | |
virtual void | control_activated (AnimControl *control) |
Called by the AnimControl whenever it starts an animation. | |
bool | control_joint (const string &joint_name, PandaNode *node) |
Specifies that the joint with the indicated name should be animated with the transform on the indicated node. | |
PartGroup * | copy_subgraph () const |
Allocates and returns a new copy of this node and of all of its children. | |
CPT (AnimPreloadTable) get_anim_preload() const | |
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. | |
bool | do_bind_anim (AnimControl *control, AnimBundle *anim, int hierarchy_match_flags, const PartSubset &subset) |
The internal implementation of bind_anim(), this receives a pointer to an uninitialized AnimControl and fills it in if the bind is successful. | |
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. | |
virtual void | do_xform (const LMatrix4f &mat, const LMatrix4f &inv_mat) |
Called by PartBundle::xform(), this indicates the indicated transform is being applied to the root joint. | |
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. | |
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. | |
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. | |
PartGroup * | find_child (const string &name) const |
Returns the first descendant found with the indicated name, or NULL if no such descendant exists. | |
virtual TypeHandle | force_init_type () |
bool | force_update () |
Updates all the parts in the bundle to reflect the data for the current frame, whether we believe it needs it or not. | |
bool | freeze_joint (const string &joint_name, const TransformState *transform) |
Specifies that the joint with the indicated name should be frozen with the specified transform. | |
bool | freeze_joint (const string &joint_name, const LVecBase3f &pos, const LVecBase3f &hpr, const LVecBase3f &scale) |
Specifies that the joint with the indicated name should be frozen with the specified transform. | |
bool | freeze_joint (const string &joint_name, float value) |
Specifies that the joint with the indicated name should be frozen with the specified transform. | |
bool | get_anim_blend_flag () const |
Returns whether the character allows multiple different animations to be bound simultaneously. | |
UpdateSeq | get_bam_modified () const |
Returns the current bam_modified counter. | |
int | get_best_parent_from_Set (const std::set< int > &) const |
BlendType | get_blend_type () const |
Returns the algorithm that is used when blending multiple frames or multiple animations together, when either anim_blend_flag or frame_blend_flag is set to true. | |
PartGroup * | get_child (int n) const |
Returns the nth child of the group. | |
PartGroup * | get_child_named (const string &name) const |
Returns the first child found with the indicated name, or NULL if no such child exists. | |
float | get_control_effect (AnimControl *control) const |
Returns the amount by which the character is affected by the indicated AnimControl and its associated animation. | |
virtual AnimChannelBase * | get_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. | |
bool | get_frame_blend_flag () const |
Returns whether the character interpolates (blends) between two sequential animation frames, or whether it holds the current frame until the next one is ready. | |
const string & | get_name () const |
Character * | get_node (int n) const |
Returns the nth Character associated with this PartBundle. | |
int | get_num_children () const |
Returns the number of child nodes of the group. | |
int | get_num_nodes () const |
Returns the number of PartBundleNodes that contain a pointer to this PartBundle. | |
int | get_ref_count () const |
Returns the current reference count. | |
const LMatrix4f & | get_root_xform () const |
Returns the transform matrix which is implicitly applied at the root of the animated hierarchy. | |
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 TypeHandle | get_value_type () const |
Returns the TypeHandle associated with the ValueType we are concerned with. | |
WeakReferenceList * | get_weak_list () const |
Returns the WeakReferenceList associated with this ReferenceCount object. | |
bool | has_name () const |
Returns true if the Namable has a nonempty name set, false if the name is empty. | |
bool | has_weak_list () const |
Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise. | |
virtual bool | is_character_joint () const |
Returns true if this part is a CharacterJoint, 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. | |
void | local_object () |
This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack. | |
MAKE_SEQ (get_children, get_num_children, get_child) | |
MAKE_SEQ (get_nodes, get_num_nodes, get_node) | |
void | mark_bam_modified () |
Increments the bam_modified counter, so that this object will be invalidated and retransmitted on any open bam streams. | |
void | merge_anim_preloads (const PartBundle *other) |
Copies the contents of the other PartBundle's preload table into this one. | |
void | operator delete (void *ptr) |
void | operator delete (void *ptr) |
void | operator delete (void *ptr, void *) |
void | operator delete (void *ptr, void *) |
void | operator delete[] (void *, void *) |
void | operator delete[] (void *, void *) |
void | operator delete[] (void *ptr) |
void | operator delete[] (void *ptr) |
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 * | operator new[] (size_t size) |
void * | operator new[] (size_t size, void *ptr) |
void * | operator new[] (size_t size) |
void * | operator new[] (size_t size, void *ptr) |
virtual void | output (ostream &out) const |
Writes a one-line description of the bundle. | |
PT (AnimControl) bind_anim(AnimBundle *anim | |
PT (PartBundle) apply_transform(const TransformState *transform) | |
PT (AnimControl) load_bind_anim(Loader *loader | |
PT (AnimPreloadTable) modify_anim_preload() | |
void | ref () const |
Explicitly increments the reference count. | |
bool | release_joint (const string &joint_name) |
Releases the named joint from the effects of a previous call to freeze_joint() or control_joint(). | |
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_anim_blend_flag (bool anim_blend_flag) |
Defines the way the character responds to multiple calls to set_control_effect()). | |
void | set_anim_preload (AnimPreloadTable *table) |
Replaces the AnimPreloadTable associated with the PartBundle. | |
void | set_blend_type (BlendType bt) |
Defines the algorithm that is used when blending multiple frames or multiple animations together, when either anim_blend_flag or frame_blend_flag is set to true. | |
void | set_control_effect (AnimControl *control, float effect) |
Sets the amount by which the character is affected by the indicated AnimControl (and its associated animation). | |
void | set_frame_blend_flag (bool frame_blend_flag) |
Specifies whether the character interpolates (blends) between two sequential frames of an active animation, showing a smooth intra-frame motion, or whether it holds each frame until the next frame is ready, showing precisely the specified animation. | |
void | set_name (const string &name) |
void | set_root_xform (const LMatrix4f &root_xform) |
Specifies the transform matrix which is implicitly applied at the root of the animated hierarchy. | |
void | set_update_delay (double delay) |
Specifies the minimum amount of time, in seconds, that should elapse between any two consecutive updates. | |
void | sort_descendants () |
Sorts the children nodes at each level of the hierarchy into alphabetical order. | |
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. | |
virtual bool | unref () const |
Explicitly decrements the reference count. | |
bool | update () |
Updates all the parts in the bundle to reflect the data for the current frame (as set in each of the AnimControls). | |
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 | wait_pending () |
Blocks the current thread until all currently-pending AnimControls, with a nonzero control effect, have been loaded and are properly bound. | |
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) const |
Writes a brief description of the bundle and all of its descendants. | |
virtual void | write_datagram (BamWriter *manager, Datagram &dg) |
Writes the contents of this object to the datagram for shipping out to a Bam file. | |
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. | |
void | xform (const LMatrix4f &mat) |
Applies the indicated transform to the root of the animated hierarchy. | |
Static Public Member Functions | |
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 TypeHandle | get_class_type () |
static void | init_type () |
static TypedWritable * | make_CharacterJointBundle (const FactoryParams ¶ms) |
Factory method to generate a CharacterJointBundle object. | |
static TypedWritable * | make_PartGroup (const FactoryParams ¶ms) |
Factory method to generate a PartGroup object. | |
static | PT (TypedWritableReferenceCount) decode_from_bam_stream(const string &data |
static void | register_with_read_factory () |
Factory method to generate a CharacterJointBundle object. | |
Public Attributes | |
const Filename int const PartSubset bool | allow_async |
const Filename & | filename |
int | hierarchy_match_flags = 0 |
const Filename int | hierarchy_match_flags |
static BamReader * | reader = NULL) |
const Filename int const PartSubset & | subset |
int const PartSubset & | subset = PartSubset()) |
Static Public Attributes | |
static TypedWritable *const | Null = (TypedWritable*)0L |
Protected Types | |
typedef pvector< PT(PartGroup) > | Children |
Protected Member Functions | |
CharacterJointBundle (const CharacterJointBundle ©) | |
Normally, you'd use make_copy() or copy_subgraph() to make a copy of this. | |
virtual void | add_node (PartBundleNode *node) |
Adds the PartBundleNode pointer to the set of nodes associated with the PartBundle. | |
virtual void | bind_hierarchy (AnimGroup *anim, int channel_index, int &joint_index, bool is_included, BitArray &bound_joints, const PartSubset &subset) |
Binds the indicated anim hierarchy to the part hierarchy, at the given channel index number. | |
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. | |
void | fillin (DatagramIterator &scan, BamReader *manager) |
This internal function is called by make_from_bam to read in all of the relevant data from the BamFile for the new PartBundle. | |
virtual void | find_bound_joints (int &joint_index, bool is_included, BitArray &bound_joints, const PartSubset &subset) |
Similar to bind_hierarchy, but does not actually perform any binding. | |
virtual PartGroup * | make_copy () const |
Allocates and returns a new copy of the node. | |
virtual void | pick_channel_index (plist< int > &holes, int &next) const |
Walks the part hierarchy, looking for a suitable channel index number to use. | |
virtual void | remove_node (PartBundleNode *node) |
Removes the PartBundleNode pointer from the set of nodes associated with the PartBundle. | |
void | write_descendants (ostream &out, int indent_level) const |
Writes a brief description of all of the group's descendants. | |
void | write_descendants_with_value (ostream &out, int indent_level) const |
Writes a brief description of all of the group's descendants and their values. | |
Static Protected Member Functions | |
static TypedWritable * | make_from_bam (const FactoryParams ¶ms) |
Factory method to generate a PartBundle object. | |
Protected Attributes | |
Children | _children |
The collection of all the joints and sliders in the character.
Definition at line 31 of file characterJointBundle.h.
CharacterJointBundle::CharacterJointBundle | ( | const CharacterJointBundle & | copy | ) | [inline, protected] |
Normally, you'd use make_copy() or copy_subgraph() to make a copy of this.
Definition at line 28 of file characterJointBundle.I.
Referenced by make_CharacterJointBundle(), and make_copy().
CharacterJointBundle::CharacterJointBundle | ( | const string & | name = "" | ) |
Normally, there is no need to create a CharacterJointBundle directly.
The Character node will automatically create one for itself.
Definition at line 31 of file characterJointBundle.cxx.
void CharacterJointBundle::add_node | ( | PartBundleNode * | node | ) | [protected, virtual] |
Adds the PartBundleNode pointer to the set of nodes associated with the PartBundle.
Normally called only by the PartBundleNode itself, for instance when the bundle is flattened with another node.
Reimplemented from PartBundle.
Definition at line 63 of file characterJointBundle.cxx.
References TypedObject::is_of_type().
bool PartGroup::apply_control | ( | PandaNode * | node | ) | [virtual, inherited] |
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 235 of file partGroup.cxx.
Referenced by PartBundle::control_joint().
bool PartGroup::apply_freeze | ( | const TransformState * | transform | ) | [inherited] |
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 185 of file partGroup.cxx.
References PartGroup::apply_freeze_matrix(), PartGroup::apply_freeze_scalar(), TransformState::get_hpr(), TransformState::get_pos(), and TransformState::get_scale().
Referenced by PartBundle::freeze_joint().
bool PartGroup::apply_freeze_matrix | ( | const LVecBase3f & | pos, |
const LVecBase3f & | hpr, | ||
const LVecBase3f & | scale | ||
) | [virtual, inherited] |
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 201 of file partGroup.cxx.
Referenced by PartGroup::apply_freeze(), and PartBundle::freeze_joint().
bool PartGroup::apply_freeze_scalar | ( | float | value | ) | [virtual, inherited] |
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 217 of file partGroup.cxx.
Referenced by PartGroup::apply_freeze(), and PartBundle::freeze_joint().
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 PartGroup::bind_hierarchy | ( | AnimGroup * | anim, |
int | channel_index, | ||
int & | joint_index, | ||
bool | is_included, | ||
BitArray & | bound_joints, | ||
const PartSubset & | subset | ||
) | [protected, virtual, inherited] |
Binds the indicated anim hierarchy to the part hierarchy, at the given channel index number.
Reimplemented in MovingPartBase.
Definition at line 632 of file partGroup.cxx.
References PartGroup::bind_hierarchy(), Thread::consider_yield(), AnimGroup::get_child(), PartGroup::get_child(), PartGroup::get_num_children(), AnimGroup::get_num_children(), PartSubset::matches_exclude(), and PartSubset::matches_include().
Referenced by PartGroup::bind_hierarchy(), and PartBundle::do_bind_anim().
bool PartGroup::check_hierarchy | ( | const AnimGroup * | anim, |
const PartGroup * | parent, | ||
int | hierarchy_match_flags = 0 |
||
) | const [inherited] |
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 323 of file partGroup.cxx.
References PartGroup::check_hierarchy(), Thread::consider_yield(), AnimGroup::get_child(), PartGroup::get_child(), PartGroup::get_child_named(), AnimGroup::get_child_named(), PartGroup::get_num_children(), AnimGroup::get_num_children(), AnimGroup::get_value_type(), and PartGroup::get_value_type().
Referenced by PartGroup::check_hierarchy(), and PartBundle::do_bind_anim().
void PartBundle::clear_anim_preload | ( | ) | [inline, inherited] |
Removes any AnimPreloadTable associated with the PartBundle.
Definition at line 58 of file partBundle.I.
void PartBundle::clear_control_effects | ( | ) | [inherited] |
Sets the control effect of all AnimControls to zero (but does not "stop" the AnimControls).
The character will no longer be affected by any animation, and will return to its default pose (unless restore-initial-pose is false).
The AnimControls which are no longer associated will not be using any CPU cycles, but they may still be in the "playing" state; if they are later reassociated with the PartBundle they will resume at their current frame as if they'd been running all along.
Definition at line 215 of file partBundle.cxx.
References PartGroup::determine_effective_channels(), and Thread::get_current_pipeline_stage().
bool PartGroup::clear_forced_channel | ( | ) | [virtual, inherited] |
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 251 of file partGroup.cxx.
Referenced by PartBundle::release_joint().
void Namable::clear_name | ( | ) | [inline, inherited] |
int PartBundle::complete_pointers | ( | TypedWritable ** | p_list, |
BamReader * | manager | ||
) | [virtual, inherited] |
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 PartGroup.
Definition at line 854 of file partBundle.cxx.
References BamReader::get_file_minor_ver().
void PartBundle::control_activated | ( | AnimControl * | control | ) | [virtual, inherited] |
Called by the AnimControl whenever it starts an animation.
This is just a hook so the bundle can do something, if necessary, before the animation starts.
Definition at line 605 of file partBundle.cxx.
References Thread::get_current_pipeline_stage(), and AnimControl::get_part().
Referenced by AnimControl::animation_activated().
bool PartBundle::control_joint | ( | const string & | joint_name, |
PandaNode * | node | ||
) | [inherited] |
Specifies that the joint with the indicated name should be animated with the transform on the indicated node.
It will henceforth always follow the node's transform, regardless of any animations that may subsequently be bound to the joint.
Returns true if the joint is successfully controlled, or false if the named child is not a joint (or slider) or does not exist.
Definition at line 496 of file partBundle.cxx.
References PartGroup::apply_control(), and PartGroup::find_child().
PartGroup * PartGroup::copy_subgraph | ( | ) | const [inherited] |
Allocates and returns a new copy of this node and of all of its children.
Definition at line 86 of file partGroup.cxx.
References PartGroup::copy_subgraph(), and PartGroup::make_copy().
Referenced by Character::Character(), PartGroup::copy_subgraph(), and PartBundleNode::xform().
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().
void PartGroup::determine_effective_channels | ( | const CycleData * | root_cdata | ) | [virtual, inherited] |
Should be called whenever the ChannelBlend values have changed, this recursively updates the _effective_channel member in each part.
Reimplemented in MovingPartBase.
Definition at line 570 of file partGroup.cxx.
Referenced by PartBundle::clear_control_effects(), and PartBundle::do_bind_anim().
bool PartBundle::do_bind_anim | ( | AnimControl * | control, |
AnimBundle * | anim, | ||
int | hierarchy_match_flags, | ||
const PartSubset & | subset | ||
) | [inherited] |
The internal implementation of bind_anim(), this receives a pointer to an uninitialized AnimControl and fills it in if the bind is successful.
Returns true if successful, false otherwise.
Definition at line 628 of file partBundle.cxx.
References BitArray::all_on(), PartGroup::bind_hierarchy(), PartGroup::check_hierarchy(), PartGroup::determine_effective_channels(), Thread::get_current_pipeline_stage(), PartSubset::is_include_empty(), PartGroup::pick_channel_index(), and AnimControl::setup_anim().
Referenced by BindAnimRequest::do_task().
bool ReferenceCount::do_test_ref_count_integrity | ( | ) | const [protected, inherited] |
Does some easy checks to make sure that the reference count isn't completely bogus.
Returns true if ok, false otherwise.
Reimplemented in NodeReferenceCount, CachedTypedWritableReferenceCount, and NodeCachedReferenceCount.
Definition at line 29 of file referenceCount.cxx.
Referenced by ReferenceCount::do_test_ref_count_nonzero(), and ReferenceCount::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().
bool PartGroup::do_update | ( | PartBundle * | root, |
const CycleData * | root_cdata, | ||
PartGroup * | parent, | ||
bool | parent_changed, | ||
bool | anim_changed, | ||
Thread * | current_thread | ||
) | [virtual, inherited] |
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 531 of file partGroup.cxx.
Referenced by PartBundle::finalize(), PartBundle::force_update(), and PartBundle::update().
Called by PartBundle::xform(), this indicates the indicated transform is being applied to the root joint.
Reimplemented in CharacterJoint.
Definition at line 554 of file partGroup.cxx.
Referenced by PartBundle::xform().
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 PartBundle::fillin | ( | DatagramIterator & | scan, |
BamReader * | manager | ||
) | [protected, virtual, inherited] |
This internal function is called by make_from_bam to read in all of the relevant data from the BamFile for the new PartBundle.
Reimplemented from PartGroup.
Definition at line 889 of file partBundle.cxx.
References DatagramIterator::get_bool(), BamReader::get_file_minor_ver(), BamReader::read_cdata(), and BamReader::read_pointer().
Referenced by make_CharacterJointBundle(), and PartBundle::make_from_bam().
void PartBundle::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 from TypedWritable.
Definition at line 827 of file partBundle.cxx.
References PartGroup::do_update(), and Thread::get_current_thread().
void PartGroup::find_bound_joints | ( | int & | joint_index, |
bool | is_included, | ||
BitArray & | bound_joints, | ||
const PartSubset & | subset | ||
) | [protected, virtual, inherited] |
Similar to bind_hierarchy, but does not actually perform any binding.
All it does is compute the BitArray bount_joints according to the specified subset. This is useful in preparation for asynchronous binding--in this case, we may need to know bound_joints immediately, without having to wait for the animation itself to load and bind.
Reimplemented in MovingPartBase.
Definition at line 691 of file partGroup.cxx.
References PartGroup::find_bound_joints(), PartGroup::get_child(), PartGroup::get_num_children(), PartSubset::matches_exclude(), and PartSubset::matches_include().
Referenced by PartGroup::find_bound_joints().
PartGroup * PartGroup::find_child | ( | const string & | name | ) | const [inherited] |
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 157 of file partGroup.cxx.
References PartGroup::find_child().
Referenced by PartBundle::control_joint(), PartGroup::find_child(), Character::find_joint(), Character::find_slider(), PartBundle::freeze_joint(), and PartBundle::release_joint().
bool PartBundle::force_update | ( | ) | [inherited] |
Updates all the parts in the bundle to reflect the data for the current frame, whether we believe it needs it or not.
Definition at line 579 of file partBundle.cxx.
References PartGroup::do_update(), Thread::get_current_thread(), and AnimControl::mark_channels().
Referenced by Character::force_update().
bool PartBundle::freeze_joint | ( | const string & | joint_name, |
const TransformState * | transform | ||
) | [inherited] |
Specifies that the joint with the indicated name should be frozen with the specified transform.
It will henceforth always hold this fixed transform, regardless of any animations that may subsequently be bound to the joint.
Returns true if the joint is successfully frozen, or false if the named child is not a joint (or slider) or does not exist.
Definition at line 418 of file partBundle.cxx.
References PartGroup::apply_freeze(), and PartGroup::find_child().
bool PartBundle::freeze_joint | ( | const string & | joint_name, |
const LVecBase3f & | pos, | ||
const LVecBase3f & | hpr, | ||
const LVecBase3f & | scale | ||
) | [inherited] |
Specifies that the joint with the indicated name should be frozen with the specified transform.
It will henceforth always hold this fixed transform, regardless of any animations that may subsequently be bound to the joint.
Returns true if the joint is successfully frozen, or false if the named child is not a joint (or slider) or does not exist.
Definition at line 444 of file partBundle.cxx.
References PartGroup::apply_freeze_matrix(), and PartGroup::find_child().
bool PartBundle::freeze_joint | ( | const string & | joint_name, |
float | value | ||
) | [inherited] |
Specifies that the joint with the indicated name should be frozen with the specified transform.
It will henceforth always hold this fixed transform, regardless of any animations that may subsequently be bound to the joint.
Returns true if the joint is successfully frozen, or false if the named child is not a joint (or slider) or does not exist.
Definition at line 470 of file partBundle.cxx.
References PartGroup::apply_freeze_scalar(), and PartGroup::find_child().
bool PartBundle::get_anim_blend_flag | ( | ) | const [inline, inherited] |
Returns whether the character allows multiple different animations to be bound simultaneously.
Definition at line 102 of file partBundle.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().
PartBundle::BlendType PartBundle::get_blend_type | ( | ) | const [inline, inherited] |
Returns the algorithm that is used when blending multiple frames or multiple animations together, when either anim_blend_flag or frame_blend_flag is set to true.
Definition at line 89 of file partBundle.I.
PartGroup * PartGroup::get_child | ( | int | n | ) | const [inherited] |
Returns the nth child of the group.
Definition at line 121 of file partGroup.cxx.
Referenced by PartGroup::bind_hierarchy(), PartGroup::check_hierarchy(), and PartGroup::find_bound_joints().
PartGroup * PartGroup::get_child_named | ( | const string & | name | ) | const [inherited] |
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 136 of file partGroup.cxx.
Referenced by PartGroup::check_hierarchy().
float PartBundle::get_control_effect | ( | AnimControl * | control | ) | const [inline, inherited] |
Returns the amount by which the character is affected by the indicated AnimControl and its associated animation.
See set_control_effect().
Definition at line 247 of file partBundle.I.
AnimChannelBase * PartGroup::get_forced_channel | ( | ) | const [virtual, inherited] |
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 264 of file partGroup.cxx.
bool PartBundle::get_frame_blend_flag | ( | ) | const [inline, inherited] |
Returns whether the character interpolates (blends) between two sequential animation frames, or whether it holds the current frame until the next one is ready.
Definition at line 145 of file partBundle.I.
Character * CharacterJointBundle::get_node | ( | int | n | ) | const [inline] |
Returns the nth Character associated with this PartBundle.
Reimplemented from PartBundle.
Definition at line 40 of file characterJointBundle.I.
References PartBundle::get_node().
Referenced by remove_node().
int PartGroup::get_num_children | ( | ) | const [inherited] |
Returns the number of child nodes of the group.
Definition at line 110 of file partGroup.cxx.
Referenced by PartGroup::bind_hierarchy(), PartGroup::check_hierarchy(), and PartGroup::find_bound_joints().
int PartBundle::get_num_nodes | ( | ) | const [inline, inherited] |
Returns the number of PartBundleNodes that contain a pointer to this PartBundle.
Definition at line 198 of file partBundle.I.
Referenced by remove_node(), and PartBundleNode::xform().
int ReferenceCount::get_ref_count | ( | ) | const [inline, inherited] |
Returns the current reference count.
Definition at line 155 of file referenceCount.I.
References ReferenceCount::test_ref_count_integrity().
Referenced by TransformState::clear_cache(), RenderState::clear_cache(), RenderState::finalize(), RenderEffects::finalize(), RenderEffect::finalize(), RenderAttrib::finalize(), InternalName::finalize(), TransformState::get_num_unused_states(), RenderState::get_num_unused_states(), TransformState::list_cycles(), RenderState::list_cycles(), GeomVertexFormat::remove_column(), TransformState::unref(), RenderState::unref(), RenderState::~RenderState(), and TransformState::~TransformState().
const LMatrix4f & PartBundle::get_root_xform | ( | ) | const [inline, inherited] |
Returns the transform matrix which is implicitly applied at the root of the animated hierarchy.
Definition at line 186 of file partBundle.I.
Referenced by CharacterJoint::update_internals().
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().
TypeHandle PartGroup::get_value_type | ( | ) | const [virtual, inherited] |
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 MovingPart< SwitchType >, MovingPartBase, MovingPart< ACScalarSwitchType >, and MovingPart< ACMatrixSwitchType >.
Definition at line 277 of file partGroup.cxx.
References TypeHandle::none().
Referenced by PartGroup::check_hierarchy().
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 Namable::has_name | ( | ) | const [inline, inherited] |
Returns true if the Namable has a nonempty name set, false if the name is empty.
Definition at line 75 of file namable.I.
Referenced by XFileNode::add_child(), EggComponentData::add_name(), Texture::do_read_dds_file(), Texture::do_read_one(), Character::fillin(), EggGroupUniquifier::get_category(), EggXfmSAnim::optimize(), NodePathComponent::output(), AsyncTask::output(), EggNamedObject::output(), EggSAnimData::write(), EggPrimitive::write_body(), ParametricCurveCollection::write_egg(), ParametricCurve::write_egg(), EggNamedObject::write_header(), XFileDataNodeTemplate::write_text(), and XFileDataDef::write_text().
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 PartGroup::is_character_joint | ( | ) | const [virtual, inherited] |
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 64 of file partGroup.cxx.
Referenced by CharacterJoint::update_internals().
bool TypedObject::is_exact_type | ( | TypeHandle | handle | ) | const [inline, inherited] |
Returns true if the current object is the indicated type exactly.
Definition at line 74 of file typedObject.I.
References TypeHandle::get_name().
Referenced by GraphicsStateGuardian::async_reload_texture(), PortalNode::combine_with(), PandaNode::combine_with(), GeomNode::combine_with(), CollisionNode::combine_with(), Character::combine_with(), PGItem::cull_callback(), FactoryParams::get_param_of_type(), CollisionHandlerPusher::handle_entries(), SceneGraphReducer::r_flatten(), ConnectionWriter::send(), FltToEggLevelState::set_transform(), and VirtualFileSystem::unmount().
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(), 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().
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 * CharacterJointBundle::make_CharacterJointBundle | ( | const FactoryParams & | params | ) | [static] |
Factory method to generate a CharacterJointBundle object.
Definition at line 121 of file characterJointBundle.cxx.
References CharacterJointBundle(), PartBundle::fillin(), and BamReader::register_finalize().
Referenced by register_with_read_factory().
PartGroup * CharacterJointBundle::make_copy | ( | ) | const [protected, virtual] |
Allocates and returns a new copy of the node.
Children are not copied, but see copy_subgraph().
Reimplemented from PartBundle.
Definition at line 50 of file characterJointBundle.cxx.
References CharacterJointBundle().
TypedWritable * PartBundle::make_from_bam | ( | const FactoryParams & | params | ) | [static, protected, inherited] |
Factory method to generate a PartBundle object.
Definition at line 870 of file partBundle.cxx.
References PartBundle::fillin(), PartBundle::PartBundle(), and BamReader::register_finalize().
Referenced by PartBundle::register_with_read_factory().
TypedWritable * PartGroup::make_PartGroup | ( | const FactoryParams & | params | ) | [static, inherited] |
Factory method to generate a PartGroup object.
Definition at line 773 of file partGroup.cxx.
References PartGroup::fillin(), and PartGroup::PartGroup().
Referenced by PartGroup::register_with_read_factory().
void TypedWritable::mark_bam_modified | ( | ) | [inline, inherited] |
Increments the bam_modified counter, so that this object will be invalidated and retransmitted on any open bam streams.
This should normally not need to be called by user code; it should be called internally when the object has been changed in a way that legitimately requires its retransmission to any connected clients.
Definition at line 54 of file typedWritable.I.
Referenced by PandaNode::add_child(), PandaNode::add_stashed(), PandaNode::adjust_draw_mask(), PandaNode::apply_attribs_to_vertices(), PandaNode::clear_attrib(), PandaNode::clear_effect(), PandaNode::clear_tag(), PandaNode::copy_all_properties(), PandaNode::copy_tags(), PandaNode::disable_cull_callback(), PandaNode::force_bounds_stale(), PandaNode::remove_all_children(), PandaNode::remove_child(), PandaNode::remove_stashed(), PandaNode::reset_all_prev_transform(), PandaNode::reset_prev_transform(), PandaNode::set_attrib(), PandaNode::set_bounds(), PandaNode::set_bounds_type(), PandaNode::set_cull_callback(), PandaNode::set_effect(), PandaNode::set_effects(), PandaNode::set_final(), PandaNode::set_internal_bounds(), PandaNode::set_into_collide_mask(), PandaNode::set_prev_transform(), PandaNode::set_state(), PandaNode::set_tag(), PandaNode::set_transform(), PandaNode::stash_child(), and PandaNode::unstash_child().
void PartBundle::merge_anim_preloads | ( | const PartBundle * | other | ) | [inherited] |
Copies the contents of the other PartBundle's preload table into this one.
Definition at line 99 of file partBundle.cxx.
Referenced by Character::merge_bundles().
void PartBundle::output | ( | ostream & | out | ) | const [virtual, inherited] |
Writes a one-line description of the bundle.
Reimplemented from Namable.
Definition at line 234 of file partBundle.cxx.
void PartGroup::pick_channel_index | ( | plist< int > & | holes, |
int & | next | ||
) | const [protected, virtual, inherited] |
Walks the part hierarchy, looking for a suitable channel index number to use.
Available index numbers are the elements of the holes set, as well as next to infinity.
Reimplemented in MovingPartBase.
Definition at line 617 of file partGroup.cxx.
Referenced by PartBundle::do_bind_anim().
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 CharacterJointBundle::register_with_read_factory | ( | ) | [static] |
Factory method to generate a CharacterJointBundle object.
Reimplemented from PartBundle.
Definition at line 139 of file characterJointBundle.cxx.
References BamReader::get_factory(), make_CharacterJointBundle(), and Factory< Type >::register_factory().
bool PartBundle::release_joint | ( | const string & | joint_name | ) | [inherited] |
Releases the named joint from the effects of a previous call to freeze_joint() or control_joint().
It will henceforth once again follow whatever transforms are dictated by the animation.
Returns true if the joint is released, or false if the named child was not previously controlled or frozen, or it does not exist.
Definition at line 521 of file partBundle.cxx.
References PartGroup::clear_forced_channel(), and PartGroup::find_child().
void CharacterJointBundle::remove_node | ( | PartBundleNode * | node | ) | [protected, virtual] |
Removes the PartBundleNode pointer from the set of nodes associated with the PartBundle.
Normally called only by the PartBundleNode itself, for instance when the bundle is flattened with another node.
Reimplemented from PartBundle.
Definition at line 81 of file characterJointBundle.cxx.
References get_node(), and PartBundle::get_num_nodes().
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 PartBundle::set_anim_blend_flag | ( | bool | anim_blend_flag | ) | [inherited] |
Defines the way the character responds to multiple calls to set_control_effect()).
By default, this flag is set false, which disallows multiple animations. When this flag is false, it is not necessary to explicitly set the control_effect when starting an animation; starting the animation will implicitly remove the control_effect from the previous animation and set it on the current one.
However, if this flag is set true, the control_effect must be explicitly set via set_control_effect() whenever an animation is to affect the character.
Definition at line 134 of file partBundle.cxx.
References Thread::get_current_pipeline_stage().
void PartBundle::set_anim_preload | ( | AnimPreloadTable * | table | ) | [inline, inherited] |
Replaces the AnimPreloadTable associated with the PartBundle.
Definition at line 47 of file partBundle.I.
void PartBundle::set_blend_type | ( | PartBundle::BlendType | bt | ) | [inline, inherited] |
Defines the algorithm that is used when blending multiple frames or multiple animations together, when either anim_blend_flag or frame_blend_flag is set to true.
See partBundle.h for a description of the meaning of each of the BlendType values.
Definition at line 74 of file partBundle.I.
References Thread::get_current_pipeline_stage().
void PartBundle::set_control_effect | ( | AnimControl * | control, |
float | effect | ||
) | [inline, inherited] |
Sets the amount by which the character is affected by the indicated AnimControl (and its associated animation).
Normally, this will only be zero or one. Zero indicates the animation does not affect the character, and one means it does.
If the _anim_blend_flag is not false (see set_anim_blend_flag()), it is possible to have multiple AnimControls in effect simultaneously. In this case, the effect is a weight that indicates the relative importance of each AnimControl to the final animation.
Definition at line 232 of file partBundle.I.
References Thread::get_current_pipeline_stage().
void PartBundle::set_frame_blend_flag | ( | bool | frame_blend_flag | ) | [inline, inherited] |
Specifies whether the character interpolates (blends) between two sequential frames of an active animation, showing a smooth intra-frame motion, or whether it holds each frame until the next frame is ready, showing precisely the specified animation.
When this value is false, the character holds each frame until the next is ready. When this is true, the character will interpolate between two consecutive frames of animation for each frame the animation is onscreen, according to the amount of time elapsed between the frames.
The default value of this flag is determined by the interpolate-frames Config.prc variable.
Use set_blend_type() to change the algorithm that the character uses to interpolate matrix positions.
Definition at line 130 of file partBundle.I.
References Thread::get_current_pipeline_stage().
void PartBundle::set_root_xform | ( | const LMatrix4f & | root_xform | ) | [inline, inherited] |
Specifies the transform matrix which is implicitly applied at the root of the animated hierarchy.
Definition at line 157 of file partBundle.I.
References Thread::get_current_pipeline_stage().
void PartBundle::set_update_delay | ( | double | delay | ) | [inline, inherited] |
Specifies the minimum amount of time, in seconds, that should elapse between any two consecutive updates.
This is normally used by Character::set_lod_animation(), and should not be called directly.
Definition at line 262 of file partBundle.I.
void PartGroup::sort_descendants | ( | ) | [inherited] |
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 300 of file partGroup.cxx.
bool ReferenceCount::test_ref_count_integrity | ( | ) | const [inline, inherited] |
Does some easy checks to make sure that the reference count isn't completely bogus.
Returns true if ok, false otherwise.
Reimplemented in NodeReferenceCount, CachedTypedWritableReferenceCount, and NodeCachedReferenceCount.
Definition at line 236 of file referenceCount.I.
References ReferenceCount::do_test_ref_count_integrity().
Referenced by EggGroupNode::add_child(), InternalName::find_ancestor(), InternalName::get_ancestor(), ReferenceCount::get_ref_count(), InternalName::get_top(), ReferenceCount::ref(), EggVertex::test_gref_integrity(), EggVertex::test_pref_integrity(), EggNode::test_under_integrity(), EggPrimitive::test_vref_integrity(), EggGroup::test_vref_integrity(), MouseWatcher::throw_event_pattern(), ReferenceCount::unref(), and EggNode::update_under().
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().
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().
bool PartBundle::update | ( | ) | [inherited] |
Updates all the parts in the bundle to reflect the data for the current frame (as set in each of the AnimControls).
Returns true if any part has changed as a result of this, or false otherwise.
Definition at line 544 of file partBundle.cxx.
References PartGroup::do_update(), Thread::get_current_thread(), ClockObject::get_frame_time(), ClockObject::get_global_clock(), and AnimControl::mark_channels().
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 PartBundle::wait_pending | ( | ) | [inherited] |
Blocks the current thread until all currently-pending AnimControls, with a nonzero control effect, have been loaded and are properly bound.
Definition at line 390 of file partBundle.cxx.
References AnimControl::wait_pending().
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 PartBundle::write | ( | ostream & | out, |
int | indent_level | ||
) | const [virtual, inherited] |
Writes a brief description of the bundle and all of its descendants.
Reimplemented from PartGroup.
Definition at line 245 of file partBundle.cxx.
References PartGroup::write_descendants().
Referenced by Character::write_parts().
Writes the contents of this object to the datagram for shipping out to a Bam file.
Reimplemented from PartGroup.
Definition at line 840 of file partBundle.cxx.
References BamWriter::write_cdata(), and BamWriter::write_pointer().
void PartGroup::write_descendants | ( | ostream & | out, |
int | indent_level | ||
) | const [protected, inherited] |
Writes a brief description of all of the group's descendants.
Definition at line 585 of file partGroup.cxx.
Referenced by MovingPartBase::write(), PartBundle::write(), and PartGroup::write().
void PartGroup::write_descendants_with_value | ( | ostream & | out, |
int | indent_level | ||
) | const [protected, inherited] |
Writes a brief description of all of the group's descendants and their values.
Definition at line 600 of file partGroup.cxx.
Referenced by PartGroup::write_with_value(), and MovingPartBase::write_with_value().
void PartGroup::write_with_value | ( | ostream & | out, |
int | indent_level | ||
) | const [virtual, inherited] |
Writes a brief description of the group, showing its current value, and that of all of its descendants.
Reimplemented in MovingPartBase.
Definition at line 510 of file partGroup.cxx.
References PartGroup::write_descendants_with_value().
Referenced by Character::write_part_values().
void PartBundle::xform | ( | const LMatrix4f & | mat | ) | [inline, inherited] |
Applies the indicated transform to the root of the animated hierarchy.
Definition at line 171 of file partBundle.I.
References PartGroup::do_xform(), and Thread::get_current_pipeline_stage().
Referenced by PartBundleNode::xform().