Decompose convex meshes

API function: algo.convexDecomposition

Use this feature to create a new set of convex meshes that approximate the selected mesh.

An example of use is convex mesh colliders.

The feature is driven by two parameters:

• The maximum number of convex meshes to be created
• The maximum number of vertices per convex mesh

This example shows how you can use this feature to solve 3D physics problems:

Without processing, classic 3D physics engines can't simulate the movement of the rings. Because of concavity, the pillars and the rings require specific processing:

1. The base must be decomposed into a set of four convex meshes:

   

2. Each ring must be decomposed into enough convex meshes for the simulation to look realistic:

   

Tip

A convex decomposition with V vertices and T triangles always satisfies the Euler characteristic:

V = 2 + T/2

You can use this formula to show the triangle count to users.