rigidbody: Add rigid body constraints

Constraints connect two rigid bodies.
Depending on which constraint is used different degrees of freedom
are limited, e.g. a hinge constraint only allows the objects to rotate
around a common axis.

Constraints are implemented as individual objects and bahave similar to
rigid bodies in terms of adding/removing/validating.

The position and orientation of the constraint object is the pivot point
of the constraint.

Constraints have their own group in the rigid body world.

To make connecting rigid bodies easier, there is a "Connect" operator that
creates an empty objects with a rigid body constraint connecting the selected
objects to active.

Currently the following constraints are implemented:
* Fixed
* Point
* Hinge
* Slider
* Piston
* Generic

Note: constraint limits aren't animatable yet).

1 files changed, 215 insertions, 0 deletions

diff --git a/release/scripts/startup/bl_ui/properties_physics_rigidbody_constraint.py b/release/scripts/startup/bl_ui/properties_physics_rigidbody_constraint.py
new file mode 100644
index 00000000000..8bd64d0324a
--- /dev/null
+++ b/release/scripts/startup/bl_ui/properties_physics_rigidbody_constraint.py
@@ -0,0 +1,215 @@
+# ##### 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 compliant>
+import bpy
+from bpy.types import Panel
+
+
+class PHYSICS_PT_rigidbody_constraint_panel():
+    bl_space_type = 'PROPERTIES'
+    bl_region_type = 'WINDOW'
+    bl_context = "physics"
+
+
+class PHYSICS_PT_rigid_body_constraint(PHYSICS_PT_rigidbody_constraint_panel, Panel):
+    bl_label = "Rigid Body Constraint"
+
+    @classmethod
+    def poll(cls, context):
+        ob = context.object
+        rd = context.scene.render
+        return (ob and ob.rigid_body_constraint and (not rd.use_game_engine))
+
+    def draw(self, context):
+        layout = self.layout
+
+        ob = context.object
+        rbc = ob.rigid_body_constraint
+
+        if rbc:
+            layout.prop(rbc, "type")
+
+            split = layout.split()
+
+            row = split.row()
+            row.prop(rbc, "enabled")
+            row.prop(rbc, "disable_collisions")
+
+            split = layout.split()
+            split.prop(rbc, "object1")
+            split = layout.split()
+            split.prop(rbc, "object2")
+
+            split = layout.split()
+            col = split.row()
+            col.prop(rbc, "use_breaking")
+            sub = col.column()
+            sub.active = rbc.use_breaking
+            sub.prop(rbc, "breaking_threshold", text="Threshold")
+
+            split = layout.split()
+            col = split.row()
+            col.prop(rbc, "override_solver_iterations", text="Override Iterations")
+            sub = col.split()
+            sub.active = rbc.override_solver_iterations
+            sub.prop(rbc, "num_solver_iterations", text="Iterations")
+
+            if rbc.type == 'HINGE':
+                col = layout.column(align=True)
+                col.label("Limits:")
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_ang_z", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_ang_z
+                sub.prop(rbc, "limit_ang_z_lower", text="Lower")
+                sub.prop(rbc, "limit_ang_z_upper", text="Upper")
+
+            elif rbc.type == 'SLIDER':
+                col = layout.column(align=True)
+                col.label("Limits:")
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_lin_x", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_lin_x
+                sub.prop(rbc, "limit_lin_x_lower", text="Lower")
+                sub.prop(rbc, "limit_lin_x_upper", text="Upper")
+
+            elif rbc.type == 'PISTON':
+                col = layout.column(align=True)
+                col.label("Limits:")
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_lin_x", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_lin_x
+                sub.prop(rbc, "limit_lin_x_lower", text="Lower")
+                sub.prop(rbc, "limit_lin_x_upper", text="Upper")
+
+                col = layout.column(align=True)
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_ang_x", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_ang_x
+                sub.prop(rbc, "limit_ang_x_lower", text="Lower")
+                sub.prop(rbc, "limit_ang_x_upper", text="Upper")
+
+            elif rbc.type in {'GENERIC', 'GENERIC_SPRING'}:
+                col = layout.column(align=True)
+                col.label("Limits:")
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_lin_x", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_lin_x
+                sub.prop(rbc, "limit_lin_x_lower", text="Lower")
+                sub.prop(rbc, "limit_lin_x_upper", text="Upper")
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_lin_y", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_lin_y
+                sub.prop(rbc, "limit_lin_y_lower", text="Lower")
+                sub.prop(rbc, "limit_lin_y_upper", text="Upper")
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_lin_z", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_lin_z
+                sub.prop(rbc, "limit_lin_z_lower", text="Lower")
+                sub.prop(rbc, "limit_lin_z_upper", text="Upper")
+
+                col = layout.column(align=True)
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_ang_x", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_ang_x
+                sub.prop(rbc, "limit_ang_x_lower", text="Lower")
+                sub.prop(rbc, "limit_ang_x_upper", text="Upper")
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_ang_y", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_ang_y
+                sub.prop(rbc, "limit_ang_y_lower", text="Lower")
+                sub.prop(rbc, "limit_ang_y_upper", text="Upper")
+
+                row = col.row()
+                sub = row.row()
+                sub.scale_x = 0.5
+                sub.prop(rbc, "use_limit_ang_z", toggle=True)
+                sub = row.row()
+                sub.active = rbc.use_limit_ang_z
+                sub.prop(rbc, "limit_ang_z_lower", text="Lower")
+                sub.prop(rbc, "limit_ang_z_upper", text="Upper")
+
+                if rbc.type == 'GENERIC_SPRING':                  
+                    col = layout.column(align=True)
+                    col.label("Springs:")
+
+                    row = col.row()
+                    sub = row.row()
+                    sub.scale_x = 0.1
+                    sub.prop(rbc, "use_spring_x", toggle=True, text="X")
+                    sub = row.row()
+                    sub.active = rbc.use_spring_x
+                    sub.prop(rbc, "spring_stiffness_x", text="Stiffness")
+                    sub.prop(rbc, "spring_damping_x")
+
+                    row = col.row()
+                    sub = row.row()
+                    sub.scale_x = 0.1
+                    sub.prop(rbc, "use_spring_y", toggle=True, text="Y")
+                    sub = row.row()
+                    sub.active = rbc.use_spring_y
+                    sub.prop(rbc, "spring_stiffness_y", text="Stiffness")
+                    sub.prop(rbc, "spring_damping_y")
+
+                    row = col.row()
+                    sub = row.row()
+                    sub.scale_x = 0.1
+                    sub.prop(rbc, "use_spring_z", toggle=True, text="Z")
+                    sub = row.row()
+                    sub.active = rbc.use_spring_z
+                    sub.prop(rbc, "spring_stiffness_z", text="Stiffness")
+                    sub.prop(rbc, "spring_damping_z")
+
+if __name__ == "__main__":  # only for live edit.
+    bpy.utils.register_module(__name__)