space_view3d_3d_navigation.py

   1 # 3D NAVIGATION TOOLBAR v1.2 - 3Dview Addon - Blender 2.5x
   2 #
   3 # THIS SCRIPT IS LICENSED UNDER GPL,
   4 # please read the license block.
   5
   6 # ##### BEGIN GPL LICENSE BLOCK #####
   7 #
   8 #  This program is free software; you can redistribute it and/or
   9 #  modify it under the terms of the GNU General Public License
  10 #  as published by the Free Software Foundation; either version 2
  11 #  of the License, or (at your option) any later version.
  12 #
  13 #  This program is distributed in the hope that it will be useful,
  14 #  but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 #  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 #  GNU General Public License for more details.
  17 #
  18 #  You should have received a copy of the GNU General Public License
  19 #  along with this program; if not, write to the Free Software Foundation,
  20 #  Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  21 #
  22 # ##### END GPL LICENSE BLOCK #####
  23 # contributed to by: Demohero, uriel, jbelcik, meta-androcto
  24
  25 bl_info = {
  26     "name": "3D Navigation",
  27     "author": "Demohero, uriel",
  28     "version": (1, 2, 3),
  29     "blender": (2, 80, 0),
  30     "location": "View3D > Tool Shelf > Display Tab",
  31     "description": "Navigate the Camera & 3D View from the Toolshelf",
  32     "warning": "",
  33     "wiki_url": "https://wiki.blender.org/index.php/Extensions:2.6/Py/"
  34                 "Scripts/3D_interaction/3D_Navigation",
  35     "category": "3D View",
  36 }
  37
  38 import bpy
  39 from bpy.types import (
  40         AddonPreferences,
  41         Operator,
  42         Panel,
  43         )
  44 from bpy.props import StringProperty
  45
  46
  47 # main class of this toolbar
  48
  49 # re-ordered (reversed) Orbit Operators
  50 class OrbitUpView1(Operator):
  51     bl_idname = "opr.orbit_up_view1"
  52     bl_label = "Orbit Up View"
  53     bl_description = "Orbit the view towards you"
  54
  55     def execute(self, context):
  56         bpy.ops.view3d.view_orbit(type='ORBITUP')
  57         return {'FINISHED'}
  58
  59
  60 class OrbitLeftView1(Operator):
  61     bl_idname = "opr.orbit_left_view1"
  62     bl_label = "Orbit Left View"
  63     bl_description = "Orbit the view around to your Right"
  64
  65     def execute(self, context):
  66         bpy.ops.view3d.view_orbit(type='ORBITLEFT')
  67         return {'FINISHED'}
  68
  69
  70 class OrbitRightView1(Operator):
  71     bl_idname = "opr.orbit_right_view1"
  72     bl_label = "Orbit Right View"
  73     bl_description = "Orbit the view around to your Left"
  74
  75     def execute(self, context):
  76         bpy.ops.view3d.view_orbit(type='ORBITRIGHT')
  77         return {'FINISHED'}
  78
  79
  80 class OrbitDownView1(Operator):
  81     bl_idname = "opr.orbit_down_view1"
  82     bl_label = "Orbit Down View"
  83     bl_description = "Orbit the view away from you"
  84
  85     def execute(self, context):
  86         bpy.ops.view3d.view_orbit(type='ORBITDOWN')
  87         return {'FINISHED'}
  88
  89
  90 # re-ordered (reversed) Pan Operators
  91 # just pass the enum from the VIEW3D_PT_pan_navigation1 Panel
  92 class PanUpViewsAll(Operator):
  93     bl_idname = "opr.pan_up_views_all"
  94     bl_label = "Pan View"
  95     bl_description = "Pan the 3D View"
  96
  97     panning: StringProperty(
  98             default="PANUP",
  99             options={"HIDDEN"}
 100             )
 101
 102     def execute(self, context):
 103         try:
 104             bpy.ops.view3d.view_pan("INVOKE_REGION_WIN", type=self.panning)
 105         except Exception as e:
 106             self.report({"WARNING"},
 107                         "Pan Views could not be completed. Operation Cancelled")
 108             print("\n[3D Navigation]\nOperator: opr.pan_up_views_all\n {}\n".format(e))
 109
 110             return {"CANCELLED"}
 111
 112         return {'FINISHED'}
 113
 114
 115 # Zoom Operators
 116 class ZoomInView1(Operator):
 117     bl_idname = "opr.zoom_in_view1"
 118     bl_label = "Zoom In View"
 119     bl_description = "Zoom In the View/Camera View"
 120
 121     def execute(self, context):
 122         bpy.ops.view3d.zoom(delta=1)
 123         return {'FINISHED'}
 124
 125
 126 class ZoomOutView1(Operator):
 127     bl_idname = "opr.zoom_out_view1"
 128     bl_label = "Zoom Out View"
 129     bl_description = "Zoom out In the View/Camera View"
 130
 131     def execute(self, context):
 132         bpy.ops.view3d.zoom(delta=-1)
 133         return {'FINISHED'}
 134
 135
 136 # Roll Operators
 137 class RollLeftView1(Operator):
 138     bl_idname = "opr.roll_left_view1"
 139     bl_label = "Roll Left View"
 140     bl_description = "Roll the view Left"
 141
 142     def execute(self, context):
 143         bpy.ops.view3d.view_roll(angle=-0.261799)
 144         return {'FINISHED'}
 145
 146
 147 class RollRightView1(Operator):
 148     bl_idname = "opr.roll_right_view1"
 149     bl_label = "Roll Right View"
 150     bl_description = "Roll the view Right"
 151
 152     def execute(self, context):
 153         bpy.ops.view3d.view_roll(angle=0.261799)
 154         return {'FINISHED'}
 155
 156
 157 # View Operators
 158 class LeftViewpoint1(Operator):
 159     bl_idname = "opr.left_viewpoint1"
 160     bl_label = "Left Viewpoint"
 161     bl_description = "View from the Left"
 162
 163     def execute(self, context):
 164         bpy.ops.view3d.view_axis(type='LEFT')
 165         return {'FINISHED'}
 166
 167
 168 class RightViewpoint1(Operator):
 169     bl_idname = "opr.right_viewpoint1"
 170     bl_label = "Right Viewpoint"
 171     bl_description = "View from the Right"
 172
 173     def execute(self, context):
 174         bpy.ops.view3d.view_axis(type='RIGHT')
 175         return {'FINISHED'}
 176
 177
 178 class FrontViewpoint1(Operator):
 179     bl_idname = "opr.front_viewpoint1"
 180     bl_label = "Front Viewpoint"
 181     bl_description = "View from the Front"
 182
 183     def execute(self, context):
 184         bpy.ops.view3d.view_axis(type='FRONT')
 185         return {'FINISHED'}
 186
 187
 188 class BackViewpoint1(Operator):
 189     bl_idname = "opr.back_viewpoint1"
 190     bl_label = "Back Viewpoint"
 191     bl_description = "View from the Back"
 192
 193     def execute(self, context):
 194         bpy.ops.view3d.view_axis(type='BACK')
 195         return {'FINISHED'}
 196
 197
 198 class TopViewpoint1(Operator):
 199     bl_idname = "opr.top_viewpoint1"
 200     bl_label = "Top Viewpoint"
 201     bl_description = "View from the Top"
 202
 203     def execute(self, context):
 204         bpy.ops.view3d.view_axis(type='TOP')
 205         return {'FINISHED'}
 206
 207
 208 class BottomViewpoint1(Operator):
 209     bl_idname = "opr.bottom_viewpoint1"
 210     bl_label = "Bottom Viewpoint"
 211     bl_description = "View from the Bottom"
 212
 213     def execute(self, context):
 214         bpy.ops.view3d.view_axis(type='BOTTOM')
 215         return {'FINISHED'}
 216
 217
 218 # Panel class of this toolbar
 219 class VIEW3D_PT_3dnavigationPanel(Panel):
 220     bl_category = "Display"
 221     bl_space_type = "VIEW_3D"
 222     bl_region_type = "UI"
 223     bl_label = "3D Nav"
 224
 225     def draw(self, context):
 226         layout = self.layout
 227         view = context.space_data
 228
 229         # Triple buttons
 230         col = layout.column(align=True)
 231         col.operator("view3d.localview", text="View Global / Local")
 232         col.operator("view3d.view_persportho", text="View Persp / Ortho")
 233         col.operator("view3d.view_camera", text="View Camera", icon='CAMERA_DATA')
 234
 235         # group of 6 buttons
 236         col = layout.column(align=True)
 237         col.label(text="Align view from:", icon="VIEW3D")
 238         row = col.row()
 239         row.operator("view3d.view_axis", text="Front").type = 'FRONT'
 240         row.operator("view3d.view_axis", text="Back").type = 'BACK'
 241         row = col.row()
 242         row.operator("view3d.view_axis", text="Left").type = 'LEFT'
 243         row.operator("view3d.view_axis", text="Right").type = 'RIGHT'
 244         row = col.row()
 245         row.operator("view3d.view_axis", text="Top").type = 'TOP'
 246         row.operator("view3d.view_axis", text="Bottom").type = 'BOTTOM'
 247
 248         # group of 2 buttons
 249         col = layout.column(align=True)
 250         col.label(text="Lock View to Object:", icon="LOCKED")
 251         col.prop(view, "lock_object", text="")
 252         col.operator("view3d.view_selected", text="View to Selected")
 253
 254         col = layout.column(align=True)
 255         col.label(text="Cursor:", icon='PIVOT_CURSOR')
 256         row = col.row(align=True)
 257         row.operator("view3d.snap_cursor_to_center", text="World Origin")
 258         row.operator("view3d.view_center_cursor", text="View")
 259         col.operator("view3d.snap_cursor_to_selected", text="Cursor to Selected")
 260
 261
 262 class VIEW3D_PT_pan_navigation1(Panel):
 263     bl_idname = "pan.navigation1"
 264     bl_label = "Pan Orbit Zoom Roll"
 265     bl_space_type = "VIEW_3D"
 266     bl_region_type = "UI"
 267     bl_category = "Display"
 268     bl_options = {'DEFAULT_CLOSED'}
 269
 270     def draw(self, context):
 271         layout = self.layout
 272         layout.label(text="Screen View Perspective")
 273
 274         row = layout.row()
 275         row.label(text="Pan:")
 276         row = layout.row()
 277
 278         row.operator("opr.pan_up_views_all", text="Up",
 279                     icon="TRIA_UP").panning = "PANDOWN"
 280         row.operator("opr.pan_up_views_all", text="Down",
 281                     icon="TRIA_DOWN").panning = "PANUP"
 282
 283         row = layout.row()
 284         row.operator("opr.pan_up_views_all", text="Left",
 285                     icon="BACK").panning = "PANRIGHT"
 286         row.operator("opr.pan_up_views_all", text="Right",
 287                     icon="FORWARD").panning = "PANLEFT"
 288
 289         row = layout.row()
 290         row.label(text="Orbit:")
 291         row = layout.row()
 292         row.operator("opr.orbit_down_view1", text="Up", icon="TRIA_UP")
 293         row.operator("opr.orbit_up_view1", text="Down", icon="TRIA_DOWN")
 294
 295         row = layout.row()
 296         row.operator("opr.orbit_right_view1", text="Left", icon="BACK")
 297         row.operator("opr.orbit_left_view1", text="Right", icon="FORWARD")
 298
 299         row = layout.row()
 300         row.label(text="Zoom:")
 301         row = layout.row()
 302         row.operator("opr.zoom_in_view1", text="In", icon='ADD')
 303         row.operator("opr.zoom_out_view1", text="Out", icon='REMOVE')
 304
 305         row = layout.row()
 306         row.label(text="Roll:")
 307         row = layout.row()
 308         row.operator("opr.roll_left_view1", text="Left", icon="LOOP_BACK")
 309         row.operator("opr.roll_right_view1", text="Right", icon="LOOP_FORWARDS")
 310
 311
 312 # Add-ons Preferences Update Panel
 313
 314 # Define Panel classes for updating
 315 panels = (
 316         VIEW3D_PT_3dnavigationPanel,
 317         VIEW3D_PT_pan_navigation1,
 318         )
 319
 320
 321 def update_panel(self, context):
 322     message = ": Updating Panel locations has failed"
 323     try:
 324         for panel in panels:
 325             if "bl_rna" in panel.__dict__:
 326                 bpy.utils.unregister_class(panel)
 327
 328         for panel in panels:
 329             panel.bl_category = context.preferences.addons[__name__].preferences.category
 330             bpy.utils.register_class(panel)
 331
 332     except Exception as e:
 333         print("\n[{}]\n{}\n\nError:\n{}".format(__name__, message, e))
 334         pass
 335
 336
 337 class NavAddonPreferences(AddonPreferences):
 338     # this must match the addon name, use '__package__'
 339     # when defining this in a submodule of a python package.
 340     bl_idname = __name__
 341
 342     category: StringProperty(
 343             name="Tab Category",
 344             description="Choose a name for the category of the panel",
 345             default="Display",
 346             update=update_panel
 347             )
 348
 349     def draw(self, context):
 350         layout = self.layout
 351
 352         row = layout.row()
 353         col = row.column()
 354         col.label(text="Tab Category:")
 355         col.prop(self, "category", text="")
 356
 357
 358 classes = (
 359     VIEW3D_PT_3dnavigationPanel,
 360     VIEW3D_PT_pan_navigation1,
 361     OrbitUpView1,
 362     OrbitLeftView1,
 363     OrbitRightView1,
 364     OrbitDownView1,
 365     ZoomInView1,
 366     ZoomOutView1,
 367     RollLeftView1,
 368     RollRightView1,
 369     LeftViewpoint1,
 370     RightViewpoint1,
 371     FrontViewpoint1,
 372     BackViewpoint1,
 373     TopViewpoint1,
 374     BottomViewpoint1,
 375     NavAddonPreferences,
 376     PanUpViewsAll,
 377 )
 378
 379
 380 # Register
 381 def register():
 382     for cls in classes:
 383         bpy.utils.register_class(cls)
 384     update_panel(None, bpy.context)
 385
 386
 387 def unregister():
 388     for cls in classes:
 389         bpy.utils.unregister_class(cls)
 390
 391
 392 if __name__ == "__main__":
 393     register()