An animation channel that issues a matrix each frame, read from a table such as might have been read from an egg file. More...

#include "animChannelMatrixXfmTable.h"

Inheritance diagram for AnimChannelMatrixXfmTable:

Public Member Functions
	AnimChannelMatrixXfmTable (AnimGroup *parent, const std::string &name)

void	clear_all_tables ()
	Removes all the tables from the channel, and resets it to its initial state. More...

void	clear_table (char table_id)

virtual TypeHandle	force_init_type ()

virtual void	get_hpr (int frame, LVecBase3 &hpr)
	Returns the h, p, and r components associated with the current frame. More...

virtual void	get_pos (int frame, LVecBase3 &pos)
	Returns the x, y, and z translation components associated with the current frame. More...

virtual void	get_quat (int frame, LQuaternion &quat)
	Returns the rotation component associated with the current frame, expressed as a quaternion. More...

virtual void	get_scale (int frame, LVecBase3 &scale)
	Gets the scale value at the indicated frame. More...

virtual void	get_shear (int frame, LVecBase3 &shear)
	Returns the a, b, and c shear components associated with the current frame. More...

CPTA_stdfloat	get_table (char table_id) const

virtual TypeHandle	get_type () const

virtual void	get_value (int frame, LMatrix4 &mat)
	Gets the value of the channel at the indicated frame. More...

virtual void	get_value_no_scale_shear (int frame, LMatrix4 &value)
	Gets the value of the channel at the indicated frame, without any scale or shear information. More...

virtual bool	has_changed (int last_frame, double last_frac, int this_frame, double this_frac)
	Returns true if the value has changed since the last call to has_changed(). More...

bool	has_table (char table_id) const

void	set_table (char table_id, const CPTA_stdfloat &table)

virtual void	write (std::ostream &out, int indent_level) const
	Writes a brief description of the table 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...

Public Member Functions inherited from AnimChannel< ACMatrixSwitchType >
	AnimChannel (AnimGroup *parent, const std::string &name)
	This is the normal constructor, which automatically places the AnimChannel in the previously-created hierarchy. More...

virtual void	get_value (int frame, ValueType &value)=0

virtual void	get_value_no_scale_shear (int frame, ValueType &value)
	Returns the value associated with the current frame, with no scale or share components. More...

virtual TypeHandle	get_value_type () const
	Returns the TypeHandle associated with the ValueType we return. More...

Public Member Functions inherited from AnimChannelBase
	AnimChannelBase (AnimGroup *parent, const std::string &name)
	This is the normal constructor, which automatically places the AnimChannel in the previously-created hierarchy. More...

Public Member Functions inherited from AnimGroup
	AnimGroup (AnimGroup *parent, const std::string &name)
	Creates the AnimGroup, and adds it to the indicated parent. More...

virtual int	complete_pointers (TypedWritable *p_list, BamReader manager)
	Takes in a vector of pointes to TypedWritable objects that correspond to all the requests for pointers that this object made to BamReader. More...

AnimGroup *	find_child (const std::string &name) const
	Returns the first descendant found with the indicated name, or NULL if no such descendant exists. More...

AnimGroup *	get_child (int n) const

AnimGroup *	get_child_named (const std::string &name) const
	Returns the first child found with the indicated name, or NULL if no such child exists. More...

int	get_num_children () const

virtual void	output (std::ostream &out) const
	Writes a one-line description of the group. More...

void	sort_descendants ()
	Sorts the children nodes at each level of the hierarchy into alphabetical order. More...

Public Member Functions inherited from TypedWritableReferenceCount
	TypedWritableReferenceCount (const TypedWritableReferenceCount &copy)

virtual ReferenceCount *	as_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)

vector_uchar	encode_to_bam_stream () const
	Converts the TypedWritable object into a single stream of data using a BamWriter, and returns that data as a bytes object. More...

bool	encode_to_bam_stream (vector_uchar &data, BamWriter *writer=nullptr) 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)=default

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

const TypedObject *	as_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...

TypedObject &	operator= (const TypedObject &copy)=default

Public Member Functions inherited from ReferenceCount
int	get_ref_count () const

WeakReferenceList *	get_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	ref_if_nonzero () const
	Atomically increases the reference count of this object if it is not zero. 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...

WeakReferenceList *	weak_ref ()
	Adds the indicated PointerToVoid as a weak reference to this object. More...

void	weak_unref ()
	Removes the indicated PointerToVoid as a weak reference to this object. More...

Public Member Functions inherited from Namable
	Namable (const std::string &initial_name="")

void	clear_name ()
	Resets the Namable's name to empty. More...

const std::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...

void	output (std::ostream &out) const
	Outputs the Namable. More...

void	set_name (const std::string &name)

Static Public Member Functions
static TypeHandle	get_class_type ()

static void	init_type ()

static bool	is_valid_id (char table_id)
	Returns true if the given letter is one of the nine valid table id's. More...

static TypedWritable *	make_AnimChannelMatrixXfmTable (const FactoryParams &params)
	Factory method to generate an AnimChannelMatrixXfmTable object. More...

static void	register_with_read_factory ()
	Factory method to generate an AnimChannelMatrixXfmTable object. More...

Static Public Member Functions inherited from AnimChannel< ACMatrixSwitchType >
static TypeHandle	get_class_type ()

static void	init_type ()

Static Public Member Functions inherited from AnimChannelBase
static TypeHandle	get_class_type ()

static void	init_type ()

Static Public Member Functions inherited from AnimGroup
static TypeHandle	get_class_type ()

static void	init_type ()

static TypedWritable *	make_AnimGroup (const FactoryParams &params)
	Factory method to generate a AnimGroup object. More...

static void	register_with_read_factory ()
	Factory method to generate a AnimGroup 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(vector_uchar data

Static Public Member Functions inherited from TypedWritable
static bool	decode_raw_from_bam_stream (TypedWritable &ptr, ReferenceCount &ref_ptr, vector_uchar data, BamReader *reader=nullptr)
	Reads the bytes created by a previous call to encode_to_bam_stream(), and extracts the single object on those bytes. 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 ()

Public Attributes
	clear_table
	Removes the indicated table from the definition. More...

	get_table
	Returns a pointer to the indicated subtable's data, if it exists, or NULL if it does not. More...

	has_table
	Returns true if the indicated subtable has been assigned. More...

	set_table
	Assigns the indicated table. More...

Public Attributes inherited from AnimGroup
	get_child
	Returns the nth child of the group. More...

	get_num_children
	Returns the number of child nodes of the group. More...

Public Attributes inherited from TypedWritableReferenceCount
static BamReader *	reader = nullptr)

Public Attributes inherited from TypedObject
	get_type

Public Attributes inherited from ReferenceCount
	get_ref_count
	Returns the current reference count. More...

Public Attributes inherited from Namable
	get_name

	set_name

Additional Inherited Members
Public Types inherited from AnimChannel< ACMatrixSwitchType >
typedef ACMatrixSwitchType ::ValueType	ValueType

Static Public Attributes inherited from TypedWritable
static TypedWritable *const	Null = nullptr

Detailed Description

An animation channel that issues a matrix each frame, read from a table such as might have been read from an egg file.

The table actually consists of nine sub-tables, each representing one component of the transform: scale, rotate, translate.

Definition at line 31 of file animChannelMatrixXfmTable.h.

Member Function Documentation

◆ clear_all_tables()

void AnimChannelMatrixXfmTable::clear_all_tables ( )

Removes all the tables from the channel, and resets it to its initial state.

Definition at line 260 of file animChannelMatrixXfmTable.cxx.

◆ get_hpr()

void AnimChannelMatrixXfmTable::get_hpr	(	int	frame,
		LVecBase3 &	hpr
	)

virtual

Returns the h, p, and r components associated with the current frame.

As above, this only makes sense for a matrix-type channel.

Reimplemented from AnimChannel< ACMatrixSwitchType >.

Definition at line 170 of file animChannelMatrixXfmTable.cxx.

◆ get_pos()

void AnimChannelMatrixXfmTable::get_pos	(	int	frame,
		LVecBase3 &	pos
	)

virtual

Returns the x, y, and z translation components associated with the current frame.

As above, this only makes sense for a matrix-type channel.

Reimplemented from AnimChannel< ACMatrixSwitchType >.

Definition at line 204 of file animChannelMatrixXfmTable.cxx.

◆ get_quat()

void AnimChannelMatrixXfmTable::get_quat	(	int	frame,
		LQuaternion &	quat
	)

virtual

Returns the rotation component associated with the current frame, expressed as a quaternion.

As above, this only makes sense for a matrix-type channel.

Reimplemented from AnimChannel< ACMatrixSwitchType >.

Definition at line 186 of file animChannelMatrixXfmTable.cxx.

◆ get_scale()

void AnimChannelMatrixXfmTable::get_scale	(	int	frame,
		LVecBase3 &	scale
	)

virtual

Gets the scale value at the indicated frame.

Reimplemented from AnimChannel< ACMatrixSwitchType >.

Definition at line 155 of file animChannelMatrixXfmTable.cxx.

◆ get_shear()

void AnimChannelMatrixXfmTable::get_shear	(	int	frame,
		LVecBase3 &	shear
	)

virtual

Returns the a, b, and c shear components associated with the current frame.

As above, this only makes sense for a matrix-type channel.

Reimplemented from AnimChannel< ACMatrixSwitchType >.

Definition at line 219 of file animChannelMatrixXfmTable.cxx.

◆ get_value()

void AnimChannelMatrixXfmTable::get_value	(	int	frame,
		LMatrix4 &	mat
	)

virtual

Gets the value of the channel at the indicated frame.

Definition at line 112 of file animChannelMatrixXfmTable.cxx.

◆ get_value_no_scale_shear()

void AnimChannelMatrixXfmTable::get_value_no_scale_shear	(	int	frame,
		LMatrix4 &	value
	)

virtual

Gets the value of the channel at the indicated frame, without any scale or shear information.

Definition at line 131 of file animChannelMatrixXfmTable.cxx.

◆ has_changed()

bool AnimChannelMatrixXfmTable::has_changed	(	int	last_frame,
		double	last_frac,
		int	this_frame,
		double	this_frac
	)

virtual

Returns true if the value has changed since the last call to has_changed().

last_frame is the frame number of the last call; this_frame is the current frame number.

Reimplemented from AnimChannelBase.

Definition at line 79 of file animChannelMatrixXfmTable.cxx.

◆ is_valid_id()

bool AnimChannelMatrixXfmTable::is_valid_id ( char table_id )

inlinestatic

Returns true if the given letter is one of the nine valid table id's.

Definition at line 18 of file animChannelMatrixXfmTable.I.

◆ make_AnimChannelMatrixXfmTable()

TypedWritable * AnimChannelMatrixXfmTable::make_AnimChannelMatrixXfmTable ( const FactoryParams & params )

static

Factory method to generate an AnimChannelMatrixXfmTable object.

Definition at line 514 of file animChannelMatrixXfmTable.cxx.

References parse_params().

Referenced by register_with_read_factory().

◆ register_with_read_factory()

void AnimChannelMatrixXfmTable::register_with_read_factory ( )

static

Factory method to generate an AnimChannelMatrixXfmTable object.

Definition at line 528 of file animChannelMatrixXfmTable.cxx.

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

◆ write()

void AnimChannelMatrixXfmTable::write	(	std::ostream &	out,
		int	indent_level
	)		const

virtual

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

Reimplemented from AnimGroup.

Definition at line 270 of file animChannelMatrixXfmTable.cxx.

References indent().

◆ write_datagram()

void AnimChannelMatrixXfmTable::write_datagram	(	BamWriter *	manager,
		Datagram &	me
	)

virtual

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

Reimplemented from AnimChannelBase.

Definition at line 327 of file animChannelMatrixXfmTable.cxx.

References AnimChannelBase::write_datagram().

Member Data Documentation

◆ clear_table

void AnimChannelMatrixXfmTable::clear_table

inline

Removes the indicated table from the definition.

Definition at line 62 of file animChannelMatrixXfmTable.h.

◆ get_table

CPTA_stdfloat AnimChannelMatrixXfmTable::get_table

inline

Returns a pointer to the indicated subtable's data, if it exists, or NULL if it does not.

Definition at line 62 of file animChannelMatrixXfmTable.h.

◆ has_table

bool AnimChannelMatrixXfmTable::has_table

inline

Returns true if the indicated subtable has been assigned.

Definition at line 62 of file animChannelMatrixXfmTable.h.

◆ set_table

void AnimChannelMatrixXfmTable::set_table

Assigns the indicated table.

table_id is one of 'i', 'j', 'k', for scale, 'a', 'b', 'c' for shear, 'h', 'p', 'r', for rotation, and 'x', 'y', 'z', for translation. The new table must have either zero, one, or get_num_frames() frames.

Definition at line 62 of file animChannelMatrixXfmTable.h.

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

panda/src/chan/animChannelMatrixXfmTable.h
panda/src/chan/animChannelMatrixXfmTable.cxx
panda/src/chan/animChannelMatrixXfmTable.I

Public Member Functions

Static Public Member Functions

Public Attributes

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ clear_all_tables()

◆ get_hpr()

◆ get_pos()

◆ get_quat()

◆ get_scale()

◆ get_shear()

◆ get_value()

◆ get_value_no_scale_shear()

◆ has_changed()

◆ is_valid_id()

◆ make_AnimChannelMatrixXfmTable()

◆ register_with_read_factory()

◆ write()

◆ write_datagram()

Member Data Documentation

◆ clear_table

◆ get_table

◆ has_table

◆ set_table