实现类头文件

以下是对你提供的 ScaleBarController.h 头文件添加详细注释后的版本，帮助你更清晰地理解每个成员和方法的用途，尤其是在 VTK 中的作用：

---

#ifndef SCALEBARCONTROLLER_H
#define SCALEBARCONTROLLER_H#include <vtkSmartPointer.h>
#include <vtkRenderer.h>
#include <vtkRenderWindow.h>
#include <vtkTextActor.h>
#include <vtkLineSource.h>
#include <vtkPolyDataMapper2D.h>
#include <vtkActor2D.h>
#include <vtkRenderWindowInteractor.h>
#include <vtkCallbackCommand.h>// 管理并绘制屏幕固定像素长度的比例尺控制器
class ScaleBarController
{
public:// 构造函数，初始化渲染器、窗口和交互器ScaleBarController(vtkSmartPointer<vtkRenderer> renderer,vtkSmartPointer<vtkRenderWindow> renderWindow,vtkSmartPointer<vtkRenderWindowInteractor> interactor);// 更新比例尺显示内容（长度、位置、标签等）void UpdateScaleBar();// 当比例尺需要重新添加回 renderer 时调用（如清空或重建渲染场景后）void ReAddToRenderer();private:// 交互事件的静态回调函数，用于处理缩放限制、比例尺更新等逻辑static void OnInteractionEvent(vtkObject *caller, unsigned long eid,void *clientdata, void *calldata);// 创建比例尺的 VTK 对象，包括线段和文字void CreateScaleBarActors();// 获取当前屏幕下 1 像素对应多少 world 单位（单位：world units / pixel）double GetCurrentScaleFactor();// 根据传入的真实比例长度，计算美观的跳变长度（如：0.5 → 1 → 5 → 10...）double ComputeRoundedLength(double length);// -------------------------// VTK 渲染相关对象// -------------------------vtkSmartPointer<vtkRenderer> renderer_;               // 场景渲染器vtkSmartPointer<vtkRenderWindow> renderWindow_;       // 渲染窗口vtkSmartPointer<vtkRenderWindowInteractor> interactor_; // 用户交互器// -------------------------// 比例尺的绘制元素// -------------------------vtkSmartPointer<vtkLineSource> lineSource_;           // 比例尺的线段vtkSmartPointer<vtkPolyDataMapper2D> lineMapper_;     // 2D 映射器vtkSmartPointer<vtkActor2D> lineActor_;               // 2D 绘制 actorvtkSmartPointer<vtkTextActor> scaleText_;             // 比例尺文字标签（显示数值）vtkSmartPointer<vtkCallbackCommand> interactionCallback_; // 鼠标缩放事件监听回调// -------------------------// 状态控制参数// -------------------------const int pixelLength_ = 200; // 比例尺在屏幕上固定显示的像素长度（单位 px）double lastValidParallelScale_ = 1.0;  // 上一次合法 Parallel 投影的相机缩放值double lastValidCameraDistance_ = 1.0; // 上一次合法 Perspective 投影的相机距离
};#endif // SCALEBARCONTROLLER_H

---

实现类源文件

以下是你提供的 ScaleBarController.cpp 文件的完整代码分析版，我已逐行添加关键注释，帮助你清晰理解每段逻辑的作用，特别是与 VTK 比例尺渲染、缩放监听、状态回退控制 相关的部分：

---

#include "ScaleBarController.h"
#include <vtkTextProperty.h>
#include <vtkCoordinate.h>
#include <vtkCamera.h>
#include <sstream>
#include <iomanip>