@certe/atmos-assets 0.1.0

package/dist/model-instantiate.js

@@ -0,0 +1,203 @@
+/**
+ * Instantiate a ModelAsset into the engine's GameObject hierarchy.
+ * Uploads textures to the GPU and creates Meshes + Materials + MeshRenderers.
+ * Supports skeletal animation via SkinnedMeshRenderer + AnimationMixer.
+ */
+import { GameObject } from '@certe/atmos-core';
+import { createMesh, createMaterial, createTextureFromRGBA, decodeImageToRGBA, MeshRenderer, SkinnedMeshRenderer, SKINNED_VERTEX_STRIDE_FLOATS, } from '@certe/atmos-renderer';
+import { AnimationMixer, AnimationHandler, createSkeleton, createAnimationClip, } from '@certe/atmos-animation';
+/**
+ * Create a GameObject tree from a ModelAsset.
+ * Decodes and uploads textures, creates GPU meshes and materials.
+ * Automatically sets up SkinnedMeshRenderer + AnimationMixer for skinned models.
+ * Returns the root GameObject (caller adds to scene).
+ */
+export async function instantiateModel(asset, options) {
+    const { device } = options.renderSystem;
+    // 1. Decode and upload textures
+    const gpuTextures = await uploadTextures(asset, device);
+    // 2. Create materials (with texture references)
+    const materials = asset.materials.map(mat => {
+        const albedoTex = mat.albedoTextureIndex !== null
+            ? gpuTextures[mat.albedoTextureIndex] ?? undefined
+            : undefined;
+        return createMaterial({
+            ...mat.params,
+            albedoTexture: albedoTex,
+        });
+    });
+    // 3. Create GPU meshes + material index lookup
+    const meshes = [];
+    const meshMatIndices = [];
+    for (const m of asset.meshes) {
+        const stride = m.skinned ? SKINNED_VERTEX_STRIDE_FLOATS : 8;
+        const gpuMesh = createMesh(device, m.geometry.vertices, m.geometry.indices, stride);
+        gpuMesh.bounds = m.geometry.bounds;
+        meshes.push(gpuMesh);
+        meshMatIndices.push(m.materialIndex);
+    }
+    // 4. Build GameObject tree from nodes
+    const ctx = {
+        meshes, materials, meshMatIndices,
+        renderSystem: options.renderSystem,
+        asset,
+    };
+    if (asset.rootNodes.length === 1) {
+        const root = buildNode(asset.rootNodes[0], ctx);
+        setupSkinning(root, asset, ctx);
+        return root;
+    }
+    // Multiple root nodes → wrap in a parent
+    const root = new GameObject(asset.name);
+    for (const node of asset.rootNodes) {
+        const child = buildNode(node, ctx);
+        child.setParent(root);
+    }
+    setupSkinning(root, asset, ctx);
+    return root;
+}
+async function uploadTextures(asset, device) {
+    const results = [];
+    for (const tex of asset.textures) {
+        const blob = new Blob([tex.data], { type: tex.mimeType });
+        const decoded = await decodeImageToRGBA(blob);
+        results.push(createTextureFromRGBA(device, decoded.data, decoded.width, decoded.height));
+    }
+    return results;
+}
+function buildNode(node, ctx) {
+    const go = new GameObject(node.name);
+    // Apply TRS
+    const t = go.transform;
+    t.setPosition(node.position[0], node.position[1], node.position[2]);
+    t.setRotation(node.rotation[0], node.rotation[1], node.rotation[2], node.rotation[3]);
+    t.setScale(node.scale[0], node.scale[1], node.scale[2]);
+    // Attach meshes
+    if (node.meshIndices.length === 1) {
+        attachMesh(go, node.meshIndices[0], node, ctx);
+    }
+    else if (node.meshIndices.length > 1) {
+        for (const mi of node.meshIndices) {
+            const child = new GameObject(`${node.name}_mesh${mi}`);
+            child.setParent(go);
+            attachMesh(child, mi, node, ctx);
+        }
+    }
+    // Recurse children
+    for (const childNode of node.children) {
+        const childGo = buildNode(childNode, ctx);
+        childGo.setParent(go);
+    }
+    return go;
+}
+function attachMesh(go, mi, node, ctx) {
+    const mesh = ctx.meshes[mi];
+    if (!mesh)
+        return;
+    const modelMesh = ctx.asset.meshes[mi];
+    const matIdx = ctx.meshMatIndices[mi] ?? 0;
+    const material = matIdx < ctx.materials.length ? ctx.materials[matIdx] : ctx.materials[0];
+    if (modelMesh?.skinned && node.skinIndex !== undefined && node.skinIndex < ctx.asset.skins.length) {
+        const skin = ctx.asset.skins[node.skinIndex];
+        const jointCount = skin.jointNodeIndices.length;
+        const smr = go.addComponent(SkinnedMeshRenderer);
+        smr.init(ctx.renderSystem, mesh, jointCount, material);
+    }
+    else {
+        const mr = go.addComponent(MeshRenderer);
+        mr.init(ctx.renderSystem, mesh, material);
+    }
+}
+/**
+ * After the full node tree is built, set up AnimationMixer on nodes that have skins.
+ * This must be done after building the tree so we can resolve joint node references.
+ */
+function setupSkinning(root, asset, _ctx) {
+    if (asset.skins.length === 0)
+        return;
+    const allObjects = collectAllObjects(root);
+    for (const go of allObjects) {
+        const smr = go.getComponent(SkinnedMeshRenderer);
+        if (!smr)
+            continue;
+        const skinIndex = findSkinIndexForObject(go, asset);
+        if (skinIndex === undefined)
+            continue;
+        const skin = asset.skins[skinIndex];
+        if (!skin)
+            continue;
+        // Create skeleton using pre-computed parent indices and names
+        const joints = skin.jointParents.map((parentIdx, i) => ({
+            name: skin.jointNames[i] ?? `joint_${i}`,
+            parentIndex: parentIdx,
+        }));
+        const skeleton = createSkeleton(joints, skin.inverseBindMatrices, skin.restT, skin.restR, skin.restS);
+        const mixer = go.addComponent(AnimationMixer);
+        mixer.skeleton = skeleton;
+        // Convert model animations to clips (remap node indices → joint indices)
+        const nodeToJoint = new Map();
+        for (let ji = 0; ji < skin.jointNodeIndices.length; ji++) {
+            nodeToJoint.set(skin.jointNodeIndices[ji], ji);
+        }
+        for (const anim of asset.animations) {
+            const tracks = [];
+            for (const track of anim.tracks) {
+                const jointIndex = nodeToJoint.get(track.targetNode);
+                if (jointIndex === undefined)
+                    continue;
+                tracks.push({
+                    jointIndex,
+                    channel: track.path,
+                    interpolation: track.interpolation,
+                    times: track.times,
+                    values: track.values,
+                });
+            }
+            if (tracks.length > 0) {
+                const clip = createAnimationClip(anim.name, tracks);
+                mixer.addClip(clip);
+                if (!mixer.initialClip) {
+                    mixer.initialClip = clip.name;
+                }
+                if (mixer.layers.length === 0) {
+                    mixer.play(clip);
+                }
+            }
+        }
+    }
+    // Add AnimationHandler on root to aggregate all child mixers
+    if (!root.getComponent(AnimationHandler)) {
+        const handler = root.addComponent(AnimationHandler);
+        // Pick first clip name found across all mixers
+        const allMixers = collectAllObjects(root)
+            .map(go => go.getComponent(AnimationMixer))
+            .filter((m) => m !== null);
+        for (const mixer of allMixers) {
+            if (mixer.initialClip) {
+                handler.initialClip = mixer.initialClip;
+                break;
+            }
+        }
+    }
+}
+function collectAllObjects(root) {
+    const result = [root];
+    for (const child of root.children) {
+        result.push(...collectAllObjects(child));
+    }
+    return result;
+}
+function findSkinIndexForObject(go, asset) {
+    return findSkinInNodes(go.name, asset.rootNodes);
+}
+function findSkinInNodes(name, nodes) {
+    for (const node of nodes) {
+        if (node.name === name && node.skinIndex !== undefined)
+            return node.skinIndex;
+        const found = findSkinInNodes(name, node.children);
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+//# sourceMappingURL=model-instantiate.js.map

package/dist/model-instantiate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-instantiate.js","sourceRoot":"","sources":["../src/model-instantiate.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,87 @@
+import type { GeometryData } from '@certe/atmos-renderer';
+import type { MaterialParams } from '@certe/atmos-renderer';
+/** A single mesh extracted from a model file. */
+export interface ModelMesh {
+    name: string;
+    geometry: GeometryData;
+    materialIndex: number;
+    /** True if vertex data includes joint indices + weights (52B skinned format). */
+    skinned: boolean;
+    /** Index into ModelAsset.skins (only set if skinned). */
+    skinIndex?: number;
+}
+/** Raw texture data extracted from a model file (CPU-side, not yet uploaded). */
+export interface ModelTexture {
+    name: string;
+    data: Uint8Array;
+    width: number;
+    height: number;
+    mimeType: string;
+}
+/** Material extracted from a model file. */
+export interface ModelMaterial {
+    name: string;
+    params: MaterialParams;
+    albedoTextureIndex: number | null;
+}
+/** A node in the model's scene hierarchy. */
+export interface ModelNode {
+    name: string;
+    meshIndices: number[];
+    position: [number, number, number];
+    rotation: [number, number, number, number];
+    scale: [number, number, number];
+    children: ModelNode[];
+    /** Index into ModelAsset.skins (set when the node references a glTF skin). */
+    skinIndex?: number;
+}
+/** Skin data extracted from a model file (joint hierarchy + inverse bind matrices). */
+export interface ModelSkin {
+    name: string;
+    /** Indices into the node array, identifying which nodes are joints. */
+    jointNodeIndices: number[];
+    /** Flat Float32Array: jointCount * 16 floats (one mat4 per joint). */
+    inverseBindMatrices: Float32Array;
+    /** Parent joint index for each joint (-1 = root). Pre-computed from node hierarchy. */
+    jointParents: number[];
+    /** Node names for each joint, indexed same as jointNodeIndices. */
+    jointNames: string[];
+    /** Rest-pose local translations: jointCount * 3 floats. */
+    restT: Float32Array;
+    /** Rest-pose local rotations (quaternions): jointCount * 4 floats. */
+    restR: Float32Array;
+    /** Rest-pose local scales: jointCount * 3 floats. */
+    restS: Float32Array;
+}
+/** A single animation track targeting one node's T/R/S channel. */
+export interface ModelAnimationTrack {
+    /** Index into the model's node array. */
+    targetNode: number;
+    /** Which channel: 'translation' | 'rotation' | 'scale' */
+    path: 'translation' | 'rotation' | 'scale';
+    /** Interpolation mode. */
+    interpolation: 'LINEAR' | 'STEP';
+    /** Keyframe timestamps (seconds). */
+    times: Float32Array;
+    /** Keyframe values (3 or 4 floats per keyframe). */
+    values: Float32Array;
+}
+/** A named animation extracted from a model file. */
+export interface ModelAnimation {
+    name: string;
+    tracks: ModelAnimationTrack[];
+}
+/**
+ * Format-agnostic, GPU-free model representation.
+ * Parse off the main thread, then instantiate on the GPU thread.
+ */
+export interface ModelAsset {
+    name: string;
+    meshes: ModelMesh[];
+    materials: ModelMaterial[];
+    textures: ModelTexture[];
+    rootNodes: ModelNode[];
+    skins: ModelSkin[];
+    animations: ModelAnimation[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uFAAuF;AACvF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,sEAAsE;IACtE,mBAAmB,EAAE,YAAY,CAAC;IAClC,uFAAuF;IACvF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mEAAmE;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2DAA2D;IAC3D,KAAK,EAAE,YAAY,CAAC;IACpB,sEAAsE;IACtE,KAAK,EAAE,YAAY,CAAC;IACpB,qDAAqD;IACrD,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,aAAa,GAAG,UAAU,GAAG,OAAO,CAAC;IAC3C,0BAA0B;IAC1B,aAAa,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,oDAAoD;IACpD,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@certe/atmos-assets",
+  "description": "glTF 2.0 / GLB asset pipeline for the Atmos Engine",
+  "version": "0.1.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/certesolutions-cyber/atmos.git",
+    "directory": "packages/assets"
+  },
+  "homepage": "https://github.com/certesolutions-cyber/atmos",
+  "license": "GPL-3.0-or-later",
+  "keywords": ["gltf", "glb", "asset-pipeline", "game-engine", "3d-model", "atmos"],
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "publishConfig": {
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts"
+  },
+  "files": ["dist", "!dist/__tests__", "package.json", "README.md", "LICENCE"],
+  "dependencies": {
+    "@certe/atmos-core": "^0.1.0",
+    "@certe/atmos-math": "^0.1.0",
+    "@certe/atmos-renderer": "^0.1.0",
+    "@certe/atmos-animation": "^0.1.0"
+  },
+  "scripts": {
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+export { parseGltfModel } from './gltf-scene.js';
+export { instantiateModel } from './model-instantiate.js';
+export type { InstantiateOptions, InstantiateContext } from './model-instantiate.js';
+export type {
+  ModelAsset,
+  ModelMesh,
+  ModelMaterial,
+  ModelTexture,
+  ModelNode,
+  ModelSkin,
+  ModelAnimation,
+  ModelAnimationTrack,
+} from './types.js';
+export { parseGlb, parseGltfJson, readAccessor, readBufferView } from './gltf-parser.js';
+export type { GltfDocument, GltfJson } from './gltf-parser.js';
+export { extractSkins } from './gltf-skin.js';
+export { extractAnimations } from './gltf-animation.js';