Pixel-Composer材质丢失主因是纹理未显式注入着色器节点链：需用Image Texture节点加载PNG/JPG，连至Colorize等节点对应输入口，并确保mode设为Texture、Preview开启、数据流闭合且类型为Texture2D或Color。
Composer 渲染模式下材质丢失，不是渲染器本身出错，而是资源路径断开或加载时机不对——尤其在 Pixel-Composer 这类节点式工具中，材质/纹理不显示，90% 是因为「纹理没被正确注入到着色器节点链里」，而不是贴图文件损坏或缺失。
为什么 Pixel-Composer 节点里看不到贴图效果？
它不直接读取磁盘路径，也不自动挂载外部图像；所有纹理必须显式作为 Texture 节点导入，并连接到对应通道（比如 Colorize 的 texture 输入、或 Draw Shape 的 mask）。常见现象包括：
— 节点预览区一片黑或纯色
— 导出 PNG 时纹理区域为空白
— 拖入图片后没反应，节点右上角无缩略图
- 检查是否用了
Image Texture节点（而非直接拖图到画布）：只有该节点能解析 PNG/JPG 并输出 UV 采样信号 - 确认图片格式支持：仅支持
.png、.jpg、.jpeg；WebP、SVG、HEIC 会静默失败 - 路径含中文或空格会导致加载中断——哪怕文件存在，节点也会返回空纹理
- 若从剪贴板粘贴图片，
Pixel-Composer不识别，必须用Load Image按钮手动选取
Image Texture 节点加载成功但材质仍不生效？
节点之间数据流向必须完整闭合。例如想让一张砖墙图控制粒子颜色，不能只连 Image Texture → Colorize，还要确保：
— Colorize 节点的 mode 设为 Texture（不是 Gradient 或 Single）
— Colorize 输出端连到了下游的 Draw Shape 或 Emit Particle 的 color 输入口
- 右键点击任意连线可查看「数据类型」：应为
Texture2D或Color，若显示Null说明上游未输出有效数据 - 多个
Image Texture节点共存时，注意它们的UV Scale和Offset参数是否重叠导致画面错位 - 启用
Preview开关（节点右上角眼睛图标）才能在编辑区实时看到该节点输出
导出 GLB 后 Three.js 加载显示黑块？
这是跨工具链最易踩的坑：Pixel-Composer 生成的是像素动画逻辑，不是标准 PBR 材质；它导出的 GLB 默认不含 baseColorTexture 等物理材质字段，Three.js 的 GLTFLoader 会 fallback 到哑光灰（0x808080）
- 不要指望导出的 GLB 直接用于
MeshStandardMaterial—— 它本质是带 UV 动画的 SpriteSheet + Shader 控制逻辑 - 若需在 Three.js 中复现效果，得手动把
Pixel-Composer输出的帧序列转成视频纹理，再用VideoTexture注入自定义 ShaderMaterial - 更务实的做法：用
Pixel-Composer做原型验证，定稿后由美术导出 PNG 序列，前端用TextureLoader+AnimationMixer驱动
