资源

阅读时间:4分钟更新于 2025-08-27 17:36

资源与元素的区别

资源,归属于项目,在【资源】窗中管理。可以应用到元素中。

元素,归属于合成。动画 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 文件

详见 《导入 Spine 文件》

字体文件

支持导入 .tff 后缀的字体文件。单个字体文件最大上传体积 5M。

可在文本元素中使用自定义字体,使用裁剪过的字体。

如何应用/替换资源

元素应用的资源,可以被替换,但只能替换为相同类型的资源。比如,图层元素,它的资源只能替换为另一张图片资源,不可替换为 Spine 文件。

以图层元素为例:

  • 在元素列表中,右键元素选择【更换贴图】;
  • 在画布中,右键元素选择【更换贴图】;
  • 或在该元素的参数面板中,点击【纹理贴图】

即可跳转到【资源】窗,选择应用/取消应用某一资源。

元素列表右键:

画布中右键:

参数面板修改贴图:

在替换图片资源时,【资源】窗有2个选项,默认勾选。

  • 自动匹配元素宽高比:替换时,新资源会按照当前元素的高宽比适配。
  • 自动匹配元素大小:替换或上传新图片时,元素大小(px)保持不变。

不同类型元素应用/替换资源的方式

元素

元素列表右键

画布中右键

参数面板

图层

发射器

Spine

×

×

模型:整体资源,仅 glTF、材质显示在元素列表及画布中。目前仅支持替换贴图类资源。

glTF

×

×

×

网格

×

×

×

材质

×

×

3D 贴图

×

×

IBL 资源

×

×

动画

×

×

×

Preview