BaseObject Class Reference | C4D R23.110 C++ SDK - 中文文档编制,帮助,手册,教程

BaseObject Class Reference

#include <c4d_baseobject.h>

Inheritance diagram for BaseObject:

[ legend ]

详细描述

All objects in Cinema 4D are derived from the BaseObject class.
Contains methods for the object's position, scale and rotation, as well as for accessing the sub-items of the object (e.g. tags and animation tracks).

注意: Has to be created with Alloc() and destroyed with Free() 。使用 AutoAlloc to automate the allocation and destruction based on scope.

私有成员函数
	BaseObject ()
	~BaseObject ()

Alloc/Free
static BaseObject *	Alloc ( Int32 type)
static void	Free ( BaseObject *&bl)

导航
BaseObject *	GetNext (void)
BaseObject *	GetPred (void)
BaseObject *	GetUp (void)
BaseObject *	GetDown (void)
BaseObject *	GetDownLast (void)

Abs Pos/Scale/Rot
向量	GetAbsPos () const
void	SetAbsPos (const 向量 &v)
向量	GetAbsScale () const
void	SetAbsScale (const 向量 &v)
向量	GetAbsRot () const
void	SetAbsRot (const 向量 &v)

Frozen Pos/Scale/Rot
向量	GetFrozenPos () const
void	SetFrozenPos (const 向量 &v)
向量	GetFrozenScale () const
void	SetFrozenScale (const 向量 &v)
向量	GetFrozenRot () const
void	SetFrozenRot (const 向量 &v)

Rel Pos/Scale/Rot
向量	GetRelPos () const
void	SetRelPos (const 向量 &v)
向量	GetRelScale () const
void	SetRelScale (const 向量 &v)
向量	GetRelRot () const
void	SetRelRot (const 向量 &v)

Ml/Mg Matrix
const 矩阵 &	GetMl (void) const
void	SetMl (const 矩阵 &m)
矩阵	GetFrozenMln () const
矩阵	GetRelMln () const
矩阵	GetRelMl () const
void	SetRelMl (const 矩阵 &m)
矩阵	GetMg () const
void	SetMg (const 矩阵 &m)
矩阵	GetMln () const
矩阵	GetMgn () const
矩阵	GetUpMg () const
void	CopyMatrixTo ( BaseObject *dst)

Bounding Box
向量	GetMp (void)
向量	GetRad (void)

Editor/Render/Deform Mode
Int32	GetEditorMode (void) const
Int32	GetEditorModeH (void) const
void	SetEditorMode ( Int32 mode)
Int32	GetRenderMode (void) const
Int32	GetRenderModeH (void) const
void	SetRenderMode ( Int32 mode)
Bool	GetDeformMode (void) const
void	SetDeformMode ( Bool mode)
Int32	GetRealDeformMode (void) const
void	SetRealDeformMode ( Int32 mode)

Unique IP
Int32	GetUniqueIP (void)
void	SetUniqueIP ( Int32 ip)

Tag
BaseTag *	GetFirstTag (void)
BaseTag *	GetLastTag (void)
BaseTag *	GetTag ( Int32 type, Int32 nr=0)
const maxon::BaseArray < BaseTag * > *	GetTagsOfType ( Int32 type) const
const maxon::BaseArray < BaseTag * > *	GetTagsWithFlags ( Int32 flags) const
const void *	GetTagDataR ( Int32 type, Int32 nr=0) const
void *	GetTagDataW ( Int32 type, Int32 nr=0)
Int32	GetTagDataCount ( Int32 type) const
BaseTag *	MakeTag ( Int32 type, BaseTag *pred=nullptr)
VariableTag *	MakeVariableTag ( Int32 type, Int32 count, BaseTag *pred=nullptr)
void	InsertTag ( BaseTag tp, BaseTag pred=nullptr)
void	KillTag ( Int32 type, Int32 nr=0)
Bool	CopyTagsTo ( BaseObject dest, Int32 visible, Int32 variable, Int32 hierarchical, AliasTrans trans)

缓存
BaseObject *	GetCache ( HierarchyHelp *hh=nullptr)
BaseObject *	GetDeformCache (void)
LineObject *	GetIsoparm (void)
void	SetIsoparm ( LineObject *l)
BaseObject *	GetCacheParent (void) const
BaseObject *	GetCacheTopParent (void) const

Phong
Bool	SetPhong ( Bool on, Bool anglelimit, Float angle)

Dirty
Bool	IsDirty ( DIRTYFLAGS flags)
void	SetDirty ( DIRTYFLAGS flags)
Bool	CheckCache ( HierarchyHelp *hh)
void	Touch (void)

Color Properties
void	GetColorProperties ( ObjectColorProperties *prop)
void	SetColorProperties ( ObjectColorProperties *prop)

Modeling Axis
const 矩阵 &	GetModelingAxis ( BaseDocument *doc)
void	SetModelingAxis (const 矩阵 &m)

Hierarchy Clone
BaseObject *	GetAndCheckHierarchyClone ( HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans, Bool allchildren)
BaseObject *	GetHierarchyClone ( HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans)
BaseObject *	GetHierarchyClone ( HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans, DIRTYFLAGS dirtyflags)

Dependence List
void	NewDependenceList (void)
Bool	CompareDependenceList (void)
void	AddDependence ( HierarchyHelp hh, BaseObject op)
void	AddDependence ( HierarchyHelp hh, BaseObject op, DIRTYFLAGS dirtyflags)
void	TouchDependenceList (void)

Rotation Order
void	SetRotationOrder ( ROTATIONORDER order)
ROTATIONORDER	GetRotationOrder (void) const

Synchronized Rotation Mode
void	SetQuaternionRotationMode ( Bool active, Bool bUndo)
Bool	IsQuaternionRotationMode (void)
Bool	SynchronizeVectorTrackKeys ( Int32 vectorTrackID, Bool bUndo, BaseTime startRange= BaseTime (-108000, 1), BaseTime endRange= BaseTime (108000, 1))
Bool	FindBestEulerAngle ( Int32 rotationTrackID, Bool bAdjustTangent, Bool bUndo, BaseTime startRange= BaseTime (-108000, 1), BaseTime endRange= BaseTime (108000, 1))
Bool	EvaluateSynchronizedRotation (const BaseTime &time, ANIMATEFLAGS flags, 向量 *resultRotation=nullptr)

杂项
Bool	GetVectorTracks (const DescID &id, CTrack &xfound, CTrack &yfound, CTrack *&zfound)
Bool	GetVectorCurves ( CCurve curveToSearch, CCurve &xfound, CCurve &yfound, CCurve &zfound)
UInt64	GetGUID ()
Int32	GetHighlightHandle ( BaseDraw *bd)
SplineObject *	GetRealSpline (void)
Float	GetVisibility ( Float parent)
Bool	SearchHierarchy ( BaseObject *op)

Private
BaseObject *	GetOrigin ( Bool safe)
void	SetOrigin ( BaseObject *origin)
BaseObject *	GetTopOrigin ( Bool parent, Bool safe)
BaseObject *	GetEditObject ( BaseObject **psds, DISPLAYEDITSTATE state, Bool safetey=true)
void	RemoveFromCache (void)
DRAWRESULT	ObjDraw ( DRAWPASS drawpass, BaseDraw bd, BaseDrawHelp bh)

Additional Inherited Members
Public Member Functions inherited from BaseList2D
const Char *	GetViewportRenderId ( VIEWPORT_RENDER_ID typeId) const
BaseList2D *	GetNext ()
BaseList2D *	GetPred ()
void	SetBit ( Int32 mask)
Bool	GetBit ( Int32 mask) const
void	DelBit ( Int32 mask)
void	ToggleBit ( Int32 mask)
Int32	GetAllBits () const
void	SetAllBits ( Int32 bits)
void	SetBitEx ( Int32 mask, Int32 flags)
BaseContainer	GetData ()
void	SetData (const BaseContainer &bc, Bool add=true)
const BaseContainer *	GetDataInstance () const
BaseContainer *	GetDataInstance ()
const BaseContainer &	GetDataInstanceRef () const
BaseContainer &	GetDataInstanceRef ()
String	GetName () const
void	SetName (const maxon::String &name)
String	GetBubbleHelp ()
Bool	TransferGoal ( BaseList2D *dst, Bool undolink)
Bool	TransferMarker ( BaseList2D *dst) const
Bool	比例 ( Float scale)
Bool	编辑 ()
void	GetIcon ( IconData *dat)
GeListHead *	GetNLARoot ()
BaseList2D *	AnimationLayerRemap ( BaseObject **layer=nullptr)
String	GetTypeName ()
BaseList2D *	GetMain () const
void	InsertTrackSorted ( CTrack *track)
Bool	AddEventNotification ( BaseList2D bl, NOTIFY_EVENT eventid, NOTIFY_EVENT_FLAG flags, const BaseContainer data)
Bool	RemoveEventNotification ( BaseDocument doc, BaseList2D bl, NOTIFY_EVENT eventid)
Bool	FindEventNotification ( BaseDocument doc, BaseList2D bl, NOTIFY_EVENT eventid)
Bool	SetDescIDState (const DescID &id, DESCIDSTATE descidstate)
DESCIDSTATE	GetDescIDState (const DescID &id, Bool tolerant) const
GeListHead *	GetOverrideRoot ()
BaseOverride *	GetFirstOverride ()
GeListHead *	GetShaderRepositoryRoot ()
GeListHead *	GetHiddenShaderRoot ()
maxon::NimbusInterface *	GetNimbusRef (const maxon::Id &spaceId) const
maxon::Result < maxon::NimbusInterface * >	GetOrCreateNimbusRef (const maxon::Id &spaceId)
void	RemoveNimbusRef (const maxon::Id &spaceId)
maxon::Result < maxon::HashMap < maxon::Id , maxon::ForwardRef < maxon::NimbusRef > > >	GetAllNimbusRefs () const
Bool	IsNodeBased () const
void	GetMarkerStampEx ( UInt32 l1, UInt32 l2)
const GeMarker &	GetMarker () const
void	SetMarker (const GeMarker &m)
Bool	AddUniqueID ( Int32 appid, const Char *const mem, Int bytes)
Bool	FindUniqueID ( Int32 appid, const Char *&mem, Int &bytes) const
Int32	GetUniqueIDCount () const
Bool	GetUniqueIDIndex ( Int32 idx, Int32 &id, const Char *&mem, Int &bytes) const
Bool	SetAnimatedParameter ( CTrack *track, const DescID &id, const GeData &t_data1, const GeData &t_data2, Float mix, DESCFLAGS_SET flags)
Bool	GetAnimatedParameter (const DescID &id, GeData &t_data1, GeData &t_data2, Float &mix, DESCFLAGS_GET flags)
BaseShader *	GetFirstShader () const
void	InsertShader ( BaseShader shader, BaseShader pred=nullptr)
void	ClearKeyframeSelection ()
Bool	FindKeyframeSelection (const DescID &id)
Bool	SetKeyframeSelection (const DescID &id, Bool selection)
Bool	KeyframeSelectionContent ()
LayerObject *	GetLayerObject ( BaseDocument *doc)
Bool	SetLayerObject ( LayerObject *layer)
const LayerData *	GetLayerData ( BaseDocument *doc, Bool rawdata=false)
Bool	SetLayerData ( BaseDocument *doc, const LayerData &data)
GeListHead *	GetCTrackRoot ()
CTrack *	GetFirstCTrack ()
CTrack *	FindCTrack (const DescID &id)
Public Member Functions inherited from GeListNode
GeListNode *	GetNext ()
GeListNode *	GetPred ()
GeListNode *	GetDown ()
GeListNode *	GetUp ()
GeListNode *	GetDownLast ()
void	InsertBefore ( GeListNode *bl)
void	InsertAfter ( GeListNode *bl)
void	InsertUnder ( GeListNode *bl)
void	InsertUnderLast ( GeListNode *bl)
void	移除 ()
GeListHead *	GetListHead ()
Int32	GetNodeID ( Int32 index=0) const
template<typename CAST >
const CAST *	GetNodeData ( Int32 index=0) const
template<typename CAST >
CAST *	GetNodeData ( Int32 index=0)
void	SetCustomData ( GeListNode *node)
GeListNode *	GetCustomData ()
BaseDocument *	GetDocument ()
Int32	GetBranchInfo ( BranchInfo *info, Int32 max, GETBRANCHINFO flags)
Bool	IsDocumentRelated ()
Int32	GetInfo ()
Bool	GetNBit ( NBIT bit) const
UInt32	GetNBitMask ( Int32 index) const
Bool	ChangeNBit ( NBIT bit, NBITCONTROL bitmode)
Public Member Functions inherited from C4DAtom
Int32	GetType () const
Int32	GetRealType () const
Int32	GetDiskType () const
Bool	IsInstanceOf ( Int32 id) const
Int32	GetClassification () const
Bool	消息 ( Int32 type, void *data=nullptr)
Bool	MultiMessage ( MULTIMSG_ROUTE flags, Int32 type, void *data)
C4DAtom *	GetClone ( COPYFLAGS flags, AliasTrans *trn)
Bool	CopyTo ( C4DAtom dst, COPYFLAGS flags, AliasTrans trn)
Bool	读取 ( HyperFile *hf, Int32 id, Int32 level)
Bool	Write ( HyperFile *hf)
Bool	ReadObject ( HyperFile *hf, Bool readheader)
Bool	WriteObject ( HyperFile *hf)
Bool	GetDescription ( 描述 *description, DESCFLAGS_DESC flags)
Bool	GetParameter (const DescID &id, GeData &t_data, DESCFLAGS_GET flags)
Bool	SetParameter (const DescID &id, const GeData &t_data, DESCFLAGS_SET flags)
DynamicDescription *	GetDynamicDescription ()
Bool	GetEnabling (const DescID &id, const GeData &t_data, DESCFLAGS_ENABLE flags, const BaseContainer *itemdesc)
Bool	TranslateDescID (const DescID &id, DescID &res_id, C4DAtom *&res_at)
UInt32	GetDirty ( DIRTYFLAGS flags) const
void	SetDirty ( DIRTYFLAGS flags)
UInt32	GetHDirty ( HDIRTYFLAGS mask) const
void	SetHDirty ( HDIRTYFLAGS mask)
Static Public Member Functions inherited from BaseList2D
static BaseList2D *	Alloc ( Int32 type)
static void	Free ( BaseList2D *&bl)
Static Public Attributes inherited from BaseList2D
static const Int32	SETBIT_FLAG_NODIRTY
static const Int32	SETBIT_FLAG_REMOVE

构造函数 & 析构函数文档编制

◆ BaseObject()

BaseObject () private

◆ ~BaseObject()

成员函数文档编制

◆ Alloc()

Allocates a base object. Destroy the allocated base object with Free() 。使用 AutoAlloc to automate the allocation and destruction based on scope.

◆ Free()

Destructs base objects allocated with Alloc() 。使用 AutoAlloc to automate the allocation and destruction based on scope.

◆ GetNext()

◆ GetPred()

◆ GetUp()

Gets the parent object of the list node. Convenience version of GeListNode::GetUp() .

◆ GetDown()

Gets the first child object of the list node. Convenience version of GeListNode::GetDown() .

◆ GetDownLast()

◆ GetAbsPos()

Gets the absolute position of the object.
These are the absolute local coordinates within the parent object.
If the object has no parent then these are world coordinates.

◆ SetAbsPos()

Sets the absolute local position of the object within its parent.
These are the absolute local coordinates within the parent object.
If the object has no parent then these are world coordinates.

◆ GetAbsScale()

Gets the absolute scale of the object.
This is relative to the object's parent if it has one.

◆ SetAbsScale()

Sets the absolute scale of the object.
This is relative to the object's parent if it has one.

◆ GetAbsRot()

Gets the absolute HPB rotation of the object.
This is relative to the object's parent if it has one.

◆ SetAbsRot()

Sets the absolute HPB rotation of the object.
This is relative to the object's parent if it has one.

◆ GetFrozenPos()

◆ SetFrozenPos()

◆ GetFrozenScale()

◆ SetFrozenScale()

◆ GetFrozenRot()

◆ SetFrozenRot()

◆ GetRelPos()

◆ SetRelPos()

◆ GetRelScale()

◆ SetRelScale()

◆ GetRelRot()

◆ SetRelRot()

◆ GetMl()

◆ SetMl()

◆ GetFrozenMln()

◆ GetRelMln()

◆ GetRelMl()

◆ SetRelMl()

◆ GetMg()

Gets the world (global) matrix representing the object's position, scale and rotation.

◆ SetMg()

Sets the world (global) matrix representing the object's position, scale and rotation.

◆ GetMln()

Gets the local normalized matrix representing the object's position, scale and rotation.

◆ GetMgn()

Gets the world (global) normalized matrix representing the object's position, scale and rotation.

◆ GetUpMg()

Gets the world (global) matrix of the parent object representing the parent's position, scale and rotation.
If the object has no parent object then the method returns a unit matrix.

◆ CopyMatrixTo()

◆ GetMp()

◆ GetRad()

◆ GetEditorMode()

◆ GetEditorModeH()

◆ SetEditorMode()

◆ GetRenderMode()

◆ GetRenderModeH()

◆ SetRenderMode()

◆ GetDeformMode()

◆ SetDeformMode()

◆ GetRealDeformMode()

◆ SetRealDeformMode()

◆ GetUniqueIP()

Gets the IP number for the object.
GetUniqueIP() and SetUniqueIP() allow Cinema 4D to identify and track objects between different frames (which is necessary for stuff like object motion blur).

In case of a static generator that is easy: for every frame there is exactly the same structure.
For a particle system however that is different: e.g. there could always be 3 objects (particles), but some might be the same, some might be new ones.
To allow Cinema 4D to track that stuff an IP-like system is used: each object can carry a unique Int32 number and Cinema 4D creates full paths from it, e.g. 5.7.102.43.65.2
This is done 100% internally.

Only generator objects that have variable output or generator objects that use GetHierarchyClone() need to program some extra lines.
Such objects need to set the bit OBJECT_UNIQUEENUMERATION . Then it needs to assign unique Int32 values to all objects returned (except for the top-level object, which is handled by Cinema 4D ).

范例：
A generator has 3 objects, but those objects appear and disappear during time. Say that


obj3

is child of


obj1

;


obj1

and


obj2

are children of


main

(which is returned).


obj2

and


obj3

might not be present:

That is all that is needed. Cinema 4D will recognize which object matches another object at a different time.
若 GetHierarchyClone() is called those objects already have a unique numeration. It is only needed to assign a unique value to the top level:

◆ SetUniqueIP()

◆ GetFirstTag()

◆ GetLastTag()

◆ GetTag()

◆ GetTagsOfType()

◆ GetTagsWithFlags()

◆ GetTagDataR()

Gets a variable tag's readable data of a certain type associated with the object.

◆ GetTagDataW()

Gets a variable tag's writable data of a certain type associated with the object.

◆ GetTagDataCount()

◆ MakeTag()

◆ MakeVariableTag()

◆ InsertTag()

◆ KillTag()

◆ CopyTagsTo()

◆ GetCache()

Gets the object from the previously built cache.
Situations can be quite complex in Cinema 4D . For instance GetCache() could return a list of objects.
For example the default Sweep Generator internally has some built-in caches for the sweep surface and for the caps.
The following helper routine can be used to make things easier. It browses through this rather complex hierarchy of objects and caches recursively:

Remember:
Use the above routine only if the caches are already built. It is for instance not safe to use it in a 命令 plugin since the user can have stopped the scene redraw and the building of caches.

◆ GetDeformCache()

Gets the previously built cache that has been deformed by an active deformer.
It is important to understand the concept how the deformer cache operates.
For each object in the hierarchy that generates a polygonal cache a deformer cache could also have been created by an active deformer object.
A simple example will help to see how this works:

Take the simple hierarchy shown above, the array generator object creates a virtual hierarchy in the cache, this can be retrieved using GetCache() .
This hierarchy is:

From each of the Cube objects a further cache is generated, this time polygonal:

When a deformer becomes active every object/cache object gets a deform cache (if it was a polygonal object). The deformer cache is always polygonal and is only ever a single object.
Important:
The caches are always built after all plugins and expressions have been called.
If the virtual objects have to be accessed to obtain a polygonal based object it is generally advised to call SendModelingCommand() with MCOMMAND_CURRENTSTATETOOBJECT.
This will rebuild the cache for the passed object if needed, and then clone the polygonal objects.
Another possible solution is to use the 层次结构 class, this will give full access to all virtual objects, or can be used to just rebuild the internal caches.
But be aware that rebuilding the internal caches can cause serious overhead, be time consuming and if called too soon in the pipeline, the caches may need to be rebuilt afterwards.

◆ GetIsoparm()

◆ SetIsoparm()

◆ GetCacheParent()

A cache/deform object has no GetUp() link. Instead this method can be called to detect the cache building parent.

◆ GetCacheTopParent()

A cache/deform object has no GetUp() link. Instead this method can be called to detect the top cache building parent.

◆ SetPhong()

Sets the phong smoothing for the object.
Deletes any existing Phong tag. If on 被设为 true it creates a new Phong tag.

◆ IsDirty()

Checks if the object has been changed since the last time the object was touched.

◆ SetDirty()

◆ CheckCache()

Check if cache is built and if it matches the requirements (polygonized/isoparm, level of detail etc.)

◆ Touch()

Marks object to be used by generator. Automatically resets dirty values for use with IsDirty() .

◆ GetColorProperties()

◆ SetColorProperties()

◆ GetModelingAxis()

◆ SetModelingAxis()

◆ GetAndCheckHierarchyClone()

Checks and generates a clone of the child objects of a parent generator.
类似 GetHierarchyClone() except that it checks if the hierarchy is dirty and if not it does not need to generate a new clone.

◆ GetHierarchyClone() [1/2]

◆ GetHierarchyClone() [2/2]

Generates a clone of the child objects of a parent generator. This version accepts dirtyflags 参数。

◆ NewDependenceList()

Starts a new dependence list. Enables to keep track of changes made to any children.

◆ CompareDependenceList()

◆ AddDependence() [1/2]

Adds a child object to the dependence list.
Usually op is a child object used by a generator object.

◆ AddDependence() [2/2]

Adds a child object to the dependence list. This version accepts dirtyflags 参数。

◆ TouchDependenceList()

◆ SetRotationOrder()

◆ GetRotationOrder()

◆ SetQuaternionRotationMode()

◆ IsQuaternionRotationMode()

◆ SynchronizeVectorTrackKeys()

Makes sure that the track Curves component are synchronized (keys on each component). If a component track is found, the other track component will be synchronized.

◆ FindBestEulerAngle()

Tries to find the best Euler Angle according to the previous key. The Object must have keys on each component.

◆ EvaluateSynchronizedRotation()

Forces an evaluation of all rotation tracks and consider Quaternion interpolation. This will directly update attribute values if no vector is specified for resultRotation .

◆ GetVectorTracks()

◆ GetVectorCurves()

◆ GetGUID()

Gets a unique ID for any object in a document.
Works for generated objects in a cache (e.g. clones generated by a MoGraph cloner) and also for 'real' objects in the document ( GetUniqueIP() does not do this).

◆ GetHighlightHandle()

Checks if a highlight handle has been hit.
Returns the handle ID previously given by ObjectData::DetectHandle() . The handle can then be drawn in the highlight mode.

◆ GetRealSpline()

Gets a real spline representation of a primitive spline object.
This can for example be used to calculate the length of a spline.
If the object is a real spline it returns


this

. Otherwise nullptr .

◆ GetVisibility()

Gets the object's visibility value. The range of values are 0.0 <= visibility <= 1.0 .
The object's visibility depends upon its parent, if it has no visibility track this will return the parent's visibility which is passed.

[in]	type	The type of tag to fetch from the object: Tag Types
[in]	nr	Optionally specify a starting tag index to begin the search. If the requested number is not available then nullptr will be returned even if there is a tag of that type with a different index.

[in]	type	The type of tag to fetch the data for: VariableTag Types
[in]	nr	Optionally specify a starting tag index to begin the search.

void* GetTagDataW	(	Int32	type ,
		Int32	nr = `0`
	)

[in]	type	The type of tag to fetch the data for: VariableTag Types
[in]	nr	Optionally specify a starting tag index to begin the search.

[in]	type	The type of tag to create: Tag Types
[in]	pred	The previous tag to insert the tag after, or nullptr if the tag should be inserted at the start of the tag list. The caller owns the pointed tag.

VariableTag * MakeVariableTag	(	Int32	type ,
		Int32	count ,
		BaseTag *	pred = `nullptr`
	)

[in]	type	The type of variable tag to create: VariableTag Types
[in]	count	The data count.
[in]	pred	The previous tag to insert the tag after, or nullptr if the tag should be inserted at the start of the tag list. The caller owns the pointed tag.

[in]	tp	The tag to insert. The object takes over the ownership of the pointed tag.
[in]	pred	The previous tag to insert the tag after, or nullptr if the tag should be inserted at the start of the tag list. The caller owns the pointed tag.

[in]	type	The type of tag to remove: Tag Types
[in]	nr	Optionally specify a starting tag index to begin the search.

Bool CopyTagsTo	(	BaseObject *	dest ,
		Int32	visible ,
		Int32	variable ,
		Int32	hierarchical ,
		AliasTrans *	trans
	)

[in]	dest	The destination object. The caller owns the pointed object.
[in]	visible	true if the tag must be visible, false if it must not be visible or NOTOK if it can be either (if this property does not need to be checked).
[in]	variable	true if the tag must be variable, false if it must not be variable or NOTOK if it can be either (if this property does not need to be checked).
[in]	hierarchical	true if the tag must be hierarchical, false if it must not be hierarchical or NOTOK if it can be either (if this property does not need to be checked).
[in]	trans	An alias translator for the operation. Can be nullptr . The caller owns the pointed alias translator.

[in]	on	false removes the Phong tag from the object. true creates a new Phong tag.
[in]	anglelimit	true if angle should be used.
[in]	angle	The phong angle.

BaseObject * GetAndCheckHierarchyClone	(	HierarchyHelp *	hh ,
		BaseObject *	op ,
		HIERARCHYCLONEFLAGS	flags ,
		Bool *	dirty ,
		AliasTrans *	trans ,
		Bool	allchildren
	)

[in]	hh	Usually passed through from a calling method, for instance from ObjectData::GetVirtualObjects() . The caller owns the pointed hierarchy helper.
[in]	op	The object to start the clone from, usually the first child of the parent object. The caller owns the pointed object.
[in]	flags	The flags for the generation of the cloned chain. The values are: HIERARCHYCLONEFLAGS
[in]	dirty	Assigned the state of any changes to the chain. true if some part of the child objects in the chain has changed, otherwise false .
[in]	trans	An alias translator for the operation. Can be nullptr . The caller owns the pointed alias translator.
[in]	allchildren	true if all children should be used in the check.

BaseObject * GetHierarchyClone	(	HierarchyHelp *	hh ,
		BaseObject *	op ,
		HIERARCHYCLONEFLAGS	flags ,
		Bool *	dirty ,
		AliasTrans *	trans
	)

[in]	hh	Usually passed from a calling method, for example from ObjectData::GetVirtualObjects() . The caller owns the pointed hierarchy help.
[in]	op	The child object to add to the dependence list. Should be a child object used by the generator object. The caller owns the pointed object.

void AddDependence	(	HierarchyHelp *	hh ,
		BaseObject *	op ,
		DIRTYFLAGS	dirtyflags
	)

[in]	active	Enable/Disable the Synchronized Rotation mode for the object.
[in]	bUndo	Add undo to value changed (need to manage start and end externally).

Bool SynchronizeVectorTrackKeys	(	Int32	vectorTrackID ,
		Bool	bUndo ,
		BaseTime	startRange = `BaseTime(-108000, 1)` ,
		BaseTime	endRange = `BaseTime(108000, 1)`
	)

[in]	vectorTrackID	ID of the Vector Track to synchronize.
[in]	bUndo	Add undo to value changed (need to manage start and end externally).
[in]	startRange	Optional start operation at given time.
[in]	endRange	Optional end operation at given time.

Bool FindBestEulerAngle	(	Int32	rotationTrackID ,
		Bool	bAdjustTangent ,
		Bool	bUndo ,
		BaseTime	startRange = `BaseTime(-108000, 1)` ,
		BaseTime	endRange = `BaseTime(108000, 1)`
	)

[in]	rotationTrackID	Rotation Track ID to manage (relative, global, absolute, frozen).
[in]	bAdjustTangent	Try to adjust the tangent with new value, if false auto is used.
[in]	bUndo	Add undo to value changed (need to manage start and end externally).
[in]	startRange	Optional start operation at given time.
[in]	endRange	Optional end operation at given time.

Bool EvaluateSynchronizedRotation	(	const BaseTime &	time ,
		ANIMATEFLAGS	flags ,
		向量 *	resultRotation = `nullptr`
	)

[in]	time	Evaluation time.
[in]	flags	The animate flags: ANIMATEFLAGS
[in]	resultRotation	Optionally store result in Vector instead of updating attributes.

Bool GetVectorTracks	(	const DescID &	id ,
		CTrack *&	xfound ,
		CTrack *&	yfound ,
		CTrack *&	zfound
	)