[Bf-docboard-svn] bf-manual: [8731] branches/blender-3.0-release/blender_docs/manual/editors/uv: UV snapping improvements

[Aaron Carlisle]

Revision: 8731
          https://developer.blender.org/rBM8731
Author:   Blendify
Date:     2021-12-02 05:15:14 +0100 (Thu, 02 Dec 2021)
Log Message:
-----------
UV snapping improvements

rBbf06f76be6316be92a4655a41391e163d2fb1221

Modified Paths:
--------------
    branches/blender-3.0-release/blender_docs/manual/editors/uv/index.rst
    branches/blender-3.0-release/blender_docs/manual/editors/uv/introduction.rst
    branches/blender-3.0-release/blender_docs/manual/editors/uv/overlays.rst
    branches/blender-3.0-release/blender_docs/manual/editors/uv/sidebar.rst

Added Paths:
-----------
    branches/blender-3.0-release/blender_docs/manual/editors/uv/controls/
    branches/blender-3.0-release/blender_docs/manual/editors/uv/controls/snapping.rst

Added: branches/blender-3.0-release/blender_docs/manual/editors/uv/controls/snapping.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/editors/uv/controls/snapping.rst	                        (rev 0)
+++ branches/blender-3.0-release/blender_docs/manual/editors/uv/controls/snapping.rst	2021-12-02 04:15:14 UTC (rev 8731)
@@ -0,0 +1,52 @@
+
+********
+Snapping
+********
+
+.. _bpy.types.ToolSettings.snap_uv_element:
+
+Snap To
+=======
+
+.. reference::
+
+   :Header:    :menuselection:`Snapping --> Snap To`
+   :Shortcut:  :kbd:`Shift-Ctrl-Tab`
+
+Increment
+   Snap elements along points on a fixed scale.
+   These pointes are defined by the grid's intersection points
+   and the scale of the increments depending on zoom level,
+   unless using :ref:`bpy.types.SpaceUVEditor.use_custom_grid`.
+
+   The Custom Grid can also be used to define a set distance of the scale.
+
+   .. note::
+
+      In this context the grid does not mean the visual grid cue displayed.
+      Snapping will use the resolution of the displayed grid,
+      but all transformations are relative to the initial position (before the snap operation).
+
+      Note, the behavior can be disabled by using *Absolute Grid Snap*.
+
+Vertex
+   Snap to UV vertices.
+
+
+Additional Options
+==================
+
+.. _bpy.types.ToolSettings.use_snap_uv_grid_absolute:
+
+Absolute Grid Snap
+   Available only for the *Increment* option.
+   Snap to the visual grid, instead of snapping in increments relative to the current location.
+
+Target
+    See :ref:`3D Viewport Snapping <bpy.types.ToolSettings.snap_target>` for more information.
+
+
+Affect
+======
+
+Limits the effect of the snap to the transformation type.


Property changes on: branches/blender-3.0-release/blender_docs/manual/editors/uv/controls/snapping.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: branches/blender-3.0-release/blender_docs/manual/editors/uv/index.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/editors/uv/index.rst	2021-12-02 02:51:32 UTC (rev 8730)
+++ branches/blender-3.0-release/blender_docs/manual/editors/uv/index.rst	2021-12-02 04:15:14 UTC (rev 8731)
@@ -13,3 +13,4 @@
    overlays.rst
    sidebar.rst
    selecting.rst
+   controls/snapping.rst

Modified: branches/blender-3.0-release/blender_docs/manual/editors/uv/introduction.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/editors/uv/introduction.rst	2021-12-02 02:51:32 UTC (rev 8730)
+++ branches/blender-3.0-release/blender_docs/manual/editors/uv/introduction.rst	2021-12-02 04:15:14 UTC (rev 8731)
@@ -144,16 +144,17 @@
 Display Channels
    Select what color channels are displayed.
 
-   Color and Alpha
+   :Color and Alpha:
       Replaces transparent pixels with background checkerboard, denoting the alpha channel.
-   Color
+   :Color:
       Display the colored image, without alpha channel.
-   Alpha
-      Displays the Alpha channel a grayscale image. White areas are opaque, black areas have an alpha of 0.
-   Z-Buffer
+   :Alpha:
+      Displays the Alpha channel a grayscale image.
+      White areas are opaque, black areas have an alpha of 0.
+   :Z-Buffer:
       Display the depth from the camera, from Clip Start to Clip End,
       as specified in the :doc:`Camera settings </render/cameras>`.
-   Red, Green, Blue
+   :Red, Green, Blue:
       Single Color Channel visualized as a grayscale image.
 
 
@@ -162,7 +163,7 @@
 
 Pivot
    Similar to working with pivot points in the 3D Viewport.
-UV Snapping
-   Similar to Snapping in the 3D Viewport.
+:doc:`UV Snapping </editors/uv/controls/snapping>`
+   Controls to snap UV points, similar to snapping in the 3D Viewport.
 Proportional Editing
    See :doc:`Proportional Editing </editors/3dview/controls/proportional_editing>`.

Modified: branches/blender-3.0-release/blender_docs/manual/editors/uv/overlays.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/editors/uv/overlays.rst	2021-12-02 02:51:32 UTC (rev 8730)
+++ branches/blender-3.0-release/blender_docs/manual/editors/uv/overlays.rst	2021-12-02 04:15:14 UTC (rev 8731)
@@ -43,7 +43,7 @@
    :Black: Display black edges.
    :White: Display white edges.
 
-.. _bpy.types.SpaceUVEditor.show_modified_edges::
+.. _bpy.types.SpaceUVEditor.show_modified_edges:
 
 Modified Edges
    Show results of modifiers in the UV display.

Modified: branches/blender-3.0-release/blender_docs/manual/editors/uv/sidebar.rst
===================================================================
--- branches/blender-3.0-release/blender_docs/manual/editors/uv/sidebar.rst	2021-12-02 02:51:32 UTC (rev 8730)
+++ branches/blender-3.0-release/blender_docs/manual/editors/uv/sidebar.rst	2021-12-02 04:15:14 UTC (rev 8731)
@@ -73,6 +73,11 @@
 Custom Grid
 -----------
 
+Displays a grid that does not depend on the zoom level to determine
+the number of subdivisions. The Custom Grid is useful in combination with
+:ref:`Absolute Grid Snap <bpy.types.ToolSettings.use_snap_uv_grid_absolute>`
+to create precise incremental snapping.
+
 .. _bpy.types.SpaceUVEditor.custom_grid_subdivisions:
 
 Subdivisions
@@ -85,4 +90,3 @@
 ======
 
 See :ref:`editors-image-scopes` in the Image Editor.
-