[Bf-docboard-svn] bf-manual: [9348] branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing: Object: Set Parent (Keep Transform Without Inverse)

[Aaron Carlisle]

Revision: 9348
          https://developer.blender.org/rBM9348
Author:   Blendify
Date:     2022-06-08 04:44:01 +0200 (Wed, 08 Jun 2022)
Log Message:
-----------
Object: Set Parent (Keep Transform Without Inverse)

rBdb6287873cd2c79741439f4d141c4b2db517d73e

Modified Paths:
--------------
    branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing/apply.rst
    branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing/parent.rst

Modified: branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing/apply.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing/apply.rst	2022-06-08 02:06:54 UTC (rev 9347)
+++ branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing/apply.rst	2022-06-08 02:44:01 UTC (rev 9348)
@@ -176,3 +176,16 @@
 
    Simple cases (like an empty instancing a collection containing instances of some other collections)
    will usually work, but more complex cases will fail to fully reproduce the whole instancing hierarchy.
+
+
+.. _bpy.ops.object.parent_inverse_apply:
+
+Parent Inverse
+==============
+
+.. reference::
+
+   :Mode:      Object Mode
+   :Menu:      :menuselection:`Object --> Apply --> Parent Inverse`
+
+Applies the object's :ref:`parent-inverse-matrix` transform to the object data.

Modified: branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing/parent.rst
===================================================================
--- branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing/parent.rst	2022-06-08 02:06:54 UTC (rev 9347)
+++ branches/blender-3.2-release/blender_docs/manual/scene_layout/object/editing/parent.rst	2022-06-08 02:44:01 UTC (rev 9348)
@@ -323,7 +323,12 @@
 This sets the parent, and then resets the *Parent Inverse* matrix and the object's local location.
 As a result, the object will move to the location of the parent, but keep its rotation and scale.
 
+Keep Transform
+   The object's current world transform (so its absolute location, rotation and scale in the world) is computed.
+   The new parent is set, and then the *Parent Inverse* matrix is computed such that after setting
+   the new parent the object is still at its previous world transform.
 
+
 .. _bpy.ops.object.parent_clear:
 
 Clear Parent
@@ -341,10 +346,12 @@
    If the parent in the group is selected, nothing is done.
    If a child or children are selected, they are disassociated from the parent,
    or freed, and they return to their *original* location, rotation, and size.
+
 Clear and Keep Transformation
    Frees the children from the parent, and *keeps* the location, rotation, and size given to them by the parent.
 
    See `Non-Uniform Scale`_ which may apply here.
+
 Clear Parent Inverse
    Instead of removing the hierarchical parent-child relationship, this clears
    the `Parent Inverse`_ matrix from the selected objects. With an empty matrix,