Methods Signatures
Creates a |
Gets the field layer’s strength in percent. |
|
Sets the field layer’s strength in percent. |
|
Gets the field layer’s blending mode. |
|
Sets field layer’s blending mode. |
|
Private. |
|
Private. |
|
Gets the enabled flags for the layer. |
|
Sets the enabled flags for the layer. |
|
Checks a specific channel flag enabled state. |
|
Sets a specific channel flag enabled state. |
|
Initializes field sampling. |
|
Frees any data allocated in |
|
Samples the field layer. |
|
Private |
|
Gets the layer’s execution and display flags. |
|
Sets the layer’s execution and display flags. |
|
Gets the linked object. |
|
Sets the linked object. |
|
If the |
|
Adds a mask to the |
|
Removes the mask on the |
Inheritance
Parent Class:
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.
- 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.- 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 withInitSampling()
.
-
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
- 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.