31 lines
1.2 KiB
C++
31 lines
1.2 KiB
C++
#pragma once
|
||
|
||
#include "domain/Project.h"
|
||
|
||
#include <QString>
|
||
|
||
namespace core {
|
||
|
||
// 实体完整数据（几何 + 贴图路径 + 动画轨道）的二进制格式，与 project.json v2 的 payload 字段对应。
|
||
// 贴图 PNG 仍单独存放在 assets/entities/，本文件不嵌入像素。
|
||
// 具体读写通过继承 PersistentBinaryObject 的适配器类完成（见 EntityPayloadBinary.cpp）。
|
||
class EntityPayloadBinary {
|
||
public:
|
||
static constexpr quint32 kMagicPayload = 0x48464550; // 'HFEP'
|
||
static constexpr quint32 kPayloadVersion = 3; // v3：追加 userScaleKeys（动画轨道）
|
||
|
||
// 旧版独立动画文件（仍用于打开 v1 项目时合并）
|
||
static constexpr quint32 kMagicLegacyAnim = 0x48465441; // 'HFTA'
|
||
static constexpr quint32 kLegacyAnimVersion = 1;
|
||
|
||
static bool save(const QString& absolutePath, const Project::Entity& entity);
|
||
|
||
// 读入后覆盖 entity 中除调用方已校验外的字段；失败时尽量保持 entity 不变。
|
||
static bool load(const QString& absolutePath, Project::Entity& entity);
|
||
|
||
// 仅读取旧 .anim（HFTA），写入 entity 的三条动画轨道。
|
||
static bool loadLegacyAnimFile(const QString& absolutePath, Project::Entity& entity);
|
||
};
|
||
|
||
} // namespace core
|