|
|
#ifndef NMVTKSCALARBARLAYER_H
|
|
|
#define NMVTKSCALARBARLAYER_H
|
|
|
|
|
|
#include "nmVTKRenderLayer.h"
|
|
|
|
|
|
#include <vtkSmartPointer.h>
|
|
|
|
|
|
class vtkActor2D;
|
|
|
class vtkLookupTable;
|
|
|
class vtkPoints;
|
|
|
class vtkPropAssembly;
|
|
|
class vtkScalarBarActor;
|
|
|
class vtkTextActor;
|
|
|
|
|
|
/**
|
|
|
* @brief 通用色标图层。
|
|
|
*
|
|
|
* 色标只展示外部 LookupTable，不解析单位，也不自行计算数据范围。
|
|
|
*/
|
|
|
class NM_RENDER_EXPORT nmVTKScalarBarLayer : public nmVTKRenderLayer
|
|
|
{
|
|
|
public:
|
|
|
/** @brief 创建空色标，并将色标及独立二维装饰加入稳定根 Assembly。 */
|
|
|
explicit nmVTKScalarBarLayer(const QString& sLayerId);
|
|
|
/** @brief 先解除 Renderer，再释放外部颜色表的共享引用。 */
|
|
|
virtual ~nmVTKScalarBarLayer();
|
|
|
|
|
|
/** @brief 共享外部 LookupTable 的 VTK 引用。 */
|
|
|
void setLookupTable(vtkLookupTable* pLookupTable);
|
|
|
/** @brief 返回当前共享颜色表的非所有权指针。 */
|
|
|
vtkLookupTable* getLookupTable() const;
|
|
|
|
|
|
/** @brief 使用 UTF-8 设置色标标题，不解释标题中的业务含义。 */
|
|
|
void setTitle(const QString& sTitle);
|
|
|
/** @brief 返回调用方设置的标题。 */
|
|
|
QString getTitle() const;
|
|
|
|
|
|
/** @brief 设置普通刻度格式，例如 %.6g；空格式返回 false。 */
|
|
|
bool setLabelFormat(const QString& sFormat);
|
|
|
/** @brief 返回调用方最后设置的普通刻度格式。 */
|
|
|
QString getLabelFormat() const;
|
|
|
/** @brief 设置 0～64 个普通刻度；常量色标使用 0。 */
|
|
|
bool setNumberOfLabels(int nLabelCount);
|
|
|
/** @brief 返回当前普通刻度数量。 */
|
|
|
int getNumberOfLabels() const;
|
|
|
/**
|
|
|
* @brief 按 QVTK 视口像素尺寸更新固定宽度的响应式二维布局。
|
|
|
* @note 只修改 Actor 布局，不主动 Render，也不修改 LookupTable。
|
|
|
*/
|
|
|
bool setViewportSize(int nWidth, int nHeight);
|
|
|
/** @brief 返回当前视口和色带高度建议使用的普通刻度数量。 */
|
|
|
int getResponsiveLabelCount() const;
|
|
|
|
|
|
/** @brief 配置低于显示范围的独立二维色块和说明文字。 */
|
|
|
void setBelowRangeSwatch(bool bVisible, const QString& sText);
|
|
|
/** @brief 配置高于显示范围的独立二维色块和说明文字。 */
|
|
|
void setAboveRangeSwatch(bool bVisible, const QString& sText);
|
|
|
|
|
|
/**
|
|
|
* @brief 显示或隐藏常量属性的唯一业务值。
|
|
|
*
|
|
|
* 该文字由独立 vtkTextActor 绘制，不启用共享 LUT 的 IndexedLookup，
|
|
|
* 因而不会改变网格使用的连续颜色映射语义。
|
|
|
*/
|
|
|
void setConstantValueLabel(bool bVisible, const QString& sText);
|
|
|
|
|
|
/** @brief 设置归一化视口坐标中的左下角位置。 */
|
|
|
bool setPosition(double dX, double dY);
|
|
|
/** @brief 设置归一化视口坐标中的宽度和高度。 */
|
|
|
bool setSize(double dWidth, double dHeight);
|
|
|
|
|
|
/** @brief 返回图层持有的 vtkScalarBarActor 非所有权指针。 */
|
|
|
vtkScalarBarActor* getActor() const;
|
|
|
|
|
|
private:
|
|
|
Q_DISABLE_COPY(nmVTKScalarBarLayer)
|
|
|
|
|
|
/** @brief 根据当前色标位置和尺寸同步全部独立二维装饰的位置。 */
|
|
|
void updateOverlayLayout();
|
|
|
/** @brief 从活动 LookupTable 同步上下越界色块的实际颜色。 */
|
|
|
void updateRangeSwatchColors();
|
|
|
|
|
|
vtkSmartPointer<vtkLookupTable> m_pLookupTable; ///< 共享外部颜色表引用。
|
|
|
vtkSmartPointer<vtkPropAssembly> m_pRootAssembly; ///< Scene 挂载的稳定根 Prop。
|
|
|
vtkSmartPointer<vtkScalarBarActor> m_pActor; ///< 图层独占的二维色标 Actor。
|
|
|
vtkSmartPointer<vtkTextActor> m_pTitleActor; ///< 独立左对齐 ASCII 标题。
|
|
|
vtkSmartPointer<vtkTextActor> m_pConstantValueActor; ///< 常量属性唯一值文字。
|
|
|
vtkSmartPointer<vtkPoints> m_pBelowRangeSwatchPoints; ///< 下越界色块四角坐标。
|
|
|
vtkSmartPointer<vtkActor2D> m_pBelowRangeSwatchActor; ///< 下越界独立色块。
|
|
|
vtkSmartPointer<vtkTextActor> m_pBelowRangeTextActor; ///< 下越界说明文字。
|
|
|
vtkSmartPointer<vtkPoints> m_pAboveRangeSwatchPoints; ///< 上越界色块四角坐标。
|
|
|
vtkSmartPointer<vtkActor2D> m_pAboveRangeSwatchActor; ///< 上越界独立色块。
|
|
|
vtkSmartPointer<vtkTextActor> m_pAboveRangeTextActor; ///< 上越界说明文字。
|
|
|
QString m_sTitle; ///< 保留无损 Qt 标题，避免从 VTK 窄字符串反向解析。
|
|
|
QString m_sLabelFormat; ///< 普通刻度的 printf 风格格式字符串。
|
|
|
QString m_sConstantValueText; ///< 保留常量值文字，避免从 VTK 反向解析。
|
|
|
QString m_sBelowRangeText; ///< 下越界说明文字状态。
|
|
|
QString m_sAboveRangeText; ///< 上越界说明文字状态。
|
|
|
double m_dPositionX; ///< 色标左下角的归一化视口 X 坐标。
|
|
|
double m_dPositionY; ///< 色标左下角的归一化视口 Y 坐标。
|
|
|
double m_dWidth; ///< 色标在归一化视口中的宽度。
|
|
|
double m_dHeight; ///< 色标在归一化视口中的高度。
|
|
|
int m_nViewportWidth; ///< 最近一次有效 QVTK 视口像素宽度。
|
|
|
int m_nViewportHeight; ///< 最近一次有效 QVTK 视口像素高度。
|
|
|
};
|
|
|
|
|
|
#endif // NMVTKSCALARBARLAYER_H
|