SpaceView3D(Space)

base classes — bpy_struct, Space

class bpy.types.SpaceView3D(Space)

3D View space data

background_images

List of background images

Type :bpy_prop_collection of BackgroundImage, (readonly)
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 [1, inf], default 0.0
clip_start

3D View near clipping distance

Type :float in [0.001, inf], default 0.0
current_orientation

Current Transformation orientation

Type :TransformOrientation, (readonly)
cursor_location

3D cursor location for this view (dependent on local view setting)

Type :float array of 3 items in [-inf, inf], default (0.0, 0.0, 0.0)
grid_lines

The number of grid lines to display in perspective view

Type :int in [0, 1024], default 0
grid_scale

The distance between 3D View grid lines

Type :float in [0, inf], default 0.0
grid_subdivisions

The number of subdivisions between grid lines

Type :int in [1, 1024], default 0
layers

Layers visible in this 3D View

Type :boolean array of 20 items, default (False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False)
layers_used

Layers that contain something

Type :boolean array of 20 items, default (False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False, False), (readonly)
lens

Lens angle (mm) in perspective view

Type :float in [1, 250], default 0.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 “”
lock_camera

Enable view navigation within the camera view

Type :boolean, default False
lock_camera_and_layers

Use the scene’s active camera and layers in this view, rather than local layers

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
pivot_point

Pivot center for rotation/scaling

  • BOUNDING_BOX_CENTER Bounding Box Center, Pivot around bounding box center of selected object(s).
  • CURSOR 3D Cursor, Pivot around the 3D cursor.
  • INDIVIDUAL_ORIGINS Individual Origins, Pivot around each object’s own origin.
  • MEDIAN_POINT Median Point, Pivot around the median point of selected objects.
  • ACTIVE_ELEMENT Active Element, Pivot around active object.
Type :enum in [‘BOUNDING_BOX_CENTER’, ‘CURSOR’, ‘INDIVIDUAL_ORIGINS’, ‘MEDIAN_POINT’, ‘ACTIVE_ELEMENT’], default ‘BOUNDING_BOX_CENTER’
region_3d

3D region in this space, in case of quad view the camera region

Type :RegionView3D, (readonly)
region_quadview

3D region that defines the quad view settings

Type :RegionView3D, (readonly)
show_all_objects_origin

Show the object origin center dot for all (selected and unselected) objects

Type :boolean, default False
show_axis_x

Show the X axis line in perspective view

Type :boolean, default False
show_axis_y

Show the Y axis line in perspective view

Type :boolean, default False
show_axis_z

Show the Z axis line in perspective view

Type :boolean, default False
show_background_images

Display reference images behind objects in the 3D View

Type :boolean, default False
show_floor

Show the ground plane grid in perspective view

Type :boolean, default False
show_manipulator

Use a 3D manipulator widget for controlling transforms

Type :boolean, default False
show_only_render

Display only objects which will be rendered

Type :boolean, default False
show_outline_selected

Show an outline highlight around selected objects in non-wireframe views

Type :boolean, default False
show_relationship_lines

Show dashed lines indicating parent or constraint relationships

Type :boolean, default False
show_textured_solid

Display face-assigned textures in solid view

Type :boolean, default False
transform_orientation

Transformation orientation

  • GLOBAL Global, Align the transformation axes to world space.
  • LOCAL Local, Align the transformation axes to the selected objects’ local space.
  • GIMBAL Gimbal, Align each axis to the Euler rotation axis as used for input.
  • NORMAL Normal, Align the transformation axes to average normal of selected elements (bone Y axis for pose mode).
  • VIEW View, Align the transformation axes to the window.
  • CUSTOM Custom, Use a custom transform orientation.
Type :enum in [‘GLOBAL’, ‘LOCAL’, ‘GIMBAL’, ‘NORMAL’, ‘VIEW’, ‘CUSTOM’], default ‘GLOBAL’
use_manipulator_rotate

Use the manipulator for rotation transformations

Type :boolean, default False
use_manipulator_scale

Use the manipulator for scale transformations

Type :boolean, default False
use_manipulator_translate

Use the manipulator for movement transformations

Type :boolean, default False
use_occlude_geometry

Limit selection to visible (clipped with depth buffer)

Type :boolean, default False
use_pivot_point_align

Manipulate object centers only

Type :boolean, default False
viewport_shade

Method to display/shade objects in the 3D View

  • BOUNDBOX Bounding Box, Display the object’s local bounding boxes only.
  • WIREFRAME Wireframe, Display the object as wire edges.
  • SOLID Solid, Display the object solid, lit with default OpenGL lights.
  • TEXTURED Textured, Display the object solid, with face-assigned textures.
Type :enum in [‘BOUNDBOX’, ‘WIREFRAME’, ‘SOLID’, ‘TEXTURED’], default ‘BOUNDBOX’

Inherited Properties

Inherited Functions

References

Previous topic

SpaceUserPreferences(Space)

Next topic

Speaker(ID)