[Bf-docboard-svn] bf-manual: [7776] trunk/blender_docs/manual: UI: Object "Make Links" sub-menu overhaul

Aaron Carlisle noreply at blender.org
Sat Feb 20 06:46:26 CET 2021


Revision: 7776
          https://developer.blender.org/rBM7776
Author:   Blendify
Date:     2021-02-20 06:46:26 +0100 (Sat, 20 Feb 2021)
Log Message:
-----------
UI: Object "Make Links" sub-menu overhaul

rB685419d6bebfec1542ecbe8c3542baba88132604

Modified Paths:
--------------
    trunk/blender_docs/manual/modeling/meshes/editing/mesh/normals.rst
    trunk/blender_docs/manual/modeling/modifiers/modify/data_transfer.rst
    trunk/blender_docs/manual/scene_layout/object/editing/index.rst
    trunk/blender_docs/manual/scene_layout/object/editing/relations/index.rst
    trunk/blender_docs/manual/scene_layout/scene/introduction.rst
    trunk/blender_docs/manual/scene_layout/scene/properties.rst
    trunk/blender_docs/manual/sculpt_paint/weight_paint/editing.rst

Added Paths:
-----------
    trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/
    trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/copy_uvmaps.rst
    trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/index.rst
    trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_data.rst
    trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_scene.rst
    trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/transfer_mesh_data.rst
    trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/transfer_mesh_data_layout.rst

Removed Paths:
-------------
    trunk/blender_docs/manual/scene_layout/object/editing/make_links.rst
    trunk/blender_docs/manual/scene_layout/object/editing/relations/transfer_mesh_data.rst
    trunk/blender_docs/manual/scene_layout/object/editing/relations/transfer_mesh_data_layout.rst

Modified: trunk/blender_docs/manual/modeling/meshes/editing/mesh/normals.rst
===================================================================
--- trunk/blender_docs/manual/modeling/meshes/editing/mesh/normals.rst	2021-02-20 04:39:03 UTC (rev 7775)
+++ trunk/blender_docs/manual/modeling/meshes/editing/mesh/normals.rst	2021-02-20 05:46:26 UTC (rev 7776)
@@ -15,7 +15,7 @@
    including *Face Strength* (see below).
 
    You can also copy normals from another mesh using Mesh Data Transfer
-   (:doc:`operator </scene_layout/object/editing/relations/transfer_mesh_data>`
+   (:doc:`operator </scene_layout/object/editing/link_transfer/transfer_mesh_data>`
    or :doc:`modifier </modeling/modifiers/modify/data_transfer>`).
 
 

Modified: trunk/blender_docs/manual/modeling/modifiers/modify/data_transfer.rst
===================================================================
--- trunk/blender_docs/manual/modeling/modifiers/modify/data_transfer.rst	2021-02-20 04:39:03 UTC (rev 7775)
+++ trunk/blender_docs/manual/modeling/modifiers/modify/data_transfer.rst	2021-02-20 05:46:26 UTC (rev 7776)
@@ -20,7 +20,7 @@
 
 .. seealso::
 
-   :doc:`Transfer Mesh Data Operator </scene_layout/object/editing/relations/transfer_mesh_data>`
+   :doc:`Transfer Mesh Data Operator </scene_layout/object/editing/link_transfer/transfer_mesh_data>`
 
 
 Options

Modified: trunk/blender_docs/manual/scene_layout/object/editing/index.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/index.rst	2021-02-20 04:39:03 UTC (rev 7775)
+++ trunk/blender_docs/manual/scene_layout/object/editing/index.rst	2021-02-20 05:46:26 UTC (rev 7776)
@@ -17,7 +17,7 @@
    join.rst
    parent.rst
    relations/index.rst
-   make_links.rst
+   link_transfer/index.rst
    shading.rst
    convert.rst
    show_hide.rst

Added: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/copy_uvmaps.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/copy_uvmaps.rst	                        (rev 0)
+++ trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/copy_uvmaps.rst	2021-02-20 05:46:26 UTC (rev 7776)
@@ -0,0 +1,16 @@
+.. _bpy.ops.object.join_uvs:
+
+************
+Copy UV Maps
+************
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Link/Transfer Data --> Copy UV Maps`
+
+The active UV map of the selected objects will be replaced by a copy of
+the active UV map of the active object. If the selected object doesn't
+have any UV maps, it is created. Objects must be of type mesh and
+must have a matching topology.


Property changes on: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/copy_uvmaps.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/index.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/index.rst	                        (rev 0)
+++ trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/index.rst	2021-02-20 05:46:26 UTC (rev 7776)
@@ -0,0 +1,20 @@
+
+######################
+  Link/Transfer Data
+######################
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Link/Transfer Data`
+   :Hotkey:    :kbd:`Ctrl-L`
+
+.. toctree::
+   :maxdepth: 2
+
+   link_scene.rst
+   link_data.rst
+   copy_uvmaps.rst
+   transfer_mesh_data.rst
+   transfer_mesh_data_layout.rst


Property changes on: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/index.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_data.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_data.rst	                        (rev 0)
+++ trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_data.rst	2021-02-20 05:46:26 UTC (rev 7776)
@@ -0,0 +1,80 @@
+.. _bpy.ops.object.make_links_data:
+
+*********
+Link Data
+*********
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Link/Transfer Data...`
+
+Links objects between scenes or data-blocks of the active object to all selected objects.
+In some case (i.e. Object Data, Modifier) the target objects must be
+of the same type as the active one or capable of receiving the data.
+If targets already have data linked to them, it will be unlinked first.
+
+Type
+   Data-block type to link.
+
+   - `Link Object Data`_
+   - `Link Materials`_
+   - `Link Animation Data`_
+   - `Link Collections`_
+   - `Link Instance Collection`_
+   - `Link Fonts to Text`_
+   - `Copy Modifiers`_
+   - `Copy Grease Pencil Effects`_
+
+.. seealso::
+
+   :ref:`data-system-datablock-make-single-user` for unlinking data-blocks.
+
+
+Link Object Data
+================
+
+Replace assigned Object Data.
+
+
+Link Materials
+==============
+
+Replace assigned Materials.
+
+
+Link Animation Data
+===================
+
+Replace assigned Animation Data.
+
+
+Link Collections
+================
+
+Replace assigned Collections.
+
+
+Link Instance Collection
+========================
+
+Replace assigned Collection Instance.
+
+
+Link Fonts to Text
+==================
+
+Replace Text object Fonts.
+
+
+Copy Modifiers
+==============
+
+Replace Modifiers.
+
+
+Copy Grease Pencil Effects
+==========================
+
+Replace Grease Pencil Effects.


Property changes on: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_data.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_scene.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_scene.rst	                        (rev 0)
+++ trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_scene.rst	2021-02-20 05:46:26 UTC (rev 7776)
@@ -0,0 +1,18 @@
+.. _bpy.ops.object.make_links_scene:
+
+*********************
+Link Objects to Scene
+*********************
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Relations --> Transfer Mesh Data`
+
+Links the selected objects into a different scene than the current one.
+The *Link Objects to Scene* in the :ref:`ui-undo-redo-adjust-last-operation` panel lets you choose between scenes.
+
+This makes the same object exist in more than one scene at once,
+including its position and animation data.
+The object's origin will change its color to reflect that.


Property changes on: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/link_scene.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/transfer_mesh_data.rst
===================================================================
--- trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/transfer_mesh_data.rst	                        (rev 0)
+++ trunk/blender_docs/manual/scene_layout/object/editing/link_transfer/transfer_mesh_data.rst	2021-02-20 05:46:26 UTC (rev 7776)
@@ -0,0 +1,172 @@
+.. _bpy.ops.object.data_transfer:
+
+******************
+Transfer Mesh Data
+******************
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Relations --> Transfer Mesh Data`
+
+The *Data Transfer* tool transfers several types of data from one mesh to another.
+Data types include vertex groups, UV maps, vertex colors, custom normals...
+Transfer works by generating a mapping between source mesh's elements (vertices, edges, etc.)
+and destination ones, either on a one-to-one basis, or mapping several source elements
+to a single destination one by interpolated mapping.
+
+Transfers data layer(s) from active to selected meshes.
+
+Freeze Operator
+   Prevent changes to settings to re-run the operator.
+   This is useful if you are editing several settings at once with heavy geometry.
+Data Type
+   Which data to transfer.
+
+   .. figure:: /images/scene-layout_object_editing_relations_menu.png
+
+      Data types.
+
+Create Data
+   Add data layers on destination meshes if needed.
+Vertex Mapping
+   Method used to map source vertices to destination ones.
+   Because the options change depending on the *Data Type*
+   options are explained in `Vertex Mapping`_ below.
+
+
+Vertex Mapping
+==============
+
+Topology
+--------
+
+The simplest option, expects both meshes to have identical number of elements, and match them by order (indices).
+Useful e.g. between meshes that were identical copies, and got deformed differently.
+
+
+One-To-One Mappings
+-------------------
+
+Those always select only one source element for each destination one, often based on shortest distance.
+
+Vertices
+   Nearest Vertex
+      Uses source's nearest vertex.
+
+   Nearest Edge Vertex
+      Uses source's nearest vertex of source's nearest edge.
+
+   Nearest Face Vertex
+      Uses source's nearest vertex of source's nearest face.
+
+Edges
+   Nearest Vertices
+      Uses source's edge which vertices are nearest from destination edge's vertices.
+
+   Nearest Edge
+      Uses source's nearest edge (using edge's midpoints).
+   Nearest Face Edge
+      Uses source's nearest edge of source's nearest face (using edge's midpoints).
+Face Corners
+   A face corner is not a real element by itself, it's some kind of split vertex attached to a specific face.
+   Hence both vertex (location) and face (normal, ...) aspects are used to match them together.
+
+   Nearest Corner and Best Matching Normal
+      Uses source's corner having the most similar *split* normal with destination one,

@@ Diff output truncated at 10240 characters. @@


More information about the Bf-docboard-svn mailing list