@loaders.gl/gltf 3.1.0-alpha.4 → 3.1.0-beta.3

package/dist/lib/api/gltf-extensions.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.decodeExtensions = exports.preprocessExtensions = exports.EXTENSIONS = void 0;
+// GLTF 1.0 extensions (decode only)
+// import * as KHR_binary_gltf from './KHR_draco_mesh_compression';
+// GLTF 2.0 Khronos extensions (decode/encode)
+const EXT_meshopt_compression = __importStar(require("../extensions/EXT_meshopt_compression"));
+const EXT_texture_webp = __importStar(require("../extensions/EXT_texture_webp"));
+const KHR_texture_basisu = __importStar(require("../extensions/KHR_texture_basisu"));
+const KHR_draco_mesh_compression = __importStar(require("../extensions/KHR_draco_mesh_compression"));
+// Deprecated. These should be handled by rendering library (e.g. luma.gl), not the loader.
+const KHR_lights_punctual = __importStar(require("../extensions/deprecated/KHR_lights_punctual"));
+const KHR_materials_unlit = __importStar(require("../extensions/deprecated/KHR_materials_unlit"));
+const KHR_techniques_webgl = __importStar(require("../extensions/deprecated/KHR_techniques_webgl"));
+/**
+ * List of extensions processed by the GLTFLoader
+ * Note that may extensions can only be handled on the rendering stage and are left out here
+ * These are just extensions that can be handled fully or partially during loading.
+ */
+exports.EXTENSIONS = [
+    // 1.0
+    // KHR_binary_gltf is handled separately - must be processed before other parsing starts
+    // KHR_binary_gltf,
+    // 2.0
+    EXT_meshopt_compression,
+    EXT_texture_webp,
+    // Basisu should come after webp, we want basisu to be preferred if both are provided
+    KHR_texture_basisu,
+    KHR_draco_mesh_compression,
+    KHR_lights_punctual,
+    KHR_materials_unlit,
+    KHR_techniques_webgl
+];
+/** Call before any resource loading starts */
+function preprocessExtensions(gltf, options = {}, context) {
+    const extensions = exports.EXTENSIONS.filter((extension) => useExtension(extension.name, options));
+    for (const extension of extensions) {
+        extension.preprocess?.(gltf, options, context);
+    }
+}
+exports.preprocessExtensions = preprocessExtensions;
+/** Call after resource loading */
+async function decodeExtensions(gltf, options = {}, context) {
+    const extensions = exports.EXTENSIONS.filter((extension) => useExtension(extension.name, options));
+    for (const extension of extensions) {
+        // Note: We decode async extensions sequentially, this might not be necessary
+        // Currently we only have Draco, but when we add Basis we may revisit
+        await extension.decode?.(gltf, options, context);
+    }
+}
+exports.decodeExtensions = decodeExtensions;
+function useExtension(extensionName, options) {
+    const excludes = options?.gltf?.excludeExtensions || {};
+    const exclude = extensionName in excludes && !excludes[extensionName];
+    return !exclude;
+}

package/dist/lib/api/gltf-scenegraph.d.ts

@@ -0,0 +1,183 @@
+import type { GLTF, GLTFScene, GLTFNode, GLTFMesh, GLTFSkin, GLTFMaterial, GLTFAccessor, GLTFSampler, GLTFTexture, GLTFImage, GLTFBuffer, GLTFBufferView } from '../types/gltf-types';
+declare type GLTFWithBuffers = {
+    json: GLTF;
+    buffers: any[];
+    binary?: ArrayBuffer;
+};
+declare type Extension = {
+    [key: string]: any;
+};
+/**
+ * Class for structured access to GLTF data
+ */
+export default class GLTFScenegraph {
+    gltf: GLTFWithBuffers;
+    sourceBuffers: any[];
+    byteLength: number;
+    constructor(gltf?: {
+        json: GLTF;
+        buffers?: any[];
+    });
+    get json(): GLTF;
+    getApplicationData(key: string): {
+        [key: string]: any;
+    };
+    getExtraData(key: string): {
+        [key: string]: any;
+    };
+    getExtension<T = Extension>(extensionName: string): T | null;
+    getRequiredExtension<T = Extension>(extensionName: string): T | null;
+    getRequiredExtensions(): string[];
+    getUsedExtensions(): string[];
+    getObjectExtension<T = Extension>(object: {
+        [key: string]: any;
+    }, extensionName: string): T | null;
+    getScene(index: number): GLTFScene;
+    getNode(index: number): GLTFNode;
+    getSkin(index: number): GLTFSkin;
+    getMesh(index: number): GLTFMesh;
+    getMaterial(index: number): GLTFMaterial;
+    getAccessor(index: number): GLTFAccessor;
+    getTexture(index: number): GLTFTexture;
+    getSampler(index: number): GLTFSampler;
+    getImage(index: number): GLTFImage;
+    getBufferView(index: number | object): GLTFBufferView;
+    getBuffer(index: number): GLTFBuffer;
+    getObject(array: string, index: number | object): object;
+    /**
+     * Accepts buffer view index or buffer view object
+     * @returns a `Uint8Array`
+     */
+    getTypedArrayForBufferView(bufferView: number | object): Uint8Array;
+    /** Accepts accessor index or accessor object
+     * @returns a typed array with type that matches the types
+     */
+    getTypedArrayForAccessor(accessor: number | object): any;
+    /** accepts accessor index or accessor object
+     * returns a `Uint8Array`
+     */
+    getTypedArrayForImageData(image: number | object): Uint8Array;
+    /**
+     * Add an extra application-defined key to the top-level data structure
+     */
+    addApplicationData(key: string, data: object): GLTFScenegraph;
+    /**
+     * `extras` - Standard GLTF field for storing application specific data
+     */
+    addExtraData(key: string, data: object): GLTFScenegraph;
+    addObjectExtension(object: object, extensionName: string, data: object): GLTFScenegraph;
+    setObjectExtension(object: object, extensionName: string, data: object): void;
+    removeObjectExtension(object: object, extensionName: string): object;
+    /**
+     * Add to standard GLTF top level extension object, mark as used
+     */
+    addExtension(extensionName: string, extensionData?: object): object;
+    /**
+     * Standard GLTF top level extension object, mark as used and required
+     */
+    addRequiredExtension(extensionName: any, extensionData?: object): object;
+    /**
+     * Add extensionName to list of used extensions
+     */
+    registerUsedExtension(extensionName: string): void;
+    /**
+     * Add extensionName to list of required extensions
+     */
+    registerRequiredExtension(extensionName: string): void;
+    /**
+     * Removes an extension from the top-level list
+     */
+    removeExtension(extensionName: string): void;
+    /**
+     *  Set default scene which is to be displayed at load time
+     */
+    setDefaultScene(sceneIndex: number): void;
+    /**
+     * @todo: add more properties for scene initialization:
+     *   name`, `extensions`, `extras`
+     *   https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#reference-scene
+     */
+    addScene(scene: {
+        nodeIndices: number[];
+    }): number;
+    /**
+     * @todo: add more properties for node initialization:
+     *   `name`, `extensions`, `extras`, `camera`, `children`, `skin`, `rotation`, `scale`, `translation`, `weights`
+     *   https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#node
+     */
+    addNode(node: {
+        meshIndex: number;
+        matrix: number[];
+    }): number;
+    /** Adds a mesh to the json part */
+    addMesh(mesh: {
+        attributes: object;
+        indices: object;
+        material: number;
+        mode: number;
+    }): number;
+    addPointCloud(attributes: object): number;
+    /**
+     * Adds a binary image. Builds glTF "JSON metadata" and saves buffer reference
+     * Buffer will be copied into BIN chunk during "pack"
+     * Currently encodes as glTF image
+     * @param imageData
+     * @param mimeType
+     */
+    addImage(imageData: any, mimeTypeOpt?: string): number;
+    /**
+     * Add one untyped source buffer, create a matching glTF `bufferView`, and return its index
+     * @param buffer
+     */
+    addBufferView(buffer: any): number;
+    /**
+     * Adds an accessor to a bufferView
+     * @param bufferViewIndex
+     * @param accessor
+     */
+    addAccessor(bufferViewIndex: number, accessor: object): number;
+    /**
+     * Add a binary buffer. Builds glTF "JSON metadata" and saves buffer reference
+     * Buffer will be copied into BIN chunk during "pack"
+     * Currently encodes buffers as glTF accessors, but this could be optimized
+     * @param sourceBuffer
+     * @param accessor
+     */
+    addBinaryBuffer(sourceBuffer: any, accessor?: object): number;
+    /**
+     * Adds a texture to the json part
+     * @todo: add more properties for texture initialization
+     * `sampler`, `name`, `extensions`, `extras`
+     * https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#texture
+     */
+    addTexture(texture: {
+        imageIndex: number;
+    }): number;
+    /** Adds a material to the json part */
+    addMaterial(pbrMaterialInfo: Object): number;
+    /** Pack the binary chunk */
+    createBinaryChunk(): void;
+    _removeStringFromArray(array: any, string: any): void;
+    /**
+     * Add attributes to buffers and create `attributes` object which is part of `mesh`
+     */
+    _addAttributes(attributes?: {}): {};
+    /**
+     * Add indices to buffers
+     */
+    _addIndices(indices: any): number;
+    /**
+     * Deduce gltf specific attribue name from input attribute name
+     */
+    _getGltfAttributeName(attributeName: any): any;
+    /**
+     * Calculate `min` and `max` arrays of accessor according to spec:
+     * https://github.com/KhronosGroup/glTF/tree/master/specification/2.0#reference-accessor
+     */
+    _getAccessorMinMax(buffer: any, size: any): {
+        min: null;
+        max: null;
+    };
+}
+export {};
+//# sourceMappingURL=gltf-scenegraph.d.ts.map

package/dist/lib/api/gltf-scenegraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-scenegraph.d.ts","sourceRoot":"","sources":["../../../src/lib/api/gltf-scenegraph.ts"],"names":[],"mappings":"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"}