pyvista.plotting.widgets.WidgetHelper.add_mesh_slice

WidgetHelper.add_mesh_slice(

mesh,

normal='x',

generate_triangles: bool = False,

widget_color=None,

assign_to_axis=None,

tubing: bool = False,

origin_translation: bool = True,

outline_translation: bool = False,

implicit: bool = True,

normal_rotation: bool = True,

interaction_event: pyvista.InteractionEventType = 'end',

origin=None,

outline_opacity=None,

**kwargs,

)

プレインウィジェットを使用してメッシュをスライスします．

メッシュをインタラクティブにスライスするために使用する平面ウィジェットを使用して，メッシュをシーンに追加します．

スライスされたメッシュは，プロッタの .plane_sliced_meshes 属性に保存されます．

パラメータ:

mesh : pyvista.DataSet か vtk.vtkAlgorithmpyvista.DataSet か vtk.vtkAlgorithm

シーンに追加する入力データセットと，当該メッシュを生成するスライスやアルゴリズム．

normalstr or tuple(float), optional

平面の開始法線ベクトル．

generate_trianglesbool, optional

これが有効な場合(デフォルトで False )，出力は3角形になります．それ以外の場合，出力は交差ポリゴンになります．

widget_colorColorLike, optional

文字列，RGB配列，または16進数の色文字列のいずれかです． デフォルトは 'white' です．

assign_to_axispython:str または python:int, optional

平面の法線を指定された軸と平行になるように割り当てます．オプションは (0, 'x') ， (1, 'y') ，または (2, 'z') です．

tubingbool, optional

When using an implicit plane widget, this controls whether or not tubing is shown around the plane's boundaries.

origin_translationbool, optional

False の場合，プレーンウィジェットは原点によって移動できず，指定された原点に厳密に配置される．インプリシット平面を使用する場合にのみ有効です．

outline_translationbool, optional

False の場合，ボックスウィジェットは変換できず，与えられた境界に厳密に配置されます．

implicitbool, optional

True の場合は vtkImplicitPlaneWidget が使用され， False の場合は vtkPlaneWidget が使用されます．

normal_rotationbool, optional

法線ベクトル矢印の不透明度を0に設定して，実質的に無効にします．これにより，ユーザは法線を回転できなくなります． assign_to_axis が設定されている場合，これは強制的に False になります．

interaction_eventInteractionEventType, optional

コールバックのトリガーに使用するVTKインタラクションイベントです．文字列 'start', 'end', `` always'`` または vtk.vtkCommand.EventIds を受け付けます．

origintuple(float), optional

平面の中心の開始座標．

outline_opacitybool or float, optional

アウトラインの可視を設定します．インプリシット平面を使用している場合のみ有効．boolまたはfloatのどちらか．

Added in version 0.44.0.

**kwargsdict, optional

All additional keyword arguments are passed to pyvista.Plotter.add_mesh() to control how the mesh is displayed.

戻り値:

vtk.vtkActor

メッシュのVTKアクター．

例

スライス専用のインタラクティブな平面を表示します．

>>> import pyvista as pv
>>> from pyvista import examples
>>> pl = pv.Plotter()
>>> mesh = examples.load_channels()
>>> _ = pl.add_mesh(mesh.outline())
>>> _ = pl.add_mesh_slice(mesh, normal=[1, 0, 0.3])
>>> pl.show()

スタティックシーン

インタラクティブなシーン

完全な例は 平面ウィジェット を参照してください．