|
|
#ifndef NMVTKORIENTATIONMARKERCONTROLLER_H
|
|
|
#define NMVTKORIENTATIONMARKERCONTROLLER_H
|
|
|
|
|
|
#include "nmRender_global.h"
|
|
|
|
|
|
#include <vtkSmartPointer.h>
|
|
|
|
|
|
class vtkAxesActor;
|
|
|
class vtkOrientationMarkerWidget;
|
|
|
class vtkRenderer;
|
|
|
class vtkRenderWindowInteractor;
|
|
|
|
|
|
/**
|
|
|
* @brief 管理单个渲染容器左下角的通用空间方向轴。
|
|
|
*
|
|
|
* 控制器独占 AxesActor 和 OrientationMarkerWidget，不进入业务 Scene，
|
|
|
* 也不主动触发 Render。所有接口必须在 Qt GUI 线程调用。
|
|
|
*/
|
|
|
class NM_RENDER_EXPORT nmVTKOrientationMarkerController
|
|
|
{
|
|
|
public:
|
|
|
/** @brief 创建默认开启、默认不可用的方向轴控制器。 */
|
|
|
nmVTKOrientationMarkerController();
|
|
|
/** @brief 先禁用并解除所有 VTK 关联，再释放内部对象。 */
|
|
|
~nmVTKOrientationMarkerController();
|
|
|
|
|
|
/**
|
|
|
* @brief 将方向轴绑定到同一 RenderWindow 的 Interactor 和主 Renderer。
|
|
|
*
|
|
|
* 重新绑定前会完整解除旧关系。绑定成功但视图尚未 Ready 时返回 true，
|
|
|
* 此时 Marker 仍保持禁用；绑定失败不修改长期显示偏好。
|
|
|
*/
|
|
|
bool bindInteractor(vtkRenderWindowInteractor* pInteractor,
|
|
|
vtkRenderer* pRenderer);
|
|
|
/** @brief 禁用 Marker，并解除 Actor、Renderer 和 Interactor 的引用关系。 */
|
|
|
void unbindInteractor();
|
|
|
|
|
|
/** @brief 修改长期显示偏好；空、错误和加载状态不会覆盖该偏好。 */
|
|
|
void setVisible(bool bVisible);
|
|
|
/** @brief 返回长期显示偏好，不代表 Marker 当前一定处于 Enabled 状态。 */
|
|
|
bool isVisible() const;
|
|
|
|
|
|
/** @brief 设置当前视图是否处于可显示方向轴的 Ready 状态。 */
|
|
|
void setViewAvailable(bool bAvailable);
|
|
|
/** @brief 返回当前视图可用状态。 */
|
|
|
bool isViewAvailable() const;
|
|
|
|
|
|
/**
|
|
|
* @brief 设置归一化视口；只接受有限且位于 [0, 1] 的有效矩形。
|
|
|
* @return 参数有效并写入内部 Widget 时返回 true。
|
|
|
*/
|
|
|
bool setViewport(double dXMinimum,
|
|
|
double dYMinimum,
|
|
|
double dXMaximum,
|
|
|
double dYMaximum);
|
|
|
|
|
|
private:
|
|
|
Q_DISABLE_COPY(nmVTKOrientationMarkerController)
|
|
|
|
|
|
/** @brief 按绑定、显示偏好和 Ready 状态统一更新 Marker 的 Enabled 状态。 */
|
|
|
void updateEnabledState();
|
|
|
|
|
|
// 智能指针独占 VTK 对象；MarkerWidget 启用期间还会持有相关 VTK 引用。
|
|
|
vtkSmartPointer<vtkAxesActor> m_pAxesActor;
|
|
|
vtkSmartPointer<vtkOrientationMarkerWidget> m_pMarkerWidget;
|
|
|
|
|
|
// 以下为非所有权访问指针，解绑时必须在释放外部对象前清空。
|
|
|
vtkRenderWindowInteractor* m_pInteractor;
|
|
|
vtkRenderer* m_pRenderer;
|
|
|
|
|
|
bool m_bVisible; ///< 用户长期显示偏好，默认开启。
|
|
|
bool m_bViewAvailable; ///< 当前容器是否处于 Ready 状态。
|
|
|
double m_dViewport[4]; ///< 归一化方向轴视口。
|
|
|
};
|
|
|
|
|
|
#endif // NMVTKORIENTATIONMARKERCONTROLLER_H
|