c4d.modules.mograph.FieldLayer¶

class c4d.modules.mograph.FieldLayer¶: New in version R20.

Warning

Due to core changes in 2024.0.0, sampling of FieldLayer is not working in Python 2024.0.0.

This is going to be fixed in an upcoming version meanwhile you can sample a FieldList.

Methods Signatures

FieldLayer.__init__(self, type)

Creates a FieldLayer instance.

`FieldLayer.GetStrength(self)`	Gets the field layer’s strength in percent.
`FieldLayer.SetStrength(self, strength)`	Sets the field layer’s strength in percent.
`FieldLayer.GetBlendingMode(self)`	Gets the field layer’s blending mode.
`FieldLayer.SetBlendingMode(self, blendingMode)`	Sets field layer’s blending mode.
`FieldLayer.GetUniqueID(self)`	Private.
`FieldLayer.SetUniqueID(self, id)`	Private.
`FieldLayer.GetChannelFlags(self)`	Gets the enabled flags for the layer.
`FieldLayer.SetChannelFlags(self, flags)`	Sets the enabled flags for the layer.
`FieldLayer.GetChannelFlag(self, flag)`	Checks a specific channel flag enabled state.
`FieldLayer.SetChannelFlag(self, flag[, state])`	Sets a specific channel flag enabled state.
`FieldLayer.InitSampling(self, info)`	Initializes field sampling.
`FieldLayer.FreeSampling(self, info)`	Frees any data allocated in `InitSampling()`.
`FieldLayer.Sample(self, input, output, info)`	Samples the field layer.
`FieldLayer.Aggregate(self, input, output, info)`	Private
`FieldLayer.GetLayerFlags(self)`	Gets the layer’s execution and display flags.
`FieldLayer.SetLayerFlags(self, flags[, state])`	Sets the layer’s execution and display flags.
`FieldLayer.GetLinkedObject(self, doc)`	Gets the linked object.
`FieldLayer.SetLinkedObject(self, link)`	Sets the linked object.
`FieldLayer.GetMaskHead(self)`	If the `c4d.FieldLayer` has a mask then this retrieve the list head containing the mask layers.
`FieldLayer.AddMask(self)`	Adds a mask to the `c4d.FieldLayer`, if a mask already exists then this will do nothing.
`FieldLayer.RemoveMask(self, link)`	Removes the mask on the `c4d.FieldLayer`, if no mask exists then this will do nothing.

Inheritance

Parent Class:

c4d.BaseList2D

Methods Documentation

FieldLayer.__init__(self, type)¶

Creates a FieldLayer instance.

Parameters: type (int) – The layer type.

FieldLayer.GetStrength(self)¶

Gets the field layer’s strength in percent.

Return type: float
Returns: The strength.

FieldLayer.SetStrength(self, strength)¶

Sets the field layer’s strength in percent.

Parameters: strength (float) – The strength to set.

FieldLayer.GetBlendingMode(self)¶

Gets the field layer’s blending mode.

Return type: int
Returns: The blending mode. See flbase.h/res for values.

FieldLayer.SetBlendingMode(self, blendingMode)¶

Sets field layer’s blending mode.

Parameters: blendingMode (int) – The blending mode to set. See flbase.h/res for values.

FieldLayer.GetUniqueID(self)¶: Private.

FieldLayer.SetUniqueID(self, id)¶: Private.

FieldLayer.GetChannelFlags(self)¶

Gets the enabled flags for the layer.

Return type

int

Returns

The channel flags:

FIELDLAYER_CHANNELFLAG_NONE	None.
FIELDLAYER_CHANNELFLAG_ENABLE	Layer is enabled and sampled.
FIELDLAYER_CHANNELFLAG_VALUE	Value sampling is enabled.
FIELDLAYER_CHANNELFLAG_COLOR	Color sampling is enabled.
FIELDLAYER_CHANNELFLAG_DIRECTION	Direction sampling is enabled.
FIELDLAYER_CHANNELFLAG_ROTATION	Rotation sampling is enabled.

FieldLayer.SetChannelFlags(self, flags)¶

Sets the enabled flags for the layer.

Parameters

flags (int) –

The channel flags to set:

FIELDLAYER_CHANNELFLAG_NONE	None.
FIELDLAYER_CHANNELFLAG_ENABLE	Layer is enabled and sampled.
FIELDLAYER_CHANNELFLAG_VALUE	Value sampling is enabled.
FIELDLAYER_CHANNELFLAG_COLOR	Color sampling is enabled.
FIELDLAYER_CHANNELFLAG_DIRECTION	Direction sampling is enabled.
FIELDLAYER_CHANNELFLAG_ROTATION	Rotation sampling is enabled.

FieldLayer.GetChannelFlag(self, flag)¶

Checks a specific channel flag enabled state.

Parameters

flag (int) –

The flag to check:

FIELDLAYER_CHANNELFLAG_NONE	None.
FIELDLAYER_CHANNELFLAG_ENABLE	Layer is enabled and sampled.
FIELDLAYER_CHANNELFLAG_VALUE	Value sampling is enabled.
FIELDLAYER_CHANNELFLAG_COLOR	Color sampling is enabled.
FIELDLAYER_CHANNELFLAG_DIRECTION	Direction sampling is enabled.
FIELDLAYER_CHANNELFLAG_ROTATION	Rotation sampling is enabled.

Return type

bool

Returns

True if channel flag is set, otherwise False.

FieldLayer.SetChannelFlag(self, flag, state=True)¶

Sets a specific channel flag enabled state.

Parameters

flags (int) –

The flag to set:

FIELDLAYER_CHANNELFLAG_NONE	None.
FIELDLAYER_CHANNELFLAG_ENABLE	Layer is enabled and sampled.
FIELDLAYER_CHANNELFLAG_VALUE	Value sampling is enabled.
FIELDLAYER_CHANNELFLAG_COLOR	Color sampling is enabled.
FIELDLAYER_CHANNELFLAG_DIRECTION	Direction sampling is enabled.
FIELDLAYER_CHANNELFLAG_ROTATION	Rotation sampling is enabled.

state (bool) – True to enable the flag, False to disable.

FieldLayer.InitSampling(self, info)¶

Initializes field sampling.

Warning

Must be called before Sample() is invoked.

Parameters: info (c4d.modules.mograph.FieldInfo) – The FieldInfo to initialize sampling with.

FieldLayer.FreeSampling(self, info)¶

Frees any data allocated in InitSampling().

Warning

Must be called after sampling is finished.

Warning

Due to core changes in 2024.0.0, this function is not working in Python 2024.0.0.

This is going to be fixed in an upcoming version.

Parameters: info (c4d.modules.mograph.FieldInfo) – The FieldInfo instance used for sampling.

FieldLayer.Sample(self, input, output, info)¶

Samples the field layer.

Warning

InitSampling() must be called before. FreeSampling() must be called once sampling is complete.

Warning

Due to core changes in 2024.0.0, this function is not working in Python 2024.0.0.

This is going to be fixed in an upcoming version.

Parameters

input (c4d.modules.mograph.FieldInput) – The points to sample in global space.
output (c4d..modules.mograph.FieldOutputBlock) – The output result values, should be allocated prior to usage.
info (c4d.modules.mograph.FieldInfo) – The FieldInfo to sample with. It should match the info used with InitSampling().

FieldLayer.Aggregate(self, input, output, info)¶: Private

FieldLayer.GetLayerFlags(self)¶

Gets the layer’s execution and display flags.

Return type

int

Returns

The layer flags:

FIELDLAYER_FLAG_NONE	None.
FIELDLAYER_FLAG_SKIP	Layer calculation is disabled, e.g. the linked object on a standard layer’s deform mode is false.
FIELDLAYER_FLAG_ERRORSKIP	Layer calculation is disabled due to a non critical error in `InitSampling()` or as user specified.
FIELDLAYER_FLAG_HIDE	Layer should be completely ignored from both calculation and GUI display, e.g. the linked object has been deleted.
FIELDLAYER_FLAG_MODIFYDATA	The layer modifies existing data and needs the values from layers beneath it in the layer list.
FIELDLAYER_FLAG_PRESERVEALPHA	The layer does not adjust the existing alpha and its color changes should be applied ignoring any alpha values.
FIELDLAYER_FLAG_NOCHILDVALUE	Children of the layer do not output their value.
FIELDLAYER_FLAG_NOCHILDCOLOR	Children of the layer do not output their color.
FIELDLAYER_FLAG_NOCHILDDIRECTION	Children of the layer do not output their direction.
FIELDLAYER_FLAG_NOCHILDROTATION	Children of the layer do not output their rotation.
FIELDLAYER_FLAG_TEMPORARY	Do not save the layer with the list or duplicate it (outside of undo).

FieldLayer.SetLayerFlags(self, flags, state=True)¶

Sets the layer’s execution and display flags.

Parameters

flags (int) –

The layer flag to set:

FIELDLAYER_FLAG_NONE	None.
FIELDLAYER_FLAG_SKIP	Layer calculation is disabled, e.g. the linked object on a standard layer’s deform mode is false.
FIELDLAYER_FLAG_ERRORSKIP	Layer calculation is disabled due to a non critical error in `InitSampling()` or as user specified.
FIELDLAYER_FLAG_HIDE	Layer should be completely ignored from both calculation and GUI display, e.g. the linked object has been deleted.
FIELDLAYER_FLAG_MODIFYDATA	The layer modifies existing data and needs the values from layers beneath it in the layer list.
FIELDLAYER_FLAG_PRESERVEALPHA	The layer does not adjust the existing alpha and its color changes should be applied ignoring any alpha values.
FIELDLAYER_FLAG_NOCHILDVALUE	Children of the layer do not output their value.
FIELDLAYER_FLAG_NOCHILDCOLOR	Children of the layer do not output their color.
FIELDLAYER_FLAG_NOCHILDDIRECTION	Children of the layer do not output their direction.
FIELDLAYER_FLAG_NOCHILDROTATION	Children of the layer do not output their rotation.
FIELDLAYER_FLAG_TEMPORARY	Do not save the layer with the list or duplicate it (outside of undo).

state (bool) – True to set, False to clear.

FieldLayer.GetLinkedObject(self, doc)¶

Gets the linked object.

Parameters: doc (c4d.documents.BaseDocument) – The document the FieldLayer belongs to.
Return type: c4d.BaseList2D
Returns: The linked object.

FieldLayer.SetLinkedObject(self, link)¶

Sets the linked object.

Parameters: link (c4d.BaseList2D) – The object to link.

FieldLayer.GetMaskHead(self)¶

If the c4d.FieldLayer has a mask then this retrieve the list head containing the mask layers.

Return type: Optional[c4d.GeListHead]
Returns: The GeListHead containing the mask layers, None if masks aren’t active on this layer.

FieldLayer.AddMask(self)¶

Adds a mask to the c4d.FieldLayer, if a mask already exists then this will do nothing.

Return type: bool
Returns: True on success.

FieldLayer.RemoveMask(self, link)¶

Removes the mask on the c4d.FieldLayer, if no mask exists then this will do nothing.

Note

In c++ the parameter link is named deleteLayers, it’s probable that it will change as well in Python.

Parameters: link (bool) – True to delete the layers in the mask, False to retain them so that when enabled again via c4d.AddMask() the layers will reappear.