pyvista.Plotter.enable_block_picking

Plotter.enable_block_picking(callback=None, side='left')

コンポジットブロックピッキングを有効にします．

このピッカーは， pyvista.MultiBlock のような複合データセットを使用する場合に，データセットのインデックスを返し，コールバックに渡すために使用します．

パラメータ:

callbackcallable(), optional

入力されると，このピッカーは選択が行われた後，この callable を呼び出します．複合インデックスが第一引数として callback に，データセットが第二引数として渡されます．

sidestr, default: "left"

追跡するマウスボタン ( 'left' または 'right' )． 'r' または 'l' も指定可能です．

備考

ピックしたブロックのインデックスは picked_block_index 属性からアクセスすることができます．

例

マルチブロックデータセットでブロックピッキングを有効にします．左クリックでブロックが青くなり，右クリックでブロックがデフォルトの色に戻ります．

>>> import pyvista as pv
>>> multiblock = pv.MultiBlock(
...     [pv.Cube(), pv.Sphere(center=(0, 0, 1))]
... )
>>> pl = pv.Plotter()
>>> actor, mapper = pl.add_composite(multiblock)
>>> def turn_blue(index, dataset):
...     mapper.block_attr[index].color = 'blue'
...
>>> pl.enable_block_picking(callback=turn_blue, side='left')
>>> def clear_color(index, dataset):
...     mapper.block_attr[index].color = None
...
>>> pl.enable_block_picking(callback=clear_color, side='right')
>>> pl.show()