VTK：vtk.vtkSplineWidget()用法解释

vtkSplineWidget 是一个交互式的控件，主要用于在 VTK 中创建和编辑样条曲线。

一些重要属性及其用法：

Interactor：设置与 widget 互动的 vtkRenderWindowInteractor。

   splineWidget.SetInteractor(renderWindowInteractor)

Enabled：开启或关闭 widget 的功能。

   splineWidget.SetEnabled(1)  # 或使用 splineWidget.EnabledOn()
   splineWidget.SetEnabled(0)  # 或使用 splineWidget.EnabledOff()

Handle Size：设置曲线上控制点的大小。

   splineWidget.SetHandleSize(0.01)

Resolution：设置样条曲线的分辨率，即曲线的细分程度。

   splineWidget.SetResolution(20)

Number of Handles：设置样条曲线上控制柄的数量，可以用来定义曲线的复杂度。

   splineWidget.SetNumberOfHandles(4)

ProjectionNormal：设置投影的法线方向，可以是 X 轴、Y 轴或 Z 轴。

   splineWidget.SetProjectionNormalToXAxis()
   splineWidget.SetProjectionNormalToYAxis()
   splineWidget.SetProjectionNormalToZAxis()

ProjectionPosition：沿着法线方向设置投影的位置。

   splineWidget.SetProjectionPosition(0.5)

Projection：设置是否将控制点投影到某个轴平面上。

   splineWidget.ProjectToXPlaneOn()
   splineWidget.ProjectToYPlaneOn()
   splineWidget.ProjectToZPlaneOn()
   splineWidget.ProjectToPlaneOff()

ParametricSpline：获取或设置样条曲线的 vtkParametricSpline 对象，该对象定义了曲线的实际形状。

   parametricSpline = splineWidget.GetParametricSpline()

Closed：设置曲线是否闭合。

splineWidget.ClosedOn()
splineWidget.ClosedOff()

Visibility：控制 widget 可视性。

splineWidget.SetVisibility(1)
splineWidget.VisibilityOn()

示例用法：

这个示例展示了如何创建一个 vtkSplineWidget，并设置其一些属性，然后启动渲染流程。

import vtk

# 创建一个回调函数，当样条曲线改变时，打印控制点的位置
def SplineCallback(obj, event):
    spline = obj.GetParametricSpline()
    points = spline.GetPoints()
    for i in range(points.GetNumberOfPoints()):
        print(f"Point {i}: {points.GetPoint(i)}")

# 创建渲染器、渲染窗口和交互器
renderer = vtk.vtkRenderer()
renderWindow = vtk.vtkRenderWindow()
renderWindow.AddRenderer(renderer)
renderWindowInteractor = vtk.vtkRenderWindowInteractor()
renderWindowInteractor.SetRenderWindow(renderWindow)

# 创建 vtkSplineWidget
splineWidget = vtk.vtkSplineWidget()
splineWidget.SetInteractor(renderWindowInteractor)
splineWidget.SetNumberOfHandles(6)
splineWidget.SetResolution(50)
splineWidget.SetHandleSize(0.05)
splineWidget.SetProjectionNormalToYAxis()
splineWidget.SetProjectionPosition(0.5)
splineWidget.ClosedOn()

# 注册回调函数
splineWidget.AddObserver('EndInteractionEvent', SplineCallback)

# 激活 widget
splineWidget.On()

# 开始渲染流程
renderWindow.Render()
renderWindowInteractor.Initialize()
renderWindowInteractor.Start()

在这个例子中，创建了一个有6个控制点的样条曲线 widget，设置其分辨率为50（曲线将在控制点之间有更多细分点），并将其投影到 Y 轴。

当样条曲线的编辑操作结束时，会通过回调函数打印每个控制点的位置。

通过调用 renderWindowInteractor.Start() 开始了渲染和交互循环，用户可以拖动控制点来编辑曲线。