user: How do I use SpaceView3D(Space) in Blender? Include parameters, examples, warnings and best practices.

assistant: # SpaceView3D(Space)

base classes — [`bpy_struct`](bpy.types.bpy_struct.html#bpy.types.bpy_struct "bpy.types.bpy_struct"), [`Space`](bpy.types.Space.html#bpy.types.Space "bpy.types.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`](bpy.types.Object.html#bpy.types.Object "bpy.types.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`](#bpy.types.SpaceView3D "bpy.types.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`](bpy.types.Object.html#bpy.types.Object "bpy.types.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`](bpy.types.View3DOverlay.html#bpy.types.View3DOverlay "bpy.types.View3DOverlay"), (readonly, never None)

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

        Type:
        :   [`RegionView3D`](bpy.types.RegionView3D.html#bpy.types.RegionView3D "bpy.types.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`](bpy.types.bpy_prop_collection.html#bpy.types.bpy_prop_collection "bpy.types.bpy_prop_collection") of [`RegionView3D`](bpy.types.RegionView3D.html#bpy.types.RegionView3D "bpy.types.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`](bpy.types.View3DShading.html#bpy.types.View3DShading "bpy.types.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 True

    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 True

    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_modifier
    :   Gizmos for the active modifier

        Type:
        :   boolean, default True

    show_gizmo_navigate
    :   Viewport navigation gizmo

        Type:
        :   boolean, default True

    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 True

    show_object_select_armature
    :   Allow selection of armatures

        Type:
        :   boolean, default True

    show_object_select_camera
    :   Allow selection of cameras

        Type:
        :   boolean, default True

    show_object_select_curve
    :   Allow selection of curves

        Type:
        :   boolean, default True

    show_object_select_curves
    :   Allow selection of hair curves

        Type:
        :   boolean, default True

    show_object_select_empty
    :   Allow selection of empties

        Type:
        :   boolean, default True

    show_object_select_font
    :   Allow selection of text objects

        Type:
        :   boolean, default True

    show_object_select_grease_pencil
    :   Allow selection of Grease Pencil objects

        Type:
        :   boolean, default True

    show_object_select_lattice
    :   Allow selection of lattices

        Type:
        :   boolean, default True

    show_object_select_light
    :   Allow selection of lights

        Type:
        :   boolean, default True

    show_object_select_light_probe
    :   Allow selection of light probes

        Type:
        :   boolean, default True

    show_object_select_mesh
    :   Allow selection of mesh objects

        Type:
        :   boolean, default True

    show_object_select_meta
    :   Allow selection of metaballs

        Type:
        :   boolean, default True

    show_object_select_pointcloud
    :   Allow selection of point clouds

        Type:
        :   boolean, default True

    show_object_select_speaker
    :   Allow selection of speakers

        Type:
        :   boolean, default True

    show_object_select_surf
    :   Allow selection of surfaces

        Type:
        :   boolean, default True

    show_object_select_volume
    :   Allow selection of volumes

        Type:
        :   boolean, default True

    show_object_viewport_armature
    :   Show armatures

        Type:
        :   boolean, default True

    show_object_viewport_camera
    :   Show cameras

        Type:
        :   boolean, default True

    show_object_viewport_curve
    :   Show curves

        Type:
        :   boolean, default True

    show_object_viewport_curves
    :   Show hair curves

        Type:
        :   boolean, default True

    show_object_viewport_empty
    :   Show empties

        Type:
        :   boolean, default True

    show_object_viewport_font
    :   Show text objects

        Type:
        :   boolean, default True

    show_object_viewport_grease_pencil
    :   Show Grease Pencil objects

        Type:
        :   boolean, default True

    show_object_viewport_lattice
    :   Show lattices

        Type:
        :   boolean, default True

    show_object_viewport_light
    :   Show lights

        Type:
        :   boolean, default True

    show_object_viewport_light_probe
    :   Show light probes

        Type:
        :   boolean, default True

    show_object_viewport_mesh
    :   Show mesh objects

        Type:
        :   boolean, default True

    show_object_viewport_meta
    :   Show metaballs

        Type:
        :   boolean, default True

    show_object_viewport_pointcloud
    :   Show point clouds

        Type:
        :   boolean, default True

    show_object_viewport_speaker
    :   Show speakers

        Type:
        :   boolean, default True

    show_object_viewport_surf
    :   Show surfaces

        Type:
        :   boolean, default True

    show_object_viewport_volume
    :   Show volumes

        Type:
        :   boolean, default True

    show_reconstruction
    :   Display reconstruction data from active movie clip

        Type:
        :   boolean, default True

    show_region_asset_shelf
    :   Display a region with assets that may currently be relevant (such as brushes in paint modes, or poses in Pose Mode)

        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 False

    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** (*str*) – The RNA type identifier.

        Returns:
        :   The RNA type or default when not found.

        Return type:
        :   [`bpy.types.Struct`](bpy.types.Struct.html#bpy.types.Struct "bpy.types.Struct") subclass

    *classmethod* bl_rna_get_subclass_py(*id*, *default=None*, */*)
    :   Parameters:
        :   **id** (*str*) – 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** (*Callable**[**...**,* *Any**]*) – A function that will be called when the region is drawn.
              It gets the specified arguments as input, it’s return value is ignored.
            - **args** (*tuple**[**Any**,* *...**]*) – Arguments that will be passed to the callback.
            - **region_type** (*str*) – The region type the callback draws in; usually `WINDOW`. ([`bpy.types.Region.type`](bpy.types.Region.html#bpy.types.Region.type "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.