View3D Operators

bpy.ops.view3d.background_image_add(name="Image", filepath="Path")

Add a new background image

Parameters:
  • name (string, (optional)) – Name, Image name to assign.
  • filepath (string, (optional)) – Filepath, Path to image file
bpy.ops.view3d.background_image_remove(index=0)

Remove a background image from the 3D view

Parameters:index (int in [0, inf], (optional)) – Index, Background image index to remove
bpy.ops.view3d.camera_to_view()

Set camera view to active view

bpy.ops.view3d.clip_border(xmin=0, xmax=0, ymin=0, ymax=0)

Set the view clipping border

Parameters:
  • xmin (int in [-inf, inf], (optional)) – X Min
  • xmax (int in [-inf, inf], (optional)) – X Max
  • ymin (int in [-inf, inf], (optional)) – Y Min
  • ymax (int in [-inf, inf], (optional)) – Y Max
bpy.ops.view3d.cursor3d()

Set the location of the 3D cursor

bpy.ops.view3d.dolly(delta=0, mx=0, my=0)

Dolly in/out in the view

Parameters:
  • delta (int in [-inf, inf], (optional)) – Delta
  • mx (int in [0, inf], (optional)) – Zoom Position X
  • my (int in [0, inf], (optional)) – Zoom Position Y
bpy.ops.view3d.edit_mesh_extrude_individual_move()

Extrude individual elements and move

File :startup/bl_ui/space_view3d.py:1549
bpy.ops.view3d.edit_mesh_extrude_move_normal()

Extrude and move along normals

File :startup/bl_ui/space_view3d.py:1578
bpy.ops.view3d.enable_manipulator(translate=False, rotate=False, scale=False)

Enable the transform manipulator for use

Parameters:
  • translate (boolean, (optional)) – Translate, Enable the translate manipulator
  • rotate (boolean, (optional)) – Rotate, Enable the rotate manipulator
  • scale (boolean, (optional)) – Scale, Enable the scale manipulator
bpy.ops.view3d.fly()

Interactively fly around the scene

bpy.ops.view3d.game_start()

Start game engine

bpy.ops.view3d.layers(nr=1, extend=False, toggle=True)

Toggle layer(s) visibility

Parameters:
  • nr (int in [0, 20], (optional)) – Number, The layer number to set, zero for all layers
  • extend (boolean, (optional)) – Extend, Add this layer to the current view layers
  • toggle (boolean, (optional)) – Toggle, Toggle the layer
bpy.ops.view3d.localview()

Toggle display of selected object(s) separately and centered in view

bpy.ops.view3d.manipulator(constraint_axis=(False, False, False), constraint_orientation='', release_confirm=False)

Manipulate selected item by axis

Parameters:
  • constraint_axis (boolean array of 3 items, (optional)) – Constraint Axis
  • constraint_orientation (enum in [], (optional)) – Orientation, Transformation orientation
  • release_confirm (boolean, (optional)) – Confirm on Release, Always confirm operation when releasing button
bpy.ops.view3d.move()

Move the view

bpy.ops.view3d.object_as_camera()

Set the active object as the active camera for this view or scene

bpy.ops.view3d.properties()

Toggles the properties panel display

bpy.ops.view3d.render_border(xmin=0, xmax=0, ymin=0, ymax=0)

Set the boundaries of the border render and enables border render

Parameters:
  • xmin (int in [-inf, inf], (optional)) – X Min
  • xmax (int in [-inf, inf], (optional)) – X Max
  • ymin (int in [-inf, inf], (optional)) – Y Min
  • ymax (int in [-inf, inf], (optional)) – Y Max
bpy.ops.view3d.rotate()

Rotate the view

bpy.ops.view3d.select(extend=False, center=False, enumerate=False)

Activate/select item(s)

Parameters:
  • extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first.
  • center (boolean, (optional)) – Center, Use the object center when selecting (object mode only).
  • enumerate (boolean, (optional)) – Enumerate, List objects under the mouse (object mode only).
bpy.ops.view3d.select_border(gesture_mode=0, xmin=0, xmax=0, ymin=0, ymax=0, extend=True)

Select items using border selection

Parameters:
  • gesture_mode (int in [-inf, inf], (optional)) – Gesture Mode
  • xmin (int in [-inf, inf], (optional)) – X Min
  • xmax (int in [-inf, inf], (optional)) – X Max
  • ymin (int in [-inf, inf], (optional)) – Y Min
  • ymax (int in [-inf, inf], (optional)) – Y Max
  • extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first
bpy.ops.view3d.select_circle(x=0, y=0, radius=0, gesture_mode=0)

Select items using circle selection

Parameters:
  • x (int in [-inf, inf], (optional)) – X
  • y (int in [-inf, inf], (optional)) – Y
  • radius (int in [-inf, inf], (optional)) – Radius
  • gesture_mode (int in [-inf, inf], (optional)) – Event Type
bpy.ops.view3d.select_lasso(path=None, deselect=False, extend=True)

Select items using lasso selection

Parameters:
  • path (bpy_prop_collection of OperatorMousePath, (optional)) – Path
  • deselect (boolean, (optional)) – Deselect, Deselect rather than select items.
  • extend (boolean, (optional)) – Extend, Extend selection instead of deselecting everything first.
bpy.ops.view3d.smoothview()

The time to animate the change of view (in milliseconds)

bpy.ops.view3d.snap_cursor_to_active()

Snap cursor to active item

bpy.ops.view3d.snap_cursor_to_center()

Snap cursor to the Center

bpy.ops.view3d.snap_cursor_to_grid()

Snap cursor to nearest grid node

bpy.ops.view3d.snap_cursor_to_selected()

Snap cursor to center of selected item(s)

bpy.ops.view3d.snap_selected_to_cursor()

Snap selected item(s) to cursor

bpy.ops.view3d.snap_selected_to_grid()

Snap selected item(s) to nearest grid node

bpy.ops.view3d.toolshelf()

Toggles tool shelf display

bpy.ops.view3d.view_all(center=False)

View all objects in scene

Parameters:center (boolean, (optional)) – Center
bpy.ops.view3d.view_center_camera()

Center the camera view

bpy.ops.view3d.view_center_cursor()

Centers the view so that the cursor is in the middle of the view

bpy.ops.view3d.view_orbit(type='ORBITLEFT')

Orbit the view

Parameters:type (enum in [‘ORBITLEFT’, ‘ORBITRIGHT’, ‘ORBITUP’, ‘ORBITDOWN’], (optional)) – Orbit, Direction of View Orbit
bpy.ops.view3d.view_pan(type='PANLEFT')

Pan the view

Parameters:type (enum in [‘PANLEFT’, ‘PANRIGHT’, ‘PANUP’, ‘PANDOWN’], (optional)) – Pan, Direction of View Pan
bpy.ops.view3d.view_persportho()

Switch the current view from perspective/orthographic

bpy.ops.view3d.view_selected()

Move the view to the selection center

bpy.ops.view3d.viewnumpad(type='FRONT', align_active=False)

Set the view

Parameters:
  • type (enum in [‘FRONT’, ‘BACK’, ‘LEFT’, ‘RIGHT’, ‘TOP’, ‘BOTTOM’, ‘CAMERA’], (optional)) – View, The Type of view
  • align_active (boolean, (optional)) – Align Active, Align to the active objects axis
bpy.ops.view3d.zoom(delta=0, mx=0, my=0)

Zoom in/out in the view

Parameters:
  • delta (int in [-inf, inf], (optional)) – Delta
  • mx (int in [0, inf], (optional)) – Zoom Position X
  • my (int in [0, inf], (optional)) – Zoom Position Y
bpy.ops.view3d.zoom_border(xmin=0, xmax=0, ymin=0, ymax=0)

Zoom in the view to the nearest object contained in the border

Parameters:
  • xmin (int in [-inf, inf], (optional)) – X Min
  • xmax (int in [-inf, inf], (optional)) – X Max
  • ymin (int in [-inf, inf], (optional)) – Y Min
  • ymax (int in [-inf, inf], (optional)) – Y Max
bpy.ops.view3d.zoom_camera_1_to_1()

Match the camera to 1:1 to the render output

Previous topic

View2D Operators

Next topic

Wm Operators