[Bf-docboard-svn] bf-manual: [8992] Merge branch 'blender-3.1-release'
Aaron Carlisle
noreply at blender.org
Tue Feb 22 03:49:52 CET 2022
Revision: 8992
https://developer.blender.org/rBM8992
Author: Blendify
Date: 2022-02-22 03:49:52 +0100 (Tue, 22 Feb 2022)
Log Message:
-----------
Merge branch 'blender-3.1-release'
Modified Paths:
--------------
trunk/blender_docs/manual/addons/uv/magic_uv.rst
Property Changed:
----------------
trunk/blender_docs/
Index: trunk/blender_docs
===================================================================
--- trunk/blender_docs 2022-02-22 02:49:33 UTC (rev 8991)
+++ trunk/blender_docs 2022-02-22 02:49:52 UTC (rev 8992)
Property changes on: trunk/blender_docs
___________________________________________________________________
Modified: svn:mergeinfo
## -1,4 +1,4 ##
/branches/blender-2.92-release/blender_docs:7610-7921
/branches/blender-2.93-release/blender_docs:7959-8113
/branches/blender-3.0-release/blender_docs:8543-8943
-/branches/blender-3.1-release/blender_docs:8904-8986
\ No newline at end of property
+/branches/blender-3.1-release/blender_docs:8904-8991
\ No newline at end of property
Modified: trunk/blender_docs/manual/addons/uv/magic_uv.rst
===================================================================
--- trunk/blender_docs/manual/addons/uv/magic_uv.rst 2022-02-22 02:49:33 UTC (rev 8991)
+++ trunk/blender_docs/manual/addons/uv/magic_uv.rst 2022-02-22 02:49:52 UTC (rev 8992)
@@ -1,11 +1,10 @@
+.. _bpy.types.Scene.muv:
+.. _bpy.ops.uv.muv:
********
Magic UV
********
-The documentation can be found in Magic UV's `Github repository <https://github.com/nutti/Magic-UV/wiki>`__.
-
-
Activation
==========
@@ -13,11 +12,887 @@
- Click UV then Magic UV to enable the script.
+Interface
+=========
+
+Located in the :menuselection:`3D Viewport --> Sidebar --> Edit`
+and :menuselection:`UV Editor --> Sidebar --> Magic UV`.
+
+
+Instructions
+============
+
+- :ref:`Copy/Paste UV <copypaste-uv>`
+- :ref:`Transfer UV <transfer-uv>`
+- :ref:`Flip/Rotate UV <fliprotate-uv>`
+- :ref:`Mirror UV <mirror-uv>`
+- :ref:`Move UV <move-uv>`
+- :ref:`World Scale UV <world-scale-uv>`
+- :ref:`Preserve UV Aspect <preserve-uv-aspect>`
+- :ref:`Texture Lock <texture-lock>`
+- :ref:`Texture Wrap <texture-wrap>`
+- :ref:`UV Sculpt <uv-sculpt>`
+- :ref:`Unwrap Constraint <unwrap-constraint>`
+- :ref:`Texture Projection <texture-projection>`
+- :ref:`UVW <uvw>`
+- :ref:`Align UV <align-uv>`
+- :ref:`Smooth UV <smooth-uv>`
+- :ref:`Select UV <select-uv>`
+- :ref:`Pack UV (Extension) <pack-uv-extension>`
+- :ref:`Clip UV <clip-uv>`
+- :ref:`Align UV Cursor <align-uv-cursor>`
+- :ref:`UV Cursor Location <uv-cursor-location>`
+- :ref:`UV Bounding Box <uv-bounding-box>`
+- :ref:`UV Inspection <uv-inspection>`
+
+
+.. _copypaste-uv:
+
+Copy/Paste UV
+-------------
+
+3D Viewport (Edit)
+^^^^^^^^^^^^^^^^^^
+
.. reference::
+ :Editor: 3D Viewport
+ :Mode: Edit
+ :Menu: :menuselection:`UV --> Copy/Paste UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> Copy/Paste UV --> Copy/Paste UV`
+
+Copy and paste UV coordinates among same/different object's faces in 3D View.
+Copy/Paste UV sometimes fails to paste UV correctly because of the incorrect UV index.
+Instead, you can try Transfer UV which you can copy and paste based on the topology.
+
+Target UV Map
+ :Default: Copy/paste UV maps currently displayed.
+ :All: Copy/Paste all UV maps.
+ :New: Allocate new UV map and paste to it.
+
+Copy/Paste Mode
+ :Selection Sequence: provides a way to specify the ordering of copied/pasted faces by face selection.
+Seams
+ If enabled, you can also copy/paste seams.
+Strategy
+ Provides a way to decide copy/paste UV repeatedly if a number of copied faces is differs from pasted faces.
+
+.. tip::
+
+ You can flip or rotate UV by changing *Flip Copied UV* property or *Rotate Copied UV* property.
+
+.. rubric:: Usage
+
+#. Click check box *Copy/Paste UV* to show Copy/Paste UV menu.
+#. Select faces whose UV you want to copy.
+#. Click :menuselection:`Copy --> (Target UV Map)`.
+#. Select faces whoe UV you want to paste.
+#. Click :menuselection:`Paste --> (Target UV Map)``.
+
+
+3D Viewport (Object)
+^^^^^^^^^^^^^^^^^^^^
+
+.. reference::
+
+ :Editor: 3D Viewport
+ :Mode: Object
+ :Menu: :menuselection:`Object --> Copy/Paste UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> Copy/Paste UV`
+
+Copy and paste UV coordinates among same topology objects.
+
+Copy/Target UV Map
+ :[Default]: Copy/paste UV maps currently displayed.
+ :[All]: Copy/Paste all UV maps.
+ :[New]: Allocate new UV map and paste to it.
+Seams
+ If enabled, you can also copy/paste seams.
+
+.. rubric:: Usage
+
+#. Select object whose UV you want to copy.
+#. Click :menuselection:`Copy --> (Target UV Map)`.
+#. Select objects whose UV you want to paste.
+#. Click :menuselection:`Paste --> (Target UV Map)`.
+
+.. tip::
+
+ You can paste UV to the multiple objects.
+
+
+UV Editor
+^^^^^^^^^
+
+.. reference::
+
+ :Editor: UV Editor
+ :Menu: :menuselection:`UV --> Copy/Paste UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> Copy/Paste UV`
+
+Copy and paste UV coordinates among same/different object's faces in UV Editor.
+
+.. rubric:: Usage
+
+#. Select UVs you want to copy.
+#. Click *Copy*.
+#. Select UVs you want to paste.
+#. Click *Paste*.
+
+.. note::
+
+ You must select UVs which consist closed loop (i.e. face).
+
+
+.. _transfer-uv:
+
+Transfer UV
+-----------
+
+.. reference::
+
+ :Editor: 3D Viewport
+ :Mode: Edit
+ :Menu: :menuselection:`UV --> Transfer UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> Copy/Paste UV --> Transfer UV`
+
+Copy and paste UV coordinates based on the mesh's topology.
+Transfer UV can solve the Copy/Paste UV issue raised when the meshes don't have same UV indices.
+However, Transfer UV also can not solve the issue raised when you try the meshes which don't have same topology.
+
+Invert Normals
+ If enabled, you can copy/paste to the mirrored mesh.
+Seams
+ If enabled, you can also copy/paste seams.
+
+.. rubric:: Usage
+
+#. Click check box *Transfer UV* to show Transfer UV menu.
+#. Select *2 adjacent faces* of the mesh whose UV you want to copy.
+#. Click *Copy*.
+#. Select *2 adjacent faces* of the mesh whose UV you want to paste.
+#. Click *Paste*.
+
+.. note::
+
+ - Copied/Pasted mesh must have the same number of faces.
+ - Transfer UV ignore the hidden faces.
+ - You can paste UV to the multiple meshes.
+
+
+.. _fliprotate-uv:
+
+Flip/Rotate UV
+--------------
+
+.. reference::
+
+ :Editor: 3D Viewport
+ :Mode: Edit
+ :Menu: :menuselection:`UV --> Flip/Rotate UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> UV Manipulation --> Flip/Rotate UV`
+
+Flip or rotate UV.
+
+Seams
+ If enabled, you can also flip/rotate seams.
+
+.. rubric:: Usage
+
+#. Click check box *Flip/Rotate UV* to show Flip/Rotate UV menu.
+#. Select faces whose UV you want to flip or rotate.
+#. Click *Flip/Rotate*.
+#. Change value *Flip UV* or *Rotate UV*.
+
+
+.. _mirror-uv:
+
+Mirror UV
+---------
+
+.. reference::
+
+ :Editor: 3D Viewport
+ :Mode: Edit
+ :Menu: :menuselection:`UV --> Mirror UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> UV Manipulation --> Mirror UV`
+
+Make mirrored UV.
+
+Error
+ Changes the error threshold for mirror.
+Origin
+ Specifies the origin of the mirror operation.
+
+.. rubric:: Usage
+
+#. Click check box *Mirror UV* to show Mirror UV menu.
+#. Select faces you want to refer.
+#. Choose the axis of the mirror direction.
+#. Click *Mirror*.
+
+
+.. _move-uv:
+
+Move UV
+-------
+
+.. reference::
+
+ :Editor: 3D Viewport
+ :Mode: Edit
+ :Menu: :menuselection:`UV --> Move UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> UV Manipulation --> Move UV`
+
+Move UV with a mouse in the 3D Viewport.
+
+.. rubric:: Usage
+
+#. Click check box *Move UV* to show Move UV menu.
+#. Select vertices/edges/faces whose UV you want to move.
+#. Click *Start*.
+#. Press *Mouse Left Button* to start moving UV.
+#. You can move UV with mouse.
+#. Press *Mouse Left Button* to stop moving UV.
+
+If you want to cancel moving UV, press :kbd:`RMB`.
+
+
+.. _world-scale-uv:
+
+World Scale UV
+--------------
+
+.. reference::
+
+ :Editor: 3D Viewport
+ :Mode: Edit
+ :Menu: :menuselection:`UV --> World Scale UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> UV Manipulation --> World Scale UV`
+
+Measure and set texel density.
+
+Texture
+ Texture to be used for the size calculation of density.
+
+ :[Average]: Average size of textures assigned to the selected object.
+ :[Max]: Max size of textures assigned to the selected object.
+ :[Min]: Min size of textures assigned to the selected object.
+ :(Texture Name): Size of selected texture.
+Origin
+ Changes the UV origin after applying texel density.
+Area Calculation Method
+ Method to calculate mesh area, UV area and density.
+Only Selected
+ If enabled, measure/apply only to the selected faces.
+
+
+Mode: Manual
+^^^^^^^^^^^^
+
+.. rubric:: Usage
+
+#. Click check box *World Scale UV* to show World Scale UV menu.
+#. Select mode *Manual*.
+#. Change value *Texture Size* referred as virtual texture size.
+#. Change value *Density* referred as target texel density.
+#. Select face you want to apply texel density.
+#. Click *Apply*.
+
+
+Mode: Same Density
+^^^^^^^^^^^^^^^^^^
+
+.. rubric:: Usage
+
+#. Click check box *World Scale UV* to show World Scale UV menu.
+#. Select mode *Same Density*.
+#. Select face you want to measure a texel density.
+#. Click *Measure*.
+#. You can see the target texel density.
+#. Select face you want to apply texel density.
+#. Click *Apply*.
+
+
+Mode: Scaling Density
+^^^^^^^^^^^^^^^^^^^^^
+
+.. rubric:: Usage
+
+#. Click check box *World Scale UV* to show World Scale UV menu.
+#. Select mode *Scaling Density*.
+#. Select face you want to measure a texel density.
+#. Click *Measure*.
+#. You can see the measured texel density.
+#. Change value *Scaling Factor* for the scale factor of the texel density.
+#. Select face you want to apply texel density.
+#. Click *Apply*.
+
+
+Mode: Proportional to Mesh
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. rubric:: Usage
+
+#. Click check box *World Scale UV* to show World Scale UV menu.
+#. Select mode *Proportional to Mesh*.
+#. Select face you want to measure a texel density.
+#. Click *Measure*.
+#. You can see the measured mesh area, UV area and density.
+#. Select face you want to apply texel density.
+#. Click *Apply*.
+
+
+.. _preserve-uv-aspect:
+
+Preserve UV Aspect
+------------------
+
+.. reference::
+
+ :Editor: 3D Viewport
+ :Menu: :menuselection:`UVs --> Preserve UV`
+ :Panel: :menuselection:`Sidebar --> Magic UV --> UV Manipulation --> Preserve UV Aspect`
+
+Change assigned texture with preserving UV aspect.
+
+Origin
@@ Diff output truncated at 10240 characters. @@
More information about the Bf-docboard-svn
mailing list