# Picking points on a mesh
# ========================

# This example demonstrates how to pick points on meshes using
# `enable_point_picking()`.
import pyvista as pv

# Pick points on a sphere
# -----------------------

sphere = pv.Sphere()

pl = pv.Plotter()
pl.add_mesh(sphere, pickable=True)
pl.enable_point_picking()
pl.show()

# Ignore the 3D window
# --------------------

# In the above example, both points on the mesh and points in the 3d window can be
# selected. It is possible instead pick only points on the mesh.
sphere = pv.Sphere()

pl = pv.Plotter()
pl.add_mesh(sphere, pickable=True)
pl.enable_point_picking(pickable_window=False)  # Make the 3D window unpickable
pl.show()

# Modify which actors are pickable
# --------------------------------

# After enabling point picking, we can modify which actors are pickable.
sphere = pv.Sphere()
cube = pv.Cube().translate([10, 10, 0])

pl = pv.Plotter()
sphere_actor = pl.add_mesh(sphere, pickable=True)  # initially pickable
cube_actor = pl.add_mesh(cube, pickable=False)  # initially unpickable
pl.enable_point_picking(pickable_window=False)

pl.pickable_actors = [sphere_actor, cube_actor]  # now both are pickable
pl.view_xy()
pl.show()

# Pick using the left-mouse button
# --------------------------------

sphere = pv.Sphere()

pl = pv.Plotter()
pl.add_mesh(sphere, pickable=True)
pl.enable_point_picking(left_clicking=True)
pl.show()

# ----------------------------------------------------------------------
# Generated by sphinx-examples-as-code https://github.com/pyvista/sphinx-examples-as-code