c4d.utils.ConvexHullDecomposition¶
-
class
c4d.utils.
ConvexHullDecomposition
¶ Efficient way to generate a low polygon representation of a given object.
New in version 2026.0.0.
Overview¶
Initialize the convex decomposition library. |
Compute convex decomposition. |
|
Fetch results of the decomposition. To be called after Compute(). |
|
Clear the stored result of the previous computation if there is any. |
Members¶
-
ConvexHullDecomposition.
__init__
(self, lod, maxVoxelCount=16000000, maxVerticesPerConvexHull=64, maxConvexHull=1024, threadCount=0)¶ Initialize the convex decomposition library.
- Parameters
lod (float) – Desired level of detail to retail in the decomposition. Allowed values are between 0 and 1. Recommended 0.5.
maxVoxelCount (int) – Maximum number of voxels used to decompose the bounding box, if the implementation uses voxelization.
maxVerticesPerConvexHull (int) – Maximum number of vertices for each output convex hull. For use with physx on the gpu: set lower or equal to 64
maxConvexHull (int) – Maximum number of output convex hulls.
threadCount (int) – Maximum number of thread to use for the computation, 0 means all threads.
-
ConvexHullDecomposition.
Compute
(self, geometry)¶ Compute convex decomposition.
- Parameters
geometry (c4d.PolygonObject) – Geometry object to decompose.
-
ConvexHullDecomposition.
FetchResults
(self)¶ Fetch results of the decomposition. To be called after Compute().
- Return type
list[c4d.PolygonObject]
- Returns
A list of objects where each entry represents one of the convex hulls the original object was decomposed into.
-
ConvexHullDecomposition.
Clear
(self)¶ Clear the stored result of the previous computation if there is any.