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:

A ring toss game slides on a sloping surface.

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:

    Create Projected UVs

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

    Create Projected UVs

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.