BaseOverrideGroup

New in version R17.032.

This type cannot be instantiated.

An Override Group manages the values of multiple objects in a Take.

Inheritance

Members

BaseOverrideGroup.GetObjectsInGroup()

Retrieves all the objects in the group.

Return type:list of BaseList2D
Returns:The objects in the group.
BaseOverrideGroup.AddToGroup(takeData, node)

Adds node to the Override Group. If node is already part of another group it will be automatically removed first.

Warning

The node to add must be a real scene node. Adding BaseOverride nodes is forbidden.

Note

An undo step is added automatically if the call is added from the main (GUI) thread and global undo is allowed (see TakeData.GetUndoState()/TakeData.SetUndoState()).

Parameters:
BaseOverrideGroup.RemoveFromGroup(takeData, node)

Removes node from the Override Group.

Note

An undo step is added automatically if the call is added from the main (GUI) thread and global undo is allowed (see TakeData.GetUndoState()/TakeData.SetUndoState()).

Parameters:
BaseOverrideGroup.AddTag(takeData, type, mat)

Adds a new tag of the given type to the Override Group if it is not already there.

Warning

Only tags registered with the flag TAG_ADDTOTAKEGROUP are accepted by the group.

Note

An undo step is added automatically if the call is added from the main (GUI) thread and global undo is allowed (see TakeData.GetUndoState()/TakeData.SetUndoState()).

Parameters:
  • takeData (c4d.modules.takesystem.TakeData) – The Take System context.
  • type (int) –
    The tag type to be added. If the tag is already in the group the function returns.
    If Ttexture the material can be assigned to mat.
  • mat (c4d.modules.takesystem.TakeData) – The optional material (can be None) if passed type is Ttexture.
Return type:

c4d.BaseTag

Returns:

The tag. The added one if created by the function or the one already in the group.

BaseOverrideGroup.RemoveTag(takeData, type)

Removes the tag of the given type from the Override Group.

Parameters:
  • takeData (c4d.modules.takesystem.TakeData) – The Take System context.
  • type (int) – The tag type to be removed. If it is not in the Group the function returns.
BaseOverrideGroup.GetEditorMode()

Returns the editor visibility mode for the Override Group.

Return type:int
Returns:The editor mode:
MODE_ON The object is enabled regardless of the state of any parent object.
MODE_OFF The object is disabled regardless of the state of any parent object.
MODE_UNDEF The object is enabled by default, but the state of any parent object is used if it is enabled or disabled.
BaseOverrideGroup.GetRenderMode()

Returns the render visibility mode for the Override Group.

Return type:int
Returns:The render mode:
MODE_ON The object is enabled regardless of the state of any parent object.
MODE_OFF The object is disabled regardless of the state of any parent object.
MODE_UNDEF The object is enabled by default, but the state of any parent object is used if it is enabled or disabled.
BaseOverrideGroup.SetEditorMode(mode)

Sets the editor visibility mode for the Override Group.

Parameters:type (int) –

The editor mode to set:

MODE_ON The object is enabled regardless of the state of any parent object.
MODE_OFF The object is disabled regardless of the state of any parent object.
MODE_UNDEF The object is enabled by default, but the state of any parent object is used if it is enabled or disabled.
BaseOverrideGroup.SetRenderMode(mode)

Sets the render visibility mode for the Override Group.

Parameters:type (int) –

The render mode to set:

MODE_ON The object is enabled regardless of the state of any parent object.
MODE_OFF The object is disabled regardless of the state of any parent object.
MODE_UNDEF The object is enabled by default, but the state of any parent object is used if it is enabled or disabled.
BaseOverrideGroup.GetTag(type)

Searches for a tag of the given type attached to the Override Group.

Parameters:type (int) – The tag type to search for.
Return type:c4d.BaseTag
Returns:The tag if found, otherwise None.
BaseOverrideGroup.GetTake()

Returns the Take that owns the Override Group.

Return type:c4d.modules.takesystem.BaseTake
Returns:The Take for the Override Group.
BaseOverrideGroup.Find(takeData, op)

Checks if an object is included in the Override Group.

Parameters:
Return type:

bool

Returns:

True if the object is included in the Override Group, otherwise False.