Commit ec4195e4 authored by Campbell Barton's avatar Campbell Barton

Initial commit for T43509

by @johnroper100 - temp branch for review/improvements
parent 342e0215
Pipeline #4751 failed with stages
in 15 seconds
# ##### 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>
# This is based on the camera rigs addon by Wayne Dixon and Kris Wittig #
bl_info = {
"name": "Advanced Camera Rigs",
"author": "John Roper",
"version": (15, 0,),
"blender": (2, 73, 0),
"location": "Add > Armature",
"description": "Adds advanced camera rigs",
"warning": "Autorun Python Scripts must be enabled.",
"wiki_url": "http://www.starlightgraphics.co.nf/software/documentation/advanced_camera_rigs.php",
"category": "Rigging",
}
import bpy
import math
import mathutils
from math import pi
from math import *
from bpy.props import *
from bpy.props import FloatVectorProperty
from bpy.types import Operator
from rna_prop_ui import rna_idprop_ui_prop_get
from math import radians
from mathutils import Vector
###############################################
# define the functions to build the Widgets #
###############################################
def create_widget(self, name):
""" Creates an empty widget object for a bone, and returns the object."""
obj_name = "WDGT_" + name
scene = bpy.context.scene
# Check if it already exists
if obj_name in scene.objects:
return None
else:
mesh = bpy.data.meshes.new(obj_name)
obj = bpy.data.objects.new(obj_name, mesh)
scene.objects.link(obj)
# this will put the Widget objects out of the way on layer 19
WDGT_layers = (False, False, False, False, False, False, False, False, False, True, False, False, False, False, False, False, False, False, False, False)
obj.layers = WDGT_layers
return obj
def create_root_widget(self, name):
# Creates a compass-shaped widget.
obj = create_widget(self, name)
if obj != None:
verts = [(0.2102552056312561, -0.0012103617191314697, 0.21025514602661133), (0.11378927528858185, -0.001210339367389679, 0.274711549282074), (-3.070153553608179e-08, -0.0012103626504540443, 0.29734566807746887), (-0.11378933489322662, -0.0012103542685508728, 0.27471157908439636), (-0.2102552056312561, -0.0012103617191314697, 0.21025516092777252), (-0.27471160888671875, -0.0012103617191314697, 0.11378928273916245), (-0.29734569787979126, -0.0012103617191314697, -1.6809221392577456e-07), (0.29734572768211365, -0.001210331916809082, -1.0901101177296368e-07), (0.2747114598751068, -0.0012103617191314697, 0.11378948390483856), (0.07152898609638214, -0.0012103691697120667, 0.5070746541023254), (-0.07152895629405975, -0.0012103617191314697, 0.5070746541023254), (-0.07152898609638214, -0.0012103915214538574, 0.38030144572257996), (0.07152898609638214, -0.0012103691697120667, 0.38030144572257996), (-0.1325872540473938, -0.0012103617191314697, 0.5070746541023254), (0.13258719444274902, -0.0012103617191314697, 0.5070746541023254), (-3.070154264150915e-08, -0.0012104818597435951, 0.6688110828399658), (-0.274711549282074, -0.0012103617191314697, -0.11378948390483856), (0.274711549282074, -0.001210331916809082, -0.1137893795967102), (0.21025514602661133, -0.001210331916809082, -0.21025525033473969), (0.11378927528858185, -0.001210339367389679, -0.27471160888671875), (-9.030617320604506e-08, -0.0012103328481316566, -0.29734572768211365), (-0.11378933489322662, -0.0012103542685508728, -0.27471157908439636), (-0.2102552056312561, -0.001210331916809082, -0.21025516092777252), (-0.6688110828399658, -0.0012103915214538574, 5.982118267411352e-08), (-0.5070747137069702, -0.0012103915214538574, 0.13258729875087738), (-0.5070747137069702, -0.001210331916809082, -0.1325872540473938), (-0.38030147552490234, -0.0012103617191314697, 0.07152903825044632), (-0.38030147552490234, -0.0012103617191314697, -0.07152897119522095), (-0.5070747137069702, -0.001210331916809082, -0.07152896374464035), (-0.5070747137069702, -0.0012103915214538574, 0.07152900844812393), (0.5070745944976807, -0.001210331916809082, -0.07152891904115677), (0.5070745944976807, -0.001210331916809082, 0.07152905315160751), (0.38030144572257996, -0.0012103617191314697, 0.07152903825044632), (0.38030141592025757, -0.001210331916809082, -0.07152897119522095), (0.5070745944976807, -0.001210331916809082, 0.13258734345436096), (0.5070745944976807, -0.001210331916809082, -0.13258720934391022), (0.6688110828399658, -0.001210331916809082, 5.279173720396102e-08), (1.4811239168466273e-07, -0.001210303045809269, -0.6688110828399658), (-0.13258716464042664, -0.0012103021144866943, -0.5070746541023254), (0.13258737325668335, -0.0012103021144866943, -0.5070746541023254), (-0.07152889668941498, -0.0012103617191314697, -0.38030150532722473), (0.07152910530567169, -0.0012103095650672913, -0.38030150532722473), (0.07152910530567169, -0.0012103095650672913, -0.5070746541023254), (-0.07152886688709259, -0.0012103021144866943, -0.5070746541023254)]
edges = [(0, 1), (1, 2), (2, 3), (3, 4), (4, 5), (5, 6), (7, 8), (0, 8), (10, 11), (9, 12), (11, 12), (10, 13), (9, 14), (13, 15), (14, 15), (16, 22), (17, 18), (18, 19), (19, 20), (20, 21), (21, 22), (7, 17), (6, 16), (23, 24), (23, 25), (24, 29), (25, 28), (26, 27), (26, 29), (27, 28), (31, 32), (30, 33), (32, 33), (31, 34), (30, 35), (34, 36), (35, 36), (37, 38), (37, 39), (38, 43), (39, 42), (40, 41), (40, 43), (41, 42)]
mesh = obj.data
mesh.from_pydata(verts, edges, [])
mesh.update()
def create_camera_widget(self, name):
# Creates a camera ctrl widget.
obj = create_widget(self, name)
if obj != None:
verts = [(0.13756819069385529, 1.0706068032106941e-08, -0.13756819069385529), (0.1797415018081665, 5.353034016053471e-09, -0.07445136457681656), (0.19455081224441528, -6.381313819948996e-16, 8.504085435845354e-09), (0.1797415018081665, -5.353034016053471e-09, 0.07445138692855835), (0.13756819069385529, -1.0706068032106941e-08, 0.13756819069385529), (0.07445137947797775, -2.1412136064213882e-08, 0.1797415018081665), (-9.740904971522468e-08, -2.1412136064213882e-08, 0.19455081224441528), (-5.87527146933553e-08, 2.1412136064213882e-08, -0.19455081224441528), (0.0744515135884285, 2.1412136064213882e-08, -0.17974145710468292), (0.3317747414112091, 5.353034016053471e-09, -0.04680081456899643), (0.3317747414112091, -5.353034016053471e-09, 0.04680081456899643), (0.24882805347442627, -5.353034016053471e-09, 0.04680081456899643), (0.24882805347442627, 5.353034016053471e-09, -0.04680084437131882), (0.3317747414112091, -5.353034016053471e-09, 0.08675074577331543), (0.3317747414112091, 5.353034016053471e-09, -0.08675074577331543), (0.43759751319885254, 0.0, 0.0), (-0.07445148378610611, -2.1412136064213882e-08, 0.17974145710468292), (-0.07445141673088074, 2.1412136064213882e-08, -0.1797415018081665), (-0.13756820559501648, 1.0706068032106941e-08, -0.1375681608915329), (-0.1797415018081665, 5.353034016053471e-09, -0.07445136457681656), (-0.19455081224441528, -1.2762627639897992e-15, 2.0872269246297037e-08), (-0.1797415018081665, -5.353034016053471e-09, 0.07445140182971954), (-0.1375681608915329, -1.0706068032106941e-08, 0.13756820559501648), (5.1712785165136665e-08, -4.2824272128427765e-08, 0.43759751319885254), (0.08675077557563782, -2.1412136064213882e-08, 0.3317747414112091), (-0.08675073087215424, -2.1412136064213882e-08, 0.3317747414112091), (0.046800870448350906, -2.1412136064213882e-08, 0.24882805347442627), (-0.04680079594254494, -2.1412136064213882e-08, 0.24882805347442627), (-0.04680079594254494, -2.1412136064213882e-08, 0.3317747414112091), (0.04680084437131882, -2.1412136064213882e-08, 0.3317747414112091), (-0.04680076241493225, 2.1412136064213882e-08, -0.3317747414112091), (0.046800874173641205, 2.1412136064213882e-08, -0.3317747414112091), (0.04680086299777031, 2.1412136064213882e-08, -0.24882805347442627), (-0.046800799667835236, 2.1412136064213882e-08, -0.24882805347442627), (0.0867508053779602, 2.1412136064213882e-08, -0.3317747414112091), (-0.08675070106983185, 2.1412136064213882e-08, -0.3317747414112091), (4.711345980012993e-08, 4.2824272128427765e-08, -0.43759751319885254), (-0.43759751319885254, 1.0210102111918393e-14, -9.882624141255292e-08), (-0.3317747414112091, -5.353034016053471e-09, 0.08675065636634827), (-0.3317747414112091, 5.353034016053471e-09, -0.08675083518028259), (-0.24882805347442627, -5.353034016053471e-09, 0.04680076986551285), (-0.24882805347442627, 5.353034016053471e-09, -0.0468008853495121), (-0.3317747414112091, 5.353034016053471e-09, -0.046800896525382996), (-0.3317747414112091, -5.353034016053471e-09, 0.04680073633790016), (-0.08263588696718216, -7.0564780685344886e-09, 0.08263592422008514), (-0.10796899348497391, -3.5282390342672443e-09, 0.04472224414348602), (-0.11686481535434723, -8.411977372806655e-16, 1.2537773486087644e-08), (-0.10796899348497391, 3.5282390342672443e-09, -0.04472222551703453), (-0.08263592422008514, 7.0564780685344886e-09, -0.08263588696718216), (-0.04472225159406662, 7.0564780685344886e-09, -0.10796899348497391), (-0.0447222925722599, -7.0564780685344886e-09, 0.10796897858381271), (0.0447223074734211, 7.0564780685344886e-09, -0.10796897858381271), (-3.529219583242593e-08, 7.0564780685344886e-09, -0.11686481535434723), (-5.8512675593647145e-08, -7.0564780685344886e-09, 0.11686481535434723), (0.04472222924232483, -7.0564780685344886e-09, 0.10796899348497391), (0.08263590186834335, -7.0564780685344886e-09, 0.08263590186834335), (0.10796899348497391, -3.5282390342672443e-09, 0.04472223296761513), (0.11686481535434723, -4.2059886864033273e-16, 5.108323541946902e-09), (0.10796899348497391, 3.5282390342672443e-09, -0.04472222924232483), (0.08263590186834335, 7.0564780685344886e-09, -0.08263590186834335), (3.725290298461914e-08, -2.1412136064213882e-08, 0.24882805347442627)]
edges = [(0, 1), (1, 2), (2, 3), (3, 4), (4, 5), (5, 6), (7, 8), (0, 8), (10, 11), (9, 12), (11, 12), (10, 13), (9, 14), (13, 15), (14, 15), (16, 22), (17, 18), (18, 19), (19, 20), (20, 21), (21, 22), (7, 17), (6, 16), (23, 24), (23, 25), (24, 29), (25, 28), (26, 29), (27, 28), (31, 32), (30, 33), (32, 33), (31, 34), (30, 35), (34, 36), (35, 36), (37, 38), (37, 39), (38, 43), (39, 42), (40, 41), (40, 43), (41, 42), (50, 53), (49, 52), (44, 45), (45, 46), (46, 47), (47, 48), (48, 49), (44, 50), (51, 59), (51, 52), (53, 54), (54, 55), (55, 56), (56, 57), (57, 58), (58, 59), (26, 60), (27, 60), (23, 60)]
mesh = obj.data
mesh.from_pydata(verts, edges, [])
mesh.update()
def create_aim_widget(self, name):
""" Creates a camera aim widget."""
obj = create_widget(self, name)
if obj != None:
verts = [(0.15504144132137299, 1.4901161193847656e-08, 0.15504144132137299), (0.20257140696048737, 7.450580596923828e-09, 0.0839078277349472), (0.21926172077655792, -8.881784197001252e-16, -9.584233851001045e-09), (0.20257140696048737, -7.450580596923828e-09, -0.0839078426361084), (0.15504144132137299, -1.4901161193847656e-08, -0.15504144132137299), (0.0839078351855278, -1.4901161193847656e-08, -0.20257140696048737), (-1.0978147457763043e-07, -1.4901161193847656e-08, -0.21926172077655792), (-6.621520043381679e-08, 1.4901161193847656e-08, 0.21926172077655792), (0.08390798419713974, 1.4901161193847656e-08, 0.2025713473558426), (0.39969685673713684, 3.725290298461914e-09, 0.05274524539709091), (0.39969685673713684, -3.725290298461914e-09, -0.05274524167180061), (0.4931790232658386, -3.725290298461914e-09, -0.05274524167180061), (0.4931790232658386, 3.725290298461914e-09, 0.052745271474123), (0.39969685673713684, -7.450580596923828e-09, -0.09776943176984787), (0.39969685673713684, 7.450580596923828e-09, 0.09776943176984787), (0.28043296933174133, 6.226862126577502e-17, -6.226862788321993e-17), (-0.08390796184539795, -1.4901161193847656e-08, -0.2025713473558426), (-0.08390787988901138, 1.4901161193847656e-08, 0.20257140696048737), (-0.15504147112369537, 1.4901161193847656e-08, 0.1550414115190506), (-0.20257140696048737, 7.450580596923828e-09, 0.08390782028436661), (-0.21926172077655792, -1.7763568394002505e-15, -2.352336458955051e-08), (-0.20257140696048737, -7.450580596923828e-09, -0.08390786498785019), (-0.1550414115190506, -1.4901161193847656e-08, -0.15504147112369537), (2.9140544199890428e-08, 2.9802322387695312e-08, 0.2804329991340637), (-0.09776944667100906, 2.9802322387695312e-08, 0.3996969163417816), (0.09776947647333145, 2.9802322387695312e-08, 0.3996969163417816), (-0.052745264023542404, 2.9802322387695312e-08, 0.4931790828704834), (0.05274529010057449, 2.9802322387695312e-08, 0.4931790828704834), (0.052745264023542404, 2.9802322387695312e-08, 0.3996969163417816), (-0.052745234221220016, 2.9802322387695312e-08, 0.3996969163417816), (0.05274517461657524, -2.9802322387695312e-08, -0.3996969759464264), (-0.052745334804058075, -2.9802322387695312e-08, -0.3996969759464264), (-0.05274537205696106, -2.9802322387695312e-08, -0.49317920207977295), (0.05274519696831703, -2.9802322387695312e-08, -0.49317920207977295), (-0.09776955097913742, -2.9802322387695312e-08, -0.3996969163417816), (0.09776940196752548, -2.9802322387695312e-08, -0.39969703555107117), (-7.148475589247028e-08, -2.9802322387695312e-08, -0.2804329991340637), (-0.2804330289363861, 3.552713678800501e-15, 4.234420103443881e-08), (-0.3996969759464264, -7.450580596923828e-09, -0.09776938706636429), (-0.39969685673713684, 7.450580596923828e-09, 0.09776950627565384), (-0.4931790232658386, -3.725290298461914e-09, -0.05274520441889763), (-0.4931790232658386, 3.725290298461914e-09, 0.05274531990289688), (-0.3996969163417816, 3.725290298461914e-09, 0.052745312452316284), (-0.3996969163417816, -3.725290298461914e-09, -0.05274519324302673), (-0.06401804089546204, -7.450580596923828e-09, -0.06401806324720383), (-0.0836436077952385, -3.725290298461914e-09, -0.03464633598923683), (-0.09053517132997513, -8.881784197001252e-16, -9.713016169143884e-09), (-0.0836436077952385, 3.725290298461914e-09, 0.03464631363749504), (-0.06401806324720383, 7.450580596923828e-09, 0.06401804089546204), (-0.03464633598923683, 7.450580596923828e-09, 0.0836436077952385), (-0.034646373242139816, -7.450580596923828e-09, -0.0836435854434967), (0.03464638441801071, 7.450580596923828e-09, 0.0836435854434967), (-2.734086912425937e-08, 7.450580596923828e-09, 0.09053517132997513), (-4.532979147597871e-08, -7.450580596923828e-09, -0.09053517132997513), (0.034646324813365936, -7.450580596923828e-09, -0.0836436077952385), (0.06401804834604263, -7.450580596923828e-09, -0.06401804834604263), (0.0836436077952385, -3.725290298461914e-09, -0.034646324813365936), (0.09053517132997513, -4.440892098500626e-16, -3.957419281164221e-09), (0.0836436077952385, 3.725290298461914e-09, 0.03464632108807564), (0.06401804834604263, 7.450580596923828e-09, 0.06401804834604263), (1.1175870895385742e-08, 2.9802322387695312e-08, 0.4931790828704834), (-3.3337176574832483e-08, 2.4835267176115394e-09, 0.030178390443325043), (-3.9333485801762436e-08, -2.4835271617007493e-09, -0.030178390443325043), (-0.030178390443325043, -7.40148665436918e-16, -7.794483281031717e-09), (0.030178390443325043, -5.921189111737107e-16, -5.875951281097969e-09)]
edges = [(0, 1), (1, 2), (2, 3), (3, 4), (4, 5), (5, 6), (7, 8), (0, 8), (10, 11), (9, 12), (11, 12), (10, 13), (9, 14), (13, 15), (14, 15), (16, 22), (17, 18), (18, 19), (19, 20), (20, 21), (21, 22), (7, 17), (6, 16), (23, 24), (23, 25), (24, 29), (25, 28), (26, 29), (27, 28), (31, 32), (30, 33), (32, 33), (31, 34), (30, 35), (34, 36), (35, 36), (37, 38), (37, 39), (38, 43), (39, 42), (40, 41), (40, 43), (41, 42), (50, 53), (49, 52), (44, 45), (45, 46), (46, 47), (47, 48), (48, 49), (44, 50), (51, 59), (51, 52), (53, 54), (54, 55), (55, 56), (56, 57), (57, 58), (58, 59), (26, 60), (27, 60), (23, 60), (61, 62), (63, 64)]
mesh = obj.data
mesh.from_pydata(verts, edges, [])
mesh.update()
# define the fuction to make the camera active
def sceneCamera():
ob = bpy.context.active_object
# find the children on the rig (the camera name)
active_cam = ob.children[0].name
# cam = bpy.data.cameras[bpy.data.objects[active_cam]]
scene_cam = bpy.context.scene.camera
if active_cam != scene_cam.name:
bpy.context.scene.camera = bpy.data.objects[active_cam]
else:
return None
class MakeCameraActive(bpy.types.Operator):
"""Makes the camera parented to this rig the active scene camera"""
bl_idname = "scene.make_camera_active"
bl_label = "Make Advanced Camera Active"
@classmethod
def poll(cls, context):
return context.active_object is not None
def execute(self, context):
sceneCamera()
return {'FINISHED'}
#############################################################
# define function to add marker to timeline and bind camera #
#############################################################
def markerBind():
ob = bpy.context.active_object # rig object
active_cam = ob.children[0] # camera object
# switch area to timeline to add marker
bpy.context.area.type = 'TIMELINE'
# add marker
bpy.ops.marker.add()
bpy.ops.marker.rename(name="cam_" + str(bpy.context.scene.frame_current))
# select rig camera
bpy.context.scene.objects.active = active_cam
# bind marker to selected camera
bpy.ops.marker.camera_bind()
# switch selected object back to the rig
bpy.context.scene.objects.active = ob
# switch back to 3d view
bpy.context.area.type = 'VIEW_3D'
class AddMarkerBind(bpy.types.Operator):
"""Add marker to current frame then bind rig camera to it (for camera switching)"""
bl_idname = "add.marker_bind"
bl_label = "Add marker and Bind Advanced Camera"
@classmethod
def poll(cls, context):
return context.active_object is not None
def execute(self, context):
markerBind()
return {'FINISHED'}
#####################################################
# Define the function to add an Empty as DOF object #
#####################################################
def add_DOF_Empty():
smode = bpy.context.mode
rig = bpy.context.active_object
bone = rig.data.bones['AIM_child']
active_cam = rig.children[0].name
cam = bpy.data.cameras[bpy.data.objects[active_cam].data.name]
bpy.ops.object.mode_set(mode='OBJECT', toggle=False)
# Add Empty
bpy.ops.object.empty_add()
obj = bpy.context.active_object
obj.name = "Empty_DOF"
# parent to AIM_Child
obj.parent = rig
obj.parent_type = "BONE"
obj.parent_bone = "AIM_child"
# clear loc and rot
bpy.ops.object.location_clear()
bpy.ops.object.rotation_clear()
# move to bone head
obj.location = bone.head
# make this new empty the dof_object
cam.dof_object = obj
# reselect the rig
bpy.context.scene.objects.active = rig
obj.select = False
rig.select = True
bpy.ops.object.mode_set(mode=smode, toggle=False)
class AddDofEmpty(bpy.types.Operator):
"""Create empty and add as DOF Object"""
bl_idname = "add.dof_empty"
bl_label = "Add DOF Empty"
@classmethod
def poll(cls, context):
return context.active_object is not None
def execute(self, context):
add_DOF_Empty()
return {'FINISHED'}
##############################################
# Define the function to build the Dolly Rig #
##############################################
def build_dolly_rig(context):
# Define some useful variables:
boneLayer = (False, True, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False)
# Add the new armature object:
bpy.ops.object.armature_add()
rig = context.active_object
# it will try to name the rig "Dolly_Rig" but if that name exists it will add 000 to the name
if "Dolly_Rig" not in context.scene.objects:
rig.name = "Dolly_Rig"
else:
rig.name = "Dolly_Rig.000"
rig["rig_id"] = "Dolly_Rig"
bpy.ops.object.mode_set(mode='EDIT')
# Remove default bone:
bones = rig.data.edit_bones
bones.remove(bones[0])
# Add new bones:
root = bones.new("Root")
root.tail = (0.0, 0.0, -5.0)
root.roll = radians(90)
bpy.ops.object.mode_set(mode='EDIT')
ctrlAimChild = bones.new("AIM_child")
ctrlAimChild.head = (0.0, 5.0, 3.0)
ctrlAimChild.tail = (0.0, 7.0, 3.0)
ctrlAimChild.layers = boneLayer
ctrlAim = bones.new("AIM")
ctrlAim.head = (0.0, 5.0, 3.0)
ctrlAim.tail = (0.0, 7.0, 3.0)
ctrl = bones.new("CTRL")
ctrl.head = (0.0, 0.0, 3.0)
ctrl.tail = (0.0, 2.0, 3.0)
# Setup hierarchy:
ctrl.parent = root
ctrlAim.parent = root
ctrlAimChild.parent = ctrlAim
# jump into pose mode and change bones to euler
bpy.ops.object.mode_set(mode='POSE')
for x in bpy.context.object.pose.bones:
x.rotation_mode = 'XYZ'
# lock z location of the Root and CTRL
bpy.context.object.pose.bones["Root"].lock_location = [False, True, False]
bpy.context.object.pose.bones["CTRL"].lock_location = [False, False, True]
# jump into pose mode and add the custom bone shapes
bpy.ops.object.mode_set(mode='POSE')
bpy.context.object.pose.bones["Root"].custom_shape = bpy.data.objects["WDGT_Camera_Root"]
bpy.context.object.data.bones["Root"].show_wire = True
bpy.context.object.pose.bones["AIM"].custom_shape = bpy.data.objects["WDGT_AIM"]
bpy.context.object.data.bones["AIM"].show_wire = True
bpy.context.object.pose.bones["AIM"].custom_shape_transform = bpy.data.objects[rig.name].pose.bones["AIM_child"]
bpy.context.object.pose.bones["CTRL"].custom_shape = bpy.data.objects["WDGT_CTRL"]
bpy.context.object.data.bones["CTRL"].show_wire = True
# jump into object mode
bpy.ops.object.mode_set(mode='OBJECT')
# Add constraints to bones:
con = rig.pose.bones['AIM_child'].constraints.new('COPY_ROTATION')
con.target = rig
con.subtarget = "CTRL"
con = rig.pose.bones['CTRL'].constraints.new('TRACK_TO')
con.target = rig
con.subtarget = "AIM"
con.use_target_z = True
# Add custom Bone property to CTRL bone
ob = bpy.context.object.pose.bones['CTRL']
prop = rna_idprop_ui_prop_get(ob, "Lock", create=True)
ob["Lock"] = 1.0
prop["soft_min"] = prop["min"] = 0.0
prop["soft_max"] = prop["max"] = 1.0
# Add Driver to Lock/Unlock Camera from Aim Target
rig = bpy.context.scene.objects.active
pose_bone = bpy.data.objects[rig.name].pose.bones['CTRL']
constraint = pose_bone.constraints["Track To"]
inf_driver = constraint.driver_add('influence')
inf_driver.driver.type = 'SCRIPTED'
var = inf_driver.driver.variables.new()
var.name = 'var'
var.type = 'SINGLE_PROP'
# Target the Custom bone property
var.targets[0].id = bpy.data.objects[rig.name]
var.targets[0].data_path = 'pose.bones["CTRL"]["Lock"]'
inf_driver.driver.expression = 'var'
# Add the camera object:
bpy.ops.object.mode_set(mode='OBJECT')
bpy.ops.object.camera_add(view_align=False, enter_editmode=False, location=(0, 0, 0), rotation=(0, 0, 0))
cam = bpy.context.active_object
# this will name the Camera Object
if 'Dolly_Camera' not in context.scene.objects:
cam.name = "Dolly_Camera"
else:
cam.name = "Dolly_Camera.000"
# this will name the camera Data Object
if "Dolly_Camera" not in bpy.context.scene.objects.data.camera:
cam.data.name = "Dolly_Camera"
else:
cam.data.name = "Dolly_Camera.000"
cam_data_name = bpy.context.object.data.name
bpy.data.cameras[cam_data_name].draw_size = 1.0
cam.rotation_euler[0] = 1.5708
cam.location = (0.0, -2.0, 0.0)
cam.parent = rig
cam.parent_type = "BONE"
cam.parent_bone = "CTRL"
# Set new camera as active camera
bpy.context.scene.camera = cam
# make the camera non-selectable (this can be unlocked in the UI)
bpy.context.object.hide_select = False
# make the rig the active object before finishing
bpy.context.scene.objects.active = rig
cam.select = False
rig.select = True
return rig
##############################################
# Define the function to build the Crane Rig #
##############################################
def build_crane_rig(context):
# Define some useful variables:
boneLayer = (False, True, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False)
# Add the new armature object:
bpy.ops.object.armature_add()
rig = context.active_object
# it will try to name the rig "Dolly_Rig" but if that name exists it will add .000 to the name
if "Crane_Rig" not in context.scene.objects:
rig.name = "Crane_Rig"
else:
rig.name = "Crane_Rig.000"
rig["rig_id"] = "Crane_Rig"
bpy.ops.object.mode_set(mode='EDIT')
# Remove default bone:
bones = rig.data.edit_bones
bones.remove(bones[0])
# Add new bones:
root = bones.new("Root")
root.tail = (0.0, 0.0, -5.0)
ctrlAimChild = bones.new("AIM_child")
ctrlAimChild.head = (0.0, 10.0, 1.0)
ctrlAimChild.tail = (0.0, 12.0, 1.0)
ctrlAimChild.layers = boneLayer
ctrlAim = bones.new("AIM")
ctrlAim.head = (0.0, 10.0, 1.0)
ctrlAim.tail = (0.0, 12.0, 1.0)
ctrl = bones.new("CTRL")
ctrl.head = (0.0, 1.0, 1.0)
ctrl.tail = (0.0, 3.0, 1.0)
arm = bones.new("Crane_Arm")
arm.head = (0.0, 0.0, 1.0)
arm.tail = (0.0, 1.0, 1.0)
height = bones.new("Height")
height.head = (0.0, 0.0, 0.0)
height.tail = (0.0, 0.0, 1.0)
# Setup hierarchy:
ctrl.parent = arm
ctrl.use_inherit_rotation = False
ctrl.use_inherit_scale = False
arm.parent = height
arm.use_inherit_scale = False
height.parent = root
ctrlAim.parent = root
ctrlAimChild.parent = ctrlAim
# change display to BBone: it just looks nicer
bpy.context.object.data.draw_type = 'BBONE'
# change display to wire for object
bpy.context.object.draw_type = 'WIRE'
# jump into pose mode and change bones to euler
bpy.ops.object.mode_set(mode='POSE')
for x in bpy.context.object.pose.bones:
x.rotation_mode = 'XYZ'
# lock the relevant loc, rot and scale
bpy.context.object.pose.bones["Crane_Arm"].lock_rotation = [False, True, False]
bpy.context.object.pose.bones["Crane_Arm"].lock_scale = [True, False, True]
bpy.context.object.pose.bones["Height"].lock_location = [True, True, True]
bpy.context.object.pose.bones["Height"].lock_rotation = [True, True, True]
bpy.context.object.pose.bones["Height"].lock_scale = [True, False, True]
# add the custom bone shapes
bpy.context.object.pose.bones["Root"].custom_shape = bpy.data.objects["WDGT_Camera_Root"] # add the widget as custom shape
bpy.context.object.data.bones["Root"].show_wire = True # set the wireframe checkbox to true
bpy.context.object.pose.bones["AIM"].custom_shape = bpy.data.objects["WDGT_AIM"]
bpy.context.object.data.bones["AIM"].show_wire = True
bpy.context.object.pose.bones["AIM"].custom_shape_transform = bpy.data.objects[rig.name].pose.bones["AIM_child"] # sets the "At" field to the child
bpy.context.object.pose.bones["CTRL"].custom_shape = bpy.data.objects["WDGT_CTRL"]
bpy.context.object.data.bones["CTRL"].show_wire = True
# jump into object mode
bpy.ops.object.mode_set(mode='OBJECT')
# Add constraints to bones:
con = rig.pose.bones['AIM_child'].constraints.new('COPY_ROTATION')
con.target = rig
con.subtarget = "CTRL"
con = rig.pose.bones['CTRL'].constraints.new('TRACK_TO')
con.target = rig
con.subtarget = "AIM"
con.use_target_z = True
# Add custom Bone property to CTRL bone
ob = bpy.context.object.pose.bones['CTRL']
prop = rna_idprop_ui_prop_get(ob, "Lock", create=True)
ob["Lock"] = 1.0
prop["soft_min"] = prop["min"] = 0.0
prop["soft_max"] = prop["max"] = 1.0
# Add Driver to Lock/Unlock Camera from Aim Target
rig = bpy.context.scene.objects.active
pose_bone = bpy.data.objects[rig.name].pose.bones['CTRL']
constraint = pose_bone.constraints["Track To"]
inf_driver = constraint.driver_add('influence')
inf_driver.driver.type = 'SCRIPTED'
var = inf_driver.driver.variables.new()
var.name = 'var'
var.type = 'SINGLE_PROP'
# Target the Custom bone property
var.targets[0].id = bpy.data.objects[rig.name]
var.targets[0].data_path = 'pose.bones["CTRL"]["Lock"]'
inf_driver.driver.expression = 'var'
# Add the camera object:
bpy.ops.object.mode_set(mode='OBJECT')
bpy.ops.object.camera_add(view_align=False, enter_editmode=False, location=(0, 0, 0), rotation=(0, 0, 0))
cam = bpy.context.active_object
# this will name the Camera Object
if 'Crane_Camera' not in context.scene.objects:
cam.name = "Crane_Camera"
else:
cam.name = "Crane_Camera.000"
# this will name the camera Data Object
if "Crane_Camera" not in bpy.context.scene.objects.data.camera:
cam.data.name = "Crane_Camera"
else:
cam.data.name = "Crane_Camera.000"
cam_data_name = bpy.context.object.data.name
bpy.data.cameras[cam_data_name].draw_size = 1.0
cam.rotation_euler[0] = 1.5708 # rotate the camera 90 degrees in x
cam.location = (0.0, -2.0, 0.0) # move the camera to the correct postion
cam.parent = rig
cam.parent_type = "BONE"
cam.parent_bone = "CTRL"
# Set new camera as active camera
bpy.context.scene.camera = cam
# make the camera non-selectable (this can be unlocked in the UI)
bpy.context.object.hide_select = True
# make the rig the active object before finishing
bpy.context.scene.objects.active = rig
cam.select = False
rig.select = True
return rig
###########################################
# This is the UI for the Dolly Camera Rig #
###########################################
class DollyCameraUI(bpy.types.Panel):
bl_space_type = 'VIEW_3D'
bl_region_type = 'UI'
bl_label = "Advanced Dolly Camera UI"
@classmethod
def poll(self, context):
try:
ob = bpy.context.active_object
return (ob["rig_id"] == "Dolly_Rig")
except (AttributeError, KeyError, TypeError):
return False
def draw(self, context):
layout = self.layout
ob = bpy.context.active_object
arm = context.active_object.data
pose_bones = context.active_object.pose.bones
# find the children on the rig (the camera name)
active_cam = ob.children[0].name
cam = bpy.data.cameras[bpy.data.objects[active_cam].data.name]
box = layout.box()
col = box.column()
row = col.row()
# Display Camera Properties
col.operator("stereocamera.set_stereo_camera", text="Set Stereo Camera")
col.label(text="Clipping:")
col.prop(cam, "clip_start", text="Start")
col.prop(cam, "clip_end", text="End")
col.prop(cam, "type")
col.prop(cam, "dof_object")
if cam.dof_object is None:
col.operator("add.dof_empty", text="Add DOF Empty")
col.prop(cam, "dof_distance")
col.prop(bpy.data.objects[active_cam], "hide_select", text="Lock Camera Select")
col.operator("add.marker_bind", text="Add Marker and Bind")
if bpy.context.scene.camera.name != active_cam:
col.operator("scene.make_camera_active", text="Make Active Camera", icon='CAMERA_DATA')
col.prop(context.active_object, 'show_x_ray', toggle=False, text='X Ray')
col.prop(cam, "show_limits")
col.prop(cam, "show_title_safe")
col.prop(cam, "show_passepartout")
col.prop(cam, "passepartout_alpha")
# Camera Lens
col.label(text="Focal Length:")
col.prop(cam, "lens", text="Angle")
# Track to Constraint
col.label(text="Tracking:")
col.prop(pose_bones["CTRL"], '["Lock"]', text="Aim Lock", slider=True)
###########################################
# This is the UI for the Crane Rig Camera #
###########################################
class CraneCameraUI(bpy.types.Panel):
bl_space_type = 'VIEW_3D'
bl_region_type = 'UI'
bl_label = "Advanced Crane Camera UI"
@classmethod
def poll(self, context):
try:
ob = bpy.context.active_object
return (ob["rig_id"] == "Crane_Rig")
except (AttributeError, KeyError, TypeError):
return False
def draw(self, context):
layout = self.layout
ob = bpy.context.active_object
arm = context.active_object.data
pose_bones = context.active_object.pose.bones
# find the children on the rig (camera)
active_cam = ob.children[0].name
cam = bpy.data.cameras[bpy.data.objects[active_cam].data.name]
box = layout.box()
col = box.column()
row = col.row()
# Display Camera Properties
col.operator("stereocamera.set_stereo_camera", text="Set Stereo Camera")
col.label(text="Clipping:")
col.prop(cam, "clip_start", text="Start")
col.prop(cam, "clip_end", text="End")
col.prop(cam, "type")
col.prop(cam, "dof_object")
if cam.dof_object is None:
col.operator("add.dof_empty", text="Add DOF object")
col.prop(cam, "dof_distance")
col.prop(bpy.data.objects[active_cam], "hide_select", text="Lock Camera Select")
col.operator("add.marker_bind", text="Add Marker and Bind")
if bpy.context.scene.camera.name != active_cam:
col.operator("scene.make_camera_active", text="Make Active Camera", icon='CAMERA_DATA')
col.prop(context.active_object, 'show_x_ray', toggle=False, text='X Ray')
col.prop(cam, "show_limits")
col.prop(cam, "show_title_safe")
col.prop(cam, "show_passepartout")
col.prop(cam, "passepartout_alpha")
# Camera Lens
col.label(text="Focal Length:")
col.prop(cam, "lens", text="Angle")
# Track to Constraint
col.label(text="Tracking:")
col.prop(pose_bones["CTRL"], '["Lock"]', text="Aim Lock", slider=True)
# make this camera active if more than one camera exists