Python使用VTK系列之添加文本注釋

在三維渲染中給出文字資訊說明或提示是非常常見和重要的功能。以下是一些常見的做法：

1. 将文字标簽添加到3D對象上：可以在三維場景中的特定位置添加文字标簽，并将其與所描述的對象相關聯。例如，在一個醫學可視化應用中，你可以在CT掃描資料中的惡性良性腫瘤區域附近添加一個文字标簽來說明該區域的資訊。
2. 展示标注或注釋：可以使用箭頭、線段等幾何形狀将注釋或标注連接配接到感興趣的區域。通過在注釋中提供文字解釋，可以幫助使用者了解特定區域的含義。
3. 在螢幕上建立固定位置的文字資訊：除了将文字直接與3D對象相關聯外，還可以在螢幕上的固定位置顯示文字資訊。這種方法常用于提供整體的場景說明、操作指南或互動提示。
4. 動态更新文字内容：在某些情況下，需要根據使用者的互動或資料改變動态更新文字内容。例如，在資料可視化中，可能需要随着時間的推移更新關于特定資料點的資訊。

要在VTK中添加文字，可以使用vtkTextActor、vtkCaptionActor2D，下面是使用這三種方式添加文字的示例代碼：

1. 使用vtkTextActor添加文字：

import vtk

# 建立一個vtkRenderer和vtkRenderWindow
renderer = vtk.vtkRenderer()
render_window = vtk.vtkRenderWindow()
render_window.AddRenderer(renderer)

# 建立一個vtkRenderWindowInteractor
interactor = vtk.vtkRenderWindowInteractor()
interactor.SetRenderWindow(render_window)

# 建立一個vtkTextActor，并設定文字内容和屬性
text_actor = vtk.vtkTextActor()
text_actor.SetInput("Hello, VTK!")
text_actor.GetTextProperty().SetColor(1.0, 0.0, 0.0)  # 設定文字顔色為紅色
text_actor.GetTextProperty().SetFontSize(24)  # 設定文字字型大小

# 将vtkTextActor添加到vtkRenderer中
renderer.AddActor2D(text_actor)

# 建立一個vtkCubeSource作為場景中的物體
cube_source = vtk.vtkCubeSource()
cube_mapper = vtk.vtkPolyDataMapper()
cube_mapper.SetInputConnection(cube_source.GetOutputPort())
cube_actor = vtk.vtkActor()
cube_actor.SetMapper(cube_mapper)

# 将物體添加到vtkRenderer中
renderer.AddActor(cube_actor)

# 設定渲染視窗、互動器并啟動渲染
render_window.SetSize(800, 600)
interactor.Initialize()
render_window.Render()
interactor.Start()           

2. 使用vtkCaptionActor2D添加文字：

iimport vtk

# 建立一個vtkRenderer和vtkRenderWindow
renderer = vtk.vtkRenderer()
render_window = vtk.vtkRenderWindow()
render_window.AddRenderer(renderer)

# 建立一個vtkRenderWindowInteractor
interactor = vtk.vtkRenderWindowInteractor()
interactor.SetRenderWindow(render_window)

# 建立一個vtkCaptionActor2D，并設定标注内容和屬性
caption_actor = vtk.vtkCaptionActor2D()
caption_actor.SetCaption("This is a caption")
caption_actor.SetAttachmentPoint(1.0, 1.0, 1.0)  # 設定标注的位置
caption_actor.GetCaptionTextProperty().SetColor(1.0, 0.0, 0.0)  # 設定文字顔色為紅色
caption_actor.GetCaptionTextProperty().SetFontSize(24)  # 設定文字字型大小

# 将vtkCaptionActor2D添加到vtkRenderer中
renderer.AddActor2D(caption_actor)

# 建立一個vtkCubeSource作為場景中的物體
cube_source = vtk.vtkCubeSource()
cube_mapper = vtk.vtkPolyDataMapper()
cube_mapper.SetInputConnection(cube_source.GetOutputPort())
cube_actor = vtk.vtkActor()
cube_actor.SetMapper(cube_mapper)

# 将物體添加到vtkRenderer中
renderer.AddActor(cube_actor)

# 設定渲染視窗、互動器并啟動渲染
render_window.SetSize(800, 600)
interactor.Initialize()
render_window.Render()
interactor.Start()