[Bf-docboard-svn] bf-manual: [9792] trunk/blender_docs/manual: Addon: Copy Global Transform

[Sybren A. Stüvel]

Revision: 9792
          https://developer.blender.org/rBM9792
Author:   sybren
Date:     2022-12-12 15:32:10 +0100 (Mon, 12 Dec 2022)
Log Message:
-----------
Addon: Copy Global Transform

Add documentation for the Copy Global Transform add-on.

Modified Paths:
--------------
    trunk/blender_docs/manual/addons/animation/index.rst

Added Paths:
-----------
    trunk/blender_docs/manual/addons/animation/copy_global_transform.rst
    trunk/blender_docs/manual/images/addons_animation_copy-global-transform.png

Added: trunk/blender_docs/manual/addons/animation/copy_global_transform.rst
===================================================================
--- trunk/blender_docs/manual/addons/animation/copy_global_transform.rst	                        (rev 0)
+++ trunk/blender_docs/manual/addons/animation/copy_global_transform.rst	2022-12-12 14:32:10 UTC (rev 9792)
@@ -0,0 +1,82 @@
+
+*********************
+Copy Global Transform
+*********************
+
+Copy and paste object and bone transforms with ease.
+
+When copying, the global (:term:`World-Space`) transform is placed on the
+clipboard. This can then be pasted onto any object or bone, at the current frame
+or at another one.
+
+Since the tranfsorm is placed on the clipboard as text, you can even copy-paste
+it into an instant messenger and send it to someone else.
+
+
+Activation
+==========
+
+- Open Blender and go to Preferences then the Add-ons tab.
+- Click Animation then Copy Global Transform to enable the add-on.
+
+
+Interface
+=========
+
+Located in :menuselection:`3D Viewport --> N-panel --> Animation tab`.
+
+.. figure:: /images/addons_animation_copy-global-transform.webp
+   :align: right
+
+
+Description
+===========
+
+Copy
+   Inspects the active Object (in Object mode) or Bone (in Pose mode) and places
+   its current global transform onto the clipboard as a matrix.
+
+Paste
+   Takes the copied global transform and applies it to the active Object or
+   Bone. This is done by **adjusting its location, rotation, and scale properties**.
+
+Paste to Selected Keys
+   Paste as described above and additionally use auto-keying to update one or
+   more frames. The key selection is used to tell Blender *which frames* this
+   should happen on; it does not influence which parts of the transform are
+   keyed. *What* is keyed is determined by the active keying set.
+
+Paste and Bake
+   Almost the same as *Paste to Selected Keys*. Instead of only pasting on the
+   selected keys, *Paste and Bake* will paste & auto-key on every frame between
+   the first and last selected keys.
+
+
+Limitations
+===========
+
+Pasting a transform adjusts the Object/Bone's location, rotation, and
+scale. This means that when copying a skewed transform, this skew is lost.
+
+If there are constraints on the Object/Bone, the resulting visual transformation
+may not be the same as the pasted one. To give a concrete example: if you have a
+constraint that adds a rotation, it will always add that rotation on top of the
+pasted transform.
+
+
+.. seealso::
+
+   :doc:`/animation/armatures/posing/editing/pose_library` for a way to manage
+   and share entire poses.
+
+.. reference::
+
+   :Category: Animation
+   :Description: Simple add-on for copying world-space transforms.
+   :Location: :menuselection:`3D Viewport --> N-panel --> Animation tab`
+   :File: copy_global_transform.py
+   :Author: Sybren A. Stüvel
+   :Maintainer: Sybren A. Stüvel
+   :License: GPL 2+
+   :Support Level: Official
+   :Note: This add-on is bundled with Blender.


Property changes on: trunk/blender_docs/manual/addons/animation/copy_global_transform.rst
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/blender_docs/manual/addons/animation/index.rst
===================================================================
--- trunk/blender_docs/manual/addons/animation/index.rst	2022-12-11 21:37:17 UTC (rev 9791)
+++ trunk/blender_docs/manual/addons/animation/index.rst	2022-12-12 14:32:10 UTC (rev 9792)
@@ -10,5 +10,6 @@
 
    animall.rst
    bone_selection_sets.rst
+   copy_global_transform.rst
    corrective_shape_keys.rst
    turnaround_camera.rst

Added: trunk/blender_docs/manual/images/addons_animation_copy-global-transform.png
===================================================================
(Binary files differ)

Index: trunk/blender_docs/manual/images/addons_animation_copy-global-transform.png
===================================================================
--- trunk/blender_docs/manual/images/addons_animation_copy-global-transform.png	2022-12-11 21:37:17 UTC (rev 9791)
+++ trunk/blender_docs/manual/images/addons_animation_copy-global-transform.png	2022-12-12 14:32:10 UTC (rev 9792)

Property changes on: trunk/blender_docs/manual/images/addons_animation_copy-global-transform.png
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/octet-stream
\ No newline at end of property