# Decompose convex meshes

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

API function: [algo.convexDecomposition](/asset-transformer-sdk/2026.4/api/python/algo_functions.md#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.](/api/media?file=/asset-transformer-sdk/media/images/decomposeconvex.gif)

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:

![](/api/media?file=/asset-transformer-sdk/media/images/decomposeconvex2.png)

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

![](/api/media?file=/asset-transformer-sdk/media/images/decomposeconvex1.png)

> **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.