unstale

pypi / trimesh

trimesh

What changed in trimesh 5, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-27.

3 breaking1 new APIs and options1 performance3 behavior and defaults18 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.2.8 on npm

trimesh 526 changes

Breaking changes 3

  • Out-of-range face indices in OFF files now raise a clear error.

    5.2.0release notes

  • Raises ValueError when an OFF file is missing its count line.

    5.1.0release notes

  • Raises ValueError when a PLY property line appears before any element.

    5.1.0release notes

New APIs and options 1

Performance 1

  • Batches the R-tree query in discrete_mean_curvature_measure, improving performance.

    5.1.0release notes

Behavior and default changes 3

Fixes and other changes 18

  • Cached normals are handled correctly under nonuniform affine transforms.

    5.2.0release notes

  • GLB loading ignores chunks with unknown types.

    5.2.0release notes

  • Prevents a crash when mixed-format OBJ files contain None vertices.

    5.2.0release notes

  • Points are sorted correctly for axis-aligned normals.

    5.2.0release notes

  • Results no longer depend on ring winding.

    5.2.0release notes

  • Fixes the angle returned by align_vectors.

    5.1.1release notes

  • Fixes Arc.length returning twice the arc length.

    5.1.1release notes

  • Handles coincident triangle vertices in closest-point queries.

    5.1.1release notes

  • Closes discretized circles exactly.

    5.1.1release notes

  • Handles rows with zero columns.

    5.1.1release notes

  • Fixes mean curvature repeat counts on 32-bit platforms.

    5.1.1release notes

  • Corrects the microinch conversion factor, which was 1000 times too large.

    5.1.1release notes

  • Fixes the z reset so it moves the camera.

    5.1.1release notes

  • Fixes SVG rotation angle units and direction.

    5.1.1release notes

  • Adds vertex list cleanup to avoid a GPU memory leak.

    5.1.1release notes

  • Keeps XYZ colors to four channels.

    5.1.1release notes

  • Passes sections through to the capsule mesh.

    5.1.0release notes

  • Fixes smoothing shifting mesh coordinates because volume_constraint was scaled about the world origin.

    5.1.0release notes