c4d.VoronoiFracture¶
-
class
c4d.
VoronoiFracture
¶ - A VoronoiFracture object represents a Voronoi Fracture MoGraph generator.The class provides safe access to the point sources referenced, owned and used by the generator.
New in version R18.039.
Methods Signatures
Returns the number of elements in the Sources list, including point generators. |
|
Retrieves the object referenced at the given index. |
|
Retrieves the object referenced in the Sources list with the given type. |
|
Removes the source element in the list at the given index. |
|
Adds a new point generator. |
|
Adds a valid object from the scene to the Sources list. |
|
Clears the Sources list and deletes all point generators. |
|
|
Returns the internal container for the settings of an external source input, like a polygon object as point source. |
|
Returns the internal container for the settings of an external source input, like a polygon object as point source. |
Inheritance
Parent Class:
Methods Documentation
-
VoronoiFracture.
__init__
(self)¶
-
VoronoiFracture.
GetSourcesCount
(self)¶ Returns the number of elements in the Sources list, including point generators.
- Return type
int
- Returns
The number of elements in the Sources list.
-
VoronoiFracture.
GetSource
(self, index)¶ Retrieves the object referenced at the given index.
Note
If index references a point generator that point generator object is returned.
- Parameters
index (int) – The index of the source element to access.
- Return type
Optional[c4d.BaseObject]
- Returns
The object at the given index, or None if the method failed.
-
VoronoiFracture.
GetSourceByType
(self, type, startIndex=- 1)¶ Retrieves the object referenced in the Sources list with the given type.
Note
If multiple objects with the given type exist the first is returned.
- Parameters
type (int) – The type of object to access.
startIndex (int) – The index to start the search.
- Return type
Optional[Tuple[c4d.BaseObject, int]]
- Returns
A tuple with the found source object and its index, or None if the method failed.
-
VoronoiFracture.
RemoveSource
(self, index)¶ Removes the source element in the list at the given index.
Note
If the index references a point generator it is also deleted from the internal list.
- Parameters
index (int) – The index of the source element to remove.
- Return type
bool
- Returns
True if the element was removed successfully, otherwise False.
-
VoronoiFracture.
AddPointGenerator
(self, type, shaderType=- 1)¶ Adds a new point generator.
- Parameters
type (int) – The type of point generator, either ID_POINTCREATOR_CREATORTYPE_DISTRIBUTION or ID_POINTCREATOR_CREATORTYPE_SHADER.
shaderType (int) – If a Shader generator is created a shader of this type is automatically added to it.
- Return type
Optional[Tuple[c4d.BaseObject, int]]
- Returns
A tuple with the added point generator and its index, or None if the method failed.
-
VoronoiFracture.
AddSceneObject
(self, object)¶ Adds a valid object from the scene to the Sources list.
- Parameters
object (c4d.BaseObject) – The scene object that should be added.
- Return type
Optional[Tuple[bool, int]]
- Returns
A tuple with the scene object addition state and its index, or None if the method failed.
-
VoronoiFracture.
ClearSources
(self)¶ Clears the Sources list and deletes all point generators.
-
VoronoiFracture.
GetSourceSettingsContainerForIndex
(self, index)¶ Returns the internal container for the settings of an external source input, like a polygon object as point source.
New in version R19.
Note
Allows to change the settings that control for example the distribution of points in the object and the point count.
- Parameters
index (int) – The index of the object in the Sources list.
- Return type
Optional[c4d.BaseContainer]
- Returns
The container for the source settings if the index fits to an external Source input, otherwise None.
-
VoronoiFracture.
GetSourceSettingsContainerForObject
(self, object)¶ Returns the internal container for the settings of an external source input, like a polygon object as point source.
New in version R19.
Note
Allows to change the settings that control for example the distribution of points in the object and the point count.
- Parameters
object (c4d.BaseObject) – The external source object in the Sources list.
- Return type
Optional[c4d.BaseContainer]
- Returns
The container for the source settings if the object is in the Sources list, otherwise None.