# SpaceView3D(Space)

base classes — `bpy_struct`, `Space`

class `bpy.types.``SpaceView3D`(Space)

  3D View space data

  `background_images`

    List of background images

    Type: | `BackgroundImages` `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 1000.0

  `clip_start`

    3D View near clipping distance (perspective view only)

    Type: | float in [0.001, inf], default 0.1

  `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)

  `fx_settings`

    Options used for real time compositing

    Type: | `GPUFXSettings`, (readonly)

  `grid_lines`

    Number of grid lines to display in perspective view

    Type: | int in [0, 1024], default 16

  `grid_scale`

    Distance between 3D View grid lines

    Type: | float in [0, inf], default 1.0

  `grid_scale_unit`

    Grid cell size scaled by scene unit system settings

    Type: | float in [-inf, inf], default 0.0, (readonly)

  `grid_subdivisions`

    Number of subdivisions between grid lines

    Type: | int in [1, 1024], default 10

  `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_local_view`

    Local view layers visible in this 3D View

    Type: | boolean array of 8 items, default (False, False, False, False, False, False, False, False), (readonly)

  `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`

    Viewport lens angle

    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 “”, (never None)

  `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`

  `matcap_icon`

    Image to use for Material Capture, active objects only

    Type: | enum in [‘01’, ‘02’, ‘03’, ‘04’, ‘05’, ‘06’, ‘07’, ‘08’, ‘09’, ‘10’, ‘11’, ‘12’, ‘13’, ‘14’, ‘15’, ‘16’, ‘17’, ‘18’, ‘19’, ‘20’, ‘21’, ‘22’, ‘23’, ‘24’], default ‘01’

  `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_quadviews`

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

    Type: | `bpy_prop_collection` of `RegionView3D`, (readonly)

  `render_border_max_x`

    Maximum X value for the render border

    Type: | float in [0, 1], default 0.0

  `render_border_max_y`

    Maximum Y value for the render border

    Type: | float in [0, 1], default 0.0

  `render_border_min_x`

    Minimum X value for the render border

    Type: | float in [0, 1], default 0.0

  `render_border_min_y`

    Minimum Y value for the render border

    Type: | float in [0, 1], default 0.0

  `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_backface_culling`

    Use back face culling to hide the back side of faces

    Type: | boolean, default False

  `show_background_images`

    Display reference images behind objects in the 3D View

    Type: | boolean, default False

  `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_floor`

    Show the ground plane grid in perspective view

    Type: | boolean, default False

  `show_grease_pencil`

    Show grease pencil for this view

    Type: | boolean, default False

  `show_manipulator`

    Use a 3D manipulator widget for controlling transforms

    Type: | boolean, default False

  `show_occlude_wire`

    Use hidden wireframe display

    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_reconstruction`

    Display reconstruction data from active movie clip

    Type: | boolean, default False

  `show_relationship_lines`

    Show dashed lines indicating parent or constraint relationships

    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 False

  `show_stereo_3d_volume`

    Show the stereo 3d frustum volume

    Type: | boolean, default False

  `show_textured_shadeless`

    Show shadeless texture without lighting in textured draw mode

    Type: | boolean, default False

  `show_textured_solid`

    Display face-assigned textures in solid view

    Type: | boolean, default False

  `show_world`

    Display world colors in the background

    Type: | boolean, default False

  `stereo_3d_camera`

    Type: | enum in [‘LEFT’, ‘RIGHT’, ‘S3D’], default ‘LEFT’

  `stereo_3d_convergence_plane_alpha`

    Opacity (alpha) of the convergence plane

    Type: | float in [0, 1], default 0.0

  `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.0

  `tracks_draw_size`

    Display size of tracks from reconstructed data

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

  `tracks_draw_type`

    Viewport display style for tracks

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

  `transform_manipulators`

    Transformation manipulators

    - `TRANSLATE` Translate, Use the manipulator for movement transformations.
    - `ROTATE` Rotate, Use the manipulator for rotation transformations.
    - `SCALE` Scale, Use the manipulator for scale transformations.

    Type: | enum set in {‘TRANSLATE’, ‘ROTATE’, ‘SCALE’}, default {‘TRANSLATE’}

  `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.
    - `NORMAL` Normal, Align the transformation axes to average normal of selected elements (bone Y axis for pose mode).
    - `GIMBAL` Gimbal, Align each axis to the Euler rotation axis as used for input.
    - `VIEW` View, Align the transformation axes to the window.

    Type: | enum in [‘GLOBAL’, ‘LOCAL’, ‘NORMAL’, ‘GIMBAL’, ‘VIEW’], default ‘GLOBAL’

  `use_matcap`

    Active Objects draw images mapped on normals, enhancing Solid Draw Mode

    Type: | boolean, default False

  `use_occlude_geometry`

    Limit selection to visible (clipped with depth buffer)

    Type: | boolean, default False

  `use_pivot_point_align`

    Manipulate center points (object and pose mode only)

    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

  `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` Texture, Display the object solid, with a texture.
    - `MATERIAL` Material, Display objects solid, with GLSL material.
    - `RENDERED` Rendered, Display render preview.

    Type: | enum in [‘BOUNDBOX’, ‘WIREFRAME’, ‘SOLID’, ‘TEXTURED’, ‘MATERIAL’, ‘RENDERED’], default ‘BOUNDBOX’

  `draw_handler_add`()

    Undocumented

  `draw_handler_remove`()

    Undocumented

Inherited Properties

`bpy_struct.id_data` `Space.type` | `Space.show_locked_time`

Inherited Functions

`bpy_struct.as_pointer` `bpy_struct.driver_add` `bpy_struct.driver_remove` `bpy_struct.get` `bpy_struct.is_property_hidden` `bpy_struct.is_property_readonly` `bpy_struct.is_property_set` `bpy_struct.items` | `bpy_struct.keyframe_delete` `bpy_struct.keyframe_insert` `bpy_struct.keys` `bpy_struct.path_from_id` `bpy_struct.path_resolve` `bpy_struct.property_unset` `bpy_struct.type_recast` `bpy_struct.values`

References

`ObjectBase.layers_from_view` | `SpaceView3D.local_view`