Skip to main content
AlejandroSoriano
Participant
August 4, 2026
Question

Is the new Hard surface auto-unwrap mode exposed in the Python API?

  • August 4, 2026
  • 0 replies
  • 7 views

Painter 12.1.1 adds a Hard surface option to the automatic unwrap settings. I'd like to use it when creating projects programmatically, but I can't find a way to reach it from the Python API (version 0.3.5).

What I checked on a live 12.1.1 install:

  • substance_painter.project.AutoUnwrapSettings still exposes the same 8 fields: recompute_seamsrecompute_uv_islandsrecompute_packingmargin_sizeisland_orientationuv_tiles_settingsavoid_elongated_uv_islandscreate_fewer_seams.
  • AutoUnwrapUVIslandOrientation has exactly three members: RotateFreelyAlignWith3DMeshKeepOriginal.
  • The private _substance_painter.project.AutoUnwrapSettings has no extra field either, and _to_private_auto_unwarp_settings copies field by field, so nothing outside the public dataclass would reach project.create anyway.
  • project_loading_options is empty, and the legacy alg.project JS API doesn't expose unwrap settings.

Questions:

  1. Is the Hard surface mode reachable from a script in 12.1.1 by some route I've missed?
  2. If not, is API support planned? It matters for pipelines that create projects automatically from CAD or architectural meshes, where hard surface is the normal case and the UI toggle can't be used.
  3. Is island_orientation=AlignWith3DMesh intended as a partial equivalent, or is it unrelated?