Class Gltf2Importer

Merges default options with glTF asset extras and user-provided options. Handles loader extension initialization based on the extension name.

Imports and processes a binary glTF (.glb) file from ArrayBuffer. Validates the GLB format, extracts JSON and binary chunks, and processes the content.

Throws

Will throw if the GLB format is invalid or unsupported

Imports and processes a JSON glTF (.gltf) file with external resources. Handles resource loading from external files and applies processing options.

Internal method to import glTF2 data from ArrayBuffer, handling both .gltf and .glb formats. Determines the file format by checking the magic number and processes accordingly.

Resolves dependencies for glTF accessors including buffer views and sparse data. Links accessors to their underlying buffer data for vertex attributes and indices.

Resolves dependencies for glTF animations including channels, samplers, and targets. Handles different interpolation modes and sets up animation data structures.

Resolves dependencies for glTF buffer views by linking them to their buffers. Establishes the connection between buffer views and the actual buffer data.

Resolves dependencies for glTF skins including skeleton, joints, and inverse bind matrices. Sets up the skeletal animation structure with proper object references.

Resolves dependencies for glTF materials including all texture references. Handles PBR textures, normal maps, occlusion, emissive, and various extensions like clearcoat, transmission, sheen, specular, iridescence, anisotropy, and MToon.

Resolves dependencies for glTF meshes including materials, attributes, indices, and morph targets. Handles material variants and creates direct object references for efficient access.

Resolves dependencies for glTF nodes including hierarchy, meshes, skins, cameras, and lights. Establishes parent-child relationships and links to associated objects.

Resolves dependencies for glTF scenes by linking node references. Creates nodesObjects array with direct references to node objects.

Resolves dependencies for glTF textures including samplers and image sources. Handles KHR_texture_basisu extension for Basis Universal texture compression.

Orchestrates the loading of resources and JSON content processing. Creates promises for both resource loading and JSON dependency resolution.

Processes the glTF JSON content by resolving all internal dependencies. Sets up object references between scenes, nodes, meshes, materials, textures, etc.

Loads all external resources referenced by the glTF file including buffers and images. Handles various URI formats including data URIs, file references, and embedded data. Supports multiple image formats including Basis Universal and KTX2 compression.

Merges extended JSON data into the main glTF JSON structure. Supports ArrayBuffer, string, or object formats for extended data.

Imports glTF2 data from a collection of ArrayBuffer files. Automatically identifies the main glTF or GLB file from the provided files.

Throws

Will reject if no glTF or GLB file is found in the provided files

Example

const files = {
  'model.gltf': gltfBuffer,
  'texture.jpg': textureBuffer
};
const gltfData = await Gltf2Importer.importFromArrayBuffers(files);
Copy

Imports a glTF2 file from a URL and processes it into RnM2 format. Automatically detects whether the file is in .gltf or .glb format.

Throws

Will reject if the file cannot be fetched or processed

Example

const gltfData = await Gltf2Importer.importFromUrl('path/to/model.gltf', {
  cameraComponent: CameraComponent,
  lightComponent: LightComponent
});
Copy