we
    Preparing search index...

    Class GLTFModel

    节点对象 1、导入导出需要实例化 2、readyForGPU需要实例化 3、_destroy需要实例化 4、updateSelf需要实例化

    Hierarchy (View Summary)

    Index

    Constructors

    constructor

    Properties

    _animation _animationGroup _children _directInWorldSpace _entity _id _isDestroy _jointsMat _manager _matrix _modelOrigin _morphTarget _name _parent _parentMatrixWorld _particle _physicBody _position _positionOld _quaternion _quaternionOld _readyForGPU _renderID _rodriguesRotation _rodriguesRotationOld _rotate _rotateOld _scale _scaleOld _skinAnimation _spaceType _state _weightMixAnimation asWhole currentScene DataLoader dataTypeOfAttribute debug device enable inputValues instanceNodes lastUpdaeTime mapList matrix matrixWorld meshAndSkin meshAndSkinBundle modelData modelLoader modelRes needUpdateLocalMatrix needUpdateuserDefine needUpdateuserDefineAtEnd needUpdateWorldMatrix resourcesGPU scene stageID type url UUID visible worldPosition

    Accessors

    Animation AnimationGroup children DirectInWorldSpace Enable Entity ID JointsMat Matrix MorphTarget Name Parent Particle PhysicBody Position Quaternion renderID RodriguesAnyPoint RodriguesZeroPoint Rotate Scale SkinAnimation SpaceType Visible WeightMixAnimation

    Methods

    _destroy add addChild attachEntity checkNeedUpdateLocalMatrix checkNeedUpdateWorldMatrix cleanInstanceResource destroy destroyScene detachData getAccessor getEnableAndParents getGPUTexture getIndecisArrayOfPrimitive getIndecisOfPrimitive getMorphTargetsForNode getNodeObjectByID getNodeObjectByName getNodeObjectByUUID getRes getTexture getVerticesArrayOfPrimitive getVerticesOfPrimitive getVisibleAndParents init initAnimationsForInstance initCamerasForInstance initData initGPUTextures initInstance initMaterials initMeshes initModelScene initNodeObject initSamplers initSkinsForInstance initTextureInfo initTextures isDestroy loadJSON meshHasMorphTarget meshHasSkins quaternion readyForGPU remove removeChild removeChildren rodriguesRotation rotate rotateAxis rotateX rotateY rotateZ saveJSON scale setRootENV setTranslation translate translation traverse update updateMatrix updateMatrixWorld updateMatrixWorldFroce updateParentOnly updateSelf updateSelfAttribute updateWorldPosition

    Constructors

    Properties

    _animation

    _animation: BaseAnimation[] = []

    动画对象 animation object
    1、有数据，则存在动画。 2、每个元素为一个动画对象。

    _animationGroup

    _animationGroup: undefined | AnimationGroup[]

    动画组对象 animation group object
    1、gltf等模型使用

    _children

    _children: NodeObject[] = []

    子节点 child nodes

    _directInWorldSpace

    _directInWorldSpace: boolean = false

    直接在世界坐标下（不考虑层级树状关系），默认false

    _entity

    _entity: undefined | BaseEntity

    实体对象 entity object

    _id

    _id: number

    节点ID node ID

    _isDestroy

    _isDestroy: boolean = false

    _jointsMat

    _jointsMat: undefined | ArrayBuffer

    骨架皮肤数据 ArrayBuffer of jointsMat 1、有数据，则存在骨骼动画。 2、工作流(每个NodeObject的逆绑定矩阵（世界逆绑定矩阵）=NodeObject的matrixWorld*inverseBindMatrix) A、获得matrixWorld， B、根据jointsMat，计算出每个joint的world matrix。

    _manager

    _manager: undefined | ECSManager<RootGPU>

    _matrix

    _matrix: undefined | Float32Array<ArrayBufferLike>

    初始化矩阵

    _modelOrigin

    _modelOrigin: undefined | BaseModel

    模型对象 model object
    如果此节点为模型实例化的根节点，则_modelOrigin为模型对象。

    _morphTarget

    _morphTarget: undefined | ArrayBuffer

    morphTarget 目标值数据 ArrayBuffer of morphTargetMat 1、有数据，则存在morphTarget动画。

    _name

    _name: string

    节点名称 node name

    _parent

    _parent: undefined | NodeObject

    父节点 parent node

    _parentMatrixWorld

    _parentMatrixWorld: undefined | Float32Array<ArrayBufferLike>

    父空间的矩阵世界

    _particle

    _particle: undefined | BaseParticle[]

    粒子对象 particle object

    _physicBody

    _physicBody: undefined | PhysicBody

    物理体对象 physical body object

    _position

    _position: Float32Array = ...

    _positionOld

    _positionOld: undefined | Float32Array<ArrayBufferLike>

    _quaternion

    _quaternion: undefined | Float32Array<ArrayBufferLike>

    四元数

    _quaternionOld

    _quaternionOld: undefined | Float32Array<ArrayBufferLike>

    _readyForGPU

    _readyForGPU: boolean

    节点是否以及GPU准备好 node is ready of GPU

    _renderID

    _renderID: number

    renderID，use for pickup generate by stage

    _rodriguesRotation

    _rodriguesRotation:
        | undefined
        | [
            Float32Array<ArrayBufferLike>,
            Float32Array<ArrayBufferLike>,
            number,
            boolean,
        ]

    任意点的任意轴的罗德里格斯旋转(考虑_position位置) 1、数组第一个元素为旋转点，第二个元素为旋转轴 2、数组第三个元素为旋转角度 3、数组第四个元素为是否在世界坐标下旋转

    _rodriguesRotationOld

    _rodriguesRotationOld:
        | undefined
        | [
            Float32Array<ArrayBufferLike>,
            Float32Array<ArrayBufferLike>,
            number,
            boolean,
        ]

    _rotate

    _rotate: undefined | weVec4

    旋转：自身原点为中心( 不，考虑_position位置)

    _rotateOld

    _rotateOld: undefined | Float32Array<ArrayBufferLike>

    _scale

    _scale: Float32Array = ...

    _scaleOld

    _scaleOld: undefined | Float32Array<ArrayBufferLike>

    _skinAnimation

    _skinAnimation: SkinAnimation[] = []

    骨架动画数据 SkinAnimation object 目前只设计了一个蒙皮动画。同一节点上不存在多个蒙皮动画。

    _spaceType

    _spaceType: E_BVHSpaceType = E_BVHSpaceType.none

    BVH空间类型

    _state

    _state: E_lifeState = E_lifeState.unstart

    _weightMixAnimation

    _weightMixAnimation: undefined | WeightMixAnimation

    权重动画 weight animation object 1、有数据，则存在权重动画。权重动画存在于_animation[]中,这里是指针的概念。 2、工作流 update()，根据是否有权重动画，选择matrixWorld的更新方式。 3、如果存在多个权重动画组，这个标志为当前使用的权重动画组。

    asWhole: boolean = true

    是否作为一个整体渲染 1、BVH作为一个使用AABB 2、pickup使用一个RenderID

    currentScene: number = 0

    gltf当前场景索引

    DataLoader: ModelDataLoader
    dataTypeOfAttribute: "BOL" | "inModel" = "inModel"
    debug: boolean = false
    device: GPUDevice
    enable: boolean = true
    inputValues: I_Update
    instanceNodes: Map<any, I_gltfInstanceResource> = ...

    实例化gltf绑定动画与动画组的资源的map，key为节点实例

    lastUpdaeTime: number = 0
    mapList: { key: any; map?: string; type: string }[] = []
    matrix: Float32Array = ...

    local matrix

    matrixWorld: Float32Array = ...

    当前entity在世界坐标（层级的到root)，可以动态更新 1、在directInWorldSpace为true时，matrixWorld与matrix相同 2、在directInWorldSpace为false时，matrixWorld为matrix的累计乘积

    meshAndSkin: undefined | Map<number, number>
    meshAndSkinBundle: { meshID: number; nodeID: number; skinID: number }[] = []

    gltf模型中的mesh和skin的绑定 1、在initScene()中使用addNode()时，根据node的mesh和skin，push到meshAndSkinBundle中.

    modelData: any

    模型原始数据 20260226 ,逐步作废

    modelLoader: ModelDataLoader
    modelRes: { [key: string]: Map<any, any> } = ...

    模型资源

    needUpdateLocalMatrix: boolean = true

    是否需要更新本地矩阵

    needUpdateuserDefine: boolean = false

    是否用户自定义更新函数

    needUpdateuserDefineAtEnd: boolean = false

    是否用户自定义更新函数，在update()函数最后调用

    needUpdateWorldMatrix: boolean = true

    是否需要更新全局矩阵

    resourcesGPU: ResourceManagerOfGPU
    scene: Scene
    stageID: number = 0

    stageID

    type: string

    节点类型 node type

    url: string
    UUID: string

    节点UUID node UUID

    visible: boolean = true

    节点是否可见,如果不在root的树，则visible为false，但没有删除，还在资源池中 node visible

    worldPosition: Float32Array = ...

    在世界坐标下的位置(x,y,z)

    Accessors

    • get RodriguesAnyPoint(): | undefined
      | [
          Float32Array<ArrayBufferLike>,
          Float32Array<ArrayBufferLike>,
          number,
          boolean,
      ]

      Returns
          | undefined
          | [
              Float32Array<ArrayBufferLike>,
              Float32Array<ArrayBufferLike>,
              number,
              boolean,
          ]

    • set RodriguesAnyPoint(
          rodriguesRotation:
              | [
                  Float32Array<ArrayBufferLike>,
                  Float32Array<ArrayBufferLike>,
                  number,
                  boolean,
              ]
              | [weVec3, weVec3, number, boolean],
      ): void

      任意点的任意轴的罗德里格斯旋转 1、数组第一个元素为旋转点，第二个元素为旋转轴 2、数组第三个元素为旋转角度

      Parameters

      • rodriguesRotation:
            | [
                Float32Array<ArrayBufferLike>,
                Float32Array<ArrayBufferLike>,
                number,
                boolean,
            ]
            | [weVec3, weVec3, number, boolean]

      Returns void

    • set RodriguesZeroPoint(
          __namedParameters: [
              weVec3
              | Float32Array<ArrayBufferLike>,
              number,
              boolean,
          ],
      ): void

      旋转：以point(0,0,0)为原点为中心，考虑_position位置 1、数组第一个元素为旋转轴+旋转角度 2、数组第二个元素为是否在世界坐标下旋转

      Parameters

      • __namedParameters: [weVec3 | Float32Array<ArrayBufferLike>, number, boolean]

      Returns void

    Methods

    _destroy

    • 添加子节点

      1. 如果是子节点，直接添加到children中 A、camera B、light C、其他类型的NodeObject，直接添加到children中 model，particle 2、entity A. 如果是BaseEntity，通过新建参数， 并将entity附着到新建Node Object上。
        B. 如果是IV_Node，根据参数创建对应的Node Object； 如果存在entity，并将entity附着到NodeObject上。 C、将entity和node添加到entityManager中 3、如果不存在entity，将node添加到children中

      4、如果是Model，根据modelAttachValue创建对应的Node Instance

      Parameters

      Returns Promise<NodeObject>

      Promise

    • 销毁节点 1、递归销毁所有子节点 2、需要entityManager中移除entity;entity的updateSelf()会更新instance 相关 3、需要注销动画 4、需要注销骨骼动画 5、需要注销动画组 6、需要注销粒子系统 7、需要注销BVH和物理引擎中的相关数据

      Returns void

    • 注销场景 1、注销所有实体和camera

      用途： 1、在场景切换时，注销当前场景的所有实体和camera 2、不适用在gltf的销毁时，gltf的注销有RootGPU的destroy方法实现

      Returns void

    • Parameters

      • id: string | number
      • format: GPUTextureFormat = "rgba8unorm-srgb"
      • premultipliedAlpha: boolean = false

      Returns Promise<undefined | GPUTexture>

    • 获取顶点数组

      Parameters

      • primitive: any

        primitive

      • meshID: string

        meshID

      • primitiveID: string

        primitiveID

      Returns Promise<
          {
              drawMode: I_drawModeIndexed
              | I_drawMode;
              indecis: number[];
              stripIndexFormat: GPUIndexFormat;
          },
      >

      顶点数组数据

    • 获取primitive的索引缓冲区和drawMode

      Parameters

      • primitive: any

        primitive

      • meshID: string

        meshID

      • primitiveID: string

        primitiveID

      Returns Promise<
          {
              drawMode: I_drawModeIndexed
              | I_drawMode;
              indecis: undefined | T_indexAttribute;
              stripIndexFormat: GPUIndexFormat;
          },
      >

      索引缓冲区和drawMode

    • 获取节点的morph target 数量

      Parameters

      • nodeID: number

        节点索引

      Returns number

      morph target 数量

    • 获取资源,根据资源类型(T_ModelResKind)和资源id获取资源

      Type Parameters

      • T

      Parameters

      • kind: T_ModelResKind

        资源类型

      • id: string | number

        资源id

      • Optionaloptione: { format?: GPUTextureFormat; premultipliedAlpha?: boolean }

      Returns Promise<false | T>

      资源或false

    • Parameters

      • id: number
      • format: GPUTextureFormat = "rgba8unorm-srgb"
      • premultipliedAlpha: boolean = false

      Returns Promise<Texture>

    • 获取顶点数组

      Parameters

      • primitive: any
      • meshID: string
      • primitiveID: string

      Returns Promise<{ [name: string]: number[] }>

      顶点数组数据

    • 获取primitive的顶点数据

      Parameters

      • primitive: any

        primitive数据

      • meshID: string

        meshID

      • primitiveID: string

        primitiveID

      Returns Promise<{ [name: string]: I_vsGPUBufferBundle }>

      顶点数据集合

    • 初始化模型数据,

      1. 解析模型数据,GPUBuffer(attributes),GPUTexture,image,
      2. 初始化模型数据,meshes,materials,animations,cameras
      3. 初始化模型数据,

      Parameters

      Returns Promise<void>

    • 初始化默认材质 1、初始化默认材质 2、按照gltf的material，初始化材质

      Returns Promise<void>

    • 初始化场景入口。 1、gltf会新建一个node object作为场景节点，并返回 2、根据场景索引，初始化场景中的节点 3、初始化节点是递归操作（包括:mesh、camera） 4、如果有animation，则在新的Node Object上初始化animation，并注册到animationManager 5、如果有animation，则在新的Node Object上初始化animation group，并注册到animationGroupManager

      Parameters

      Returns Promise<NodeObject>

      场景节点实例

    • 初始化采样器 1、初始化默认采样器：linear 2、按照gltf的sampler，初始化采样器

      Returns void

    • 初始化纹理 1、按照gltf的texture，初始化纹理

      Returns Promise<void>

    • 判断primitive是否有morph target

      Parameters

      • primitive: any

        primitive

      Returns boolean

      boolean 是否有morph target

    • 三段式初始化的第三步：readyForGPU 当前对象的GPU已经可以用时，执行此调用。 when GPU is ready, call this function

      Returns Promise<any>

    • remove child from this node 移除子节点

      Parameters

      • child: NodeObject

        子节点

      • onlyOne: boolean = true

        是否只移除一个子节点，默认:true 只删除单个节点，删除后，从children中移除 删除所有子节点，不从children中移除（防止for失效），最后由removeChildren()移除

      Returns boolean

      是否移除成功

    • 替换pos的位置（matrix的:12,13,14），其他的matrix数据不变， 将entity的位置变为POS,等价wgpu-matrix的mat4的translation，是替换，不是增加

      Parameters

      • pos: Float32Array

        :Vec3

      Returns void

    • 在现有matrix（原有的position）上增加pos的xyz， 将entity的矩阵应用POS的位置变换，是在原有矩阵上增加

      Parameters

      • pos: Float32Array

        :Vec3

      Returns void

    • 更新 1、判断是否需要更新（时间上） 2、调用super.update()更新， A、NodeSpace：更新空间属性 B、RootGPU：更新user call back，调用最终子类更新自身updateSelf() 3、更新NodeObject的属性 4、更新子节点

      Parameters

      • clock: Clock

        Clock 时钟

      • updateSelftFN: boolean = true

        是否调用自身的updateSelf(),默认=true 此参数可以方便子类重载时，决定调用的updateSelf()的时间顺序或是否调用updateSelft()

      Returns boolean

    • 1、矩阵操作一般来说： CPU中：SRT(右乘)，行向量列矩阵=行向量 GPU中: TRS(左乘)，列矩阵列向量=列向量

      2、更新矩阵的顺序是先进行线性变换，再进行位置变换。其实是没有影响，线性工作在3x3矩阵，位置变换在[12,13,14]，列优先。

      3、旋转部分，四元数优先，然后后轴旋转。 A、在模型gltf中，旋转使用四元数。

      Returns Float32Array

    • 更新世界位置 1、entity的worldPosition 是entity的position在世界坐标系下的位置 2、如果没有提供世界矩阵，默认使用entity的matrixWorld

      Parameters

      • Optional_matrixWorld: Float32Array<ArrayBufferLike>

        世界矩阵

      Returns Float32Array

      世界位置

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Accessors
    Methods
    _destroyaddaddChildattachEntitycheckNeedUpdateLocalMatrixcheckNeedUpdateWorldMatrixcleanInstanceResourcedestroydestroyScenedetachDatagetAccessorgetEnableAndParentsgetGPUTexturegetIndecisArrayOfPrimitivegetIndecisOfPrimitivegetMorphTargetsForNodegetNodeObjectByIDgetNodeObjectByNamegetNodeObjectByUUIDgetResgetTexturegetVerticesArrayOfPrimitivegetVerticesOfPrimitivegetVisibleAndParentsinitinitAnimationsForInstanceinitCamerasForInstanceinitDatainitGPUTexturesinitInstanceinitMaterialsinitMeshesinitModelSceneinitNodeObjectinitSamplersinitSkinsForInstanceinitTextureInfoinitTexturesisDestroyloadJSONmeshHasMorphTargetmeshHasSkinsquaternionreadyForGPUremoveremoveChildremoveChildrenrodriguesRotationrotaterotateAxisrotateXrotateYrotateZsaveJSONscalesetRootENVsetTranslationtranslatetranslationtraverseupdateupdateMatrixupdateMatrixWorldupdateMatrixWorldFroceupdateParentOnlyupdateSelfupdateSelfAttributeupdateWorldPosition