AnimControl¶
-
class
AnimControl
¶ Bases:
TypedReferenceCount
,AnimInterface
,Namable
Controls the timing of a character animation. An AnimControl object is created for each character/bundle binding and manages the state of the animation: whether started, stopped, or looping, and the current frame number and play rate.
Inheritance diagram
-
AnimBundle *
get_anim
(void) const¶ Returns the
AnimBundle
bound in with thisAnimControl
.
-
PandaNode *
get_anim_model
(void) const¶ Retrieves the pointer set via
set_anim_model()
. Seeset_anim_model()
.
-
BitArray const &
get_bound_joints
(void) const¶ Returns the subset of joints controlled by this
AnimControl
. Most of the time, this will beBitArray::all_on()
, for a normal full-body animation. For a subset animation, however, this will be just a subset of those bits, corresponding to the set of joints and sliders actually bound (as enumerated by bind_hierarchy() in depth-first LIFO order).
-
int
get_channel_index
(void) const¶ Returns the particular channel index associated with this
AnimControl
. This channel index is the slot on which eachAnimGroup
is bound to its associatedPartGroup
, for each joint in the animation.It will be true that get_part()->find_child(“n”)->get_bound(get_channel_index()) == get_anim()->find_child(“n”), for each joint “n”.
-
static TypeHandle
get_class_type
(void)¶
-
PartBundle *
get_part
(void) const¶ Returns the
PartBundle
bound in with thisAnimControl
.
-
std::string
get_pending_done_event
(void) const¶ Returns the event name that will be thrown when the
AnimControl
is finished binding asynchronously.
-
bool
has_anim
(void) const¶ Returns true if the
AnimControl
was successfully loaded, or false if there was a problem. This may return false whileis_pending()
is true.
-
bool
is_pending
(void) const¶ Returns true if the
AnimControl
is being bound asynchronously, and has not yet finished. If this is true, the AnimControl’s interface is still available and will be perfectly useful (thoughget_anim()
might return NULL), but nothing visible will happen immediately.
-
virtual void
output
(std::ostream &out) const¶
-
void
set_anim_model
(PandaNode *model)¶ Associates the indicated
PandaNode
with theAnimControl
. By convention, this node represents the root node of the model file that corresponds to this AnimControl’s animation file, though nothing in this code makes this assumption or indeed does anything with this node.The purpose of this is simply to allow the
AnimControl
to keep a reference count on theModelRoot
node that generated it, so that the model will not disappear from the model pool until it is no longer referenced.
-
void
set_pending_done_event
(std::string const &done_event)¶ Specifies an event name that will be thrown when the
AnimControl
is finished binding asynchronously. If theAnimControl
has already finished binding, the event will be thrown immediately.
-
void
wait_pending
(void)¶ Blocks the current thread until the
AnimControl
has finished loading and is fully bound.
-
AnimBundle *