How do I read an exported material group code?

如何读取导出的材质组代码

Last updated: 2026-10-21

Read a material group (SG) code as fixed-format 64-bit numeric fields, one entry per part: Part ID, Parent ID, baseX, baseY, Anchor X/Y, Scale, Layer, Z-perspective, category and numbered states.

材质组（SG）代码是固定格式的64位数值字段，每个部件一条：Part ID、Parent ID、baseX、baseY、Anchor X/Y、Scale、Layer、Z-perspective、类别与编号状态。

How to do it in 3SAX V3

在 3SAX V3 中如何操作

1. Open the SG Material Group panel; load the exported code or the saved project.

1. 打开 SG 材质组面板，载入导出的代码或已保存项目。

2. Check each part's IDs: Parent ID must match an existing Part ID, or the parent-child tree breaks.

2. 核对每个部件的 ID：Parent ID 必须对应已有 Part ID，否则父子树断裂。

3. Verify baseX/baseY and Anchor X/Y before Layer and Z-perspective; the canvas preview reflects any mismatch.

3. 先验证 baseX/baseY 与 Anchor X/Y，再看 Layer 与 Z-perspective；画布预览会同步显示偏差。

4. Confirm each part's category (join) and numbered states — action seq ranges like 01:0-5 refer to these states.

4. 确认每个部件的类别（join）与编号状态——动作 seq 区间如 01:0-5 引用的就是这些状态。

5. Use real-time input hints (green valid / red error with fix example) and run whole-project validation to catch broken references.

5. 查看输入框旁的实时提示（绿色有效／红色报错并给出修正示例），运行整项目校验找出错误引用。

6. Reuse the code by loading it into a new project or binding it to an Action Group.

6. 将代码载入新项目或绑定到 Action Group，即可复用。

What you CAN and CANNOT do

可以做什么与不能做什么

CAN: read, edit and re-save fixed-format codes; reuse finished clips; bind codes to actions, camera, music, scheduler and events.
CANNOT: rely on invalid fields — a wrong Parent ID makes parts fly apart, missing states break action seq ranges, and failed validation blocks MP4 render.

可以：读取、编辑并重新保存固定格式代码；复用已完成片段；将代码绑定到动作、相机、音乐、调度与事件。
不可以：忽略错误字段——Parent ID 错误会导致部件飞散，状态缺失会使动作区间失效，校验不通过将无法渲染 MP4。

Try it in the 3SAX V3 creator tool and read your first exported code today.

现在就在 3SAX V3 创作工具中读取你的第一份导出代码。