Skip to content

CLI Reference

Matthew Scott edited this page Nov 21, 2026 · 1 revision

CLI Reference

uvbake - generate a bake-ready UV atlas for a mesh (unique, large low-distortion islands)

usage: uvbake <in.obj> [-o <out.obj>] [options]

options:
  -o, --output <path>   write the atlas (.obj per-wedge UVs, or .gltf); omit for a dry run
  --layout <path.svg>   write an SVG of the packed UV layout (islands colored by chart)
  --res <n>             atlas resolution (default 2048)
  --gutter <n>          inter-island gutter in texels (default 8)
  --density <x>         fixed texels-per-unit; spills across UDIM tiles if needed (default: auto-fit one tile)
  --max-stretch <x>     distortion budget for chart growth (default 0.25)
  --hard-edge <deg>     dihedral hard-edge threshold (default 45)
  --seams <mode>        DihedralAngle|ProvidedTags|Both (default Both)
  --packer <mode>       BoundingBox|Silhouette (default BoundingBox)
  --no-rotate           disable 90-degree chart rotation when packing
  --no-pot              do not round the atlas up to a power of two

Formats are chosen by extension, and .fbx works for input and output as well.

uvbake model.obj -o model.uv.obj                      # unwrap with defaults
uvbake model.fbx -o atlas.fbx --res 4096 --gutter 16  # FBX in and out
uvbake model.obj -o atlas.gltf --layout atlas.svg     # glTF plus an SVG of the layout
uvbake model.obj -o atlas.obj --density 512           # fixed texel density across UDIM tiles

Clone this wiki locally