c4d.modules.mograph.FieldInput

New in version R20.

Members

FieldInput._blockCount

[Read-only]

The number of elements to be processed. The count to use when iterating over elements in FieldObject and FieldLayer.

Type: int

FieldInput._blockOffset

[Read-only]

The offset (starting point) of the elements if a portion of a larger array. Used for example to get the actual index in the list: actualIndex = index - points._blockOffset.

Type: int

FieldInput._fullArraySize

[Read-only]

The full size of the source data. May be larger than _blockCount and also might be larger than the size of the allocated block within the c4d.modules.mograph.FieldInput.

Warning

Do no use _fullArraySize to browse the arrays.

Type: int

FieldInput._transform

[Read-only]

The transform matrix for the points in the input block. Use to bring the position and direction lists into world space or the local space of a FieldObject.

Type: c4d.Matrix

FieldInput._position

[Read-only]

The position values for the array of points. If it is a sub-block then element 0 is at _blockOffset within the larger block.

Type: List[c4d.Vector]

FieldInput._direction

[Read-only]

The direction values for the array of points. If it is a sub-block then element 0 is at _blockOffset within the larger block.

Type: List[c4d.Vector]

FieldInput._uvw

[Read-only]

The uvw values for the array of points. If it is a sub-block then element 0 is at _blockOffset within the larger block.

Type: List[c4d.Vector]

FieldInput.__init__(position, allocatedCount, transform=None, fullCount=c4d.NOTOK, direction=None, uvw=None)

Creates a FieldInput instance.

Parameters:
  • position (List[c4d.Vector]) – The position list to sample.
  • allocatedCount (int) – The length of the position list.
  • transform (c4d.Matrix) – The transform matrix required to convert the position and direction inputs to global space.
  • fullCount (int) – The full position count if allocatedCount is too big to allocate position list. If not set allocatedCount is used instead.
  • direction (List[c4d.Vector]) – The direction list to sample.
  • uvw (List[c4d.Vector]) – The uvw list to sample.
Return type:

c4d.modules.mograph.FieldInput

Returns:

The created FieldInput instance.

FieldInput.GetSubBlock(offset, blockSize)

Retrieves a FieldInput for a subset of the original block.

Note

Useful to pass smaller blocks to the field processing threads.

Parameters:
  • offset (int) – The sub-block start offset.
  • blockSize (int) – The size of the desired sub-block. 400 is the recommended size.
Return type:

c4d.modules.mograph.FieldInput

Returns:

The sub-block FieldInput.

FieldInput.IsValid()

Checks if the FieldInput allocations and sizes are valid.

Note

Default empty FieldInput is considered valid.

Return type:bool
Returns:True if the FieldInput is valid, otherwise False.
FieldInput.IsPopulated()

Checks if the FieldInput is valid and non-empty.

Return type:bool
Returns:True if the FieldInput is populated, otherwise False.
FieldInput.GetCount()

Returns the number of elements in the FieldInput.

Return type:int
Returns:The number of elements.
FieldInput.GetOffset()

Returns the offset of the first element in full arrays.

Return type:int
Returns:The offset.