pyvista.Plotter.pickable_actors#

property Plotter.pickable_actors[source]#

Return or set the pickable actors.

When setting, this will be the list of actors to make pickable. All actors not in the list will be made unpickable. If actors is None, all actors will be made unpickable.

Returns:
list[pyvista.Actor]

List of actors.

Examples

Add two actors to a pyvista.Plotter, make one pickable, and then list the pickable actors.

>>> import pyvista as pv
>>> pl = pv.Plotter()
>>> sphere_actor = pl.add_mesh(pv.Sphere())
>>> cube_actor = pl.add_mesh(
...     pv.Cube(), pickable=False, style='wireframe'
... )
>>> len(pl.pickable_actors)
1

Set the pickable actors to both actors.

>>> pl.pickable_actors = [sphere_actor, cube_actor]
>>> len(pl.pickable_actors)
2

Set the pickable actors to None.

>>> pl.pickable_actors = None
>>> len(pl.pickable_actors)
0
../../../_images/pyvista-Plotter-pickable_actors-1_00_00.png