主题
限额与兼容性
限额是拒绝超限数据的边界,不是建议把每项都用满。
文件与图片
| 项目 | 当前边界 |
|---|---|
| 完整 UTF-8 JSON | ≤ 50 × 1024² 字节(50 MiB) |
| 每个图片 data URI | ≤ 16 × 1024² 字符,包含前缀和 Base64 |
| 实际图片宽/高 | 各 ≤ 8192 |
| 原生单次图片解码分配 | 128 MiB 预算 |
| 封面与图片合计 | ≤ 192 × 1024² 像素 |
| 格式 | 内置 PNG/WebP,真实解码必须通过 |
V2 按 cover 加 scene.textures 每项计数;V3 按 cover 加 images 计数,贴图别名不重复计数。入门包的 Pillow 预检还按 RGBA 做保守估算;它不是原生分配器的逐字节模拟。
V2 场景与动画
| 项目 | 上限 |
|---|---|
| 节点/几何 | 各 3000 |
| 材质/贴图 | 500/300 |
| 基础顶点总数 | 1,500,000 |
| 状态/动作 | 768/4000 |
| 每几何、每类形变目标 | 256 |
| 每动作轨道数 | 9000 |
| 每轨道时间采样 | 2~10000;从 0 到 duration |
| 动作 duration | 1~120000 毫秒 |
| 累计动画数值 | 6,000,000(不是帧数) |
| 每状态 returns/每条返回路径 steps | 100/32 |
优化顺序
- 去掉没有使用的节点、重复图片与无意义的采样;保留制作源与原图。
- 复用材质、几何和完全一致的轨道;注意预算按校验器实际遍历方式计算,复用不一定降低所有计数。
- 对完整画幅尝试 WebP 压缩,逐页比较小字和边缘。
- 降低不可见细节的几何密度,不破坏轮廓、铰链与可见厚度。
- 仍无法符合预算时明确说明取舍,不关闭校验、不截掉重要内容。
兼容边界
DiscAtelier 支持 V2 和已注册结构的 V3,不支持 V1。OBJ/GLB/FBX 需要先转换为符合要求的 .ateliermodel。模型包只包含数据与内置资源;导入前请确认所用软件版本支持对应的格式和结构。