当前位置：首页 > news >正文

VTK开发笔记（八）：示例Cone5，交互器的实现方式，在Qt窗口中详解复现对应的Demo

news 2025/10/31 12:06:35

若该文为原创文章，转载请注明出处
本文章博客地址：https://hpzwl.blog.csdn.net/article/details/154077570

长沙红胖子Qt（长沙创微智科）博文大全：开发技术集合（包含Qt实用技术、树莓派、三维、OpenCV、OpenGL、ffmpeg、OSG、单片机、软硬结合等等）持续更新中…

OSG、VTK、OSGEARTH三维开发专栏（点击传送门）

上一篇：《VTK开发笔记（七）：示例Cone4，一数据源多演员模式，在Qt窗口中详解复现对应的Demo》
下一篇：敬请期待…

前言

本篇详细解析Cone5.exe，了解预定义的交互器操作。

Demo

在这里插入图片描述

交互器

概述

VTK（Visualization Toolkit）中的交互器（Interactor）是连接用户操作与可视化场景的核心组件，它负责处理鼠标、键盘等输入事件，并将这些事件转化为对场景中对象的操作（如旋转、缩放、平移等）。
在 VTK 中，交互器的核心作用是事件监听与响应，它连接了用户输入设备（鼠标、键盘）和可视化场景（如vtkRenderer渲染的图像）。其核心组成包括：

交互器对象（如vtkRenderWindowInteractor）：负责监听输入事件（如鼠标点击、移动、滚轮，键盘按键）。
交互样式（vtkInteractorStyle及其子类）：定义事件的响应逻辑（如鼠标左键拖动是旋转还是平移）。
渲染窗口（vtkRenderWindow）：交互器需要绑定到渲染窗口，以获取渲染的图像并处理用户输入。

工作流程

初始化交互器：将交互器绑定到渲染窗口（SetRenderWindow()），并设置交互样式（SetInteractorStyle()）。
启动事件循环：通过Start()方法启动交互器的事件循环，开始监听用户输入。
事件触发与处理：
用户操作（如鼠标拖动）被交互器捕获，转化为特定事件（如LeftButtonPressEvent、MouseMoveEvent）。
交互样式（vtkInteractorStyle）中定义的对应事件处理函数被调用（如OnLeftButtonDown()）。
处理函数更新场景状态（如旋转相机vtkCamera的角度），并触发渲染窗口重绘（Render()）。
场景更新：渲染窗口根据新的状态重新绘制图像，用户看到交互后的效果。

常用交互器与交互样式

查看VTKMananger.h的枚举定义说明：

/** 预定义的交互器类型*     操作对象（摄像机 vs 演员）；交互连续性（平滑 Trackball vs 步进 Joystick）；场景类型（图像、地形、通用 3D 等）。*     实际使用时，可根据具体场景选择合适的样式，或基于 vtkInteractorStyleUser 扩展自定义交互逻辑。 */
enum INTERACTOR_STYLE {// 基础交互器样式INTERACTOR_STYLE_TRACKBALL_CAMERA = 0x00,   //  摄像机       鼠标左键旋转、中键平移、右键 / 滚轮缩放，交互平滑连续（类似 “轨迹球” 效果），通用 3D 场景浏览，操作摄像机以改变观察视角。INTERACTOR_STYLE_TRACKBALL_ACTOR,           //  选中的演员    先点击选中演员，再通过鼠标左键旋转、中键平移、右键缩放该演员。仅修改单个对象的姿态，不改变摄像机位置。// 遥感式交互器样式INTERACTOR_STYLE_JOYSTICK_CAMERA,           //  摄像机       类似TrackballCamera，但交互是 “步进式”（拖动鼠标后松开才执行操作），而非连续平滑，需要精确控制交互幅度的场景。INTERACTOR_STYLE_JOYSTICK_ACTOR,            //  选中的演员    步进式操作单个演员，与 JoystickCamera 逻辑类似，但针对演员而非摄像机。// 图像与切片交互器样式INTERACTOR_STYLE_IMAGE,                     //  专为 2D/3D 图像（如 CT、MRI 切片）设计。交互方式：左键平移图像、右键缩放、键盘 / 下键切换切片层，默认禁用摄像机旋转（保持正交视角）。扩展功能：支持图像窗宽窗位调整（通过键盘或鼠标）。// 选择与区域操作样式INTERACTOR_STYLE_RUBBER_BAND_ZOOM,          //  核心功能：支持 “框选缩放”—— 拖动鼠标绘制矩形区域，场景自动缩放至该区域。适用场景：快速聚焦到局部区域（如病灶、细节）。INTERACTOR_STYLE_RUBBER_BAND_PICK,          //  支持框选区域内的对象（如演员、点集），配合拾取器（Picker）使用。INTERACTOR_STYLE_DRAW_POLYGON,              //  支持用鼠标绘制多边形区域，用于复杂区域的选择或裁剪。// 特殊场景与特殊场景样式INTERACTOR_STYLE_TERRAIN,                   //  专为地形数据（如高程图、地形模型）设计。交互方式：模拟 “在地形上行走”，支持前后移动、左右转向，避免摄像机穿入地形。INTERACTOR_STYLE_FLIGHT,                    //  模拟 “飞行” 视角，通过鼠标控制飞行方向和速度，适合大规模场景（如城市、地形）浏览。INTERACTOR_STYLE_UNICAM,                    //  基于 “单摄像机” 模型，优化了 3D 交互的直观性，减少操作歧义。// 扩展与集成样式INTERACTOR_STYLE_USER,                      //  用于自定义交互逻辑的基类，可通过重写事件回调函数实现个性化操作。INTERACTOR_STYLE_SWITCH,                    //  支持动态切换多种交互器样式（如在 Trackball 和 Image 样式间切换）。
};

事件与自定义交互

VTK允许通过自定义交互样式或绑定回调函数，实现个性化的事件响应逻辑。

常用的事件类型

交互器支持的事件可分为鼠标事件、键盘事件、窗口事件等，例如：

鼠标事件：LeftButtonPressEvent（左键按下）、MouseMoveEvent（鼠标移动）、MouseWheelForwardEvent（滚轮向前）。
键盘事件：KeyPressEvent（按键按下）、KeyReleaseEvent（按键释放）。
窗口事件：ConfigureEvent（窗口大小改变）、ExitEvent（退出事件循环）。

自定义交互的两种方式

继承vtkInteractorStyle并重写事件处理函数通过子类化交互样式，重写特定事件的处理方法（如OnLeftButtonDown、OnKeyPress），实现自定义逻辑。
自定义鼠标左键点击时输出坐标。
通过观察者模式绑定回调函数
使用AddObserver(eventName, callback)直接为交互器或交互样式绑定事件回调，无需子类化。

交互器与camera/actor 的联动

交互的本质是通过事件处理函数修改场景中的对象状态，最常见的是操作相机（改变视角）或 actor（改变位置 / 姿态）：

操作相机：通过vtkCamera的Azimuth()（水平旋转）、Elevation()（垂直旋转）、Dolly()（缩放）等方法实现。
操作actor：通过vtkActor的SetPosition()、SetOrientation()等方法修改位置或旋转角度
VTK交互器是用户与可视化场景交互的桥梁，其核心是交互器对象（监听事件）与交互样式（处理事件）的配合。通过预定义的交互样式可快速实现旋转、缩放等基础操作，而自定义交互则能满足复杂场景需求（如医学图像测量、特定对象选择等）。

高级交互功能

拾取

通过交互事件获取场景中被点击的对象（Actor、Cell、Point等），常用类：vtkCellPicker、vtkPointPicker。

vtkSmartPointer<vtkCellPicker> pCellPicker = vtkSmartPointer<vtkCellPicker>::New();
// 将拾取器与交互器关联
pRenderWindowInteractor->SetPicker(pCellPicker);

在事件响应中获取拾取结果

// 获取鼠标位置
int* pos = pRenderWindowInteractor->GetEventPosition();
// 执行拾取
picker->Pick(pos[0], pos[1], 0, renderer); 
// 获取被拾取的Actor
vtkActor* pActor = picker->GetActor();

手势交互

VTK 支持触屏设备的手势事件（如捏合缩放、旋转），需使用vtkInteractorStyleMultiTouchCamera等样式。

Demo源码

VTKWidget.cpp

void VTKWidget::test_demo7_createCone(VTKManager::INTERACTOR_STYLE interactorStyle)
{// 步骤一：创建圆锥体数据源vtkSmartPointer<vtkConeSource> pConeSource =VTKManager::createConeSource(0, 0, 0, 8, 30, 100);// 步骤二：创建多边形映射器vtkSmartPointer<vtkPolyDataMapper> pPolyDataMapper =VTKManager::createPolyDataMapper(pConeSource->GetOutputPort());// 步骤三：创建演员vtkSmartPointer<vtkActor> pActor =VTKManager::createActor(pPolyDataMapper, 1.0, 0.3882, 0.2784, 1.0);// 步骤四：创建渲染器vtkSmartPointer<vtkRenderer> pRenderer =VTKManager::createRenderer(pActor, 0.1, 0.2, 0.4);// 步骤五：渲染器添加到QVTKWidget渲染_pQVTKWidget->GetRenderWindow()->AddRenderer(pRenderer);// 步骤六：设置交互器vtkSmartPointer<vtkRenderWindowInteractor> pRenderWindowInteractor =VTKManager::createRenderWindowInteractor(_pQVTKWidget->GetRenderWindow(), interactorStyle);
}

VTKManager.h

public:/** 预定义的交互器类型*     操作对象（摄像机 vs 演员）；交互连续性（平滑 Trackball vs 步进 Joystick）；场景类型（图像、地形、通用 3D 等）。*     实际使用时，可根据具体场景选择合适的样式，或基于 vtkInteractorStyleUser 扩展自定义交互逻辑。 */enum INTERACTOR_STYLE {// 基础交互器样式INTERACTOR_STYLE_TRACKBALL_CAMERA = 0x00,   //  摄像机       鼠标左键旋转、中键平移、右键 / 滚轮缩放，交互平滑连续（类似 “轨迹球” 效果），通用 3D 场景浏览，操作摄像机以改变观察视角。INTERACTOR_STYLE_TRACKBALL_ACTOR,           //  选中的演员    先点击选中演员，再通过鼠标左键旋转、中键平移、右键缩放该演员。仅修改单个对象的姿态，不改变摄像机位置。// 遥感式交互器样式INTERACTOR_STYLE_JOYSTICK_CAMERA,           //  摄像机       类似TrackballCamera，但交互是 “步进式”（拖动鼠标后松开才执行操作），而非连续平滑，需要精确控制交互幅度的场景。INTERACTOR_STYLE_JOYSTICK_ACTOR,            //  选中的演员    步进式操作单个演员，与 JoystickCamera 逻辑类似，但针对演员而非摄像机。// 图像与切片交互器样式INTERACTOR_STYLE_IMAGE,                     //  专为 2D/3D 图像（如 CT、MRI 切片）设计。交互方式：左键平移图像、右键缩放、键盘 / 下键切换切片层，默认禁用摄像机旋转（保持正交视角）。扩展功能：支持图像窗宽窗位调整（通过键盘或鼠标）。// 选择与区域操作样式INTERACTOR_STYLE_RUBBER_BAND_ZOOM,          //  核心功能：支持 “框选缩放”—— 拖动鼠标绘制矩形区域，场景自动缩放至该区域。适用场景：快速聚焦到局部区域（如病灶、细节）。INTERACTOR_STYLE_RUBBER_BAND_PICK,          //  支持框选区域内的对象（如演员、点集），配合拾取器（Picker）使用。INTERACTOR_STYLE_DRAW_POLYGON,              //  支持用鼠标绘制多边形区域，用于复杂区域的选择或裁剪。// 特殊场景与特殊场景样式INTERACTOR_STYLE_TERRAIN,                   //  专为地形数据（如高程图、地形模型）设计。交互方式：模拟 “在地形上行走”，支持前后移动、左右转向，避免摄像机穿入地形。INTERACTOR_STYLE_FLIGHT,                    //  模拟 “飞行” 视角，通过鼠标控制飞行方向和速度，适合大规模场景（如城市、地形）浏览。INTERACTOR_STYLE_UNICAM,                    //  基于 “单摄像机” 模型，优化了 3D 交互的直观性，减少操作歧义。// 扩展与集成样式INTERACTOR_STYLE_USER,                      //  用于自定义交互逻辑的基类，可通过重写事件回调函数实现个性化操作。INTERACTOR_STYLE_SWITCH,                    //  支持动态切换多种交互器样式（如在 Trackball 和 Image 样式间切换）。};

VTKManager.cpp

vtkSmartPointer<vtkRenderWindowInteractor> VTKManager::createRenderWindowInteractor(vtkRenderWindow *pRenderWindow, VTKManager::INTERACTOR_STYLE interactorStyle)
{// 步骤一：智能指针定义vtkSmartPointer<vtkRenderWindowInteractor> pRenderWindowInteractor;// 步骤二：智能指针实例化pRenderWindowInteractor = vtkSmartPointer<vtkRenderWindowInteractor>::New();// 步骤三：智能指针定义vtkSmartPointer<vtkInteractorObserver> pInteractorObserver;// 步骤四：智能指针实例化switch (interactorStyle){// 基础交互器样式case INTERACTOR_STYLE_TRACKBALL_CAMERA: //  摄像机       鼠标左键旋转、中键平移、右键 / 滚轮缩放，交互平滑连续（类似 “轨迹球” 效果），通用 3D 场景浏览，操作摄像机以改变观察视角。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleTrackballCamera>::New();break;case INTERACTOR_STYLE_TRACKBALL_ACTOR:  //  选中的演员    先点击选中演员，再通过鼠标左键旋转、中键平移、右键缩放该演员。仅修改单个对象的姿态，不改变摄像机位置。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleTrackballActor>::New();break;// 遥感式交互器样式case INTERACTOR_STYLE_JOYSTICK_CAMERA:  //  摄像机       类似TrackballCamera，但交互是 “步进式”（拖动鼠标后松开才执行操作），而非连续平滑，需要精确控制交互幅度的场景。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleJoystickCamera>::New();break;case INTERACTOR_STYLE_JOYSTICK_ACTOR:   //  选中的演员    步进式操作单个演员，与 JoystickCamera 逻辑类似，但针对演员而非摄像机。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleJoystickActor>::New();break;// 图像与切片交互器样式case INTERACTOR_STYLE_IMAGE:            //  专为 2D/3D 图像（如 CT、MRI 切片）设计。交互方式：左键平移图像、右键缩放、键盘 / 下键切换切片层，默认禁用摄像机旋转（保持正交视角）。扩展功能：支持图像窗宽窗位调整（通过键盘或鼠标）。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleImage>::New();break;// 选择与区域操作样式case INTERACTOR_STYLE_RUBBER_BAND_ZOOM: //  核心功能：支持 “框选缩放”—— 拖动鼠标绘制矩形区域，场景自动缩放至该区域。适用场景：快速聚焦到局部区域（如病灶、细节）。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleRubberBandZoom>::New();break;case INTERACTOR_STYLE_RUBBER_BAND_PICK: //  支持框选区域内的对象（如演员、点集），配合拾取器（Picker）使用。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleRubberBandPick>::New();break;case INTERACTOR_STYLE_DRAW_POLYGON:     //  支持用鼠标绘制多边形区域，用于复杂区域的选择或裁剪。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleDrawPolygon>::New();break;// 特殊场景与特殊场景样式case INTERACTOR_STYLE_TERRAIN:          //  专为地形数据（如高程图、地形模型）设计。交互方式：模拟 “在地形上行走”，支持前后移动、左右转向，避免摄像机穿入地形。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleTerrain>::New();break;case INTERACTOR_STYLE_FLIGHT:           //  模拟 “飞行” 视角，通过鼠标控制飞行方向和速度，适合大规模场景（如城市、地形）浏览。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleFlight>::New();break;case INTERACTOR_STYLE_UNICAM:           //  基于 “单摄像机” 模型，优化了 3D 交互的直观性，减少操作歧义。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleUnicam>::New();break;// 扩展与集成样式case INTERACTOR_STYLE_USER:              //  用于自定义交互逻辑的基类，可通过重写事件回调函数实现个性化操作。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleUser>::New();break;case INTERACTOR_STYLE_SWITCH:           //  支持动态切换多种交互器样式（如在 Trackball 和 Image 样式间切换）。pInteractorObserver = vtkSmartPointer<vtkInteractorStyleSwitch>::New();break;default:break;}// 步骤五：设置交换器pRenderWindowInteractor->SetInteractorStyle(pInteractorObserver);// 步骤六：设置处理的渲染窗口pRenderWindowInteractor->SetRenderWindow(pRenderWindow);// 步骤七：初始化pRenderWindowInteractor->Initialize();// 步骤八：开始pRenderWindowInteractor->Start();return pRenderWindowInteractor;
}