pyvista.Plotter.add_actor#

Plotter.add_actor(
actor,
reset_camera=False,
name=None,
culling=False,
pickable=True,
render=True,
remove_existing_actor=True,
)[source]#

Add an actor to render window.

Creates an actor if input is a mapper.

Parameters:
actorvtk.vtkActor | vtk.vtkMapper | pyvista.Actor

The actor to be added. Can be either vtkActor or vtkMapper.

reset_camerabool, default: False

Resets the camera when True.

namestr, optional

Name to assign to the actor. Defaults to the memory address.

cullingstr, default: False

Does not render faces that are culled. Options are 'front' or 'back'. This can be helpful for dense surface meshes, especially when edges are visible, but can cause flat meshes to be partially displayed.

pickablebool, default: True

Whether to allow this actor to be pickable within the render window.

renderbool, default: True

If the render window is being shown, trigger a render after adding the actor.

remove_existing_actorbool, default: True

Removes any existing actor if the named actor name is already present.

Returns:
actorvtk.vtkActor or pyvista.Actor

The actor.

actor_propertiesvtk.Properties

Actor properties.