@adobe/data-gpu 0.9.69

package/dist/graphics/rendering/material-gpu/material-gpu-plugin.d.ts

@@ -0,0 +1,259 @@
+import { type MaterialArrays } from "./material-arrays.js";
+/**
+ * materialGpu — derives the shared GPU material set from the `Material`
+ * registry. Each authored material is assigned one array layer; its factors go
+ * into the palette buffer and its maps are fetched + blitted into that layer.
+ *
+ * Incremental and cached: the arrays / palette / bind group are built once, and
+ * a layer is assigned only to a material that doesn't have one yet (`_layerIndex`
+ * excluded). Materials are added rarely and edited never, so steady state does
+ * no work. The renderer (P3) binds `_materialBindGroup` once and selects a
+ * material per instance by `_layerIndex`.
+ */
+export declare const materialGpu: {
+    readonly components: {} & {
+        readonly material: {
+            readonly type: "integer";
+            readonly minimum: -2147483648;
+            readonly maximum: 2147483647;
+            readonly default: number;
+        };
+        readonly name: {
+            readonly type: "string";
+        };
+        readonly density: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly restitution: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly friction: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly compliance: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly heatCapacity: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly baseColorFactor: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 4;
+            readonly maxItems: 4;
+            readonly default: readonly [0, 0, 0, 0];
+        };
+        readonly emissiveFactor: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly metallicFactor: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly roughnessFactor: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly normalScale: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly occlusionStrength: {
+            readonly type: "number";
+            readonly precision: 1;
+            readonly default: number;
+        };
+        readonly baseColorUrl: {
+            readonly type: "string";
+        };
+        readonly metallicRoughnessUrl: {
+            readonly type: "string";
+        };
+        readonly normalUrl: {
+            readonly type: "string";
+        };
+        readonly occlusionUrl: {
+            readonly type: "string";
+        };
+        readonly emissiveUrl: {
+            readonly type: "string";
+        };
+    } & {
+        readonly _layerIndex: {
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 4294967295;
+            readonly default: number;
+        };
+    };
+    readonly resources: {
+        readonly frameTime: {
+            readonly default: import("../../../core/frame-time/public.js");
+            readonly transient: true;
+        };
+    } & {
+        readonly schedulerState: {
+            readonly default: import("@adobe/data/ecs").SchedulerState;
+        };
+    } & {
+        readonly device: {
+            readonly default: GPUDevice | null;
+            readonly transient: true;
+        };
+        readonly commandEncoder: {
+            readonly default: GPUCommandEncoder | null;
+            readonly transient: true;
+        };
+    } & {
+        readonly materials: {
+            readonly default: Record<string, number>;
+        };
+    } & {
+        readonly _materialArrays: {
+            readonly default: MaterialArrays | null;
+            readonly transient: true;
+        };
+        readonly _materialPalette: {
+            readonly default: GPUBuffer | null;
+            readonly transient: true;
+        };
+        readonly _materialBindGroup: {
+            readonly default: GPUBindGroup | null;
+            readonly transient: true;
+        };
+    };
+    readonly archetypes: {} & {
+        readonly Material: readonly ["name", "density", "restitution", "friction", "compliance", "heatCapacity", "baseColorFactor", "emissiveFactor", "metallicFactor", "roughnessFactor", "normalScale", "occlusionStrength", "baseColorUrl", "metallicRoughnessUrl", "normalUrl", "occlusionUrl", "emissiveUrl"];
+    } & {};
+    readonly transactions: {} & {} & {
+        readonly seedStandardMaterials: (t: import("@adobe/data/ecs").TransactionContext<import("@adobe/data/schema").FromSchemas<{
+            readonly material: {
+                readonly type: "integer";
+                readonly minimum: -2147483648;
+                readonly maximum: 2147483647;
+                readonly default: number;
+            };
+            readonly name: {
+                readonly type: "string";
+            };
+            readonly density: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly restitution: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly friction: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly compliance: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly heatCapacity: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly baseColorFactor: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 4;
+                readonly maxItems: 4;
+                readonly default: readonly [0, 0, 0, 0];
+            };
+            readonly emissiveFactor: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                    readonly precision: 1;
+                    readonly default: number;
+                };
+                readonly minItems: 3;
+                readonly maxItems: 3;
+                readonly default: readonly [0, 0, 0];
+            };
+            readonly metallicFactor: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly roughnessFactor: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly normalScale: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly occlusionStrength: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly baseColorUrl: {
+                readonly type: "string";
+            };
+            readonly metallicRoughnessUrl: {
+                readonly type: "string";
+            };
+            readonly normalUrl: {
+                readonly type: "string";
+            };
+            readonly occlusionUrl: {
+                readonly type: "string";
+            };
+            readonly emissiveUrl: {
+                readonly type: "string";
+            };
+        }>, import("@adobe/data/schema").FromSchemas<{
+            readonly materials: {
+                readonly default: Record<string, number>;
+            };
+        }>, {
+            readonly Material: readonly ["name", "density", "restitution", "friction", "compliance", "heatCapacity", "baseColorFactor", "emissiveFactor", "metallicFactor", "roughnessFactor", "normalScale", "occlusionStrength", "baseColorUrl", "metallicRoughnessUrl", "normalUrl", "occlusionUrl", "emissiveUrl"];
+        }, {}>) => void;
+    } & {};
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<"update" | "_frameTime" | "schedulerSystem" | "input" | "preUpdate" | "postUpdate" | "physics" | "preRender" | "render" | "postRender" | "materialGpuBuilder">;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {} & {} & {};
+};

package/dist/graphics/rendering/material-gpu/material-gpu-plugin.js

@@ -0,0 +1,90 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { U32 } from "@adobe/data/math";
+import { core } from "../../../core/core-plugin.js";
+import { Material } from "../../../material/material.js";
+import { MAX_MATERIAL_LAYERS, PALETTE_STRIDE, createMaterialArrays, writePaletteLayer, loadMaterialMaps, } from "./material-arrays.js";
+import { createMaterialBindGroup } from "./material-bind-group.js";
+/** Material rows the builder reads to fill a layer (factors + map URLs). */
+const MATERIAL_COMPONENTS = [
+    "baseColorFactor", "emissiveFactor", "metallicFactor", "roughnessFactor", "normalScale", "occlusionStrength",
+    "baseColorUrl", "metallicRoughnessUrl", "normalUrl", "occlusionUrl", "emissiveUrl",
+];
+/**
+ * materialGpu — derives the shared GPU material set from the `Material`
+ * registry. Each authored material is assigned one array layer; its factors go
+ * into the palette buffer and its maps are fetched + blitted into that layer.
+ *
+ * Incremental and cached: the arrays / palette / bind group are built once, and
+ * a layer is assigned only to a material that doesn't have one yet (`_layerIndex`
+ * excluded). Materials are added rarely and edited never, so steady state does
+ * no work. The renderer (P3) binds `_materialBindGroup` once and selects a
+ * material per instance by `_layerIndex`.
+ */
+export const materialGpu = Database.Plugin.create({
+    extends: Database.Plugin.combine(Material.plugin, core),
+    components: {
+        _layerIndex: U32.schema,
+    },
+    resources: {
+        _materialArrays: { default: null, transient: true },
+        _materialPalette: { default: null, transient: true },
+        _materialBindGroup: { default: null, transient: true },
+    },
+    systems: {
+        materialGpuBuilder: {
+            schedule: { during: ["preRender"] },
+            create: db => {
+                let arrays = null;
+                let palette = null;
+                let nextLayer = 0;
+                return () => {
+                    const { device } = db.store.resources;
+                    if (!device)
+                        return;
+                    // Assign a layer to each material that lacks one. Tail→head:
+                    // every visited row migrates out (gains _layerIndex), so the
+                    // removal is always from the tail — no hole-fill shift. The GPU
+                    // arrays are created lazily on the first material, so glTF-only
+                    // scenes (no materials) allocate nothing.
+                    for (const arch of db.store.queryArchetypes(["name", ...MATERIAL_COMPONENTS], { exclude: ["_layerIndex"] })) {
+                        const c = arch.columns;
+                        for (let i = arch.rowCount - 1; i >= 0; i--) {
+                            if (nextLayer >= MAX_MATERIAL_LAYERS)
+                                break;
+                            if (!arrays || !palette) {
+                                arrays = createMaterialArrays(device);
+                                palette = device.createBuffer({
+                                    size: MAX_MATERIAL_LAYERS * PALETTE_STRIDE,
+                                    usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+                                });
+                                db.store.resources._materialArrays = arrays;
+                                db.store.resources._materialPalette = palette;
+                                db.store.resources._materialBindGroup = createMaterialBindGroup(device, arrays, palette);
+                            }
+                            const id = c.id.get(i);
+                            const layer = nextLayer++;
+                            writePaletteLayer(device, palette, layer, {
+                                baseColorFactor: c.baseColorFactor.get(i),
+                                emissiveFactor: c.emissiveFactor.get(i),
+                                metallicFactor: c.metallicFactor.get(i),
+                                roughnessFactor: c.roughnessFactor.get(i),
+                                normalScale: c.normalScale.get(i),
+                                occlusionStrength: c.occlusionStrength.get(i),
+                            });
+                            loadMaterialMaps(device, arrays, layer, {
+                                baseColorUrl: c.baseColorUrl.get(i),
+                                metallicRoughnessUrl: c.metallicRoughnessUrl.get(i),
+                                normalUrl: c.normalUrl.get(i),
+                                occlusionUrl: c.occlusionUrl.get(i),
+                                emissiveUrl: c.emissiveUrl.get(i),
+                            });
+                            db.store.update(id, { _layerIndex: layer });
+                        }
+                    }
+                };
+            },
+        },
+    },
+});
+//# sourceMappingURL=material-gpu-plugin.js.map

package/dist/graphics/rendering/material-gpu/material-gpu-plugin.js.map

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