Implement an Armature constraint that mimics the modifier.

The main use one can imagine for this is adding tweak controls to
parts of a model that are already deformed by multiple other major
bones. It is natural to expect such locations to deform as if the
tweaks aren't there by default; however currently there is no easy
way to make a bone follow multiple other bones.

This adds a new constraint that implements the math behind the Armature
modifier, with support for explicit weights, bone envelopes, and dual
quaternion blending. It can also access bones from multiple armatures
at the same time (mainly because it's easier to code it that way.)

This also fixes dquat_to_mat4, which wasn't used anywhere before.

Differential Revision: https://developer.blender.org/D3664

3 files changed, 117 insertions, 0 deletions

diff --git a/release/scripts/startup/bl_operators/__init__.py b/release/scripts/startup/bl_operators/__init__.py
index de538634595..4d9038684d1 100644
--- a/release/scripts/startup/bl_operators/__init__.py
+++ b/release/scripts/startup/bl_operators/__init__.py
@@ -29,6 +29,7 @@ _modules = [
     "anim",
     "clip",
     "console",
+    "constraint",
     "file",
     "image",
     "mask",
diff --git a/release/scripts/startup/bl_operators/constraint.py b/release/scripts/startup/bl_operators/constraint.py
new file mode 100644
index 00000000000..cf70022ed48
--- /dev/null
+++ b/release/scripts/startup/bl_operators/constraint.py
@@ -0,0 +1,76 @@
+# ##### BEGIN GPL LICENSE BLOCK #####
+#
+#  This program is free software; you can redistribute it and/or
+#  modify it under the terms of the GNU General Public License
+#  as published by the Free Software Foundation; either version 2
+#  of the License, or (at your option) any later version.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public License
+#  along with this program; if not, write to the Free Software Foundation,
+#  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+#
+# ##### END GPL LICENSE BLOCK #####
+
+# <pep8-80 compliant>
+
+import bpy
+from bpy.types import (
+    Operator,
+)
+from bpy.props import (
+    IntProperty,
+)
+
+
+class CONSTRAINT_OT_add_target(Operator):
+    """Add a target to the constraint"""
+    bl_idname = "constraint.add_target"
+    bl_label = "Add Target"
+    bl_options = {'UNDO', 'INTERNAL'}
+
+    def execute(self, context):
+        context.constraint.targets.new()
+        return {'FINISHED'}
+
+
+class CONSTRAINT_OT_remove_target(Operator):
+    """Remove the target from the constraint"""
+    bl_idname = "constraint.remove_target"
+    bl_label = "Remove Target"
+    bl_options = {'UNDO', 'INTERNAL'}
+
+    index = IntProperty()
+
+    def execute(self, context):
+        tgts = context.constraint.targets
+        tgts.remove(tgts[self.index])
+        return {'FINISHED'}
+
+
+class CONSTRAINT_OT_normalize_target_weights(Operator):
+    """Normalize weights of all target bones"""
+    bl_idname = "constraint.normalize_target_weights"
+    bl_label = "Normalize Weights"
+    bl_options = {'UNDO', 'INTERNAL'}
+
+    def execute(self, context):
+        tgts = context.constraint.targets
+        total = sum(t.weight for t in tgts)
+
+        if total > 0:
+            for t in tgts:
+                t.weight = t.weight / total
+
+        return {'FINISHED'}
+
+
+classes = (
+    CONSTRAINT_OT_add_target,
+    CONSTRAINT_OT_remove_target,
+    CONSTRAINT_OT_normalize_target_weights,
+)
diff --git a/release/scripts/startup/bl_ui/properties_constraint.py b/release/scripts/startup/bl_ui/properties_constraint.py
index 30822fbe9a1..b1c0217f9c9 100644
--- a/release/scripts/startup/bl_ui/properties_constraint.py
+++ b/release/scripts/startup/bl_ui/properties_constraint.py
@@ -919,6 +919,46 @@ class ConstraintButtonsPanel:
     def SCRIPT(self, context, layout, con):
         layout.label(text="Blender 2.6 doesn't support python constraints yet")
 
+    def ARMATURE(self, context, layout, con):
+        topcol = layout.column()
+        topcol.use_property_split = True
+        topcol.operator("constraint.add_target", text="Add Target Bone")
+
+        if not con.targets:
+            box = topcol.box()
+            box.label(text="No target bones were added", icon="ERROR")
+
+        for i, tgt in enumerate(con.targets):
+            box = topcol.box()
+
+            has_target = tgt.target is not None
+
+            header = box.row()
+            header.use_property_split = False
+
+            split = header.split(factor=0.45, align=True)
+            split.prop(tgt, "target", text="")
+
+            row = split.row(align=True)
+            row.active = has_target
+            if has_target:
+                row.prop_search(tgt, "subtarget", tgt.target.data, "bones", text="")
+            else:
+                row.prop(tgt, "subtarget", text="", icon="BONE_DATA")
+
+            header.operator("constraint.remove_target", icon="REMOVE", text="").index = i
+
+            col = box.column()
+            col.active = has_target and tgt.subtarget != ""
+            col.prop(tgt, "weight", slider=True)
+
+        topcol.operator("constraint.normalize_target_weights")
+        topcol.prop(con, "use_deform_preserve_volume")
+        topcol.prop(con, "use_bone_envelopes")
+
+        if context.pose_bone:
+            topcol.prop(con, "use_current_location")
+
 
 class OBJECT_PT_constraints(ConstraintButtonsPanel, Panel):
     bl_label = "Object Constraints"