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 sub-set 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 in this space, in case of 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 lens & ortho size

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
Type

boolean, default False

show_object_select_camera
Type

boolean, default False

show_object_select_curve
Type

boolean, default False

show_object_select_empty
Type

boolean, default False

show_object_select_font
Type

boolean, default False

show_object_select_grease_pencil
Type

boolean, default False

show_object_select_lattice
Type

boolean, default False

show_object_select_light
Type

boolean, default False

show_object_select_light_probe
Type

boolean, default False

show_object_select_mesh
Type

boolean, default False

show_object_select_meta
Type

boolean, default False

show_object_select_speaker
Type

boolean, default False

show_object_select_surf
Type

boolean, default False

show_object_select_volume
Type

boolean, default False

show_object_viewport_armature
Type

boolean, default False

show_object_viewport_camera
Type

boolean, default False

show_object_viewport_curve
Type

boolean, default False

show_object_viewport_empty
Type

boolean, default False

show_object_viewport_font
Type

boolean, default False

show_object_viewport_grease_pencil
Type

boolean, default False

show_object_viewport_lattice
Type

boolean, default False

show_object_viewport_light
Type

boolean, default False

show_object_viewport_light_probe
Type

boolean, default False

show_object_viewport_mesh
Type

boolean, default False

show_object_viewport_meta
Type

boolean, default False

show_object_viewport_speaker
Type

boolean, default False

show_object_viewport_surf
Type

boolean, default False

show_object_viewport_volume
Type

boolean, default False

show_reconstruction

Display reconstruction data from active movie clip

Type

boolean, default True

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

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 drawn

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

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

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