SpaceView3D(Space)#

base classes — bpy_struct, Space

class bpy.types.SpaceView3D(Space)#

3D View space data

camera#

Active camera used in this view (when unlocked from the scene’s active camera)

Type:

Object

clip_end#

3D View far clipping distance

Type:

float in [1e-06, inf], default 1000.0

clip_start#

3D View near clipping distance (perspective view only)

Type:

float in [1e-06, inf], default 0.01

icon_from_show_object_viewport#
Type:

int in [-inf, inf], default 0, (readonly)

lens#

Viewport lens angle

Type:

float in [1, 250], default 50.0

local_view#

Display an isolated subset of objects, apart from the scene visibility

Type:

SpaceView3D, (readonly)

lock_bone#

3D View center is locked to this bone’s position

Type:

string, default “”, (never None)

lock_camera#

Enable view navigation within the camera view

Type:

boolean, default False

lock_cursor#

3D View center is locked to the cursor’s position

Type:

boolean, default False

lock_object#

3D View center is locked to this object’s position

Type:

Object

mirror_xr_session#

Synchronize the viewer perspective of virtual reality sessions with this 3D viewport

Type:

boolean, default False

overlay#

Settings for display of overlays in the 3D viewport

Type:

View3DOverlay, (readonly, never None)

region_3d#

3D region for this space. When the space is in quad view, the camera region

Type:

RegionView3D, (readonly)

region_quadviews#

3D regions (the third one defines quad view settings, the fourth one is same as ‘region_3d’)

Type:

bpy_prop_collection of RegionView3D, (readonly)

render_border_max_x#

Maximum X value for the render region

Type:

float in [0, 1], default 0.0

render_border_max_y#

Maximum Y value for the render region

Type:

float in [0, 1], default 0.0

render_border_min_x#

Minimum X value for the render region

Type:

float in [0, 1], default 0.0

render_border_min_y#

Minimum Y value for the render region

Type:

float in [0, 1], default 0.0

shading#

Settings for shading in the 3D viewport

Type:

View3DShading, (readonly, never None)

show_bundle_names#

Show names for reconstructed tracks objects

Type:

boolean, default False

show_camera_path#

Show reconstructed camera path

Type:

boolean, default False

show_gizmo#

Show gizmos of all types

Type:

boolean, default False

show_gizmo_camera_dof_distance#

Gizmo to adjust camera focus distance (depends on limits display)

Type:

boolean, default False

show_gizmo_camera_lens#

Gizmo to adjust camera focal length or orthographic scale

Type:

boolean, default False

show_gizmo_context#

Context sensitive gizmos for the active item

Type:

boolean, default False

show_gizmo_empty_force_field#

Gizmo to adjust the force field

Type:

boolean, default False

show_gizmo_empty_image#

Gizmo to adjust image size and position

Type:

boolean, default False

show_gizmo_light_look_at#

Gizmo to adjust the direction of the light

Type:

boolean, default False

show_gizmo_light_size#

Gizmo to adjust spot and area size

Type:

boolean, default False

show_gizmo_navigate#

Viewport navigation gizmo

Type:

boolean, default False

show_gizmo_object_rotate#

Gizmo to adjust rotation

Type:

boolean, default False

show_gizmo_object_scale#

Gizmo to adjust scale

Type:

boolean, default False

show_gizmo_object_translate#

Gizmo to adjust location

Type:

boolean, default False

show_gizmo_tool#

Active tool gizmo

Type:

boolean, default False

show_object_select_armature#

Allow selection of armatures

Type:

boolean, default False

show_object_select_camera#

Allow selection of cameras

Type:

boolean, default False

show_object_select_curve#

Allow selection of curves

Type:

boolean, default False

show_object_select_curves#

Allow selection of hair curves

Type:

boolean, default False

show_object_select_empty#

Allow selection of empties

Type:

boolean, default False

show_object_select_font#

Allow selection of text objects

Type:

boolean, default False

show_object_select_grease_pencil#

Allow selection of grease pencil objects

Type:

boolean, default False

show_object_select_lattice#

Allow selection of lattices

Type:

boolean, default False

show_object_select_light#

Allow selection of lights

Type:

boolean, default False

show_object_select_light_probe#

Allow selection of light probes

Type:

boolean, default False

show_object_select_mesh#

Allow selection of mesh objects

Type:

boolean, default False

show_object_select_meta#

Allow selection of metaballs

Type:

boolean, default False

show_object_select_pointcloud#

Allow selection of point clouds

Type:

boolean, default False

show_object_select_speaker#

Allow selection of speakers

Type:

boolean, default False

show_object_select_surf#

Allow selection of surfaces

Type:

boolean, default False

show_object_select_volume#

Allow selection of volumes

Type:

boolean, default False

show_object_viewport_armature#

Show armatures

Type:

boolean, default False

show_object_viewport_camera#

Show cameras

Type:

boolean, default False

show_object_viewport_curve#

Show curves

Type:

boolean, default False

show_object_viewport_curves#

Show hair curves

Type:

boolean, default False

show_object_viewport_empty#

Show empties

Type:

boolean, default False

show_object_viewport_font#

Show text objects

Type:

boolean, default False

show_object_viewport_grease_pencil#

Show grease pencil objects

Type:

boolean, default False

show_object_viewport_lattice#

Show lattices

Type:

boolean, default False

show_object_viewport_light#

Show lights

Type:

boolean, default False

show_object_viewport_light_probe#

Show light probes

Type:

boolean, default False

show_object_viewport_mesh#

Show mesh objects

Type:

boolean, default False

show_object_viewport_meta#

Show metaballs

Type:

boolean, default False

show_object_viewport_pointcloud#

Show point clouds

Type:

boolean, default False

show_object_viewport_speaker#

Show speakers

Type:

boolean, default False

show_object_viewport_surf#

Show surfaces

Type:

boolean, default False

show_object_viewport_volume#

Show volumes

Type:

boolean, default False

show_reconstruction#

Display reconstruction data from active movie clip

Type:

boolean, default True

show_region_asset_shelf#
Type:

boolean, default False

show_region_hud#
Type:

boolean, default False

show_region_tool_header#
Type:

boolean, default False

show_region_toolbar#
Type:

boolean, default False

show_region_ui#
Type:

boolean, default False

show_stereo_3d_cameras#

Show the left and right cameras

Type:

boolean, default False

show_stereo_3d_convergence_plane#

Show the stereo 3D convergence plane

Type:

boolean, default True

show_stereo_3d_volume#

Show the stereo 3D frustum volume

Type:

boolean, default False

show_viewer#

Display non-final geometry from viewer nodes

Type:

boolean, default True

stereo_3d_camera#
Type:

enum in [‘LEFT’, ‘RIGHT’, ‘S3D’], default ‘S3D’

stereo_3d_convergence_plane_alpha#

Opacity (alpha) of the convergence plane

Type:

float in [0, 1], default 0.15

stereo_3d_eye#

Current stereo eye being displayed

Type:

enum in [‘LEFT_EYE’, ‘RIGHT_EYE’], default ‘LEFT_EYE’, (readonly)

stereo_3d_volume_alpha#

Opacity (alpha) of the cameras’ frustum volume

Type:

float in [0, 1], default 0.05

tracks_display_size#

Display size of tracks from reconstructed data

Type:

float in [0, inf], default 0.2

tracks_display_type#

Viewport display style for tracks

Type:

enum in [‘PLAIN_AXES’, ‘ARROWS’, ‘SINGLE_ARROW’, ‘CIRCLE’, ‘CUBE’, ‘SPHERE’, ‘CONE’], default ‘PLAIN_AXES’

use_local_camera#

Use a local camera in this view, rather than scene’s active camera

Type:

boolean, default True

use_local_collections#

Display a different set of collections in this viewport

Type:

boolean, default False

use_render_border#

Use a region within the frame size for rendered viewport (when not viewing through the camera)

Type:

boolean, default False

classmethod bl_rna_get_subclass(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The RNA type or default when not found.

Return type:

bpy.types.Struct subclass

classmethod bl_rna_get_subclass_py(id, default=None)#
Parameters:

id (string) – The RNA type identifier.

Returns:

The class or default when not found.

Return type:

type

classmethod draw_handler_add(callback, args, region_type, draw_type)#

Add a new draw handler to this space type. It will be called every time the specified region in the space type will be drawn. Note: All arguments are positional only for now.

Parameters:
  • callback (function) – A function that will be called when the region is drawn. It gets the specified arguments as input.

  • args (tuple) – Arguments that will be passed to the callback.

  • region_type (str) – The region type the callback draws in; usually WINDOW. (bpy.types.Region.type)

  • draw_type (str) – Usually POST_PIXEL for 2D drawing and POST_VIEW for 3D drawing. In some cases PRE_VIEW can be used. BACKDROP can be used for backdrops in the node editor.

Returns:

Handler that can be removed later on.

Return type:

object

classmethod draw_handler_remove(handler, region_type)#

Remove a draw handler that was added previously.

Parameters:
  • handler (object) – The draw handler that should be removed.

  • region_type (str) – Region type the callback was added to.

Inherited Properties#

Inherited Functions#

References#