blender-uv-ops

blender-uv-ops

Typed UV authoring tools for Blender meshes. Load this skill when a workflow needs UV maps, texture-coordinate projection, unwraps, UV island diagnostics, packing, or normalization.

Prefer blender-mesh for topology and modifier work, blender-materials for material slots, and blender-shader-nodes for shader graph edits. Use blender-scripting only after checking this typed surface.

Quality and delivery

Use audit_uv_layout with explicit mesh names (up to 4096) for source mesh quality checks. It does not evaluate modifiers or silently switch out of Edit Mode. success means the query ran; require both context.complete and context.passed for a clean result for the enabled checks (reported in context.checks); disabling overlap is not a complete quality acceptance. Budget limits are shared by the entire request; complete=false requires a narrower request or a larger budget. Counts for degeneracy, tile bounds and overlap are triangle counts/pairs, not unique polygons. Face indices in the bounded detail list locate problems. per_object overlap is the default; choose selection only when those objects must share a non-overlapping atlas. Exact coincident triangle stacks (including mirrors) are allowed only with allow_stacked=true. UV distortion and texel density are not measured. udim permits tile crossings and validates only the nonnegative ten-column coordinate domain, not texture-file availability.

Use export_uv_layout to write actual polygon UV edges to a new SVG path. Each object gets its own labelled panel, fitted to its coordinates with the unit-tile border shown; panels do not imply shared texel scale. Export is a layout visualization, not a quality pass. It neither packs nor repairs UVs. The default panels mode accepts at most 64 objects. Choose layout_mode=overlay to display up to 4096 objects in their shared UV coordinate space. Set an explicit max_triangles budget (up to 500000) for larger atlas exports.