docs.unity3d.com
Version: 

    Retopologize meshes

    API function: algo.retopologize

    Use this feature to create a lightweight representation of a complex mesh by reducing the polygon count.

    This feature is suitable for colliders, levels of detail (LODs), and devices with limited graphics power.

    The algorithm

    This algorithm is based on instant meshes. It will produce a new mesh, containing either only quadrangles (if pureQuad is checked) or triangles and quadrangles. The target triangle count is indicative and will not create exactly the input number.

    Tip

    If the resulting mesh has lots of holes or missing parts, try running the algorithm again with a higher target triangle count. It can be reduced afterwards using the decimation.

    One major advantage of this approach is that the final mesh will automatically align to the structure of the 3D model.

    Precision

    The precision parameter will increase the fidelity of the output mesh, at the expense of some more polygons and more processing time.

    Tip

    Decreasing the precision will require more RAM to process, so keep track of your RAM usage when using this parameter.

    Limitation

    This algorithm does not handle surfacic meshes correctly. For surfacic meshes, consider using the proxy mesh with the surfacic parameter checked, or the dual contouring that will automatically handle the surfacic parts.

    Additional resources

    • Bake materials
    Version 2025.2.0.1
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX.