c4d.modules.mograph

class c4d.modules.mograph

Note

By default, for legacy reason, an effector added programmatically to the scene will use the falloff option. To switch that effector to fields, the effector need to receive a message MSG_MENUPREPARE. This message can be sent with field.Message(c4d.MSG_MENUPREPARE, currentDoc);

Attributes

FIELD_EXECUTION_BLOCK_SIZEf

The size of a block that’s executed in an MP environment.

For single depth execution a value closer to 1200 is actually more optimal, with one group 600 and from then on for each group depth you can expect a drop of a third.

For general usage on current architectures this gives the best balance.

Type: Float

Types

• c4d.modules.mograph.C4D_Falloff
• c4d.modules.mograph.FalloffDataData

• c4d.modules.mograph.MoData

• c4d.modules.mograph.FieldCallerStack
• c4d.modules.mograph.FieldInfo
• c4d.modules.mograph.FieldInput
• c4d.modules.mograph.FieldLayer
• c4d.modules.mograph.FieldObject
• c4d.modules.mograph.FieldOutput
• c4d.modules.mograph.FieldOutputBlock

Functions Signatures

c4d.modules.mograph.GeGetMoData()	Returns the MoGraph data of an object.
c4d.modules.mograph.GeGetMoDataSelection()	Retrieves the MoGraph clones selection.
c4d.modules.mograph.GeSetMoDataSelection()	Sets the MoGraph clones selection.
c4d.modules.mograph.GeGetMoDataWeights()	Retrieves the MoGraph clones weights.
c4d.modules.mograph.GeSetMoDataWeights()	Sets the MoGraph clones weights.
c4d.modules.mograph.GetMoDataDefault()	Get the default value for the specified MoData ID.
c4d.modules.mograph.GetMoDataDefaultType()	Get the default value for the specified MoData ID.

GetGenerator()

To get the generator (cloner, matrix object, text object, instance object, fracture object) that owns the MoData currently being modified in a Python effector, see Python Effector Object Manual.

Functions Documentation

c4d.modules.mograph.GeGetMoData(op)

Returns the MoGraph data of an object.

Parameters

op (c4d.BaseObject) – The object.

Return type

MoData

Returns

The MoGraph data.

c4d.modules.mograph.GeGetMoDataSelection(op)

Retrieves the MoGraph clones selection.

New in version R18.020.

Parameters

op (c4d.BaseList2D) – Can be either a MoGraph Selection tag BaseTag(c4d.Tmgselection) or an object with a MoGraph Selection tag.

Return type

c4d.BaseSelect

Returns

The clones selection.

c4d.modules.mograph.GeSetMoDataSelection(op, selection)

Sets the MoGraph clones selection.

New in version R18.039.

Warning

Before R21, makes sure to call C4DAtom.SetDirty() after any usage of this method to properly updates the mograph object.

In R21 this bug was fixed so the next code is no more needed.

# mographObject is the host mograph object of the MoGraph Selection tag: BaseTag(c4d.Tmgselection).
mographObject.SetDirty(c4d.DIRTYFLAGS_DATA)
mographObject.Message(c4d.MSG_UPDATE)

Parameters

• op (c4d.BaseList2D) – Can be either a MoGraph Selection tag BaseTag(c4d.Tmgselection) or an object with a MoGraph Selection tag.

• selection (c4d.BaseSelect) – The clones selection to set.

Return type

bool

Returns

True if successful, otherwise False.

c4d.modules.mograph.GeGetMoDataWeights(op)

Retrieves the MoGraph clones weights.

New in version R18.020.

Parameters

op (c4d.BaseList2D) – Can be either a MoGraph Weightmap tag BaseTag(c4d.Tmgweight) or an object with a MoGraph Weightmap tag.

Return type

List[float]

Returns

The clones weights.

c4d.modules.mograph.GeSetMoDataWeights(op, weights)

Sets the MoGraph clones weights.

New in version R18.039.

Warning

Before R21, makes sure to call C4DAtom.SetDirty() after any usage of this method to properly updates the mograph object. In R21 this bug was fixed so the next code is no more needed.

# mographObject is the host mograph object of the MoGraph Weight tag: BaseTag(c4d.Tmgweight).
# moSelTag is a BaseTag(c4d.Tmgweight)
moSelTag.SetDirty(c4d.DIRTYFLAGS_DATA)
mographObject.SetDirty(c4d.DIRTYFLAGS_DATA)
mographObject.Message(c4d.MSG_UPDATE)

Parameters

• op (c4d.BaseList2D) – Can be either a MoGraph Weight tag BaseTag(c4d.Tmgweight) or an object with a MoGraph Weight tag.

• weights (List[float]) – The clones weights to set.

Return type

bool

Returns

True if successful, otherwise False.

c4d.modules.mograph.GetMoDataDefault(id)

Get the default value for the specified MoData ID.

Parameters

id (int) –

The MoData ID:

MODATA_MATRIX	Matrix	Matrix of the clone.
MODATA_COLOR	Vector	Color of the clone.
MODATA_SIZE	Vector	Size of the clone.
MODATA_UVW	Vector	UV position of the clone.
MODATA_FLAGS	int	Flags:
	MOGENFLAG_CLONE_ON	Particle is visible.
	MOGENFLAG_DISABLE	Particle is permanently disabled.
	MOGENFLAG_BORN	Particle is just generated (internal use only).
	MOGENFLAG_MODATASET	The MoData has been set and does not need the input of the transform panel.
	MOGENFLAG_COLORSET	The MoData color has been set and does not need to be updated.
	MOGENFLAG_TIMESET	The MoData time has been set and does not need to be updated.
MODATA_WEIGHT	float	Weight of the clone.
MODATA_CLONE	float	Clone Offset (picks which child of the Cloner gets cloned or the blending between those children).
MODATA_TIME	float	Time offset of the clone.
MODATA_LASTMAT	Matrix	Previous frame particle matrix.
MODATA_STARTMAT	Matrix	Matrix at the particle’s birth.
MODATA_ALT_INDEX	int	Alternative index value that can be used for instance by the Step Effector when cloned over a spline with an offset.
MODATA_FALLOFF_WGT	float	Falloff weight.
MODATA_SPLINE_SEGMENT	int	The segment index, mostly used with the MoSpline (currently unused).
MODATA_GROWTH	float	Offset of growth for the particle on the MoSpline (currently unused).

Return type

Any

Returns

The default value.

c4d.modules.mograph.GetMoDataDefaultType(id)

Get the default value for the specified MoData ID.

Parameters

id (int) –

The MoData ID:

MODATA_MATRIX	Matrix	Matrix of the clone.
MODATA_COLOR	Vector	Color of the clone.
MODATA_SIZE	Vector	Size of the clone.
MODATA_UVW	Vector	UV position of the clone.
MODATA_FLAGS	int	Flags:
	MOGENFLAG_CLONE_ON	Particle is visible.
	MOGENFLAG_DISABLE	Particle is permanently disabled.
	MOGENFLAG_BORN	Particle is just generated (internal use only).
	MOGENFLAG_MODATASET	The MoData has been set and does not need the input of the transform panel.
	MOGENFLAG_COLORSET	The MoData color has been set and does not need to be updated.
	MOGENFLAG_TIMESET	The MoData time has been set and does not need to be updated.
MODATA_WEIGHT	float	Weight of the clone.
MODATA_CLONE	float	Clone Offset (picks which child of the Cloner gets cloned or the blending between those children).
MODATA_TIME	float	Time offset of the clone.
MODATA_LASTMAT	Matrix	Previous frame particle matrix.
MODATA_STARTMAT	Matrix	Matrix at the particle’s birth.
MODATA_ALT_INDEX	int	Alternative index value that can be used for instance by the Step Effector when cloned over a spline with an offset.
MODATA_FALLOFF_WGT	float	Falloff weight.
MODATA_SPLINE_SEGMENT	int	The segment index, mostly used with the MoSpline (currently unused).
MODATA_GROWTH	float	Offset of growth for the particle on the MoSpline (currently unused).

Return type

int

Returns

The default type:

MD_TYPE_MD_NONE	None.
MD_TYPE_MD_CHAR	Char type.
MD_TYPE_MD_UCHAR	UChar type.
MD_TYPE_MD_LONG	Int32 type.
MD_TYPE_MD_ULONG	UInt32 type.
MD_TYPE_MD_LLONG	Int64 type.
MD_TYPE_MD_MATRIX	Matrix type.
MD_TYPE_MD_COLOR	Vector type.
MD_TYPE_MD_VECTOR	Vector type.
MD_TYPE_MD_NORMAL	Normal type.
MD_TYPE_MD_REAL	Float type.
MD_TYPE_MD_BOOL	Bool type.