Why does my uploaded part not appear in the canvas?

为什么我上传的部件没有出现在画布上？

Last updated: 2026-10-21

Why does my uploaded part not appear in the canvas?

为什么我上传的部件没有出现在画布上？

The canvas only loads the scene plus action-referenced frames. A part that is not bound to an action, or has a wrong Parent ID or Layer, will not show.

画布只加载场景与动作引用的帧。未绑定动作、或 Parent ID、Layer 设置错误的部件不会显示。

How to do it in 3SAX V3

在 3SAX V3 里怎么做

1. Open the SG Material Group panel. Confirm your PNG uploaded and check the Part ID, baseX/baseY, Anchor X/Y, Scale, Layer and Z-perspective hints (green = valid).

1. 打开 SG 材质组面板，确认 PNG 已上传，检查 Part ID、baseX/baseY、Anchor X/Y、Scale、Layer、Z 透视的提示（绿色为有效）。

2. Check Parent ID. If the parent does not exist, the part drops out of the tree. Set a valid parent or make it a root part.

2. 检查 Parent ID。父级不存在时部件会脱离树。填有效父级，或设为根部件。

3. Set the part category (join) and its numbered states (frames).

3. 设置部件类别（join）和编号状态（帧）。

4. Open AG Action and bind the material group. Add an action unit whose target part = that join, with a seq frame range (e.g. 01:0-5). Use auto-suggest sequence to match available states.

4. 打开 AG 动作组并绑定该材质组，添加动作单元：目标部件 = 该 join，填 seq 帧范围（如 01:0-5）。用自动建议序列匹配可用状态。

5. Open CANVAS and preview. Drag to fine-tune dx/dy, edit rot/scale; changes sync back to the codes.

5. 打开 CANVAS 预览，拖动微调 dx/dy，编辑 rot/scale，改动会同步回代码。

What you CAN and CANNOT do

能做与不能做

CAN: fix Part ID / Parent ID / Layer, bind the part to an action, then preview in CANVAS.
CANNOT: expect an unbound part to appear. The canvas does not load unreferenced frames.

能做：修正 Part ID / Parent ID / Layer，把部件绑定到动作，再到 CANVAS 预览。
不能做：指望未绑定的部件出现。画布不加载未被引用的帧。

If the parent tree is broken, parts fly apart or vanish; render validation will list the error.

父级树错误时部件会飞散或消失，渲染校验会列出错误。

Try the 3SAX V3 creator tool and preview your material group now.

现在就用 3SAX V3 创作工具预览你的材质组。