glTF 模型
Cocos Creator 支持 glTF 2.0 及更早的文件格式。
URI 解析
Creator 支持 glTF 中指定以下形式的 URI:
Data URI
相对 URI 路径
文件 URL
文件路径
转换关系
当导入 glTF 模型到 Creator 时,glTF 中的资源将会按照以下关系转换为 Creator 中的资源:
glTF 资源 | Cocos Creator 资源 |
---|---|
glTF 场景 | 预制体 |
glTF 网格 | 网格 |
glTF 蒙皮 | 骨骼 |
glTF 材质 | 材质 |
glTF 贴图 | 贴图 |
glTF 图像 | 图像 |
glTF 动画 | 动画剪辑 |
glTF 场景
导入后,glTF 场景将转换为 Creator 中的预制体资源,glTF 场景中递归包含的节点也将按照相同层级关系一一转换为预制体中的节点。
场景根节点
预制体将使用一个不带任何空间转换信息的节点作为根节点,glTF 场景的所有 根节点 将作为该节点的子节点。
节点转换
glTF 节点中的属性将按照下表中的映射关系转换为预制体节点中的属性:
glTF 节点属性 | 预制体节点属性 |
---|---|
层级关系 | 层级关系 |
位移 | 位置 |
旋转 | 旋转 |
缩放 | 缩放 |
矩阵 | 解压,并分别设置位置、旋转、缩放 |
网格引用 | 网格渲染器组件 |
蒙皮引用 | 蒙皮网格渲染器组件 |
初始权重 | (蒙皮)网格渲染器组件权重 |
网格渲染器
若 glTF 节点引用了网格,那么导入后相对应的预制体节点也会添加网格渲染组件(MeshRenderer)。若该 glTF 节点还引用了蒙皮,那么相对应的预制体节点还会添加蒙皮网格渲染组件(SkinnedMeshRenderer)。
(蒙皮)网格渲染组件中的网格、骨骼和材质,都会与转换后的 glTF 网格、蒙皮、材质资源一一对应。
若 glTF 节点指定了初始权重,则转换后的(蒙皮)网格渲染器也将带有此权重。
glTF 网格
导入后,glTF 网格将转换为 Cocos Creator 中的网格资源。
glTF 网格中的所有 基元体 将被一一转换为 Creator 中的子网格。
若 glTF 网格指定了 权重,则相应地,转换后的 Creator 网格中也将存储相应的权重。
glTF 基元体
glTF 基元体的索引数组将一一对应转换为 Cocos Creator 子网格的索引数组。
glTF 基元模式将按照下表中的映射关系转换为 Cocos Creator 基元模式:
glTF 基元模式 | Cocos Creator 基元模式 |
---|---|
POINTS | gfx.PrimitiveMode.POINT_LIST |
LINES | gfx.PrimitiveMode.LINE_LIST |
LINE_LOOP | gfx.PrimitiveMode.LINE_LOOP |
LINE_STRIP | gfx.PrimitiveMode.LINE_STRIP |
TRIANGLES | gfx.PrimitiveMode.TRIANGLE_LIST |
TRIANGLE_STRIP | gfx.PrimitiveMode.TRIANGLE_STRIP |
TRIANGLE_FAN | gfx.PrimitiveMode.TRIANGLE_FAN |
glTF 顶点属性将转换为 Cocos Creator 顶点属性,属性名称的转换如下表所示:
glTF 顶点属性名称 | Cocos Creator 顶点属性名称 |
---|---|
POSITION | gfx.AttributeName.ATTR_POSITION |
NORMAL | gfx.AttributeName.ATTR_NORMAL |
TANGENT | gfx.AttributeName.ATTR_TANGENT |
TEXCOORD_0 | gfx.AttributeName.ATTR_TEX_COORD |
TEXCOORD_1 ..TEXCOORD_8 | gfx.AttributeName.ATTR_TEX_COORD1 ..gfx.AttributeName.ATTR_TEX_COORD8 |
COLOR_0 | gfx.AttributeName.ATTR_COLOR |
COLOR_1 ..COLOR_2 | gfx.AttributeName.ATTR_COLOR1 ..gfx.AttributeName.ATTR_COLOR2 |
JOINTS_0 | gfx.AttributeName.ATTR_JOINTS |
WEIGHTS_0 | gfx.AttributeName.ATTR_WEIGHTS |
注意:若 glTF 基元体中存在其他
JOINTS
、WEIGHTS
顶点属性,例如JOINTS_1
、WEIGHTS_1
,则意味着此 glTF 网格的顶点可能受到多于 4 根骨骼的影响。
对于每个顶点,所有由 JOINTS_{}
、WEIGHTS_{}
确定的权重信息将按权重值进行排序,取出影响权重最大的四根骨骼作为 gfx.AttributeName.ATTR_JOINTS
和 gfx.AttributeName.ATTR_WEIGHTS
。
glTF 形变目标将被转换为 Cocos Creator 子网格形变数据。
glTF 蒙皮
导入后,glTF 蒙皮将转换为 Cocos Creator 中的骨骼资源。
glTF 材质
导入后,glTF 材质将转换为 Cocos Creator 中的材质资源。
glTF 贴图
导入后,glTF 贴图将转换为 Cocos Creator 中的贴图资源。
glTF 贴图中引用的 glTF 图像将转换为对相应转换后的 Cocos Creator 图像的引用。
glTF 贴图属性将按照下表中的映射关系转换为 Cocos Creator 贴图属性:
glTF 贴图属性 | Cocos Creator 贴图属性 |
---|---|
放大筛选器 | 放大筛选器 |
缩小筛选器 | 缩小筛选器、Mip Map 筛选器 |
S 环绕模式 | S 环绕模式 |
T 环绕模式 | 环绕模式 |
glTF 贴图放大筛选器将按照下表中的映射关系转换为 Cocos Creator 贴图放大筛选器:
glTF 贴图放大筛选器 | Cocos Creator 贴图放大筛选器 |
---|---|
NEAREST | TextureBase.Filter.NEAREST |
LINEAR | TextureBase.Filter.LINEAR |
glTF 贴图缩小筛选器将按照下表中的映射关系转换为 Cocos Creator 贴图缩小筛选器和 Cocos Creator 贴图 Mip Map 筛选器:
glTF 贴图缩小筛选器 | Cocos Creator 贴图缩小筛选器 | Cocos Creator 贴图 Mip Map 筛选器 |
---|---|---|
NEAREST | TextureBase.Filter.NEAREST | TextureBase.Filter.NONE |
LINEAR_MIPMAP_LINEAR | TextureBase.Filter.LINEAR | TextureBase.Filter.NONE |
LINEAR_MIPMAP_NEAREST | TextureBase.Filter.NEAREST | TextureBase.Filter.NEAREST |
LINEAR | TextureBase.Filter.LINEAR | TextureBase.Filter.NEAREST |
NEAREST_MIPMAP_LINEAR | TextureBase.Filter.NEAREST | TextureBase.Filter.LINEAR |
NEAREST_MIPMAP_NEAREST | TextureBase.Filter.LINEAR | TextureBase.Filter.LINEAR |
glTF 贴图环绕模式将按照下表中的映射关系转换为 Cocos Creator 贴图环绕模式:
glTF 贴图环绕模式 | Cocos Creator 贴图环绕模式 |
---|---|
CLAMP_TO_EDGE | TextureBase.WrapMode.CLAMP_TO_EDGE |
REPEAT | TextureBase.WrapMode.REPEAT |
MIRRORED_REPEAT | TextureBase.WrapMode.MIRRORED_REPEAT |
glTF 图像
导入后,glTF 图像将转换为 Cocos Creator 中的图像资源。
当 glTF 图像的 URI 是 Data URI 时,图像数据将从 Data URI 中获取。否则,将根据 Cocos Creator 图像位置解析算法 解析并引用外部图像文件,其中 url
就是 glTF 图像的 URI,startDir
为 glTF 文件所在目录。
glTF 动画
导入后,glTF 动画将转换为 Cocos Creator 动画资源。