Skip to content

限额与兼容性 ​

限额是拒绝超限数据的边界,不是建议把每项都用满。

文件与图片 ​

项目当前边界
完整 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
动作 duration1~120000 毫秒
累计动画数值6,000,000(不是帧数)
每状态 returns/每条返回路径 steps100/32

优化顺序 ​

  1. 去掉没有使用的节点、重复图片与无意义的采样;保留制作源与原图。
  2. 复用材质、几何和完全一致的轨道;注意预算按校验器实际遍历方式计算,复用不一定降低所有计数。
  3. 对完整画幅尝试 WebP 压缩,逐页比较小字和边缘。
  4. 降低不可见细节的几何密度,不破坏轮廓、铰链与可见厚度。
  5. 仍无法符合预算时明确说明取舍,不关闭校验、不截掉重要内容。

兼容边界 ​

DiscAtelier 支持 V2 和已注册结构的 V3,不支持 V1。OBJ/GLB/FBX 需要先转换为符合要求的 .ateliermodel。模型包只包含数据与内置资源;导入前请确认所用软件版本支持对应的格式和结构。

模型制作工具遵循随包许可证