adding ob_arm.makeParentBone([ob1, ob2...], bonename)

ob.parentbonename is also settable now as long as it already has a bone parent

1 files changed, 23 insertions, 1 deletions

diff --git a/source/blender/python/api2_2x/doc/Object.py b/source/blender/python/api2_2x/doc/Object.py
index bdb11c95905..6dd92624b74 100644
--- a/source/blender/python/api2_2x/doc/Object.py
+++ b/source/blender/python/api2_2x/doc/Object.py
@@ -374,7 +374,7 @@ class Object:
         Read-only.
     @type effects: list of Effect objects
     @ivar parentbonename: The string name of the parent bone (if defined).
-        Read-only.
+        This can be set to another bone in the armature if the object already has a bone parent
     @type parentbonename: string or None
     @ivar protectFlags: The "transform locking" bitfield flags for the object.  
     See L{ProtectFlags} const dict for values.
@@ -1003,6 +1003,28 @@ class Object:
         parents of other objects.  Calling this makeParent method for an
         unlinked object will result in an error.
     """
+  def makeParentBone(objects, bonename, noninverse = 0, fast = 0):
+    """
+    Makes one of the objects bones the parent of the objects provided in the argument
+    which must be a list of valid Objects.
+    The parent object must be an Armature.
+    @type objects: Sequence of Blender Object
+    @param objects: The children of the parent
+    @type bonename: string
+    @param bonename: a valid bone name from the armature
+    @type noninverse: Integer
+    @param noninverse:
+        0 - make parent with inverse
+        1 - make parent without inverse
+    @type fast: Integer
+    @param fast:
+        0 - update scene hierarchy automatically
+        1 - don't update scene hierarchy (faster). In this case, you must
+        explicitely update the Scene hierarchy.
+    @warn: objects must first be linked to a scene before they can become
+        parents of other objects.  Calling this makeParent method for an
+        unlinked object will result in an error.
+    """
 
   def setDeltaLocation(delta_location):
     """