|
|
#ifndef NMPEBIRESULTANIMATIONEXPORTER_H
|
|
|
#define NMPEBIRESULTANIMATIONEXPORTER_H
|
|
|
|
|
|
#include "nmSubWxs_global.h"
|
|
|
#include "nmPebiResultAnimationExportSettings.h"
|
|
|
#include "nmPebiResultDisplaySettings.h"
|
|
|
|
|
|
#include <QObject>
|
|
|
#include <QSharedPointer>
|
|
|
#include <QString>
|
|
|
#include <vtkSmartPointer.h>
|
|
|
|
|
|
class nmPebiResultSnapshot;
|
|
|
class vtkCamera;
|
|
|
|
|
|
/** @brief 在独立VTK场景中同步渲染并编码PEBI结果动画。 */
|
|
|
class NM_SUB_WXS_EXPORT nmPebiResultAnimationExporter : public QObject
|
|
|
{
|
|
|
Q_OBJECT
|
|
|
|
|
|
public:
|
|
|
/** @brief 一次同步导出调用的终止状态。 */
|
|
|
enum ExportResult
|
|
|
{
|
|
|
/** 临时视频已成功发布到目标路径。 */
|
|
|
Export_Succeeded = 0,
|
|
|
/** 用户在完整帧边界请求取消，临时文件已清理。 */
|
|
|
Export_Cancelled,
|
|
|
/** 渲染、编码或文件发布失败，详细原因由pError返回。 */
|
|
|
Export_Failed
|
|
|
};
|
|
|
|
|
|
/** @brief 调用方在开始导出前冻结的全部输入。 */
|
|
|
struct Request
|
|
|
{
|
|
|
/** @brief 创建空请求，显隐和背景字段使用默认值。 */
|
|
|
Request();
|
|
|
|
|
|
/** @brief 导出期间持有的只读快照强引用。 */
|
|
|
QSharedPointer<const nmPebiResultSnapshot> m_pSnapshot;
|
|
|
/** @brief 待导出的稳定动态属性ID。 */
|
|
|
QString m_sPropertyId;
|
|
|
/** @brief 开始导出时冻结的颜色映射设置。 */
|
|
|
nmPebiResultDisplaySettings m_oDisplaySettings;
|
|
|
/** @brief 已规范化的帧范围、采样、帧率和输出尺寸。 */
|
|
|
nmPebiResultAnimationExportSettings m_oExportSettings;
|
|
|
/** @brief 最终视频目标路径，扩展名决定输出格式。 */
|
|
|
QString m_sTargetFilePath;
|
|
|
/** @brief 是否在视频中显示色标。 */
|
|
|
bool m_bScalarBarVisible;
|
|
|
/** @brief 是否在视频中显示比例网格。 */
|
|
|
bool m_bScaleGridVisible;
|
|
|
/** @brief 是否在视频中显示井名和引线。 */
|
|
|
bool m_bWellNamesVisible;
|
|
|
/** @brief Renderer第一背景色，三个分量均为0～1。 */
|
|
|
double m_dBackground[3];
|
|
|
/** @brief Renderer渐变背景的第二颜色，三个分量均为0～1。 */
|
|
|
double m_dBackground2[3];
|
|
|
/** @brief 是否启用Renderer渐变背景。 */
|
|
|
bool m_bGradientBackground;
|
|
|
/** @brief 当前屏幕相机的深拷贝，导出器不会修改屏幕相机。 */
|
|
|
vtkSmartPointer<vtkCamera> m_pCamera;
|
|
|
};
|
|
|
|
|
|
/** @param pParent Qt父对象，不参与VTK资源所有权。 */
|
|
|
explicit nmPebiResultAnimationExporter(QObject* pParent = nullptr);
|
|
|
/** @brief 释放导出器；实际导出在exportAnimation()返回前同步结束。 */
|
|
|
virtual ~nmPebiResultAnimationExporter();
|
|
|
|
|
|
/**
|
|
|
* @brief 同步执行离屏渲染、临时编码和最终文件发布事务。
|
|
|
* @param oRequest 调用期间保持不变的冻结请求。
|
|
|
* @param pError 可选错误输出；取消不写入错误文字。
|
|
|
* @return 成功、取消或失败状态。
|
|
|
*/
|
|
|
ExportResult exportAnimation(const Request& oRequest,
|
|
|
QString* pError = nullptr);
|
|
|
|
|
|
signals:
|
|
|
/** @brief 每完成一帧编码后报告进度，首次以0作为已完成帧数。 */
|
|
|
void progressChanged(int nCompletedFrames, int nTotalFrames);
|
|
|
|
|
|
public slots:
|
|
|
/** @brief 请求在当前完整帧写入后取消；不会中断正在编码的半帧。 */
|
|
|
void cancel();
|
|
|
|
|
|
private:
|
|
|
Q_DISABLE_COPY(nmPebiResultAnimationExporter)
|
|
|
|
|
|
/** @brief 在完整帧编码边界读取的取消请求标志。 */
|
|
|
bool m_bCancelRequested;
|
|
|
};
|
|
|
|
|
|
#endif // NMPEBIRESULTANIMATIONEXPORTER_H
|