pyvista.Plotter.enable_element_picking

pyvista.Plotter.enable_element_picking#

Plotter.enable_element_picking(
callback=None,
mode='cell',
show=True,
show_message=True,
font_size=18,
tolerance=0.025,
pickable_window=False,
left_clicking=False,
picker=PickerType.CELL,
**kwargs,
)[source]#

Select individual elements on a mesh.

Parameters:
callbackcallable(), optional

When input, calls this callable after a selection is made. The mesh is input as the first parameter to this callable.

modestr | ElementType, default: “cell”

The picking mode. Either "mesh", "cell", "face", "edge", or "point".

showbool, default: True

Show the selection interactively.

show_messagebool | str, default: True

Show the message about how to use the mesh picking tool. If this is a string, that will be the message shown.

font_sizeint, default: 18

Sets the font size of the message.

tolerancefloat, default: 0.025

Specify tolerance for performing pick operation. Tolerance is specified as fraction of rendering window size. Rendering window size is measured across diagonal.

Warning

This is ignored with the 'hardware' picker.

pickable_windowbool, default: False

When True, points in the 3D window are pickable.

left_clickingbool, default: False

When True, meshes can be picked by clicking the left mousebutton.

Note

If enabled, left-clicking will not display the bounding box around the picked mesh.

pickerstr | PickerType, optional

Choice of VTK picker class type:

  • 'hardware': Uses vtkHardwarePicker which is more performant for large geometries (default).

  • 'cell': Uses vtkCellPicker.

  • 'point': Uses vtkPointPicker which will snap to points on the surface of the mesh.

  • 'volume': Uses vtkVolumePicker.

**kwargsdict, optional

All remaining keyword arguments are used to control how the picked path is interactively displayed.