跳到主要内容

第 6 章:SCNE 区段

SCNE 是可选、全局 RAW8 UTF-8 JSON 区段。它保存展示和编辑建议,不参与 sourceHash,也不改变 VOX0、PAL0 或坐标系。当前 Writer 的结构为:

{
"activeObject":"obj_main",
"pivot":[64.0,64.0,64.0],
"coordinateSystem":"Z_UP",
"axisConvention":{"up":"+Z","forward":"+Y","handedness":"RIGHT_HANDED"},
"camera":{"mode":"orbit","yaw":0.0,"pitch":0.0},
"symmetry":{"x":false}
}

Reader 可按产品相机系统消费或完全忽略 SCNE;损坏、未知字段或不支持的展示字段只能使 SCNE 被丢弃,不能阻断权威资产读取。axisConvention 与 META 相同:+Z 上、+Y 前、右手系,且 yaw=0 是相机位于模型正前方(+Y)朝向 Pivot;正 yaw 由 +Y 向 +X 旋转,正 pitch 向上。缺失 axisConvention 的历史 SCNE 使用相同默认值。SCNE 不是旧的固定 128 B 相机/灯光二进制表,也不能用于覆盖 META 的 Z_UP 约定。