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¶

Decomposition Workflow
`ConvexHullDecomposition.Clear()`	Clear the stored result of the previous computation if there is any.
`ConvexHullDecomposition.Compute()`	Compute convex decomposition.
`ConvexHullDecomposition.FetchResults()`	Fetch results of the decomposition.
Magic Methods
`ConvexHullDecomposition.__init__()`	Initialize the convex decomposition library.

Members¶

Decomposition Workflow¶

ConvexHullDecomposition.Clear(self)¶: Clear the stored result of the previous computation if there is any.

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.

Magic Methods¶

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.

Category	Option	Description
Query	Words and phrases	Search is case-insensitive. Put a phrase in quotes for an exact match. Quoted phrases require every word and disable fuzzy matching.
Terms	OR / AND	Choose whether to match any term or require all terms.
Fuzzy	On / Off	Toggle approximate and prefix matches. Quoted phrases always use strict matching.
Results	Sparse / Dense	Sparse groups multiple hits for one entity and hides its owned API members when the class or module itself matches. Dense lists each match separately.
Sort by	Type / Relevance	Group results by entity type then rank within each group, or rank all results by relevance.
Content	All / API / Manuals / Examples / Resources	Search all documentation, API documentation, manuals, the examples index, or the resources index. Code examples embedded in other sections retain their own content area.
Entity	All / Page / Module / Class / Function / Attribute / Description / Node / Symbol / Icon	Page covers results without a specific entity type. Resource entity types are available with All or Resources; API entity types are available with All or API.
Location	All / Text / Code / Name / Signature	Text covers everything outside code, names, and signatures. Name and Signature are available with All or API.