camera_dolly_crane_rigs.py commit to addons release: T51067

This commit is contained in:
Brendon Murphy 2017-04-01 14:28:47 +11:00
parent a72be7c9be
commit 2fb704b93e
1 changed files with 930 additions and 0 deletions

930
camera_dolly_crane_rigs.py Normal file
View File

@ -0,0 +1,930 @@
bl_info = {
"name": "Add Camera Rigs",
"author": "Wayne Dixon, Kris Wittig",
"version": (1, 1),
"blender": (2, 77, 0),
"location": "View3D > Add > Camera > Dolly or Crane Rig",
"description": "Adds a Camera Rig with UI",
"warning": "Enable Auto Run Scripts > User prefs System for drivers",
"wiki_url": "http://wiki.blender.org/index.php/Extensions:2.6/Py/Scripts/Rigging/Add_Camera_Rigs",
"tracker_url": "https://developer.blender.org/maniphest/task/edit/form/2/",
"category": "Camera",
}
import bpy
from bpy.types import Operator
from rna_prop_ui import rna_idprop_ui_prop_get
from math import radians
# =========================================================================
# 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 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 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'
# 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"] # add the widget as custom shape
# set the wireframe checkbox to true
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"] # 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 '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 # 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"
# Add blank drivers to lock the camera loc, rot scale
cam.driver_add('location', 0)
cam.driver_add('location', 1)
cam.driver_add('location', 2)
cam.driver_add('rotation_euler', 0)
cam.driver_add('rotation_euler', 1)
cam.driver_add('rotation_euler', 2)
cam.driver_add('scale', 0)
cam.driver_add('scale', 1)
cam.driver_add('scale', 2)
# Set new camera as active camera
bpy.context.scene.camera = cam
# make sure the camera is selectable by default (this can be locked 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
# set the wireframe checkbox to true
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"] # 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"
# Add blank drivers to lock the camera loc, rot scale
cam.driver_add('location', 0)
cam.driver_add('location', 1)
cam.driver_add('location', 2)
cam.driver_add('rotation_euler', 0)
cam.driver_add('rotation_euler', 1)
cam.driver_add('rotation_euler', 2)
cam.driver_add('scale', 0)
cam.driver_add('scale', 1)
cam.driver_add('scale', 2)
# Set new camera as active camera
bpy.context.scene.camera = cam
# make sure the camera is selectable by default (this can be locked 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
# =========================================================================
# 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 = "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.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")
# added the comp guides here
col.prop_menu_enum(cam, "show_guide", text="Compostion Guides")
col.prop(bpy.data.objects[active_cam],
"hide_select", text="Make Camera Unselectable")
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_safe_areas")
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 = "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.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")
# added the comp guides here
col.prop_menu_enum(cam, "show_guide", text="Compostion Guides")
col.prop(bpy.data.objects[active_cam],
"hide_select", text="Make Camera Unselectable")
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_safe_areas")
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
'''if cam != bpy.context.scene.camera:
col.op(, text="Make Active Camera", toggle=True)'''
box = layout.box()
col = box.column()
row = col.row()
# Crane arm stuff
col.label(text="Crane Arm:")
col.prop(pose_bones["Height"], 'scale', index=1, text="Arm Height")
col.prop(pose_bones["Crane_Arm"], 'scale', index=1, text="Arm Length")
# =========================================================================
# This is the operator that will call all the functions and build the dolly rig
# =========================================================================
class BuildDollyRig(bpy.types.Operator):
"""Build a Camera Dolly Rig"""
bl_idname = "object.build_dolly_rig"
bl_label = "Build Dolly Camera Rig"
bl_options = {'REGISTER', 'UNDO'}
def execute(self, context):
# build the Widgets
create_root_widget(self, "Camera_Root")
create_camera_widget(self, "CTRL")
create_aim_widget(self, "AIM")
# call the function to build the rig
build_dolly_rig(context)
return {'FINISHED'}
# =========================================================================
# This is the operator that will call all the functions and build the crane rig
# =========================================================================
class BuildCraneRig(bpy.types.Operator):
"""Build a Camera Crane Rig"""
bl_idname = "object.build_crane_rig"
bl_label = "Build Crane Camera Rig"
bl_options = {'REGISTER', 'UNDO'}
def execute(self, context):
# build the Widgets
create_root_widget(self, "Camera_Root")
create_camera_widget(self, "CTRL")
create_aim_widget(self, "AIM")
# call the function to build the rig
build_crane_rig(context)
return {'FINISHED'}
# =========================================================================
# Registration:
# =========================================================================
# dolly button in Armature menu
def add_dolly_button(self, context):
if context.mode == 'OBJECT':
self.layout.operator(
BuildDollyRig.bl_idname,
text="Dolly Camera Rig",
icon='CAMERA_DATA')
# crane button in Armature menu
def add_crane_button(self, context):
if context.mode == 'OBJECT':
self.layout.operator(
BuildCraneRig.bl_idname,
text="Crane Camera Rig",
icon='CAMERA_DATA')
def register():
bpy.utils.register_class(BuildDollyRig)
bpy.utils.register_class(BuildCraneRig)
bpy.utils.register_class(DollyCameraUI)
bpy.utils.register_class(CraneCameraUI)
bpy.utils.register_class(MakeCameraActive)
bpy.utils.register_class(AddMarkerBind)
bpy.utils.register_class(AddDofEmpty)
bpy.types.INFO_MT_camera_add.append(add_dolly_button)
bpy.types.INFO_MT_camera_add.append(add_crane_button)
def unregister():
bpy.utils.unregister_class(BuildDollyRig)
bpy.utils.unregister_class(BuildCraneRig)
bpy.utils.unregister_class(DollyCameraUI)
bpy.utils.unregister_class(CraneCameraUI)
bpy.utils.unregister_class(MakeCameraActive)
bpy.utils.unregister_class(AddMarkerBind)
bpy.utils.unregister_class(AddDofEmpty)
bpy.types.INFO_MT_camera_add.remove(add_dolly_button)
bpy.types.INFO_MT_camera_add.remove(add_crane_button)
if __name__ == "__main__":
register()