From fcaf33888011d4533bbd1f3fa98693ae9107f35b Mon Sep 17 00:00:00 2001 From: Chris Blackbourn Date: Fri, 2 Jun 2023 19:26:14 +1200 Subject: [PATCH 1/2] UV: Document pack islands features and new ui --- manual/modeling/meshes/uv/editing.rst | 63 +++++++++++++++++++-------- 1 file changed, 44 insertions(+), 19 deletions(-) diff --git a/manual/modeling/meshes/uv/editing.rst b/manual/modeling/meshes/uv/editing.rst index 9cda0bf95..6325deaa3 100644 --- a/manual/modeling/meshes/uv/editing.rst +++ b/manual/modeling/meshes/uv/editing.rst @@ -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, the tool will scale, translate and rotate the islands, 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 - Determines the final placement of UV islands after completing the packing operation. + Shape Method + The method to use when considering the shape of each island. - :Closest UDIM: Pack islands to the :doc:`UDIM ` 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. + :Exact Shape (Concave): + Use the complete shape of the island, including filling any holes or concave regions around the island. + :Boundary Shape (Convex): + Takes into account the boundary (Convex Hull) of the island. + This method will not place islands inside holes. + :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 Allows the rotation of islands, as well as translation and scaling, to optimize texture usage. - Merge Overlapped - 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. + Rotation Method + The allowable rotations to use for each each island. + + :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 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 The scale for the empty space between islands. - Shape Method - The method to use when considering the shape of each island. + Pinned Islands + 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): - Use the complete shape of the island, including filling any holes or concave regions around the island. - :Boundary shape (Convex): - Takes into account the boundary (Convex Hull) of the island. - This method will not place islands inside holes. - :Bounding box: Uses the simple bounding box of the island. + :Pack: *Pinned Islands* are packed in the same way as other islands. + :Lock Scale: The scale of the *Pinned Islands* will not change. + :Lock Rotation: *Pinned Islands* will not rotate. + :Lock Rotation and Scale: *Pinned Islands* can translate, but not scale nor rotate. + :Lock in Place: *Pinned Islands* will be unable to move. The other islands will pack around them. + :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 ` 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:: -- 2.30.2 From e6a221e878dd8520c04acd7935d8186c7d883344 Mon Sep 17 00:00:00 2001 From: Chris Blackbourn Date: Sat, 3 Jun 2023 18:25:06 +1200 Subject: [PATCH 2/2] UV: Update grammar --- manual/modeling/meshes/uv/editing.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/manual/modeling/meshes/uv/editing.rst b/manual/modeling/meshes/uv/editing.rst index 6325deaa3..7b86c550f 100644 --- a/manual/modeling/meshes/uv/editing.rst +++ b/manual/modeling/meshes/uv/editing.rst @@ -311,7 +311,7 @@ Pinned islands can have additional restrictions applied to customize the packing 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. + :Cardinal: Like the four cardinal directions on a compass, North, South, East and West, only 90-degree turns will be allowed. Margin Method @@ -325,7 +325,7 @@ Pinned islands can have additional restrictions applied to customize the packing The scale for the empty space between islands. Pinned Islands - An island which has any of it's UVs pinned is considered a *Pinned Island*. + An island which has any of its UVs pinned is considered a *Pinned Island*. With this option, you can change the way *Pinned Islands* are packed :Pack: *Pinned Islands* are packed in the same way as other islands. -- 2.30.2