pyvista.Renderer.reset_camera

pyvista.Renderer.reset_camera#

Renderer.reset_camera(render=True, bounds=None)[source]#

Reset the camera of the active render window.

The camera slides along the vector defined from camera position to focal point until all of the actors can be seen.

Parameters:
renderbool, default: True

Trigger a render after resetting the camera.

boundsiterable(int), optional

Automatically set up the camera based on a specified bounding box (x_min, x_max, y_min, y_max, z_min, z_max).

Examples

Add a mesh and place the camera position too close to the mesh. Then reset the camera and show the mesh.

>>> import pyvista as pv
>>> pl = pv.Plotter()
>>> actor = pl.add_mesh(pv.Sphere(), show_edges=True)
>>> pl.set_position((0, 0.1, 0.1))
>>> pl.reset_camera()
>>> pl.show()
../../../_images/pyvista-Renderer-reset_camera-1_00_00.png