QQuickVTKItem::initializeVTK()中VTK对象的存储方法咨询

关于TestQQuickVTKItem_2示例是否完整 #

这个单元测试示例并非不完整，而是针对测试场景做了简化。单元测试中QQuickVTKItem的生命周期被严格管控，底层QSGNode不会在测试流程中意外销毁，所以未将VTK对象存入vtkUserData也能正常运行。但在实际项目中，这种写法存在严重风险：一旦QtQuick场景图因节点复用、组件隐藏等触发QSGNode销毁，未存入vtkUserData的VTK对象会被自动析构，直接导致VTK管线崩溃。

正确的QQuickVTKItem实现示例 #

以下是符合官方规范的完整实现思路，确保VTK对象生命周期安全：

1. 自定义VTK用户数据类 #

继承vtkObject创建自定义类，统一存储所有VTK管线对象：

#include <vtkObject.h>
#include <vtkSmartPointer.h>
#include <vtkConeSource.h>
#include <vtkPolyDataMapper.h>
#include <vtkActor.h>
#include <vtkRenderer.h>

class VTKUserData : public vtkObject
{
public:
  static VTKUserData* New();
  vtkTypeMacro(VTKUserData, vtkObject);

  vtkSmartPointer<vtkConeSource> ConeSource;
  vtkSmartPointer<vtkPolyDataMapper> Mapper;
  vtkSmartPointer<vtkActor> Actor;
  vtkSmartPointer<vtkRenderer> Renderer;
};

vtkStandardNewMacro(VTKUserData);

2. 重写initializeVTK()方法 #

在该方法中初始化VTK管线，并将所有对象存入自定义UserData后返回：

vtkSmartPointer<vtkObject> MyQQuickVTKItem::initializeVTK()
{
  auto userData = vtkSmartPointer<VTKUserData>::New();

  // 创建VTK管线对象
  userData->ConeSource = vtkSmartPointer<vtkConeSource>::New();
  userData->Mapper = vtkSmartPointer<vtkPolyDataMapper>::New();
  userData->Actor = vtkSmartPointer<vtkActor>::New();
  userData->Renderer = vtkSmartPointer<vtkRenderer>::New();

  // 构建渲染管线
  userData->Mapper->SetInputConnection(userData->ConeSource->GetOutputPort());
  userData->Actor->SetMapper(userData->Mapper);
  userData->Renderer->AddActor(userData->Actor);
  userData->Renderer->SetBackground(0.1, 0.2, 0.3);

  // 将Renderer添加到QQuickVTKItem的渲染器集合
  this->addRenderer(userData->Renderer);

  return userData;
}

3. 在syncVTK()中访问VTK对象 #

后续需要更新VTK对象时，通过userData()方法获取并转换类型：

void MyQQuickVTKItem::syncVTK()
{
  auto userData = VTKUserData::SafeDownCast(this->userData());
  if (!userData)
  {
    return;
  }
  // 示例：修改圆锥高度并更新管线
  userData->ConeSource->SetHeight(5.0);
  userData->ConeSource->Update();
}

你也可以直接用vtkSmartPointer<vtkCollection>作为userData存储所有VTK对象，但自定义UserData类的方式可读性和维护性更强。

内容的提问来源于stack exchange，提问作者Tomasso