|
|
#ifndef NMVOLUMEDATA_H
|
|
|
#define NMVOLUMEDATA_H
|
|
|
|
|
|
#include "nmData_global.h"
|
|
|
#include <QSharedPointer>
|
|
|
#include <QStringList>
|
|
|
#include <QVector>
|
|
|
#include <vtkSmartPointer.h>
|
|
|
#include <vtkType.h>
|
|
|
|
|
|
class vtkUnstructuredGrid;
|
|
|
class nmVolumeDataBuilder;
|
|
|
class nmVolumeDataRenderAdapter;
|
|
|
|
|
|
/** @brief 三维属性的存储关联；不包含任何求解器或 PEBI 业务约定。 */
|
|
|
enum NM_VOLUME_PROPERTY_ASSOCIATION
|
|
|
{
|
|
|
NM_VolumeProperty_CellData = 0,
|
|
|
NM_VolumeProperty_PointData
|
|
|
};
|
|
|
|
|
|
/** @brief 已校验的单分量属性描述；范围只统计有限值，名称不推断单位。 */
|
|
|
struct NM_DATA_EXPORT nmVolumePropertyDescriptor
|
|
|
{
|
|
|
QString m_sPropertyId; ///< 关联类型与原数组名组成的稳定身份。
|
|
|
QString m_sArrayName; ///< 文件中的原始名称，以 UTF-8 交给 VTK。
|
|
|
NM_VOLUME_PROPERTY_ASSOCIATION m_eAssociation; ///< 数组关联到单元或节点。
|
|
|
double m_dMinimum; ///< 全模型范围内的最小有限属性值。
|
|
|
double m_dMaximum; ///< 全模型范围内的最大有限属性值，常量时等于最小值。
|
|
|
};
|
|
|
|
|
|
/**
|
|
|
* @brief 与数据来源无关的只读三维体网格。
|
|
|
* Builder 独立复制并校验后才发布；UI 只能查询元数据，渲染适配器可以共享
|
|
|
* 已冻结的数组，但任何下游均不得修改共享几何和数组。
|
|
|
*/
|
|
|
class NM_DATA_EXPORT nmVolumeData
|
|
|
{
|
|
|
public:
|
|
|
/** @brief 释放当前数据对象独占的网格容器及冻结数组引用。 */
|
|
|
~nmVolumeData();
|
|
|
/** @brief 返回本次发布的唯一数据 ID；重复导入同一文件也生成新身份。 */
|
|
|
QString getDataId() const;
|
|
|
/** @brief 返回可选来源名称；文件导入使用文件名，求解器可提供业务名称。 */
|
|
|
QString getSourceName() const;
|
|
|
/** @brief 返回已校验三维网格的节点数量。 */
|
|
|
vtkIdType getPointCount() const;
|
|
|
/** @brief 返回已校验三维网格的体单元数量。 */
|
|
|
vtkIdType getCellCount() const;
|
|
|
/** @brief 复制 X/Y/Z 最小、最大边界；空输出指针不执行操作。 */
|
|
|
void getBounds(double dBounds[6]) const;
|
|
|
/** @brief 返回只读属性目录，顺序为单元属性在前、节点属性在后。 */
|
|
|
const QVector<nmVolumePropertyDescriptor>& getProperties() const;
|
|
|
/** @brief 按稳定 ID 查找只读描述；不存在时返回 nullptr。 */
|
|
|
const nmVolumePropertyDescriptor* findProperty(const QString& sPropertyId) const;
|
|
|
/** @brief 返回默认着色属性 ID；没有合法标量时返回空字符串。 */
|
|
|
QString getInitialPropertyId() const;
|
|
|
/** @brief 返回被跳过属性等非致命诊断，不影响合法几何发布。 */
|
|
|
QStringList getDiagnostics() const;
|
|
|
|
|
|
private:
|
|
|
/** @brief 只允许 Builder 创建待校验对象，普通调用者不能发布半成品。 */
|
|
|
nmVolumeData();
|
|
|
Q_DISABLE_COPY(nmVolumeData)
|
|
|
friend class nmVolumeDataBuilder;
|
|
|
friend class nmVolumeDataRenderAdapter;
|
|
|
|
|
|
vtkSmartPointer<vtkUnstructuredGrid> m_pGrid; ///< 发布后不再写入。
|
|
|
QString m_sDataId; ///< 本次发布唯一 UUID，与路径及界面索引无关。
|
|
|
QString m_sSourceName; ///< 仅供显示的来源名称，不用于读取或身份比较。
|
|
|
QString m_sInitialPropertyId; ///< 构建时按活动标量优先级选定的默认属性。
|
|
|
QVector<nmVolumePropertyDescriptor> m_vecProperties; ///< 发布后不可修改的属性目录。
|
|
|
QStringList m_listDiagnostics; ///< 被跳过的数组等非致命诊断。
|
|
|
double m_dBounds[6]; ///< 有限且三轴非零跨度的原始网格边界。
|
|
|
};
|
|
|
|
|
|
/** @brief 导入过程的非所有权回调；实现必须允许工作线程调用。 */
|
|
|
class NM_DATA_EXPORT nmVolumeImportFeedback
|
|
|
{
|
|
|
public:
|
|
|
/** @brief 支持通过反馈接口销毁具体回调实现。 */
|
|
|
virtual ~nmVolumeImportFeedback() {}
|
|
|
/** @brief 返回线程安全的取消状态；读取、校验和复制循环均需检查。 */
|
|
|
virtual bool isCanceled() const = 0;
|
|
|
/** @brief 报告 0～100 的加载进度；不得在此直接操作界面对象。 */
|
|
|
virtual void reportProgress(int nPercent) = 0;
|
|
|
};
|
|
|
|
|
|
#endif // NMVOLUMEDATA_H
|