glTF 模型

    Creator 支持 glTF 中指定以下形式的 URI:

    • Data URI

    • 相对 URI 路径

    • 文件 URL

    • 文件路径

    转换关系

    当导入 glTF 模型到 Creator 时,glTF 中的资源将会按照以下关系转换为 Creator 中的资源:

    导入后,glTF 场景将转换为 Creator 中的预制体资源,glTF 场景中递归包含的节点也将按照相同层级关系一一转换为预制体中的节点。

    场景根节点

    预制体将使用一个不带任何空间转换信息的节点作为根节点,glTF 场景的所有 根节点 将作为该节点的子节点。

    节点转换

    glTF 节点中的属性将按照下表中的映射关系转换为预制体节点中的属性:

    glTF 节点属性预制体节点属性
    层级关系层级关系
    位置
    旋转旋转
    缩放
    矩阵解压,并分别设置位置、旋转、缩放
    网格渲染器组件
    蒙皮引用蒙皮网格渲染器组件
    (蒙皮)网格渲染器组件权重

    网格渲染器

    若 glTF 节点引用了网格,那么导入后相对应的预制体节点也会添加网格渲染组件(MeshRenderer)。若该 glTF 节点还引用了蒙皮,那么相对应的预制体节点还会添加蒙皮网格渲染组件(SkinnedMeshRenderer)。

    若 glTF 节点指定了初始权重,则转换后的(蒙皮)网格渲染器也将带有此权重。

    glTF 网格

    导入后,glTF 网格将转换为 Cocos Creator 中的网格资源。

    glTF 网格中的所有 基元体 将被一一转换为 Creator 中的子网格。

    若 glTF 网格指定了 ,则相应地,转换后的 Creator 网格中也将存储相应的权重。

    glTF 基元体

    glTF 基元体的索引数组将一一对应转换为 Cocos Creator 子网格的索引数组。

    glTF 基元模式将按照下表中的映射关系转换为 Cocos Creator 基元模式:

    glTF 顶点属性将转换为 Cocos Creator 顶点属性,属性名称的转换如下表所示:

    glTF 顶点属性名称Cocos Creator 顶点属性名称
    POSITIONgfx.AttributeName.ATTR_POSITION
    NORMALgfx.AttributeName.ATTR_NORMAL
    TANGENTgfx.AttributeName.ATTR_TANGENT
    TEXCOORD_0gfx.AttributeName.ATTR_TEX_COORD
    TEXCOORD_1..TEXCOORD_8..gfx.AttributeName.ATTR_TEX_COORD8
    COLOR_0gfx.AttributeName.ATTR_COLOR
    COLOR_1..COLOR_2gfx.AttributeName.ATTR_COLOR1..gfx.AttributeName.ATTR_COLOR2
    JOINTS_0gfx.AttributeName.ATTR_JOINTS
    WEIGHTS_0gfx.AttributeName.ATTR_WEIGHTS

    对于每个顶点,所有由 JOINTS_{}WEIGHTS_{} 确定的权重信息将按权重值进行排序,取出影响权重最大的四根骨骼作为 gfx.AttributeName.ATTR_JOINTSgfx.AttributeName.ATTR_WEIGHTS

    glTF 形变目标将被转换为 Cocos Creator 子网格形变数据。

    glTF 材质

    导入后,glTF 材质将转换为 Cocos Creator 中的材质资源。

    导入后,glTF 贴图将转换为 Cocos Creator 中的贴图资源。

    glTF 贴图中引用的 glTF 图像将转换为对相应转换后的 Cocos Creator 图像的引用。

    glTF 贴图属性将按照下表中的映射关系转换为 Cocos Creator 贴图属性:

    glTF 贴图放大筛选器将按照下表中的映射关系转换为 Cocos Creator 贴图放大筛选器:

    glTF 贴图放大筛选器Cocos Creator 贴图放大筛选器
    NEARESTTextureBase.Filter.NEAREST
    LINEARTextureBase.Filter.LINEAR

    glTF 贴图缩小筛选器将按照下表中的映射关系转换为 Cocos Creator 贴图缩小筛选器和 Cocos Creator 贴图 Mip Map 筛选器:

    glTF 贴图环绕模式将按照下表中的映射关系转换为 Cocos Creator 贴图环绕模式:

    glTF 贴图环绕模式Cocos Creator 贴图环绕模式
    CLAMP_TO_EDGETextureBase.WrapMode.CLAMP_TO_EDGE
    REPEATTextureBase.WrapMode.REPEAT
    MIRRORED_REPEATTextureBase.WrapMode.MIRRORED_REPEAT

    glTF 图像

    导入后,glTF 图像将转换为 Cocos Creator 中的图像资源。

    当 glTF 图像的 是 Data URI 时,图像数据将从 Data URI 中获取。否则,将根据 Cocos Creator 图像位置解析算法 解析并引用外部图像文件,其中 就是 glTF 图像的 URI,startDir 为 glTF 文件所在目录。

    导入后,glTF 动画将转换为 Cocos Creator 动画资源。