c4d.GeListNode

class c4d.GeListNode
The base class of many other classes.
This class is also a linked list which enables you to link several objects with each other.

Methods Signatures

Magic Methods

GeListNode.__setitem__(self, key, value) Uses a description ID as a key into the container, and stores the specified data.
GeListNode.__getitem__(self, key) Uses a description ID as a key into the container, and retrieves the stored data.

Hierarchy Navigation Methods

GeListNode.GetChildren(self) Returns children in a list (not grandchild).
GeListNode.GetDown(self) Returns the first child of this object in the list.
GeListNode.GetDownLast(self) Returns the last child of this object in the list.
GeListNode.GetNext(self) Returns the next object in the list.
GeListNode.GetPred(self) Returns the previous object in the list.
GeListNode.GetUp(self) Returns the parent object.

Insertion Methods

GeListNode.InsertAfter(self, obj) Insert self after obj.
GeListNode.InsertBefore(self, obj) Insert self before obj.
GeListNode.InsertUnder(self, obj) Insert self under obj.
GeListNode.InsertUnderLast(self, obj) Insert self as the last child of obj.

N-Bit Methods

GeListNode.ChangeNBit(self, bit, bitmode) Sets bits in the 64-bit bitfield of the node.
GeListNode.GetNBit(self, bit) Raw access to a 64-bit bitfield, containing information about the node state.

Uncategorized

GeListNode.Remove(self) Removes this node from a list.
GeListNode.GetDocument(self) Get the document for this node.
GeListNode.GetListHead(self) Returns the list head.
GeListNode.GetBranchInfo(self[, flags]) Returns information about which other nodes the node contains. For example objects contain tags.
GeListNode.IsDocumentRelated(self) Checks if the node is of a type that can be inserted into a BaseDocument

Inheritance

Inheritance

Parent Class:

Children Classes:

Methods Documentation

GeListNode.__setitem__(self, key, value)

Uses a description ID as a key into the container, and stores the specified data.

Note

Has to be used to set an object’s parameters data.
Its corresponding function of the C++ API is C4DAtom::SetParameter().
Parameters:
GeListNode.__getitem__(self, key)

Uses a description ID as a key into the container, and retrieves the stored data.

Note

Has to be used to get an object’s parameters data. Its corresponding function of the C++ API is C4DAtom::GetParameter().

Parameters:key (Union[int, list, c4d.DescID]) – The description ID.
Return type:Any
Returns:See __setitem__()
GeListNode.GetChildren(self)

Returns children in a list (not grandchild).

Return type:list of type GeListNode
Returns:All children in a list.
GeListNode.GetDown(self)

Returns the first child of this object in the list.

Return type:c4d.GeListNode or None
Returns:The first child object.
GeListNode.GetDownLast(self)

Returns the last child of this object in the list.

Return type:c4d.GeListNode or None
Returns:The first child object.
GeListNode.GetNext(self)

Returns the next object in the list.

Return type:c4d.GeListNode or None
Returns:The next object.
GeListNode.GetPred(self)

Returns the previous object in the list.

Return type:c4d.GeListNode or None
Returns:The previous object.
GeListNode.GetUp(self)

Returns the parent object.

Return type:c4d.GeListNode or None
Returns:The parent object.
GeListNode.InsertAfter(self, obj)

Insert self after obj.

Note

Take care obj is a correct type.
For example it is not possible to insert a document after a BaseObject.

Warning

Forbidden to call in expressions (tags/nodes). Changing the document structure while an expression is evaluated will crash the application!
Parameters:obj (c4d.GeListNode) – The object to insert after.
GeListNode.InsertBefore(self, obj)

Insert self before obj.

Note

Take care obj is a correct type.
For example it is not possible to insert a document before a BaseObject.

Warning

Forbidden to call in expressions (tags/nodes). Changing the document structure while an expression is evaluated will crash the application!
Parameters:obj (c4d.GeListNode) – The object to insert before.
GeListNode.InsertUnder(self, obj)

Insert self under obj.

Note

Take care obj is a correct type.
For example it is not possible to insert a document under a BaseObject.
Parameters:obj (c4d.GeListNode) – The object to insert under.
GeListNode.InsertUnderLast(self, obj)

Insert self as the last child of obj.

Note

Take care obj is a correct type.
For example it is not possible to insert a document under a BaseObject.

Warning

Forbidden to call in expressions (tags/nodes). Changing the document structure while an expression is evaluated will crash the application!
Parameters:obj (c4d.GeListNode) – The object to insert under.
GeListNode.ChangeNBit(self, bit, bitmode)

Sets bits in the 64-bit bitfield of the node.

Parameters:
  • bit (int) –

    Bit index:

    NBIT_NONE None.
    NBIT_TL1_FOLD Folding bit for Timeline 1.
    NBIT_TL2_FOLD Folding bit for Timeline 2.
    NBIT_TL3_FOLD Folding bit for Timeline 3.
    NBIT_TL4_FOLD Folding bit for Timeline 4.
    NBIT_TL1_SELECT Selection bit for Timeline 1.
    NBIT_TL2_SELECT Selection bit for Timeline 2.
    NBIT_TL3_SELECT Selection bit for Timeline 3.
    NBIT_TL4_SELECT Selection bit for Timeline 4.
    NBIT_TL1_TDRAW Private.
    NBIT_TL2_TDRAW Private.
    NBIT_TL3_TDRAW Private.
    NBIT_TL4_TDRAW Private.
    NBIT_CKEY_ACTIVE Active point of animation path in editor.
    NBIT_OM1_FOLD Folding bit for Object Manager 1.
    NBIT_OM2_FOLD Folding bit for Object Manager 2.
    NBIT_OM3_FOLD Folding bit for Object Manager 3.
    NBIT_OM4_FOLD Folding bit for Object Manager 4.
    NBIT_TL1_FOLDTR Track folding for Timeline 1.
    NBIT_TL2_FOLDTR Track folding for Timeline 2.
    NBIT_TL3_FOLDTR Track folding for Timeline 3.
    NBIT_TL4_FOLDTR Track folding for Timeline 4.
    NBIT_TL1_FOLDFC F-Curve folding for Timeline 1.
    NBIT_TL2_FOLDFC F-Curve folding for Timeline 2.
    NBIT_TL3_FOLDFC F-Curve folding for Timeline 3.
    NBIT_TL4_FOLDFC F-Curve folding for Timeline 4.
    NBIT_SOURCEOPEN Source open in motion clip hierarchy tree.
    NBIT_TL1_HIDE Hide in Timeline 1.
    NBIT_TL2_HIDE Hide in Timeline 2.
    NBIT_TL3_HIDE Hide in Timeline 3.
    NBIT_TL4_HIDE Hide in Timeline 4.
    NBIT_SOLO_ANIM Solo animation.
    NBIT_SOLO_LAYER Solo layer.
    NBIT_TL1_SELECT2 Private.
    NBIT_TL2_SELECT2 Private.
    NBIT_TL3_SELECT2 Private.
    NBIT_TL4_SELECT2 Private.
    NBIT_SOLO_MOTION Solo motion.
    NBIT_CKEY_LOCK_T Lock key time.
    NBIT_CKEY_LOCK_V Lock key value.
    NBIT_CKEY_MUTE Mute key.
    NBIT_CKEY_CLAMP Clamp key tangents.
    NBIT_CKEY_BREAK Break key tangents.
    NBIT_CKEY_KEEPVISUALANGLE Keep visual angle.
    NBIT_CKEY_LOCK_O Lock key tangents angles.
    NBIT_CKEY_LOCK_L Lock key tangents length.
    NBIT_CKEY_AUTO Key auto tangents.
    NBIT_CKEY_ZERO_O_OLD Deprecated.
    NBIT_CKEY_ZERO_L_OLD Deprecated.
    NBIT_TL1_FCSELECT F-Curve selection bit for Timeline 1.
    NBIT_TL2_FCSELECT F-Curve selection bit for Timeline 2.
    NBIT_TL3_FCSELECT F-Curve selection bit for Timeline 3.
    NBIT_TL4_FCSELECT F-Curve selection bit for Timeline 4.
    NBIT_CKEY_BREAKDOWN Private.
    NBIT_TL1_FOLDMOTION Motion clip folding for Timeline 1.
    NBIT_TL2_FOLDMOTION Motion clip folding for Timeline 2.
    NBIT_TL3_FOLDMOTION Motion clip folding for Timeline 3.
    NBIT_TL4_FOLDMOTION Motion clip folding for Timeline 4.
    NBIT_TL1_SELECTMOTION Motion clip selection for Timeline 1.
    NBIT_TL2_SELECTMOTION Motion clip selection for Timeline 2.
    NBIT_TL3_SELECTMOTION Motion clip selection for Timeline 3.
    NBIT_TL4_SELECTMOTION Motion clip selection for Timeline 4.
    NBIT_OHIDE Hide object/tag in Object Manager or material in Material Manager.
    NBIT_TL_TBAKE Private.
    NBIT_TL1_FOLDSM Private.
    NBIT_TL2_FOLDSM Private.
    NBIT_TL3_FOLDSM Private.
    NBIT_TL4_FOLDSM Private.
    NBIT_SUBOBJECT Private.
    NBIT_LINK_ACTIVE Private.
    NBIT_THIDE Hide object in Timeline.
    NBIT_SUBOBJECT_AM Private.
    NBIT_PROTECTION PSR protection.
    NBIT_NOANIM No animation.
    NBIT_NOSELECT No selection.
    NBIT_EHIDE Hide in viewport.
    NBIT_REF XRef.
    NBIT_REF_NO_DD XRef object no drag and drop. Private.
    NBIT_REF_OHIDE XRef object hide. Private.
    NBIT_NO_DD No drag and drop duplication.
    NBIT_HIDEEXCEPTVIEWSELECT Hide in viewport except to viewport select.
    NBIT_CKEY_WEIGHTEDTANGENT

    New in version R17.032: Weighted tangent.

    NBIT_CKEY_REMOVEOVERSHOOT

    New in version R17.032: Gradual clamp of tangent to avoid over shooting.

    NBIT_CKEY_AUTOWEIGHT

    New in version R17.032: Weight still adjusted even if angle is user defined.

    NBIT_TAKE_LOCK

    New in version R17.032: A node in an override group cannot be changed.

    NBIT_TAKE_OBJINGROUP

    New in version R17.032: The object is overridden by an override group.

    NBIT_TAKE_EGROUPOVERIDDEN

    New in version R17.032: The object editor visibility is overridden by an override group.

    NBIT_TAKE_RGROUPOVERIDDEN

    New in version R17.032: The object render visibility is overridden by an override group.

    NBIT_CKEY_BREAKDOWNCOLOR

    New in version R18: The key is a golden pose.

    NBIT_NO_DELETE

    New in version R18: No delete in Object Manager.

    NBIT_LOD_HIDE

    New in version R19: Used by LOD object to hide itself outside the view.

    NBIT_LOD_PRIVATECACHE

    New in version R19: Private.

    NBIT_MAX Maximum NBIT.
    NBIT_PRIVATE_MASK1 Private.
    NBIT_PRIVATE_MASK2 Private.
    NBIT_PRIVATE_MASK3 Private.
    NBIT_PRIVATE_MASK4 Private.
  • bitmode (int) –

    Bit mode:

    NBITCONTROL_SET Set bit.
    NBITCONTROL_CLEAR Clear bit.
    NBITCONTROL_TOGGLE Toggle bit.
    NBITCONTROL_PRIVATE_NODIRTY Private.
Return type:

bool

Returns:

Bit state.

GeListNode.GetNBit(self, bit)

Raw access to a 64-bit bitfield, containing information about the node state.

Parameters:bit (int) –

Bit index:

NBIT_NONE None.
NBIT_TL1_FOLD Folding bit for Timeline 1.
NBIT_TL2_FOLD Folding bit for Timeline 2.
NBIT_TL3_FOLD Folding bit for Timeline 3.
NBIT_TL4_FOLD Folding bit for Timeline 4.
NBIT_TL1_SELECT Selection bit for Timeline 1.
NBIT_TL2_SELECT Selection bit for Timeline 2.
NBIT_TL3_SELECT Selection bit for Timeline 3.
NBIT_TL4_SELECT Selection bit for Timeline 4.
NBIT_TL1_TDRAW Private.
NBIT_TL2_TDRAW Private.
NBIT_TL3_TDRAW Private.
NBIT_TL4_TDRAW Private.
NBIT_CKEY_ACTIVE Active point of animation path in editor.
NBIT_OM1_FOLD Folding bit for Object Manager 1.
NBIT_OM2_FOLD Folding bit for Object Manager 2.
NBIT_OM3_FOLD Folding bit for Object Manager 3.
NBIT_OM4_FOLD Folding bit for Object Manager 4.
NBIT_TL1_FOLDTR Track folding for Timeline 1.
NBIT_TL2_FOLDTR Track folding for Timeline 2.
NBIT_TL3_FOLDTR Track folding for Timeline 3.
NBIT_TL4_FOLDTR Track folding for Timeline 4.
NBIT_TL1_FOLDFC F-Curve folding for Timeline 1.
NBIT_TL2_FOLDFC F-Curve folding for Timeline 2.
NBIT_TL3_FOLDFC F-Curve folding for Timeline 3.
NBIT_TL4_FOLDFC F-Curve folding for Timeline 4.
NBIT_SOURCEOPEN Source open in motion clip hierarchy tree.
NBIT_TL1_HIDE Hide in Timeline 1.
NBIT_TL2_HIDE Hide in Timeline 2.
NBIT_TL3_HIDE Hide in Timeline 3.
NBIT_TL4_HIDE Hide in Timeline 4.
NBIT_SOLO_ANIM Solo animation.
NBIT_SOLO_LAYER Solo layer.
NBIT_TL1_SELECT2 Private.
NBIT_TL2_SELECT2 Private.
NBIT_TL3_SELECT2 Private.
NBIT_TL4_SELECT2 Private.
NBIT_SOLO_MOTION Solo motion.
NBIT_CKEY_LOCK_T Lock key time.
NBIT_CKEY_LOCK_V Lock key value.
NBIT_CKEY_MUTE Mute key.
NBIT_CKEY_CLAMP Clamp key tangents.
NBIT_CKEY_BREAK Break key tangents.
NBIT_CKEY_KEEPVISUALANGLE Keep visual angle.
NBIT_CKEY_LOCK_O Lock key tangents angles.
NBIT_CKEY_LOCK_L Lock key tangents length.
NBIT_CKEY_AUTO Key auto tangents.
NBIT_CKEY_ZERO_O_OLD Deprecated.
NBIT_CKEY_ZERO_L_OLD Deprecated.
NBIT_TL1_FCSELECT F-Curve selection bit for Timeline 1.
NBIT_TL2_FCSELECT F-Curve selection bit for Timeline 2.
NBIT_TL3_FCSELECT F-Curve selection bit for Timeline 3.
NBIT_TL4_FCSELECT F-Curve selection bit for Timeline 4.
NBIT_CKEY_BREAKDOWN Private.
NBIT_TL1_FOLDMOTION Motion clip folding for Timeline 1.
NBIT_TL2_FOLDMOTION Motion clip folding for Timeline 2.
NBIT_TL3_FOLDMOTION Motion clip folding for Timeline 3.
NBIT_TL4_FOLDMOTION Motion clip folding for Timeline 4.
NBIT_TL1_SELECTMOTION Motion clip selection for Timeline 1.
NBIT_TL2_SELECTMOTION Motion clip selection for Timeline 2.
NBIT_TL3_SELECTMOTION Motion clip selection for Timeline 3.
NBIT_TL4_SELECTMOTION Motion clip selection for Timeline 4.
NBIT_OHIDE Hide object/tag in Object Manager or material in Material Manager.
NBIT_TL_TBAKE Private.
NBIT_TL1_FOLDSM Private.
NBIT_TL2_FOLDSM Private.
NBIT_TL3_FOLDSM Private.
NBIT_TL4_FOLDSM Private.
NBIT_SUBOBJECT Private.
NBIT_LINK_ACTIVE Private.
NBIT_THIDE Hide object in Timeline.
NBIT_SUBOBJECT_AM Private.
NBIT_PROTECTION PSR protection.
NBIT_NOANIM No animation.
NBIT_NOSELECT No selection.
NBIT_EHIDE Hide in viewport.
NBIT_REF XRef.
NBIT_REF_NO_DD XRef object no drag and drop. Private.
NBIT_REF_OHIDE XRef object hide. Private.
NBIT_NO_DD No drag and drop duplication.
NBIT_HIDEEXCEPTVIEWSELECT Hide in viewport except to viewport select.
NBIT_CKEY_WEIGHTEDTANGENT

New in version R17.032: Weighted tangent.

NBIT_CKEY_REMOVEOVERSHOOT

New in version R17.032: Gradual clamp of tangent to avoid over shooting.

NBIT_CKEY_AUTOWEIGHT

New in version R17.032: Weight still adjusted even if angle is user defined.

NBIT_TAKE_LOCK

New in version R17.032: A node in an override group cannot be changed.

NBIT_TAKE_OBJINGROUP

New in version R17.032: The object is overridden by an override group.

NBIT_TAKE_EGROUPOVERIDDEN

New in version R17.032: The object editor visibility is overridden by an override group.

NBIT_TAKE_RGROUPOVERIDDEN

New in version R17.032: The object render visibility is overridden by an override group.

NBIT_CKEY_BREAKDOWNCOLOR

New in version R18: The key is a golden pose.

NBIT_NO_DELETE

New in version R18: No delete in Object Manager.

NBIT_LOD_HIDE

New in version R19: Used by LOD object to hide itself outside the view.

NBIT_LOD_PRIVATECACHE

New in version R19: Private.

NBIT_MAX Maximum NBIT.
NBIT_PRIVATE_MASK1 Private.
NBIT_PRIVATE_MASK2 Private.
NBIT_PRIVATE_MASK3 Private.
NBIT_PRIVATE_MASK4 Private.
Return type:bool
Returns:Bit state.
GeListNode.Remove(self)

Removes this node from a list.

Warning

Forbidden to call in expressions (tags/nodes). Changing the document structure while an expression is evaluated will crash the application!
GeListNode.GetDocument(self)

Get the document for this node.

Return type:c4d.documents.BaseDocument
Returns:The document.
GeListNode.GetListHead(self)

Returns the list head.

Return type:c4d.GeListHead
Returns:The list head, or None if the node is not attached to one.

Changed in version R19: The function now returns a c4d.GeListHead object.

GeListNode.GetBranchInfo(self, flags=GETBRANCHINFO_NONE)

Returns information about which other nodes the node contains. For example objects contain tags.

New in version R19.

Parameters:flags (int) –

The flags:

GETBRANCHINFO_NONE None.
GETBRANCHINFO_ONLYWITHCHILDREN Only return branch if it is in use, i.e. has content.
GETBRANCHINFO_GELISTNODES Private.
GETBRANCHINFO_ONLYMODIFIABLE Private.
Return type:list of dict{‘head’, ‘name’, ‘id’, ‘flags’}
Returns:A list of dictionaries (None if the function failed) with the following information:
’head’: c4d.GeListHead: Either a c4d.GeListNode or a c4d.GeListHead for the branch, depending on flags.
’name’: str: The human readable name of the branch.
’id’: int: The base ID of the branch. For example VPbase, Mbase or Obase.
’flags’: int: The flags for the branch:
BRANCHINFOFLAGS_NONE None.
BRANCHINFOFLAGS_ANIMATE Animate the nodes in the branch.
BRANCHINFOFLAGS_HIDEINTIMELINE If set, the branch does not show up in the timeline.
GeListNode.IsDocumentRelated(self)

Checks if the node is of a type that can be inserted into a BaseDocument

Return type:bool
Returns:True if the node is document related, otherwise False.