# ##### 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 ##### bl_info = { "name": "Cameras Lister TY", "author": "Ryxx", "version": (1, 4, 1), "blender": (2, 80, 0), "description": "Lists all cameras from the scene and allows to easily set the view to a particular one.", "location": "Camera Lister Panel shortcut: Alt + C", "support": "COMMUNITY", "category": "Camera" } import bpy from bpy.types import Operator, Menu, Panel, AddonPreferences #-------------------------------------------------------------------------------------- # T O D O L I S T #-------------------------------------------------------------------------------------- # Feature: BindCameraToMarker - Being able to delete the marker from the addon panel. # Feature: BindCameraToMarker - Replacing a current marker by another from another camera. # Feature: RenameCamera: Being able to rename the camera directly from the addon panel. # Feature: Preferences - Allow user to choose FloatingPanel's shortcut / DockedInSidePanel's tab category. # Optimization: Remove CameraViewOn / CameraViewOff buttons and instead, make the current camera's button clickable again, to switch to CamViewOff # Optimization: Put a CAMERA_DATA icon for the current Camera View On. #-------------------------------------------------------------------------------------- # F E A T U R E S #-------------------------------------------------------------------------------------- # CAMERA VIEW ON class CameraViewOn(bpy.types.Operator): bl_idname = 'cameras.camera_view_on' bl_label = 'Camera View On' bl_description = "Camera View On" bl_options = {'UNDO'} def execute(self,context): context.area.spaces[0].region_3d.view_perspective='CAMERA' return{'FINISHED'} # CAMERA LOCK TO VIEW class CameraLockToView(bpy.types.Operator): bl_idname = 'cameras.lock' bl_label = 'Camera LOCK' bl_description = "Camera lock to View" bl_options = {'UNDO'} def execute(self,context): if context.space_data.lock_camera: context.space_data.lock_camera=False else: context.space_data.lock_camera=True return{'FINISHED'} # CAMERA VIEW OFF class CameraViewOff(bpy.types.Operator): bl_idname = 'cameras.camera_view_off' bl_label = 'Camera View Off' bl_description = "Camera View Off" bl_options = {'UNDO'} def execute(self,context): context.area.spaces[0].region_3d.view_perspective='PERSP' return{'FINISHED'} # VIEW FROM SELECTED CAMERA class ViewFromSelectedCamera(bpy.types.Operator): bl_idname = 'cameras.view_from_selected' bl_label = 'View From Selected' bl_description = "Switch to view from selected camera" bl_options = {'UNDO'} def execute(self,context): if context.object: ob = context.object if ob.type == 'CAMERA': bpy.ops.view3d.object_as_camera() return{'FINISHED'} # ALIGN SELECTED CAMERA TO VIEW class AlignSelectedCameraToView(bpy.types.Operator): bl_idname = 'cameras.align_selected_to_view' bl_label = 'New Camera From View' bl_description = "Create a new camera from view" bl_options = {'UNDO'} def execute(self,context): if context.object: if context.area.spaces[0].region_3d.view_perspective == 'CAMERA': return {'FINISHED'} else: ob = context.object if ob.type == 'CAMERA': context = bpy.context scene = context.scene currentCameraObj = bpy.data.objects[bpy.context.active_object.name] scene.camera = currentCameraObj bpy.ops.view3d.camera_to_view() return{'FINISHED'} # NEW CAMERA FROM VIEW class NewCameraFromView(bpy.types.Operator): bl_idname = 'cameras.new_from_view' bl_label = 'New Camera From View' bl_description = "Create a new camera from view" bl_options = {'UNDO'} def execute(self,context): if context.area.spaces[0].region_3d.view_perspective == 'CAMERA': context.area.spaces[0].region_3d.view_perspective='PERSP' bpy.ops.object.camera_add() context = bpy.context scene = context.scene currentCameraObj = bpy.data.objects[bpy.context.active_object.name] scene.camera = currentCameraObj bpy.ops.view3d.camera_to_view() return{'FINISHED'} # SORTING CAMERAS OPTIONS sorting_cameras_options = [ ("alphabetically", "Alphabetically", ""), ("by_collections", "By Collections", "")] bpy.types.Scene.sort_cameras = bpy.props.EnumProperty( items=sorting_cameras_options, description="Sort cameras", default= "alphabetically") # SET CAMERA VIEW class SetCameraView(bpy.types.Operator): bl_idname = 'cameras.set_view' bl_label = 'Set Camera View' bl_description = "Set View to this Camera" bl_options = {'UNDO'} camera: bpy.props.StringProperty() def execute(self,context): bpy.ops.cameras.select(camera=self.camera) bpy.ops.view3d.object_as_camera() return{'FINISHED'} # SELECT CAMERA class SelectCamera(bpy.types.Operator): bl_idname = 'cameras.select' bl_label = 'Select Camera' bl_description = "Select camera" bl_options = {'UNDO'} camera: bpy.props.StringProperty() def execute(self,context): if context.object: if context.object.select_get(): context.object.select_set(state=False) cam=bpy.data.objects[self.camera] cam.select_set(state=True) context.view_layer.objects.active = cam context.scene.camera=cam return{'FINISHED'} # BIND CAMERA TO MARKER class BindCameraToMarker(bpy.types.Operator): bl_idname = 'cameras.bind_to_marker' bl_label = 'Bind Camera to Marker' bl_description = "Bind camera to marker at current frame" bl_options = {'UNDO'} camera: bpy.props.StringProperty() def execute(self,context): tm = bpy.context.scene.timeline_markers cur_frame = context.scene.frame_current frame_markers = [marker for marker in tm if marker.frame == cur_frame] if len(frame_markers) == 0: new_marker = tm.new(self.camera, frame = cur_frame) new_marker.camera = bpy.data.objects[self.camera] elif len(frame_markers) == 1: frame_markers[0].camera = bpy.data.objects[self.camera] elif len(frame_markers) >= 2: frame_markers[0].camera = bpy.data.objects[self.camera] return{'FINISHED'} # DELETE CAMERA class DeleteCamera(bpy.types.Operator): bl_idname = 'cameras.delete' bl_label = 'Delete Camera' bl_description = "Delete camera" bl_options = {'UNDO'} camera: bpy.props.StringProperty() def execute(self,context): cam=bpy.data.objects[self.camera] bpy.data.objects.remove(cam) tm = bpy.context.scene.timeline_markers for marker in tm: if marker.name == self.camera: tm.remove(marker) return{'FINISHED'} #-------------------------------------------------------------------------------------- # C O M M O N D R A W P A N E L #-------------------------------------------------------------------------------------- # COMMON DRAW def common_draw(self,layout,context): def coll_rec(coll, clist): if coll.children: for child in coll.children: coll_rec(child, clist) cams=[cam.name for cam in coll.objects if cam.type=='CAMERA'] if cams: cams.sort(key=str.lower) clist.append((coll.name, cams)) box = layout row = box.row(align = False) row.operator("cameras.camera_view_on", text="Camera", icon="VIEW_CAMERA") # ADD LOCK CAM TO VIEW BUTTON row.operator("cameras.lock", text="CamToView", icon="LOCKED") row.operator("cameras.camera_view_off", text="Perspective", icon="CAMERA_DATA") box.separator() box.separator() box.operator("cameras.view_from_selected", text="View from Selected", icon="TRIA_RIGHT") box.operator("cameras.align_selected_to_view", text="Align Selected to View", icon="TRIA_RIGHT") box.operator("cameras.new_from_view", text="New Camera from View", icon="TRIA_RIGHT") box.separator() row = box.row(align=True) row.prop(context.scene, "sort_cameras", text=" ", expand=True) box.separator() boxframe = box.box() boxframecolumn = boxframe.column() sort_option = context.scene.sort_cameras if sort_option == sorting_cameras_options[0][0]: cam_list=[cam.name for cam in context.scene.collection.all_objects if cam.type=='CAMERA'] cam_list.sort(key=str.lower) for cam in cam_list: row = boxframecolumn.row(align=True) row.operator("cameras.set_view", text=cam).camera=cam row.operator("cameras.select", text="", icon="RESTRICT_SELECT_OFF").camera=cam row.operator("cameras.bind_to_marker", text="", icon="MARKER").camera=cam row.operator("cameras.delete", text="", icon="PANEL_CLOSE").camera=cam elif sort_option == sorting_cameras_options[1][0]: collcamlist=[] master_coll = context.scene.collection coll_rec(master_coll, collcamlist) collcamlist.sort() for coll in collcamlist: boxframecolumn.label(text=coll[0]) for cam in coll[1]: row = boxframecolumn.row(align=True) row.operator("cameras.set_view", text=cam).camera=cam row.operator("cameras.select", text="", icon="RESTRICT_SELECT_OFF").camera=cam row.operator("cameras.bind_to_marker", text="", icon="MARKER").camera=cam row.operator("cameras.delete", text="", icon="PANEL_CLOSE").camera=cam #-------------------------------------------------------------------------------------- # P A N E L #-------------------------------------------------------------------------------------- # FLOATING PANEL class VIEW3D_PT_FloatingPanel(Operator): bl_label = "Cameras Lister" bl_idname = "cameras.lister" def draw(self, context): layout = self.layout box = layout.column(align=True) box.label(text="CAMERAS LISTER", icon="OUTLINER_OB_CAMERA") box.separator() common_draw(self, box, context) def invoke(self, context, event): wm = context.window_manager return wm.invoke_popup(self) def execute(self, context): self.report({'INFO'}, self.my_enum) return {'FINISHED'} # DOCKED IN SIDE PANEL class VIEW3D_PT_DockedInSidePanel(Panel): bl_space_type = 'VIEW_3D' bl_region_type = 'UI' bl_category = "View" bl_label = "Cameras Lister" def draw(self, context): col = self.layout.column(align=True) common_draw(self, col, context) # ADDON PREFERENCES class CamerasListerPreferences(AddonPreferences): bl_idname = __name__ def sp_toggle(self, context): if self.add_side_panel: bpy.utils.register_class(VIEW3D_PT_DockedInSidePanel) else: if hasattr(bpy.types, 'VIEW3D_PT_DockedInSidePanel'): bpy.utils.unregister_class(VIEW3D_PT_DockedInSidePanel) add_side_panel: bpy.props.BoolProperty(name="side panel", default=False, update=sp_toggle) def draw(self, context): layout = self.layout layout.prop(self, "add_side_panel", text="Add CamerasLister to Side Panel") #-------------------------------------------------------------------------------------- # R E G I S T R Y #-------------------------------------------------------------------------------------- classes = ( CameraViewOn, CameraLockToView, CameraViewOff, ViewFromSelectedCamera, AlignSelectedCameraToView, NewCameraFromView, SetCameraView, SelectCamera, BindCameraToMarker, DeleteCamera, VIEW3D_PT_FloatingPanel, CamerasListerPreferences ) def register(): from bpy.utils import register_class for cls in classes: register_class(cls) wm = bpy.context.window_manager wm = bpy.context.window_manager km = wm.keyconfigs.addon.keymaps.new(name = 'Object Mode') kmi = km.keymap_items.new('cameras.lister', 'C', 'PRESS', alt=True) kmi.active = True def unregister(): from bpy.utils import unregister_class for cls in classes: unregister_class(cls) if hasattr(bpy.types, 'VIEW3D_PT_DockedInSidePanel'): bpy.utils.unregister_class(VIEW3D_PT_DockedInSidePanel) addon_keymaps = [] wm = bpy.context.window_manager if wm.keyconfigs.addon: for km in addon_keymaps: for kmi in km.keymap_items: km.keymap_items.remove(kmi) wm.keyconfigs.addon.keymaps.remove(km) addon_keymaps.clear() if __name__ == "__main__": register()