c4d.AliasTrans¶

class c4d.AliasTrans¶

The alias translator takes care about reconnecting BaseLink links when cloning, copying, reading or writing objects.

New in version R17.032.

Normally Cinema 4D provides an alias translator when needed, for example in NodeData.CopyTo(). However, to copy objects manually use:

trans = c4d.AliasTrans()
if not trans or not trans.Init(doc):
    return False

clone = op.GetClone(c4d.COPYFLAGS_NONE, trans)
if not clone:
    return False

trans.Translate(True)

Overview¶

Initialization
`AliasTrans.Init()`	Initializes the alias translator in the specified document doc.
Link Translation
`AliasTrans.Translate()`	Translates the links in all objects that the translator has come across.

Members¶

Initialization¶

AliasTrans.Init(self, doc)¶

Initializes the alias translator in the specified document doc.

Parameters: doc (c4d.documents.BaseDocument) – The document.
Return type: bool
Returns: True if the alias translator was initialized, otherwise False.

Link Translation¶

AliasTrans.Translate(self, connect_oldgoals)¶

Translates the links in all objects that the translator has come across.

Parameters

connect_oldgoals (bool) –

True to connect old goals.
For example: Take a cube with an instance linked to this cube, select both and duplicate them in one action.
The new cube is linked to the new instance if connect_oldgoals is True.
If it is False the new instance is linked to the old cube.

Category	Option	Description
Query	Words and phrases	Search is case-insensitive. Put a phrase in quotes for an exact match. Quoted phrases require every word and disable fuzzy matching.
Terms	OR / AND	Choose whether to match any term or require all terms.
Fuzzy	On / Off	Toggle approximate and prefix matches. Quoted phrases always use strict matching.
Results	Sparse / Dense	Sparse groups multiple hits for one entity and hides its owned API members when the class or module itself matches. Dense lists each match separately.
Sort by	Type / Relevance	Group results by entity type then rank within each group, or rank all results by relevance.
Content	All / API / Manuals / Examples / Resources	Search all documentation, API documentation, manuals, the examples index, or the resources index. Code examples embedded in other sections retain their own content area.
Entity	All / Page / Module / Class / Function / Attribute / Description / Node / Symbol / Icon	Page covers results without a specific entity type. Resource entity types are available with All or Resources; API entity types are available with All or API.
Location	All / Text / Code / Name / Signature	Text covers everything outside code, names, and signatures. Name and Signature are available with All or API.