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

ConvexHullDecomposition.__init__

Initialize the convex decomposition library.

ConvexHullDecomposition.Compute

Compute convex decomposition.

ConvexHullDecomposition.FetchResults

Fetch results of the decomposition. To be called after Compute().

ConvexHullDecomposition.Clear

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.