资源
资源与元素的区别
资源,归属于项目,在【资源】窗中管理。可以应用到元素中。
元素,归属于合成。动画 K 帧,指的是向元素添加关键帧信息。

支持导入的资源
Galacean Effects 支持导入 2D 贴图、模型、 Spine、字体四类资源。
也支持解析 .vfx、.psd 及 lottie 文件(sketch 文件计划中)。

如何导入
2D 贴图
导入 2D 贴图资源的三种方式:
- 文件 - 添加图片:文件菜单下,选择添加图片,即可向当前项目,添加图片资源。
- 资源 - 上传:在【资源】中,选择 2D 贴图分类,点击【+】号,即可向当前项目,添加图片资源。
- 资源 - 拖拽添加:在【资源】中,选择2D 贴图分类,直接将图片拖拽添加到【资源】,即完成添加。
模型
带有动画的模型,可以作为一个元素,被使用到 Galacean Effects 的合成中。
模型资源(含动画)可以通过 .fbx 或 .glb 文件上传到【资源】。
导入 3D 模型资源的三种方式:
- 文件 - 添加模型:文件菜单下,选择添加模型,即可向当前项目,添加模型资源。
- 资源 - 上传:在【资源】中,选择模型分类,点击【+】号,即可向当前项目,添加模型资源。
- 资源 - 拖拽添加:在【资源】中,选择模型分类,直接将文件拖拽添加到【资源】,即完成添加。
模型资源的分类展示
上传后,.fbx/.glb 文件会被分类解析出来。全部显示在【模型】分类中。
【模型】分类下有二级分类,帮助筛选展示某一二级类型的资源。二级分类包括:
资源类型 | 资源描述 | 文件后缀 | 引用关系 |
gltfScene | glTF | .scene | 引用多个 mesh |
mesh | 网格 | .mesh | 引用多个 material |
material | 材质 | .mat | 引用多个 texture |
texture | 3D 贴图 | .tex | 引用单个 image |
iblResource | IBL资源 | .ibl | - |
animation | 动画 | .ani | - |
- glTF:.scene 文件。可直接拖拽添加到画布中,在元素列表中展示为 treeitem 及 mesh 元素。
- 网格:.mesh 文件。mesh 元素的参数中可设置不同类型贴图。
- 材质:.mat 文件。Galacean Effects 支持从【模型】资源上传入口创建 unlit 和 PBR 材质。
- 3D 贴图:.tex 文件。3D 贴图与 2D 贴图的文件解析方式不同,因此用作模型贴图的图片需要从【模型】资源入口上传。
- IBL 资源:天空盒资源,需要随 .fbx/.glb 文件上传到资源。
- 动画:动画资源,需要随 .fbx/.glb 文件上传到资源。
Spine 文件
字体文件
支持导入 .tff 后缀的字体文件。单个字体文件最大上传体积 5M。
可在文本元素中使用自定义字体,使用裁剪过的字体。
如何应用/替换资源
元素应用的资源,可以被替换,但只能替换为相同类型的资源。比如,图层元素,它的资源只能替换为另一张图片资源,不可替换为 Spine 文件。
以图层元素为例:
- 在元素列表中,右键元素选择【更换贴图】;
- 在画布中,右键元素选择【更换贴图】;
- 或在该元素的参数面板中,点击【纹理贴图】
即可跳转到【资源】窗,选择应用/取消应用某一资源。
元素列表右键:
画布中右键:
参数面板修改贴图:
在替换图片资源时,【资源】窗有2个选项,默认勾选。
- 自动匹配元素宽高比:替换时,新资源会按照当前元素的高宽比适配。
- 自动匹配元素大小:替换或上传新图片时,元素大小(px)保持不变。
不同类型元素应用/替换资源的方式
元素 | 元素列表右键 | 画布中右键 | 参数面板 | |
图层 | ✅ | ✅ | ✅ | |
发射器 | ✅ | ✅ | ✅ | |
Spine | × | × | ✅ | |
模型:整体资源,仅 glTF、材质显示在元素列表及画布中。目前仅支持替换贴图类资源。 | glTF | × | × | × |
网格 | × | × | × | |
材质 | × | × | ✅ | |
3D 贴图 | × | × | ✅ | |
IBL 资源 | × | × | ✅ | |
动画 | × | × | × |