blender/blender-manual
24
24
Fork 105
Code Issues 76 Pull Requests 6 Projects 1 Releases Wiki Activity

UV: Document pack islands features and new ui #104468

Closed
Chris Blackbourn wants to merge 63 commits from Chris_Blackbourn/blender-manual:uv_pack_islands into blender-v3.6-release
pull from: Chris_Blackbourn/blender-manual:uv_pack_islands
merge into: blender:blender-v3.6-release

When changing the target branch, be careful to rebase the branch in your fork to match. See documentation.
Conversation 3 Commits 63 Files Changed 49 +44 -19
1 changed files with 44 additions and 19 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 12e9794a2d - Show all commits

63
manual/modeling/meshes/uv/editing.rst
View File

@ -286,23 +286,33 @@ The *Pack Islands* tool can be used to optimize the UV layout by adjusting exist
to efficiently fill the :term:`Texture Space`. Based on the options selected, to efficiently fill the :term:`Texture Space`. Based on the options selected,
the tool will scale, translate and rotate the islands, the tool will scale, translate and rotate the islands,
ensuring a specified margin exists between them to maximize the usage of the UV space. ensuring a specified margin exists between them to maximize the usage of the UV space.
Pinned islands can have additional restrictions applied to customize the packing process even further.
Pack To Shape Method
Determines the final placement of UV islands after completing the packing operation. The method to use when considering the shape of each island.
:Closest UDIM: Pack islands to the :doc:`UDIM </modeling/meshes/uv/workflows/udims>` grid :Exact Shape (Concave):
nearest to the center of the selection. Use the complete shape of the island, including filling any holes or concave regions around the island.
:Active UDIM: Pack islands to the active UDIM image tile or, if no image is available, :Boundary Shape (Convex):
the UDIM grid tile where the 2D cursor is located. Takes into account the boundary (Convex Hull) of the island.
:Original bounding box: Find the original bounding box of the selection, This method will not place islands inside holes.
packs the islands, and then moves them back inside the original box. :Bounding Box: Uses the simple bounding box of the island.
Scale
Scale the islands to fill the unit square, or pack islands towards the lower left corner.
Rotate Rotate
Allows the rotation of islands, as well as translation and scaling, to optimize texture usage. Allows the rotation of islands, as well as translation and scaling, to optimize texture usage.
Merge Overlapped Rotation Method
Before the main packing operation, overlapping islands are detected and temporarily combined. The allowable rotations to use for each each island.
During packing, the relative rotation and position of the merged islands are preserved.
:Any:
Any rotation which improves the packing is allowed.
:Axis-aligned:
The island will first be rotated into a smallest rectangle. Additional rotation will only be in 90-degree turns.
:Cardinal: Like the four cardinal direction on a compass, North, South, East and West, only 90-degree turns will be allowed.
Margin Method Margin Method
The method to use when calculating the empty space between islands. The method to use when calculating the empty space between islands.
@ -314,15 +324,30 @@ ensuring a specified margin exists between them to maximize the usage of the UV
Margin Margin
The scale for the empty space between islands. The scale for the empty space between islands.
Shape Method Pinned Islands
The method to use when considering the shape of each island. An island which has any of it's UVs pinned is considered a *Pinned Island*.
With this option, you can change the way *Pinned Islands* are packed
:Exact shape (Concave): :Pack: *Pinned Islands* are packed in the same way as other islands.
Use the complete shape of the island, including filling any holes or concave regions around the island. :Lock Scale: The scale of the *Pinned Islands* will not change.
:Boundary shape (Convex): :Lock Rotation: *Pinned Islands* will not rotate.
Takes into account the boundary (Convex Hull) of the island. :Lock Rotation and Scale: *Pinned Islands* can translate, but not scale nor rotate.
This method will not place islands inside holes. :Lock in Place: *Pinned Islands* will be unable to move. The other islands will pack around them.
:Bounding box: Uses the simple bounding box of the island. :Ignore: Even if an island is selected, if it contains a pin, it will not be included in the *Pack Islands* calculation.
Merge Overlapping
Before the main packing operation, overlapping islands are detected and temporarily combined.
During packing, the relative rotation and position of the merged islands are preserved.
Pack To
Determines the final placement of UV islands after completing the packing operation.
:Closest UDIM: Pack islands to the :doc:`UDIM </modeling/meshes/uv/workflows/udims>` grid
nearest to the center of the selection.
:Active UDIM: Pack islands to the active UDIM image tile or, if no image is available,
the UDIM grid tile where the 2D cursor is located.
:Original bounding box: Find the original bounding box of the selection,
packs the islands, and then moves them back inside the original box.
.. note:: .. note::