c4d.BaseList2D

class c4d.BaseList2D

Methods Signatures

Magic Methods

BaseList2D.__init__(self, type)	type type:int
BaseList2D.__str__(self)	Returns the BaseList2D as string. Called if str() is wrapped around an instance of BaseList2D. (See __str__.)

Bit Handler

BaseList2D.DelBit(self, mask)	Deletes the object bits denoted by mask, i.e. sets the corresponding bit to 0.
BaseList2D.GetAllBits(self)	Returns all of the object’s bits.
BaseList2D.GetBit(self, mask)	Gets the state of the object bits denoted by mask.
BaseList2D.SetAllBits(self, mask)	Sets all the object’s bits at once.
BaseList2D.SetBit(self, mask)	Sets the object bits denoted by mask.
BaseList2D.ToggleBit(self, mask)	Toggles the state of the object bits denoted by mask.

Data

BaseList2D.GetData(self)	Returns a copy of the object’s container.
BaseList2D.GetDataInstance(self)	This method returns the original container of the object.
BaseList2D.SetData(self, bc[, add])	Sets the object container.

Keyframes

BaseList2D.ClearKeyframeSelection(self)	Clears the current keyframe selection.
BaseList2D.FindKeyframeSelection(self, id)	Checks if id is included in the keyframe selection.
BaseList2D.KeyframeSelectionContent(self)	Checks if there are any active keyframe selections.
BaseList2D.SetKeyframeSelection(self, id, selection)	Sets the keyframe selection status of id to selection.

Layer

BaseList2D.GetLayerData(self, doc[, rawdata])	Get the layer data for this object.
BaseList2D.GetLayerObject(self, doc)	Get the layer of this object.
BaseList2D.SetLayerData(self, doc, data)	Set the layer data for this object.
BaseList2D.SetLayerObject(self, layer)	Set the layer of this object.

Name and Description

BaseList2D.GetBubbleHelp(self)	Returns the bubble help of the object.
BaseList2D.GetName(self)	Returns the name of the object.
BaseList2D.GetTypeName(self)	The name of the object category, for example Phong, Spline, Bone, etc.
BaseList2D.SetName(self, name)	Set the name of the object.

Private

BaseList2D.AddEventNotification(self, bl, eventid, ...)	Private.
BaseList2D.FindEventNotification(self, doc, bl, eventid)	Private.
BaseList2D.RemoveEventNotification(self, doc, bl, eventid)	Private.

Shader

BaseList2D.GetFirstShader(self)	Returns the first shader of the object.
BaseList2D.InsertShader(self, shader[, pred])	Inserts a shader in the object’s shader list.

Tracks

BaseList2D.FindCTrack(self, id)	Find the track for the specified description id.
BaseList2D.GetCTrackRoot(self)	Returns the track root of the object. To get the tracks of an object use GetCTracks() instead.
BaseList2D.GetCTracks(self)	Returns all CTracks of an object.
BaseList2D.GetFirstCTrack(self)	Returns the first CTrack of the object.
BaseList2D.InsertTrackSorted(self, track)	Inserts a track and automatically places it at the right place (so that Y comes after Y etc.)

User Data

BaseList2D.AddUserData(self, datadescription)	Allocates a new user data and return its ID. Use c4d.GetCustomDataTypeDefault() to create a default container for user data.
BaseList2D.GetUserDataContainer(self)	Browse through the user data container sequence.
BaseList2D.RemoveUserData(self, id)	Removes a userdata element. There are several ways how to delete a user data.
BaseList2D.SetUserDataContainer(self, descid, ...)	Insert a new user data with the specified ID.

Uncategorized

BaseList2D.GetNodeData(self)	Returns the NodeData part of the BaseList2D.
BaseList2D.GetMain(self)	Goes up the next level, e.g. from tag to object or Xpresso node to tag, or object to document, etc.
BaseList2D.GetIcon(self)	Returns the original bitmap pattern.
BaseList2D.GetIconEx(self)	Returns the original bitmap pattern.
BaseList2D.GetInfo(self)	Returns the information flags for the object. The interpretation depends on the object type.
BaseList2D.TransferGoal(self, dst, undolink)	Transfer goals from this object to dst.
BaseList2D.GetNLARoot(self)	Private.
BaseList2D.Scale(self, scale)	Scale the object.
BaseList2D.Edit(self)	Triggers the edit action for this object.

Inheritance

Parent Class:

• c4d.GeListNode

Children Classes:

• c4d.BaseMaterial
• c4d.BaseShader
• c4d.CCurve
• c4d.CTrack
• c4d.BaseTag
• c4d.BaseObject
• c4d.BaseView
• c4d.documents.BaseDocument
• c4d.documents.LayerObject
• c4d.documents.RenderData
• c4d.documents.BaseVideoPost
• c4d.modules.mograph.FieldLayer
• c4d.modules.net.RenderJob
• c4d.modules.bodypaint.PaintBitmap
• c4d.modules.thinkingparticles.TP_PGroup
• c4d.modules.thinkingparticles.TP_MasterSystem
• c4d.modules.sculpting.SculptLayerData
• c4d.modules.graphview.GvNodeMaster
• c4d.modules.graphview.GvNode
• c4d.modules.takesystem.BaseTake
• c4d.modules.takesystem.BaseOverride
• c4d.modules.takesystem.BaseOverrideGroup
• c4d.plugins.BasePlugin

Methods Documentation

BaseList2D.__init__(self, type)

Parameters:type (int) – The id of the object, e.g: (Ocube). See also: Descriptions in Cinema 4D. Return type:c4d.BaseList2D Returns:The new object.

BaseList2D.__str__(self)

Returns the BaseList2D as string. Called if str() is wrapped around an instance of BaseList2D. (See __str__.)

Return type:str Returns:The string representation of BaseList2D.

BaseList2D.DelBit(self, mask)

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

Parameters:mask (int) –

The bit mask of the bits:

BIT_ACTIVE	Active element.
BIT_ACTIVE2	Private.
BIT_ACTIVE3	New in version R17.032: Private.
BIT_MATMARK	Marked material.
BIT_ENABLEPAINT	Enable painting.
BIT_RECALCPREVIEW	Recalculate preview.
BIT_MFOLD	Folded in material manager when used as a Paint Layer in BodyPaint.
BIT_BP_FOLDLAYERS	Fold layers in material manager.
BIT_IGNOREDRAW	Ignore object during draw.
BIT_OFOLD	Folded in a Treeview (e.g. the Layer Manager, for the Object Manager, see NBIT.
BIT_CONTROLOBJECT	Internal bit set by generators.
BIT_RECMARK	Private.
BIT_IGNOREDRAWBOX	Ignore object drawing box.
BIT_EDITOBJECT	Private.
BIT_ACTIVESELECTIONDRAW	Draws active selection.
BIT_TEMPDRAW_VISIBLE_CACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_DEFCACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_CHILD	Private.
BIT_HIGHLIGHT	Private.
BIT_FORCE_UNOPTIMIZED	Private.
BIT_TRACKPROCESSED	Track has been processed, avoid recursions.
BIT_ANIM_OFF	Inactive sequence.
BIT_ANIM_SOLO	Solo track.
BIT_ANIM_CONSTANTVELOCITY	Constant velocity of the track.
BIT_VPDISABLED	Videopost is disabled.
BIT_DOCUMENT_CHECKREWIND	Check rewind.
BIT_ACTIVERENDERDATA	Active render data.

BaseList2D.GetAllBits(self)

Returns all of the object’s bits.

Return type:int Returns:The object’s bits:

BIT_ACTIVE	Active element.
BIT_ACTIVE2	Private.
BIT_ACTIVE3	New in version R17.032: Private.
BIT_MATMARK	Marked material.
BIT_ENABLEPAINT	Enable painting.
BIT_RECALCPREVIEW	Recalculate preview.
BIT_MFOLD	Folded in material manager when used as a Paint Layer in BodyPaint.
BIT_BP_FOLDLAYERS	Fold layers in material manager.
BIT_IGNOREDRAW	Ignore object during draw.
BIT_OFOLD	Folded in a Treeview (e.g. the Layer Manager, for the Object Manager, see NBIT.
BIT_CONTROLOBJECT	Internal bit set by generators.
BIT_RECMARK	Private.
BIT_IGNOREDRAWBOX	Ignore object drawing box.
BIT_EDITOBJECT	Private.
BIT_ACTIVESELECTIONDRAW	Draws active selection.
BIT_TEMPDRAW_VISIBLE_CACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_DEFCACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_CHILD	Private.
BIT_HIGHLIGHT	Private.
BIT_FORCE_UNOPTIMIZED	Private.
BIT_TRACKPROCESSED	Track has been processed, avoid recursions.
BIT_ANIM_OFF	Inactive sequence.
BIT_ANIM_SOLO	Solo track.
BIT_ANIM_CONSTANTVELOCITY	Constant velocity of the track.
BIT_VPDISABLED	Videopost is disabled.
BIT_DOCUMENT_CHECKREWIND	Check rewind.
BIT_ACTIVERENDERDATA	Active render data.

BaseList2D.GetBit(self, mask)

Gets the state of the object bits denoted by mask.

Parameters:mask (int) –

The bit mask of the bits:

BIT_ACTIVE	Active element.
BIT_ACTIVE2	Private.
BIT_ACTIVE3	New in version R17.032: Private.
BIT_MATMARK	Marked material.
BIT_ENABLEPAINT	Enable painting.
BIT_RECALCPREVIEW	Recalculate preview.
BIT_MFOLD	Folded in material manager when used as a Paint Layer in BodyPaint.
BIT_BP_FOLDLAYERS	Fold layers in material manager.
BIT_IGNOREDRAW	Ignore object during draw.
BIT_OFOLD	Folded in a Treeview (e.g. the Layer Manager, for the Object Manager, see NBIT.
BIT_CONTROLOBJECT	Internal bit set by generators.
BIT_RECMARK	Private.
BIT_IGNOREDRAWBOX	Ignore object drawing box.
BIT_EDITOBJECT	Private.
BIT_ACTIVESELECTIONDRAW	Draws active selection.
BIT_TEMPDRAW_VISIBLE_CACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_DEFCACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_CHILD	Private.
BIT_HIGHLIGHT	Private.
BIT_FORCE_UNOPTIMIZED	Private.
BIT_TRACKPROCESSED	Track has been processed, avoid recursions.
BIT_ANIM_OFF	Inactive sequence.
BIT_ANIM_SOLO	Solo track.
BIT_ANIM_CONSTANTVELOCITY	Constant velocity of the track.
BIT_VPDISABLED	Videopost is disabled.
BIT_DOCUMENT_CHECKREWIND	Check rewind.
BIT_ACTIVERENDERDATA	Active render data.

Return type:bool Returns:The state of the object bits.

BaseList2D.SetAllBits(self, mask)

Sets all the object’s bits at once.

Parameters:mask (int) –

The object’s bits to set:

BIT_ACTIVE	Active element.
BIT_ACTIVE2	Private.
BIT_ACTIVE3	New in version R17.032: Private.
BIT_MATMARK	Marked material.
BIT_ENABLEPAINT	Enable painting.
BIT_RECALCPREVIEW	Recalculate preview.
BIT_MFOLD	Folded in material manager when used as a Paint Layer in BodyPaint.
BIT_BP_FOLDLAYERS	Fold layers in material manager.
BIT_IGNOREDRAW	Ignore object during draw.
BIT_OFOLD	Folded in a Treeview (e.g. the Layer Manager, for the Object Manager, see NBIT.
BIT_CONTROLOBJECT	Internal bit set by generators.
BIT_RECMARK	Private.
BIT_IGNOREDRAWBOX	Ignore object drawing box.
BIT_EDITOBJECT	Private.
BIT_ACTIVESELECTIONDRAW	Draws active selection.
BIT_TEMPDRAW_VISIBLE_CACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_DEFCACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_CHILD	Private.
BIT_HIGHLIGHT	Private.
BIT_FORCE_UNOPTIMIZED	Private.
BIT_TRACKPROCESSED	Track has been processed, avoid recursions.
BIT_ANIM_OFF	Inactive sequence.
BIT_ANIM_SOLO	Solo track.
BIT_ANIM_CONSTANTVELOCITY	Constant velocity of the track.
BIT_VPDISABLED	Videopost is disabled.
BIT_DOCUMENT_CHECKREWIND	Check rewind.
BIT_ACTIVERENDERDATA	Active render data.

BaseList2D.SetBit(self, mask)

Sets the object bits denoted by mask.

Parameters:mask (int) –

The bit mask of the bits:

BIT_ACTIVE	Active element.
BIT_ACTIVE2	Private.
BIT_ACTIVE3	New in version R17.032: Private.
BIT_MATMARK	Marked material.
BIT_ENABLEPAINT	Enable painting.
BIT_RECALCPREVIEW	Recalculate preview.
BIT_MFOLD	Folded in material manager when used as a Paint Layer in BodyPaint.
BIT_BP_FOLDLAYERS	Fold layers in material manager.
BIT_IGNOREDRAW	Ignore object during draw.
BIT_OFOLD	Folded in a Treeview (e.g. the Layer Manager, for the Object Manager, see NBIT.
BIT_CONTROLOBJECT	Internal bit set by generators.
BIT_RECMARK	Private.
BIT_IGNOREDRAWBOX	Ignore object drawing box.
BIT_EDITOBJECT	Private.
BIT_ACTIVESELECTIONDRAW	Draws active selection.
BIT_TEMPDRAW_VISIBLE_CACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_DEFCACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_CHILD	Private.
BIT_HIGHLIGHT	Private.
BIT_FORCE_UNOPTIMIZED	Private.
BIT_TRACKPROCESSED	Track has been processed, avoid recursions.
BIT_ANIM_OFF	Inactive sequence.
BIT_ANIM_SOLO	Solo track.
BIT_ANIM_CONSTANTVELOCITY	Constant velocity of the track.
BIT_VPDISABLED	Videopost is disabled.
BIT_DOCUMENT_CHECKREWIND	Check rewind.
BIT_ACTIVERENDERDATA	Active render data.

BaseList2D.ToggleBit(self, mask)

Toggles the state of the object bits denoted by mask.

Parameters:mask (int) –

The bit mask of the bits:

BIT_ACTIVE	Active element.
BIT_ACTIVE2	Private.
BIT_ACTIVE3	New in version R17.032: Private.
BIT_MATMARK	Marked material.
BIT_ENABLEPAINT	Enable painting.
BIT_RECALCPREVIEW	Recalculate preview.
BIT_MFOLD	Folded in material manager when used as a Paint Layer in BodyPaint.
BIT_BP_FOLDLAYERS	Fold layers in material manager.
BIT_IGNOREDRAW	Ignore object during draw.
BIT_OFOLD	Folded in a Treeview (e.g. the Layer Manager, for the Object Manager, see NBIT.
BIT_CONTROLOBJECT	Internal bit set by generators.
BIT_RECMARK	Private.
BIT_IGNOREDRAWBOX	Ignore object drawing box.
BIT_EDITOBJECT	Private.
BIT_ACTIVESELECTIONDRAW	Draws active selection.
BIT_TEMPDRAW_VISIBLE_CACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_DEFCACHECHILD	Private.
BIT_TEMPDRAW_VISIBLE_CHILD	Private.
BIT_HIGHLIGHT	Private.
BIT_FORCE_UNOPTIMIZED	Private.
BIT_TRACKPROCESSED	Track has been processed, avoid recursions.
BIT_ANIM_OFF	Inactive sequence.
BIT_ANIM_SOLO	Solo track.
BIT_ANIM_CONSTANTVELOCITY	Constant velocity of the track.
BIT_VPDISABLED	Videopost is disabled.
BIT_DOCUMENT_CHECKREWIND	Check rewind.
BIT_ACTIVERENDERDATA	Active render data.

BaseList2D.GetData(self)

Returns a copy of the object’s container.

Return type:c4d.BaseContainer Returns:The container reference.

BaseList2D.GetDataInstance(self)

This method returns the original container of the object.

The container is only alive as long as the host object is alive.

If you access the container even the host object is dead, Python will raise a ReferenceError.

The elements of the container are type protected when you set touch them via GeListNode.__setitem__(),

that means, you can just overwrite an element with a new object when its of the same type. When you want to overwrite the element with another type, you need to delete the previous element

with del(bc[ELEMENT_ID]), or use the manual BaseContainer.Set* methods.

Raises:

• ReferenceError – If the container is dead. The container is just alive as long as the host object is alive. Access to a dead container leads to this error.
• TypeError – When you set an element of the wrong expected type.

Return type:

c4d.BaseContainer

Returns:

The original container reference.

BaseList2D.SetData(self, bc, add=True)

Sets the object container.

By default the contents of bc are merged with the existing container.

You can control this behavior with add.

Note

Do not forget to send a C4DAtom.Message() if you change any settings.

Parameters:

• bc (c4d.BaseContainer) – The container.
• add (bool) – If this is True the values are merged, otherwise the old values are discarded.

Return type:

c4d.BaseContainer

Returns:

The container reference.

BaseList2D.ClearKeyframeSelection(self)

Clears the current keyframe selection.

BaseList2D.FindKeyframeSelection(self, id)

Checks if id is included in the keyframe selection.

Parameters:id (c4d.DescID) – The description ID to check. Return type:bool Returns:True if the given id is selected, otherwise False.

BaseList2D.KeyframeSelectionContent(self)

Checks if there are any active keyframe selections.

Note

This is not the same as BIT_ACTIVE, it is the possibility to restrict autokeyframing to certain description parameters.

See “Animation->Add Keyframe Selection” in the Attributes Manager.

Return type:bool Returns:True if there is a keyframe selection, otherwise False.

BaseList2D.SetKeyframeSelection(self, id, selection)

Sets the keyframe selection status of id to selection.

Parameters:id (c4d.DescID) – The description ID to set. Returns:True to select the key, otherwise id is selected, otherwise False.

BaseList2D.GetLayerData(self, doc, rawdata=False)

Get the layer data for this object.

Changed in version R21: xref added to the dictionary.

Parameters:

• doc (c4d.documents.BaseDocument) – The document.
• rawdata (bool) – Usually GetLayerData() takes special global modes like SOLO Layer automatically into account. But if you want to see the original layer values without any additional global changes you can set rawdata to True to get them.

Return type:

dict{solo: bool, view: bool, render: bool, manager: bool, locked: bool, generators: bool, expressions: bool, animation: bool, color: Vector, xref: bool}

BaseList2D.GetLayerObject(self, doc)

Get the layer of this object.

Parameters:doc (c4d.documents.BaseDocument) – The document. Return type:c4d.documents.LayerObject Returns:The layer.

BaseList2D.SetLayerData(self, doc, data)

Set the layer data for this object.

Changed in version R21: xref added to the dictionary.

Parameters:

• doc (c4d.documents.BaseDocument) – The document.
• data (dict{solo: bool, view: bool, render: bool, manager: bool, locked: bool, generators: bool, expressions: bool, animation: bool, color: c4d.Vector, xref: bool}) – The new layer data. it is possible to leave values in the dictionary out.

Return type:

bool

Returns:

True if successful, otherwise False.

BaseList2D.SetLayerObject(self, layer)

Set the layer of this object.

Parameters:layer (c4d.documents.LayerObject) –

The new layer.

Changed in version R18.020: Can be None.

Return type:bool Returns:True if successful, otherwise False.

BaseList2D.GetBubbleHelp(self)

Returns the bubble help of the object.

Return type:str Returns:The bubble help.

BaseList2D.GetName(self)

Returns the name of the object.

Return type:str Returns:The name.

BaseList2D.GetTypeName(self)

The name of the object category, for example Phong, Spline, Bone, etc.

Return type:str Returns:The type name.

BaseList2D.SetName(self, name)

Set the name of the object.

Parameters:name (str) – Set the name.

BaseList2D.AddEventNotification(self, bl, eventid, flags, data)

Private.

BaseList2D.FindEventNotification(self, doc, bl, eventid)

Private.

BaseList2D.RemoveEventNotification(self, doc, bl, eventid)

Private.

BaseList2D.GetFirstShader(self)

Returns the first shader of the object.

Note

Normally you don’t have to deal with this list. But if you want to create or modify shader trees via the API you need to read the following lines:

• If you are programming shader links you need 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 a 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 tag.InsertShader().
• Example 2: A shader (A) references another shader (B): shader B must be a child of shader A.

Return type:c4d.BaseList2D Returns:The first shader of the object, or None if there is no shader.

BaseList2D.InsertShader(self, shader, pred=None)

Inserts a shader in the object’s shader list.

import c4d

mat = doc.GetFirstMaterial()
if mat is None: return False

shd = c4d.BaseList2D(c4d.Xbitmap)

mat[c4d.MATERIAL_COLOR_SHADER] = shd
mat.InsertShader(shd)
mat.Message(c4d.MSG_UPDATE)
mat.Update(True, True)

c4d.EventAdd()

Parameters:

• shader (c4d.BaseList2D) – The shader to insert.
• pred (c4d.BaseList2D) – The shader to insert the new shader after, or None to insert the new shader first. This shader must already be inserted into the list.

BaseList2D.FindCTrack(self, id)

Find the track for the specified description id.

Parameters:id (c4d.DescID) – The description ID to check. Return type:c4d.CTrack Returns:The track found, or None if there was no match.

BaseList2D.GetCTrackRoot(self)

Returns the track root of the object. To get the tracks of an object use GetCTracks() instead.

Return type:c4d.GeListHead Returns:The track root if there is one, otherwise None.

Changed in version R19.

The function now returns a c4d.GeListHead object.

BaseList2D.GetCTracks(self)

Returns all CTracks of an object.

Return type:list of type CTrack Returns:The CTrack.

BaseList2D.GetFirstCTrack(self)

Returns the first CTrack of the object.

Return type:c4d.CTrack Returns:The first track, or None if there are no tracks.

BaseList2D.InsertTrackSorted(self, track)

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

Parameters:track (c4d.CTrack) – The track to insert.

BaseList2D.AddUserData(self, datadescription)

Allocates a new user data and return its ID. Use c4d.GetCustomDataTypeDefault() to create a default container for user data.

import c4d

def AddLongDataType(obj):
    if obj is None: return

    bc = c4d.GetCustomDataTypeDefault(c4d.DTYPE_LONG) # Create default container
    bc[c4d.DESC_NAME] = "Test"                        # Rename the entry

    element = obj.AddUserData(bc)     # Add userdata container
    obj[element] = 30                 # Assign a value
    c4d.EventAdd()                    # Update

Parameters:datadescription (c4d.BaseContainer) – Settings of the new user data. See Description for more information on the description IDs. Return type:c4d.DescID Returns:The description ID. The first level is c4d.DESCID_DYNAMICSUB.

BaseList2D.GetUserDataContainer(self)

Browse through the user data container sequence.

for id, bc in op.GetUserDataContainer():
    print id, bc

Return type:list[(DescID, BaseContainer),] Returns:A list of tuples with the Description ID and container for each user data.

BaseList2D.RemoveUserData(self, id)

Removes a userdata element. There are several ways how to delete a user data.

This function supports several types to identify a user data entry.

obj.RemoveUserData(1)  # removes the first user data
obj.RemoveUserData([c4d.ID_USERDATA, 1])
obj.RemoveUserData(c4d.DescID(c4d.DescLevel(c4d.ID_USERDATA), c4d.DescLevel(1)))

Parameters:id (Union[int, List[int], c4d.DescID]) – The id of the userdata. Return type:bool Returns:True if the userdata is removed, otherwise False.

BaseList2D.SetUserDataContainer(self, descid, datadescription)

Insert a new user data with the specified ID.

Parameters:

• descid (c4d.DescID) – ID of the new user data.
• datadescription (c4d.BaseContainer) – Settings to the new user data. See Description for more information on the description IDs.

Return type:

True if the user data was inserted, otherwise False.

BaseList2D.GetNodeData(self)

Returns the NodeData part of the BaseList2D.

Note

Only Python defined node.

Return type:any Returns:The established NodeData.

BaseList2D.GetMain(self)

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

Return type:c4d.BaseList2D Returns:The main object of this object or None.

BaseList2D.GetIcon(self)

Returns the original bitmap pattern.

Warning

Please, never edit the returned bitmap - read only.

An example

icon = obj.GetIcon()
print icon["bmp"], icon["x"], icon["y"], icon["w"], icon["h"]

Return type:dict{bmp: BaseBitmap, x: int, y: int, w: int, h: int} Returns:The image and size information like height, width and X/Y position in the icon table.

BaseList2D.GetIconEx(self)

Returns the original bitmap pattern.

Note

Similar to BaseList2D.GetIcon() but instead returns a c4d.IconData.

Warning

Please, never edit the returned bitmap - read only.

Return type:c4d.IconData Returns:The image and size information like height, width and X/Y position in the icon table.

BaseList2D.GetInfo(self)

Returns the information flags for the object. The interpretation depends on the object type.

When a BaseList2D is registered, some behaviors have to be defined (e.g. for an object, it might be a generator, a modifier, etc…)

This is done through Flags, and GetInfo returns these flags.

if bl2D.GetInfo() & c4d.OBJECT_MODIFIER:
    print " This bl2D is an object modifier"

Return type:int Returns:The flags. This is the same as the info parameter of the registration function of the registration function of the NodeData.

BaseList2D.TransferGoal(self, dst, undolink)

Transfer goals from this object to dst.

This changes all internal links that point to this object to point to dst instead.

Parameters:

• dst (c4d.BaseList2D) – The destination
• undolink (bool) – This has to be set to False. Private.

BaseList2D.GetNLARoot(self)

Private.

BaseList2D.Scale(self, scale)

Scale the object.

Parameters:scale (float) – The size.

BaseList2D.Edit(self)

Triggers the edit action for this object.

Note

For most types this brings up the node in the attributes manager.

Some still show a separate dialog.

Return type:bool Returns:False if an error occurred, otherwise True.