就业培训     下载中心     Wiki     联络 登录   注册

---

1. 首页
2. C4D R23.110 C++ SDK

私有成员函数 | 所有成员列表

BaseList2D Class Reference

#include <c4d_baselist.h>

Inheritance diagram for BaseList2D:

[ legend ]

详细描述

Represents a C4DAtom that resides in a 2D list.

注意

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

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

Alloc/Free
static BaseList2D *	Alloc ( Int32 type)
static void	Free ( BaseList2D *&bl)
const Char *	GetViewportRenderId ( VIEWPORT_RENDER_ID typeId) const

导航
BaseList2D *	GetNext ()
BaseList2D *	GetPred ()

Bit
static const Int32	SETBIT_FLAG_NODIRTY
static const Int32	SETBIT_FLAG_REMOVE
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)

Container
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

Marker
void	GetMarkerStampEx ( UInt32 *l1, UInt32 *l2)
const GeMarker &	GetMarker () const
void	SetMarker (const GeMarker &m)

Unique ID
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

Animated Parameter
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)

Keyframe
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)

Track
GeListHead *	GetCTrackRoot ()
CTrack *	GetFirstCTrack ()
CTrack *	FindCTrack (const DescID &id)

Additional Inherited Members
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)

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

◆  BaseList2D()

BaseList2D () private

◆  ~BaseList2D()

成员函数文档编制

◆  Alloc()

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

参数

[in]

type

A node type ID.

◆  Free()

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

参数

[in,out]

bl

The base list node to destruct. If the pointer is nullptr nothing happens. The pointer is assigned nullptr afterwards.

◆  GetViewportRenderId()

Gets the Id of the viewport render object. The return value can be nullptr.

参数

[in]

typeId

Defines which Id to return.

返回

The viewport render Id.

◆  GetNext()

Gets the next BaseList2D in the list. Convenience version of GeListNode::GetNext() .

返回

The next BaseList2D ，或 nullptr if there is none. Cinema 4D owns the pointed BaseList2D .

◆  GetPred()

Gets the previous BaseList2D in the list. Convenience version of GeListNode::GetPred() .

返回

The previous BaseList2D ，或 nullptr if there is none. Cinema 4D owns the pointed BaseList2D .

◆  SetBit()

Sets the bits denoted by mask to true .

参数

[in]

mask

The mask of the bits: BIT

◆  GetBit()

Gets the state of the object bits denoted by mask .

参数

[in]

mask

The mask of the bits: BIT

返回

The state of the object bits denoted by mask .

◆  DelBit()

Deletes the object bits denoted by mask , i.e. sets the corresponding bit to 0 .

参数

[in]

mask

The bit mask of the bits: BIT

◆  ToggleBit()

Toggles the state of the object bits denoted by the mask .

参数

[in]

mask

The bit mask of the bits: BIT

◆  GetAllBits()

Returns all the object's bits.

返回

All the object's bits: BIT

◆  SetAllBits()

Sets all the object's bits at once.

参数

[in]

bits

The new object's bits.

◆  SetBitEx()

◆  GetData()

Retrieves a copy of the object's container.

注意

Some objects do not store all their data in the container. For these use GetParameter() /SetParameter() instead.
Here are some built-in objects that do not store everything in the container:

• CompositingTag
• DisplayTag
• ValueKey
• TextureTag
• KinematicTag
• UVWTag
• LightObject
• MetaballTag

There are also often some other pieces of information that are not stored in the container, for example:

• a BaseList2D 's name.
• a CameraObject 's FOV (which is used just for display).

Most of this information is accessible through other API functions, like for example BaseList2D::GetName() .

返回

The object container.

◆  SetData()

Sets the object container.
By default the contents of bc is added to the existing container; control this behavior with add .

注意

Do not forget to send a message if you change any settings.

参数

[in]	bc	The container with the new values.
[in]	add	若 false the values are merged, otherwise the old values are discarded.

◆  GetDataInstance() [1/2]

Retrieves a pointer to the read-only object container.

另请参阅

GetData()

返回

A pointer to the read-only internal container. The node owns the pointed container.

注意

The returned pointer is guaranteed to be valid and never nullptr .

◆  GetDataInstance() [2/2]

Retrieves a pointer to the object container that can be changed directly.

另请参阅

GetData()

返回

A pointer to the internal container. The node owns the pointed container.

注意

The returned pointer is guaranteed to be valid and never nullptr .

◆  GetDataInstanceRef() [1/2]

Retrieves a reference to the read-only object container.

由于

R19

另请参阅

GetData()

返回

A reference to the read-only internal container. The node owns the referenced container.

◆  GetDataInstanceRef() [2/2]

Retrieves a reference to the object container that can be changed directly.

由于

R19

另请参阅

GetData()

返回

A reference to the internal container. The node owns the referenced container.

◆  GetName()

Gets the name of the object.

返回

The object's name.

◆  SetName()

Sets the name of the object.

参数

[in]

name

The new object's name.

◆  GetBubbleHelp()

Gets the bubble help text for the object.

返回

The bubble help text.

◆  TransferGoal()

Transfer goals from the object to dst .
This changes all BaseLink links that point to this object to point to dst instead.

参数

[in]	dst	The destination. The caller owns the pointed object.
[in]	undolink	This has to be set to false . Private.

返回

true if the goals could be transfered, otherwise false .

◆  TransferMarker()

Private .

◆  GetMarkerStampEx()

Deprecated .

◆  GetMarker()

Gets the object's marker.

返回

The object's marker.

◆  SetMarker()

Sets the object's marker.

参数

[in]

m

The new object's marker.

◆  AddUniqueID()

Adds a unique application ID data to the object.

注意

This is used for instance to identify scenes written by external applications.

参数

[in]	appid	A unique application ID. It has to be registered at MAXON, at least it should be obtained from http://www.plugincafe.com .
[in]	mem	A pointer to a block of memory, used for instance to store the name of a software vendor.
[in]	bytes	The length of the memory block mem .

返回

true if successful, otherwise false .

◆  FindUniqueID()

Checks for a specific unique application ID data.

注意

This is used for instance to identify scenes written by external applications.

参数

[in]	appid	A unique application ID. It has to be registered at MAXON, at least it should be obtained from http://www.plugincafe.com .
[out]	mem	Assigned a pointer to a block of memory, used for instance to read the name of a software vendor.
[out]	bytes	Assigned the length of the memory block mem .

返回

true if the ID could be found, otherwise false .

◆  GetUniqueIDCount()

Gets the number of unique application IDs.

返回

The number of unique application IDs.

◆  GetUniqueIDIndex()

Gets the idx -th unique application ID data ( idx ranging from 0 to GetUniqueIDCount() -1).

注意

This is used for instance to identify scenes written by external applications.

参数

[in]	idx	The unique ID index.
[out]	id	Assigned the unique application ID.
[out]	mem	Assigned a pointer to a block of memory, used for instance to read the name of a software vendor.
[out]	bytes	Assigned the length of the memory block mem .

返回

true if successful, otherwise false .

◆  SetAnimatedParameter()

Normally not used. Used by the animator to set the interpolated value along with the right and left value.

参数

[in]	track	The animation track. The caller owns the pointed track.
[in]	id	The ID of the animated parameter.
[in]	t_data1	The first data.
[in]	t_data2	The second data.
[in]	mix	The mix value between t_data1 and t_data2 .
[in]	flags	Flags: DESCFLAGS_SET

返回

true if the animated parameter was set, otherwise false .

◆  GetAnimatedParameter()

If a parameter is set to MIX animation use this function to retrieve information about it.
For example, the target expression has a link to its current target and when it is animated it slides between the two targets:

参数

[in]	id	The ID of the parameter.
[in]	t_data1	Assigned the first data.
[in]	t_data2	Assigned the second data.
[in]	mix	Assigned the mix value between t_data1 and t_data2 .
[in]	flags	Flags: DESCFLAGS_GET

返回

true if the animated parameter was retrieved, otherwise false .

◆  Scale()

Sets the object's scale.
This will scale all parameters with length units by the factor scale.

参数

[in]

scale

The scale factor.

返回

true if the object was scaled successfully, otherwise false .

◆  GetFirstShader()

Retrieves the first shader of the object.

注意

Normally you do not have to deal with the shader list. But if you want to create or modify shader trees via the API read the following lines:
If you are programming shader links to make sure that every shader is referenced only once; it is not allowed that a shader is referenced multiple times.
If the referencing object is a shader the referenced shader must be child of it, otherwise it must be inserted via InsertShader() .

Example 1: A tag references a shader. The shader must be inserted into the tag using InsertShader() ;. Example 2: A Shader (A) references another shader (B): the shader B must be child of the shader A.

返回

The first shader of the object, or nullptr if there are none. The object owns the pointed shader.

◆  InsertShader()

Inserts a shader in the object's shader list.

参数

[in]	shader	The shader to insert. The object takes over the ownership of the pointed shader.
[in]	pred	The shader to insert the new shader after, or nullptr (default)to insert the new shader first. The pointed shader must already be inserted into the list.

◆  Edit()

Triggers the edit action for the object.

注意

For most types this brings up the node in the attributes manager. Some still show a separate dialog.

返回

true if successful, otherwise false .

◆  GetIcon()

Gets the icon for the object, by filling dat .

参数

[out]

dat

Pointer to the icon data to fill. The caller owns the pointed icon data.

◆  ClearKeyframeSelection()

Clears the current keyframe selection.

◆  FindKeyframeSelection()

Checks if id is included in the keyframe selection.

参数

[in]

id

The description ID to check.

返回

true if the given id is selected, otherwise false .

◆  SetKeyframeSelection()

Sets the keyframe selection status of id to selection.

参数

[in]	id	The description ID to set.
[in]	selection	true if the element should be included in the keyframe selection, otherwise false .

返回

A value that should be ignored.

◆  KeyframeSelectionContent()

Checks if there is any active keyframe selections.

注意

This is not the same as BIT_ACTIVE ; it is the possibility to restrict auto-keyframing to certain description parameters.
See "Animation->Add Keyframe Selection" in the Attribute Manager.

返回

true if there is a keyframe selection, otherwise false .

◆  GetLayerObject()

Gets the layer of the object.

参数

[in]

doc

The document for the operation.

返回

The layer, or nullptr .

◆  SetLayerObject()

Sets the layer of the object.

参数

[in]

layer

The new layer.

返回

true if the layer was successfully set, otherwise false .

◆  GetLayerData()

Gets the layer data for the object.

参数

[in]	doc	The document for the operation.
[in]	rawdata	Usually GetLayerData() takes special global modes like SOLO layer automatically into account. To get the original layer values without any additional global changes set rawdata to true .

返回

The layer data, or nullptr .

◆  SetLayerData()

Sets the layer data for the object.

参数

[in]	doc	The document for the operation.
[in]	data	The new layer data.

返回

true if the layer data was successfully set, otherwise false .

◆  GetCTrackRoot()

Gets the track root of the object.

返回

The track root.

◆  GetFirstCTrack()

Gets the first track of the object.

返回

The first track, or nullptr if there are no tracks.

◆  FindCTrack()

Finds the track for the specified description id .

参数

[in]

id

The description ID for the searched track.

返回

The found track, or nullptr if there was no match.

◆  GetNLARoot()

Private .

◆  AnimationLayerRemap()

Retrieves a remapped base list pointer if an active animation layer is existent.
If there is no active layer or no layer at all this will be returned.
Optionally access the layer by passing layer .

参数

[out]

layer

The current active layer. You can then access the layer properties. Cinema 4D owns the pointed layer object.

返回

The remapped base list pointer. This is the object of the current active layer. Cinema 4D owns the pointed layer object.

◆  GetTypeName()

The name of the object type, for example "Phong" , "Spline" , "Bone" ，等。

返回

The type name.

◆  GetMain()

Goes up the next level, e.g. from tag to object or XPresso node to tag, or object to document, etc.

返回

The main object of the object.

◆  InsertTrackSorted()

Inserts a track and automatically places it at the right place (so that Y comes after X for example).

参数

[in]

track

The track to insert.

◆  AddEventNotification()

Private .

◆  RemoveEventNotification()

Private .

◆  FindEventNotification()

Private .

◆  SetDescIDState()

Sets the state for the description id .

参数

[in]	id	The description ID.
[in]	descidstate	The new description ID state: DESCIDSTATE

返回

true if the description ID state was successfully set, otherwise false .

◆  GetDescIDState()

Gets the state of a description id .

参数

[in]	id	The description ID.
[in]	tolerant	若设为 true a valid state is returned even though the description ID do not match-completly. This can be useful for descriptions with several levels. Take this description ID for example: DescID ( DescLevel (1000, DTYPE_VECTOR , 0), DescLevel (1, DTYPE_REAL , 0)) 若 tolerant is true a valid state is returned even though only the following description ID is passed: DescID ( DescLevel (1000, DTYPE_VECTOR , 0))

返回

The description ID state: DESCIDSTATE

◆  GetOverrideRoot()

Private .

由于

R17.032

◆  GetFirstOverride()

Private .

由于

R17.032

◆  GetShaderRepositoryRoot()

Private .

由于

R17.032

◆  GetHiddenShaderRoot()

Private .

◆  GetNimbusRef()

Private .

◆  GetOrCreateNimbusRef()

Private .

◆  RemoveNimbusRef()

Private .

◆  GetAllNimbusRefs()

Private .

◆  IsNodeBased()

Checks whether the object contains nodes.

返回

True if node-based.

Member Data Documentation

◆  SETBIT_FLAG_NODIRTY

Private .

◆  SETBIT_FLAG_REMOVE

• BaseList2D