pyvista.Plotter.enable_point_picking

Plotter.enable_point_picking(callback=None, tolerance=0.025, left_clicking=False, picker=PickerType.POINT, show_message=True, font_size=18, color='pink', point_size=10, show_point=True, use_picker=False, pickable_window=False, clear_on_no_selection=True, **kwargs)

カーソル下のポイントでのピッキングを有効にします．

マウスの右ボタンを使用して，レンダリングビュー内のマウス位置でポイントを選択できるようにします．この点はプロッタの .picked_point 属性に保存されます．そのポイントを引数として取るコールバックを渡します．選択した点は，最初に交差するメッシュ上の点か，3 Dウィンドウ内の点のいずれかです．

picker の選択は，ポイントピッキングがどのように行われるかを決定するのに役立ちます．

パラメータ:

callbackcallable(), optional

入力すると，ピックが行われた後にこのcallableが呼び出されます．ピックされた点は，このcallableの最初のパラメータとして入力されます．

tolerancefloat, tolerance: 0.025

ピック操作を実行するための公差を指定してください．許容値は，レンダリングウィンドウサイズの割合で指定します．レンダリングウィンドウのサイズは対角で測定されます．これは， picker の選択肢によっては有効です．

left_clickingbool, default: False

True の場合，マウスの左ボタンをクリックすることでポイントをピックすることができます．デフォルトはマウスの右ボタンを使用します．

pickerstr | PickerType, optional

VTKピッカークラスタイプの選択:

• 'hardware': vtkHardwarePicker を使用し、大きなジオメトリに対してより高いパフォーマンスを発揮します(デフォルト)．

• 'cell': vtkCellPicker を使用します．

• 'point': メッシュ表面の点にスナップする vtkPointPicker を使用します．

• 'volume': vtkVolumePicker を使用します．

show_messagebool | str, default: True

ポイント選択ツールの使用方法に関するメッセージを表示します．これが文字列の場合は，メッセージが表示されます．

font_sizeint, default: 18

メッセージのサイズを設定します．

colorColorLike, default: "pink"

選択されたメッシュを表示したときの色．

point_sizeint, default: 10

show_point が True の場合の選択されたポイントのサイズ．

show_pointbool, default: True

クリックした後のピックポイントを表示します．

use_pickerbool, default: False

True の場合，コールバックはピッカーも渡します．

pickable_windowbool, default: False

True でピッカーがサポートしている場合，3Dウィンドウ内のポイントがピック可能になります．

clear_on_no_selectionbool, default: True

ポイントが選択されていない場合，選択内容をクリアします．

**kwargsdict, optional

残りのキーワード引数はすべて，選択した点を対話的に表示する方法をコントロールするために使用されます．

例

カスタムメッセージでポイントを獲得できるようになりました．

>>> import pyvista as pv
>>> pl = pv.Plotter()
>>> _ = pl.add_mesh(pv.Sphere())
>>> _ = pl.add_mesh(pv.Cube(), pickable=False)
>>> pl.enable_point_picking(show_message='Pick a point')

このメソッドを使った例は， メッシュ上の点の選択 をご覧ください．