@luma.gl/engine 9.0.0-alpha.4 → 9.0.0-alpha.40

package/dist/model/model.d.ts

@@ -0,0 +1,175 @@
+import type { TypedArray, RenderPipelineProps, RenderPipelineParameters, BufferLayout, VertexArray, AttributeInfo } from '@luma.gl/core';
+import type { Binding, UniformValue, PrimitiveTopology } from '@luma.gl/core';
+import { Device, Buffer, RenderPipeline, RenderPass } from '@luma.gl/core';
+import type { ShaderModule } from '@luma.gl/shadertools';
+import { ShaderAssembler } from '@luma.gl/shadertools';
+import type { Geometry } from '../geometry/geometry';
+import { GPUGeometry } from '../geometry/gpu-geometry';
+import { PipelineFactory } from '../lib/pipeline-factory';
+export type ModelProps = Omit<RenderPipelineProps, 'vs' | 'fs'> & {
+    vs: {
+        glsl?: string;
+        wgsl?: string;
+    } | string | null;
+    fs: {
+        glsl?: string;
+        wgsl?: string;
+    } | string | null;
+    /** shadertool shader modules (added to shader code) */
+    modules?: ShaderModule[];
+    /** Shadertool module defines (configures shader code)*/
+    defines?: Record<string, string | number | boolean>;
+    /** pipeline factory to use to create render pipelines. Defaults to default factory for the device */
+    pipelineFactory?: PipelineFactory;
+    /** Shader assembler. Defaults to the ShaderAssembler.getShaderAssembler() */
+    shaderAssembler?: ShaderAssembler;
+    /** Parameters that are built into the pipeline */
+    parameters?: RenderPipelineParameters;
+    /** Geometry */
+    geometry?: GPUGeometry | Geometry | null;
+    /** Vertex count */
+    vertexCount?: number;
+    /** instance count */
+    instanceCount?: number;
+    indexBuffer?: Buffer | null;
+    /** @note this is really a map of buffers, not a map of attributes */
+    attributes?: Record<string, Buffer>;
+    /**   */
+    constantAttributes?: Record<string, TypedArray>;
+    /** Mapped uniforms for shadertool modules */
+    moduleSettings?: Record<string, Record<string, any>>;
+};
+/**
+ * v9 Model API
+ * A model
+ * - automatically reuses pipelines (programs) when possible
+ * - automatically rebuilds pipelines if necessary to accommodate changed settings
+ * shadertools integration
+ * - accepts modules and performs shader transpilation
+ */
+export declare class Model {
+    static defaultProps: Required<ModelProps>;
+    readonly device: Device;
+    readonly id: string;
+    readonly vs: string;
+    readonly fs: string;
+    readonly pipelineFactory: PipelineFactory;
+    userData: {
+        [key: string]: any;
+    };
+    /** The render pipeline GPU parameters, depth testing etc */
+    parameters: RenderPipelineParameters;
+    /** The primitive topology */
+    topology: PrimitiveTopology;
+    /** Buffer layout */
+    bufferLayout: BufferLayout[];
+    /** Vertex count */
+    vertexCount: number;
+    /** instance count */
+    instanceCount: number;
+    /** Index buffer */
+    indexBuffer: Buffer | null;
+    /** Buffer-valued attributes */
+    bufferAttributes: Record<string, Buffer>;
+    /** Constant-valued attributes */
+    constantAttributes: Record<string, TypedArray>;
+    /** Bindings (textures, samplers, uniform buffers) */
+    bindings: Record<string, Binding>;
+    /** Sets uniforms @deprecated Use uniform buffers and setBindings() for portability*/
+    uniforms: Record<string, UniformValue>;
+    /** The underlying GPU "program". @note May be recreated if parameters change */
+    pipeline: RenderPipeline;
+    /**
+     * VertexArray
+     * @note not implemented: if bufferLayout is updated, vertex array has to be rebuilt!
+     * @todo - allow application to define multiple vertex arrays?
+     * */
+    vertexArray: VertexArray;
+    _pipelineNeedsUpdate: string | false;
+    _attributeInfos: Record<string, AttributeInfo>;
+    _gpuGeometry: GPUGeometry | null;
+    private _getModuleUniforms;
+    private props;
+    constructor(device: Device, props: ModelProps);
+    destroy(): void;
+    draw(renderPass: RenderPass): void;
+    /**
+     * Updates the optional geometry
+     * Geometry, set topology and bufferLayout
+     * @note Can trigger a pipeline rebuild / pipeline cache fetch on WebGPU
+     */
+    setGeometry(geometry: GPUGeometry | Geometry): GPUGeometry;
+    /**
+     * Updates the optional geometry attributes
+     * Geometry, sets several attributes, indexBuffer, and also vertex count
+     * @note Can trigger a pipeline rebuild / pipeline cache fetch on WebGPU
+     */
+    _setGeometryAttributes(gpuGeometry: GPUGeometry): void;
+    /**
+     * Updates the primitive topology ('triangle-list', 'triangle-strip' etc).
+     * @note Triggers a pipeline rebuild / pipeline cache fetch on WebGPU
+     */
+    setTopology(topology: PrimitiveTopology): void;
+    /**
+     * Updates the buffer layout.
+     * @note Triggers a pipeline rebuild / pipeline cache fetch on WebGPU
+     */
+    setBufferLayout(bufferLayout: BufferLayout[]): void;
+    /**
+     * Set GPU parameters.
+     * @note Can trigger a pipeline rebuild / pipeline cache fetch.
+     * @param parameters
+     */
+    setParameters(parameters: RenderPipelineParameters): void;
+    /**
+     * Updates the vertex count (used in draw calls)
+     * @note Any attributes with stepMode=vertex need to be at least this big
+     */
+    setVertexCount(vertexCount: number): void;
+    /**
+     * Updates the instance count (used in draw calls)
+     * @note Any attributes with stepMode=instance need to be at least this big
+     */
+    setInstanceCount(instanceCount: number): void;
+    /**
+     * Updates shader module settings (which results in uniforms being set)
+     */
+    setShaderModuleProps(props: Record<string, any>): void;
+    /**
+     * @deprecated Updates shader module settings (which results in uniforms being set)
+     */
+    updateModuleSettings(props: Record<string, any>): void;
+    /**
+     * Sets bindings (textures, samplers, uniform buffers)
+     */
+    setBindings(bindings: Record<string, Binding>): void;
+    /**
+     * Sets individual uniforms
+     * @deprecated WebGL only, use uniform buffers for portability
+     * @param uniforms
+     * @returns self for chaining
+     */
+    setUniforms(uniforms: Record<string, UniformValue>): void;
+    /**
+     * Sets the index buffer
+     * @todo - how to unset it if we change geometry?
+     */
+    setIndexBuffer(indexBuffer: Buffer | null): void;
+    /**
+     * Sets attributes (buffers)
+     * @note Overrides any attributes previously set with the same name
+     */
+    setAttributes(buffers: Record<string, Buffer>): void;
+    /**
+     * Sets constant attributes
+     * @note Overrides any attributes previously set with the same name
+     * Constant attributes are only supported in WebGL, not in WebGPU
+     * Any attribute that is disabled in the current vertex array object
+     * is read from the context's global constant value for that attribute location.
+     * @param constantAttributes
+     */
+    setConstantAttributes(attributes: Record<string, TypedArray>): void;
+    _setPipelineNeedsUpdate(reason: string): void;
+    _updatePipeline(): RenderPipeline;
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model/model.d.ts.map

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

package/dist/model/model.js

@@ -0,0 +1,273 @@
+import { RenderPipeline, log, uid, deepEqual } from '@luma.gl/core';
+import { getAttributeInfosFromLayouts } from '@luma.gl/core';
+import { ShaderAssembler } from '@luma.gl/shadertools';
+import { makeGPUGeometry } from "../geometry/gpu-geometry.js";
+import { PipelineFactory } from "../lib/pipeline-factory.js";
+export class Model {
+  constructor(device, props) {
+    this.device = void 0;
+    this.id = void 0;
+    this.vs = void 0;
+    this.fs = void 0;
+    this.pipelineFactory = void 0;
+    this.userData = {};
+    this.parameters = void 0;
+    this.topology = void 0;
+    this.bufferLayout = void 0;
+    this.vertexCount = void 0;
+    this.instanceCount = 0;
+    this.indexBuffer = null;
+    this.bufferAttributes = {};
+    this.constantAttributes = {};
+    this.bindings = {};
+    this.uniforms = {};
+    this.pipeline = void 0;
+    this.vertexArray = void 0;
+    this._pipelineNeedsUpdate = 'newly created';
+    this._attributeInfos = {};
+    this._gpuGeometry = null;
+    this._getModuleUniforms = void 0;
+    this.props = void 0;
+    this.props = {
+      ...Model.defaultProps,
+      ...props
+    };
+    props = this.props;
+    this.id = props.id || uid('model');
+    this.device = device;
+    Object.assign(this.userData, props.userData);
+    const platformInfo = {
+      type: device.info.type,
+      shaderLanguage: device.info.shadingLanguages[0],
+      gpu: device.info.gpu,
+      features: device.features
+    };
+    const {
+      vs,
+      fs,
+      getUniforms
+    } = this.props.shaderAssembler.assembleShaders(platformInfo, this.props);
+    this.vs = vs;
+    this.fs = fs;
+    this._getModuleUniforms = getUniforms;
+    this.vertexCount = this.props.vertexCount;
+    this.instanceCount = this.props.instanceCount;
+    this.topology = this.props.topology;
+    this.bufferLayout = this.props.bufferLayout;
+    this.parameters = this.props.parameters;
+    if (props.geometry) {
+      this._gpuGeometry = this.setGeometry(props.geometry);
+    }
+    this.pipelineFactory = props.pipelineFactory || PipelineFactory.getDefaultPipelineFactory(this.device);
+    this.pipeline = this._updatePipeline();
+    this.vertexArray = device.createVertexArray({
+      renderPipeline: this.pipeline
+    });
+    if (this._gpuGeometry) {
+      this._setGeometryAttributes(this._gpuGeometry);
+    }
+    if (props.vertexCount) {
+      this.setVertexCount(props.vertexCount);
+    }
+    if (props.instanceCount) {
+      this.setInstanceCount(props.instanceCount);
+    }
+    if (props.indices) {
+      throw new Error('Model.props.indices removed. Use props.indexBuffer');
+    }
+    if (props.indexBuffer) {
+      this.setIndexBuffer(props.indexBuffer);
+    }
+    if (props.attributes) {
+      this.setAttributes(props.attributes);
+    }
+    if (props.constantAttributes) {
+      this.setConstantAttributes(props.constantAttributes);
+    }
+    if (props.bindings) {
+      this.setBindings(props.bindings);
+    }
+    if (props.uniforms) {
+      this.setUniforms(props.uniforms);
+    }
+    if (props.moduleSettings) {
+      this.updateModuleSettings(props.moduleSettings);
+    }
+    this.setUniforms(this._getModuleUniforms());
+    Object.seal(this);
+  }
+  destroy() {
+    this.pipelineFactory.release(this.pipeline);
+  }
+  draw(renderPass) {
+    this.pipeline = this._updatePipeline();
+    this.pipeline.setBindings(this.bindings);
+    this.pipeline.setUniforms(this.uniforms);
+    this.pipeline.draw({
+      renderPass,
+      vertexArray: this.vertexArray,
+      vertexCount: this.vertexCount,
+      instanceCount: this.instanceCount
+    });
+  }
+  setGeometry(geometry) {
+    const gpuGeometry = geometry && makeGPUGeometry(this.device, geometry);
+    this.setTopology(gpuGeometry.topology || 'triangle-list');
+    this.bufferLayout = mergeBufferLayouts(this.bufferLayout, gpuGeometry.bufferLayout);
+    if (this.vertexArray) {
+      this._setGeometryAttributes(gpuGeometry);
+    }
+    return gpuGeometry;
+  }
+  _setGeometryAttributes(gpuGeometry) {
+    this.vertexCount = gpuGeometry.vertexCount;
+    this.setAttributes(gpuGeometry.attributes);
+    this.setIndexBuffer(gpuGeometry.indices);
+  }
+  setTopology(topology) {
+    if (topology !== this.topology) {
+      this.topology = topology;
+      this._setPipelineNeedsUpdate('topology');
+    }
+  }
+  setBufferLayout(bufferLayout) {
+    this.bufferLayout = this._gpuGeometry ? mergeBufferLayouts(bufferLayout, this._gpuGeometry.bufferLayout) : bufferLayout;
+    this._setPipelineNeedsUpdate('bufferLayout');
+    this.pipeline = this._updatePipeline();
+    this.vertexArray = this.device.createVertexArray({
+      renderPipeline: this.pipeline
+    });
+    if (this._gpuGeometry) {
+      this._setGeometryAttributes(this._gpuGeometry);
+    }
+  }
+  setParameters(parameters) {
+    if (!deepEqual(parameters, this.parameters, 2)) {
+      this.parameters = parameters;
+      this._setPipelineNeedsUpdate('parameters');
+    }
+  }
+  setVertexCount(vertexCount) {
+    this.vertexCount = vertexCount;
+  }
+  setInstanceCount(instanceCount) {
+    this.instanceCount = instanceCount;
+  }
+  setShaderModuleProps(props) {
+    const uniforms = this._getModuleUniforms(props);
+    const keys = Object.keys(uniforms).filter(k => uniforms[k].constructor.name.includes('WEBGL'));
+    const bindings = {};
+    for (const k of keys) {
+      bindings[k] = uniforms[k];
+      delete uniforms[k];
+    }
+    Object.assign(this.uniforms, uniforms);
+    Object.assign(this.bindings, bindings);
+  }
+  updateModuleSettings(props) {
+    this.setShaderModuleProps(props);
+  }
+  setBindings(bindings) {
+    Object.assign(this.bindings, bindings);
+  }
+  setUniforms(uniforms) {
+    this.pipeline.setUniforms(uniforms);
+    Object.assign(this.uniforms, uniforms);
+  }
+  setIndexBuffer(indexBuffer) {
+    this.vertexArray.setIndexBuffer(indexBuffer);
+  }
+  setAttributes(buffers) {
+    if (buffers.indices) {
+      log.warn(`Model:${this.id} setAttributes() - indexBuffer should be set using setIndexBuffer()`);
+    }
+    for (const [bufferName, buffer] of Object.entries(buffers)) {
+      var _bufferLayout$attribu;
+      const bufferLayout = this.bufferLayout.find(layout => layout.name === bufferName);
+      if (!bufferLayout) {
+        continue;
+      }
+      const attributeNames = bufferLayout.attributes ? (_bufferLayout$attribu = bufferLayout.attributes) === null || _bufferLayout$attribu === void 0 ? void 0 : _bufferLayout$attribu.map(layout => layout.attribute) : [bufferLayout.name];
+      let set = false;
+      for (const attributeName of attributeNames) {
+        const attributeInfo = this._attributeInfos[attributeName];
+        if (attributeInfo) {
+          this.vertexArray.setBuffer(attributeInfo.location, buffer);
+          set = true;
+        }
+      }
+      if (!set) {
+        log.warn(`Model(${this.id}): Ignoring buffer "${buffer.id}" for unknown attribute "${bufferName}"`)();
+      }
+    }
+  }
+  setConstantAttributes(attributes) {
+    for (const [attributeName, value] of Object.entries(attributes)) {
+      const attributeInfo = this._attributeInfos[attributeName];
+      if (attributeInfo) {
+        this.vertexArray.setConstant(attributeInfo.location, value);
+      } else {
+        log.warn(`Model "${this.id}: Ignoring constant supplied for unknown attribute "${attributeName}"`)();
+      }
+    }
+  }
+  _setPipelineNeedsUpdate(reason) {
+    this._pipelineNeedsUpdate = this._pipelineNeedsUpdate || reason;
+  }
+  _updatePipeline() {
+    if (this._pipelineNeedsUpdate) {
+      if (this.pipeline) {
+        log.log(1, `Model ${this.id}: Recreating pipeline because "${this._pipelineNeedsUpdate}".`)();
+      }
+      this._pipelineNeedsUpdate = false;
+      this.pipeline = this.device.createRenderPipeline({
+        ...this.props,
+        bufferLayout: this.bufferLayout,
+        topology: this.topology,
+        parameters: this.parameters,
+        vs: this.device.createShader({
+          id: '{$this.id}-vertex',
+          stage: 'vertex',
+          source: this.vs
+        }),
+        fs: this.fs ? this.device.createShader({
+          id: '{$this.id}-fragment',
+          stage: 'fragment',
+          source: this.fs
+        }) : null
+      });
+      this._attributeInfos = getAttributeInfosFromLayouts(this.pipeline.shaderLayout, this.bufferLayout);
+    }
+    return this.pipeline;
+  }
+}
+Model.defaultProps = {
+  ...RenderPipeline.defaultProps,
+  vs: null,
+  fs: null,
+  id: 'unnamed',
+  handle: undefined,
+  userData: {},
+  defines: {},
+  modules: [],
+  moduleSettings: {},
+  geometry: null,
+  indexBuffer: null,
+  attributes: {},
+  constantAttributes: {},
+  pipelineFactory: undefined,
+  shaderAssembler: ShaderAssembler.getDefaultShaderAssembler()
+};
+function mergeBufferLayouts(layouts1, layouts2) {
+  const layouts = [...layouts1];
+  for (const attribute of layouts2) {
+    const index = layouts.findIndex(attribute2 => attribute2.name === attribute.name);
+    if (index < 0) {
+      layouts.push(attribute);
+    } else {
+      layouts[index] = attribute;
+    }
+  }
+  return layouts;
+}
+//# sourceMappingURL=model.js.map

package/dist/model/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","names":["RenderPipeline","log","uid","deepEqual","getAttributeInfosFromLayouts","ShaderAssembler","makeGPUGeometry","PipelineFactory","Model","constructor","device","props","id","vs","fs","pipelineFactory","userData","parameters","topology","bufferLayout","vertexCount","instanceCount","indexBuffer","bufferAttributes","constantAttributes","bindings","uniforms","pipeline","vertexArray","_pipelineNeedsUpdate","_attributeInfos","_gpuGeometry","_getModuleUniforms","defaultProps","Object","assign","platformInfo","type","info","shaderLanguage","shadingLanguages","gpu","features","getUniforms","shaderAssembler","assembleShaders","geometry","setGeometry","getDefaultPipelineFactory","_updatePipeline","createVertexArray","renderPipeline","_setGeometryAttributes","setVertexCount","setInstanceCount","indices","Error","setIndexBuffer","attributes","setAttributes","setConstantAttributes","setBindings","setUniforms","moduleSettings","updateModuleSettings","seal","destroy","release","draw","renderPass","gpuGeometry","setTopology","mergeBufferLayouts","_setPipelineNeedsUpdate","setBufferLayout","setParameters","setShaderModuleProps","keys","filter","k","name","includes","buffers","warn","bufferName","buffer","entries","_bufferLayout$attribu","find","layout","attributeNames","map","attribute","set","attributeName","attributeInfo","setBuffer","location","value","setConstant","reason","createRenderPipeline","createShader","stage","source","shaderLayout","handle","undefined","defines","modules","getDefaultShaderAssembler","layouts1","layouts2","layouts","index","findIndex","attribute2","push"],"sources":["../../src/model/model.ts"],"sourcesContent":["// luma.gl, MIT license\n// Copyright (c) vis.gl contributors\n\nimport type {\n  TypedArray,\n  RenderPipelineProps,\n  RenderPipelineParameters,\n  BufferLayout,\n  VertexArray,\n  AttributeInfo\n} from '@luma.gl/core';\nimport type {Binding, UniformValue, PrimitiveTopology} from '@luma.gl/core';\nimport {Device, Buffer, RenderPipeline, RenderPass, log, uid, deepEqual} from '@luma.gl/core';\nimport {getAttributeInfosFromLayouts} from '@luma.gl/core';\nimport type {ShaderModule, PlatformInfo} from '@luma.gl/shadertools';\nimport {ShaderAssembler} from '@luma.gl/shadertools';\nimport type {Geometry} from '../geometry/geometry';\nimport {GPUGeometry, makeGPUGeometry} from '../geometry/gpu-geometry';\nimport {PipelineFactory} from '../lib/pipeline-factory';\n\nexport type ModelProps = Omit<RenderPipelineProps, 'vs' | 'fs'> & {\n  // Model also accepts a string shaders\n  vs: {glsl?: string; wgsl?: string} | string | null;\n  fs: {glsl?: string; wgsl?: string} | string | null;\n  /** shadertool shader modules (added to shader code) */\n  modules?: ShaderModule[];\n  /** Shadertool module defines (configures shader code)*/\n  defines?: Record<string, string | number | boolean>;\n  // TODO - injections, hooks etc?\n\n  /** pipeline factory to use to create render pipelines. Defaults to default factory for the device */\n  pipelineFactory?: PipelineFactory;\n  /** Shader assembler. Defaults to the ShaderAssembler.getShaderAssembler() */\n  shaderAssembler?: ShaderAssembler;\n\n  /** Parameters that are built into the pipeline */\n  parameters?: RenderPipelineParameters;\n\n  /** Geometry */\n  geometry?: GPUGeometry | Geometry | null;\n\n  /** Vertex count */\n  vertexCount?: number;\n  /** instance count */\n  instanceCount?: number;\n\n  indexBuffer?: Buffer | null;\n  /** @note this is really a map of buffers, not a map of attributes */\n  attributes?: Record<string, Buffer>;\n  /**   */\n  constantAttributes?: Record<string, TypedArray>;\n\n  /** Mapped uniforms for shadertool modules */\n  moduleSettings?: Record<string, Record<string, any>>;\n};\n\n/**\n * v9 Model API\n * A model\n * - automatically reuses pipelines (programs) when possible\n * - automatically rebuilds pipelines if necessary to accommodate changed settings\n * shadertools integration\n * - accepts modules and performs shader transpilation\n */\nexport class Model {\n  static defaultProps: Required<ModelProps> = {\n    ...RenderPipeline.defaultProps,\n    vs: null,\n    fs: null,\n    id: 'unnamed',\n    handle: undefined,\n    userData: {},\n    defines: {},\n    modules: [],\n    moduleSettings: {},\n    geometry: null,\n    indexBuffer: null,\n    attributes: {},\n    constantAttributes: {},\n\n    pipelineFactory: undefined!,\n    shaderAssembler: ShaderAssembler.getDefaultShaderAssembler()\n  };\n\n  readonly device: Device;\n  readonly id: string;\n  readonly vs: string;\n  readonly fs: string;\n  readonly pipelineFactory: PipelineFactory;\n  userData: {[key: string]: any} = {};\n\n  // Fixed properties (change can trigger pipeline rebuild)\n\n  /** The render pipeline GPU parameters, depth testing etc */\n  parameters: RenderPipelineParameters;\n\n  /** The primitive topology */\n  topology: PrimitiveTopology;\n  /** Buffer layout */\n  bufferLayout: BufferLayout[];\n\n  // Dynamic properties\n\n  /** Vertex count */\n  vertexCount: number;\n  /** instance count */\n  instanceCount: number = 0;\n\n  /** Index buffer */\n  indexBuffer: Buffer | null = null;\n  /** Buffer-valued attributes */\n  bufferAttributes: Record<string, Buffer> = {};\n  /** Constant-valued attributes */\n  constantAttributes: Record<string, TypedArray> = {};\n  /** Bindings (textures, samplers, uniform buffers) */\n  bindings: Record<string, Binding> = {};\n  /** Sets uniforms @deprecated Use uniform buffers and setBindings() for portability*/\n  uniforms: Record<string, UniformValue> = {};\n\n  /** The underlying GPU \"program\". @note May be recreated if parameters change */\n  pipeline: RenderPipeline;\n\n  /**\n   * VertexArray\n   * @note not implemented: if bufferLayout is updated, vertex array has to be rebuilt!\n   * @todo - allow application to define multiple vertex arrays?\n   * */\n  vertexArray: VertexArray;\n\n  _pipelineNeedsUpdate: string | false = 'newly created';\n  _attributeInfos: Record<string, AttributeInfo> = {};\n  _gpuGeometry: GPUGeometry | null = null;\n  private _getModuleUniforms: (props?: Record<string, Record<string, any>>) => Record<string, any>;\n  private props: Required<ModelProps>;\n\n  constructor(device: Device, props: ModelProps) {\n    this.props = {...Model.defaultProps, ...props};\n    props = this.props;\n    this.id = props.id || uid('model');\n    this.device = device;\n\n    Object.assign(this.userData, props.userData);\n\n    /** Create a shadertools platform info from the Device */\n    const platformInfo: PlatformInfo = {\n      type: device.info.type,\n      shaderLanguage: device.info.shadingLanguages[0],\n      gpu: device.info.gpu,\n      features: device.features\n    };\n\n    const {vs, fs, getUniforms} = this.props.shaderAssembler.assembleShaders(\n      platformInfo,\n      this.props\n    );\n    this.vs = vs;\n    this.fs = fs;\n    this._getModuleUniforms = getUniforms;\n\n    this.vertexCount = this.props.vertexCount;\n    this.instanceCount = this.props.instanceCount;\n\n    this.topology = this.props.topology;\n    this.bufferLayout = this.props.bufferLayout;\n    this.parameters = this.props.parameters;\n\n    // Geometry, if provided, sets topology and vertex cound\n    if (props.geometry) {\n      this._gpuGeometry = this.setGeometry(props.geometry);\n    }\n\n    this.pipelineFactory =\n      props.pipelineFactory || PipelineFactory.getDefaultPipelineFactory(this.device);\n\n    // Create the pipeline\n    // @note order is important\n    this.pipeline = this._updatePipeline();\n\n    this.vertexArray = device.createVertexArray({\n      renderPipeline: this.pipeline\n    });\n\n    // Now we can apply geometry attributes\n    if (this._gpuGeometry) {\n      this._setGeometryAttributes(this._gpuGeometry);\n    }\n\n    // Apply any dynamic settings that will not trigger pipeline change\n    if (props.vertexCount) {\n      this.setVertexCount(props.vertexCount);\n    }\n    if (props.instanceCount) {\n      this.setInstanceCount(props.instanceCount);\n    }\n    // @ts-expect-error\n    if (props.indices) {\n      throw new Error('Model.props.indices removed. Use props.indexBuffer')\n    }\n    if (props.indexBuffer) {\n      this.setIndexBuffer(props.indexBuffer);\n    }\n    if (props.attributes) {\n      this.setAttributes(props.attributes);\n    }\n    if (props.constantAttributes) {\n      this.setConstantAttributes(props.constantAttributes);\n    }\n    if (props.bindings) {\n      this.setBindings(props.bindings);\n    }\n    if (props.uniforms) {\n      this.setUniforms(props.uniforms);\n    }\n    if (props.moduleSettings) {\n      this.updateModuleSettings(props.moduleSettings);\n    }\n\n    this.setUniforms(this._getModuleUniforms()); // Get all default module uniforms\n\n    // Catch any access to non-standard props\n    Object.seal(this);\n  }\n\n  destroy(): void {\n    this.pipelineFactory.release(this.pipeline);\n  }\n\n  // Draw call\n\n  draw(renderPass: RenderPass): void {\n    // Check if the pipeline is invalidated\n    // TODO - this is likely the worst place to do this from performance perspective. Perhaps add a predraw()?\n    this.pipeline = this._updatePipeline();\n\n    // Set pipeline state, we may be sharing a pipeline so we need to set all state on every draw\n    // Any caching needs to be done inside the pipeline functions\n    this.pipeline.setBindings(this.bindings);\n    this.pipeline.setUniforms(this.uniforms);\n\n    this.pipeline.draw({\n      renderPass,\n      vertexArray: this.vertexArray,\n      vertexCount: this.vertexCount,\n      instanceCount: this.instanceCount\n    });\n  }\n\n  // Update fixed fields (can trigger pipeline rebuild)\n\n  /**\n   * Updates the optional geometry\n   * Geometry, set topology and bufferLayout\n   * @note Can trigger a pipeline rebuild / pipeline cache fetch on WebGPU\n   */\n  setGeometry(geometry: GPUGeometry | Geometry): GPUGeometry {\n    const gpuGeometry = geometry && makeGPUGeometry(this.device, geometry);\n    this.setTopology(gpuGeometry.topology || 'triangle-list');\n    this.bufferLayout = mergeBufferLayouts(this.bufferLayout, gpuGeometry.bufferLayout);\n    if (this.vertexArray) {\n      this._setGeometryAttributes(gpuGeometry);\n    }\n    return gpuGeometry;\n  }\n\n  /**\n   * Updates the optional geometry attributes\n   * Geometry, sets several attributes, indexBuffer, and also vertex count\n   * @note Can trigger a pipeline rebuild / pipeline cache fetch on WebGPU\n   */\n  _setGeometryAttributes(gpuGeometry: GPUGeometry): void {\n    // TODO - delete previous geometry?\n    this.vertexCount = gpuGeometry.vertexCount;\n    this.setAttributes(gpuGeometry.attributes);\n    this.setIndexBuffer(gpuGeometry.indices);\n  }\n\n  /**\n   * Updates the primitive topology ('triangle-list', 'triangle-strip' etc).\n   * @note Triggers a pipeline rebuild / pipeline cache fetch on WebGPU\n   */\n  setTopology(topology: PrimitiveTopology): void {\n    if (topology !== this.topology) {\n      this.topology = topology;\n      this._setPipelineNeedsUpdate('topology');\n    }\n  }\n\n  /**\n   * Updates the buffer layout.\n   * @note Triggers a pipeline rebuild / pipeline cache fetch on WebGPU\n   */\n  setBufferLayout(bufferLayout: BufferLayout[]): void {\n    this.bufferLayout = this._gpuGeometry\n      ? mergeBufferLayouts(bufferLayout, this._gpuGeometry.bufferLayout)\n      : bufferLayout;\n    this._setPipelineNeedsUpdate('bufferLayout');\n\n    // Recreate the pipeline\n    this.pipeline = this._updatePipeline();\n    \n    // vertex array needs to be updated if we update buffer layout,\n    // but not if we update parameters\n    this.vertexArray = this.device.createVertexArray({\n      renderPipeline: this.pipeline\n    });\n\n    // Reapply geometry attributes to the new vertex array\n    if (this._gpuGeometry) {\n      this._setGeometryAttributes(this._gpuGeometry);\n    }\n  }\n\n  /**\n   * Set GPU parameters.\n   * @note Can trigger a pipeline rebuild / pipeline cache fetch.\n   * @param parameters\n   */\n  setParameters(parameters: RenderPipelineParameters) {\n    if (!deepEqual(parameters, this.parameters, 2)) {\n      this.parameters = parameters;\n      this._setPipelineNeedsUpdate('parameters');\n    }\n  }\n\n  // Update dynamic fields\n\n  /**\n   * Updates the vertex count (used in draw calls)\n   * @note Any attributes with stepMode=vertex need to be at least this big\n   */\n  setVertexCount(vertexCount: number): void {\n    this.vertexCount = vertexCount;\n  }\n\n  /**\n   * Updates the instance count (used in draw calls)\n   * @note Any attributes with stepMode=instance need to be at least this big\n   */\n  setInstanceCount(instanceCount: number): void {\n    this.instanceCount = instanceCount;\n  }\n\n  /**\n   * Updates shader module settings (which results in uniforms being set)\n   */\n  setShaderModuleProps(props: Record<string, any>): void {\n    const uniforms = this._getModuleUniforms(props);\n\n    // Extract textures & framebuffers set by the modules\n    // TODO better way to extract bindings\n    const keys = Object.keys(uniforms).filter(k => uniforms[k].constructor.name.includes('WEBGL'));\n    const bindings: Record<string, Binding> = {};\n    for (const k of keys) {\n      bindings[k] = uniforms[k];\n      delete uniforms[k];\n    }\n\n    Object.assign(this.uniforms, uniforms);\n    Object.assign(this.bindings, bindings);\n  }\n\n  /**\n   * @deprecated Updates shader module settings (which results in uniforms being set)\n   */\n  updateModuleSettings(props: Record<string, any>): void {\n    this.setShaderModuleProps(props);\n  }\n\n  /**\n   * Sets bindings (textures, samplers, uniform buffers)\n   */\n  setBindings(bindings: Record<string, Binding>): void {\n    Object.assign(this.bindings, bindings);\n  }\n\n  /**\n   * Sets individual uniforms\n   * @deprecated WebGL only, use uniform buffers for portability\n   * @param uniforms\n   * @returns self for chaining\n   */\n  setUniforms(uniforms: Record<string, UniformValue>): void {\n    this.pipeline.setUniforms(uniforms);\n    Object.assign(this.uniforms, uniforms);\n  }\n\n  /**\n   * Sets the index buffer\n   * @todo - how to unset it if we change geometry?\n   */\n  setIndexBuffer(indexBuffer: Buffer | null): void {\n    this.vertexArray.setIndexBuffer(indexBuffer);\n  }\n\n  /**\n   * Sets attributes (buffers)\n   * @note Overrides any attributes previously set with the same name\n   */\n  setAttributes(buffers: Record<string, Buffer>): void {\n    if (buffers.indices) {\n      log.warn(\n        `Model:${this.id} setAttributes() - indexBuffer should be set using setIndexBuffer()`\n      );\n    }\n    for (const [bufferName, buffer] of Object.entries(buffers)) {\n      const bufferLayout = this.bufferLayout.find(layout => layout.name === bufferName);\n      if (!bufferLayout) {\n        continue; // eslint-disable-line no-continue\n      }\n\n      // For an interleaved attribute we may need to set multiple attributes\n      const attributeNames = bufferLayout.attributes\n        ? bufferLayout.attributes?.map(layout => layout.attribute)\n        : [bufferLayout.name];\n      let set = false;\n      for (const attributeName of attributeNames) {\n        const attributeInfo = this._attributeInfos[attributeName];\n        if (attributeInfo) {\n          this.vertexArray.setBuffer(attributeInfo.location, buffer);\n          set = true;\n        }\n      }\n      if (!set) {\n        log.warn(\n          `Model(${this.id}): Ignoring buffer \"${buffer.id}\" for unknown attribute \"${bufferName}\"`\n        )();\n      }\n    }\n  }\n\n  /**\n   * Sets constant attributes\n   * @note Overrides any attributes previously set with the same name\n   * Constant attributes are only supported in WebGL, not in WebGPU\n   * Any attribute that is disabled in the current vertex array object\n   * is read from the context's global constant value for that attribute location.\n   * @param constantAttributes\n   */\n  setConstantAttributes(attributes: Record<string, TypedArray>): void {\n    for (const [attributeName, value] of Object.entries(attributes)) {\n      const attributeInfo = this._attributeInfos[attributeName];\n      if (attributeInfo) {\n        this.vertexArray.setConstant(attributeInfo.location, value);\n      } else {\n        log.warn(`Model \"${this.id}: Ignoring constant supplied for unknown attribute \"${attributeName}\"`)();\n      }\n    }\n  }\n\n  _setPipelineNeedsUpdate(reason: string): void {\n    this._pipelineNeedsUpdate = this._pipelineNeedsUpdate || reason;\n  }\n\n  _updatePipeline(): RenderPipeline {\n    if (this._pipelineNeedsUpdate) {\n      if (this.pipeline) {\n        log.log(1, `Model ${this.id}: Recreating pipeline because \"${this._pipelineNeedsUpdate}\".`)();\n      }\n      this._pipelineNeedsUpdate = false;\n      this.pipeline = this.device.createRenderPipeline({\n        ...this.props,\n        bufferLayout: this.bufferLayout,\n        topology: this.topology,\n        parameters: this.parameters,\n        vs: this.device.createShader({id: '{$this.id}-vertex', stage: 'vertex', source: this.vs}),\n        fs: this.fs ? this.device.createShader({id: '{$this.id}-fragment', stage: 'fragment', source: this.fs}) : null\n      });\n      this._attributeInfos = getAttributeInfosFromLayouts(\n        this.pipeline.shaderLayout,\n        this.bufferLayout\n      );\n    }\n    return this.pipeline;\n  }\n}\n\n/** TODO - move to core, document add tests */\nfunction mergeBufferLayouts(layouts1: BufferLayout[], layouts2: BufferLayout[]): BufferLayout[] {\n  const layouts = [...layouts1];\n  for (const attribute of layouts2) {\n    const index = layouts.findIndex(attribute2 => attribute2.name === attribute.name);\n    if (index < 0) {\n      layouts.push(attribute);\n    } else {\n      layouts[index] = attribute;\n    }\n  }\n  return layouts;\n}\n"],"mappings":"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"}

package/dist/scenegraph/group-node.d.ts

@@ -0,0 +1,21 @@
+import { Matrix4 } from '@math.gl/core';
+import { ScenegraphNode, ScenegraphNodeProps } from './scenegraph-node';
+export type GroupNodeProps = ScenegraphNodeProps & {
+    children?: ScenegraphNode[];
+};
+export declare class GroupNode extends ScenegraphNode {
+    children: ScenegraphNode[];
+    constructor(children: ScenegraphNode[]);
+    constructor(props?: GroupNodeProps);
+    getBounds(): [number[], number[]] | null;
+    destroy(): void;
+    add(...children: (ScenegraphNode | ScenegraphNode[])[]): this;
+    remove(child: ScenegraphNode): this;
+    removeAll(): this;
+    traverse(visitor: (node: ScenegraphNode, context: {
+        worldMatrix: Matrix4;
+    }) => void, { worldMatrix }?: {
+        worldMatrix?: Matrix4;
+    }): void;
+}
+//# sourceMappingURL=group-node.d.ts.map

package/dist/scenegraph/group-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-node.d.ts","sourceRoot":"","sources":["../../src/scenegraph/group-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAU,MAAM,eAAe,CAAC;AAE/C,OAAO,EAAC,cAAc,EAAE,mBAAmB,EAAC,MAAM,mBAAmB,CAAC;AAEtE,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG;IACjD,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B,CAAA;AAED,qBAAa,SAAU,SAAQ,cAAc;IAC3C,QAAQ,EAAE,cAAc,EAAE,CAAC;gBAEf,QAAQ,EAAE,cAAc,EAAE;gBAC1B,KAAK,CAAC,EAAE,cAAc;IAazB,SAAS,IAAI,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI;IAkCxC,OAAO,IAAI,IAAI;IAOxB,GAAG,CAAC,GAAG,QAAQ,EAAE,CAAC,cAAc,GAAG,cAAc,EAAE,CAAC,EAAE,GAAG,IAAI;IAW7D,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IASnC,SAAS,IAAI,IAAI;IAKjB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE;QAAC,WAAW,EAAE,OAAO,CAAA;KAAC,KAAK,IAAI,EAAE,EAAC,WAA2B,EAAC;;KAAK;CAWtH"}

package/dist/scenegraph/group-node.js

@@ -0,0 +1,94 @@
+import { Matrix4, Vector3 } from '@math.gl/core';
+import { log } from '@luma.gl/core';
+import { ScenegraphNode } from "./scenegraph-node.js";
+export class GroupNode extends ScenegraphNode {
+  constructor() {
+    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    props = Array.isArray(props) ? {
+      children: props
+    } : props;
+    const {
+      children = []
+    } = props;
+    log.assert(children.every(child => child instanceof ScenegraphNode), 'every child must an instance of ScenegraphNode');
+    super(props);
+    this.children = void 0;
+    this.children = children;
+  }
+  getBounds() {
+    const result = [[Infinity, Infinity, Infinity], [-Infinity, -Infinity, -Infinity]];
+    this.traverse((node, _ref) => {
+      let {
+        worldMatrix
+      } = _ref;
+      const bounds = node.getBounds();
+      if (!bounds) {
+        return;
+      }
+      const [min, max] = bounds;
+      const center = new Vector3(min).add(max).divide([2, 2, 2]);
+      worldMatrix.transformAsPoint(center, center);
+      const halfSize = new Vector3(max).subtract(min).divide([2, 2, 2]);
+      worldMatrix.transformAsVector(halfSize, halfSize);
+      for (let v = 0; v < 8; v++) {
+        const position = new Vector3(v & 0b001 ? -1 : 1, v & 0b010 ? -1 : 1, v & 0b100 ? -1 : 1).multiply(halfSize).add(center);
+        for (let i = 0; i < 3; i++) {
+          result[0][i] = Math.min(result[0][i], position[i]);
+          result[1][i] = Math.max(result[1][i], position[i]);
+        }
+      }
+    });
+    if (!Number.isFinite(result[0][0])) {
+      return null;
+    }
+    return result;
+  }
+  destroy() {
+    this.children.forEach(child => child.destroy());
+    this.removeAll();
+    super.destroy();
+  }
+  add() {
+    for (var _len = arguments.length, children = new Array(_len), _key = 0; _key < _len; _key++) {
+      children[_key] = arguments[_key];
+    }
+    for (const child of children) {
+      if (Array.isArray(child)) {
+        this.add(...child);
+      } else {
+        this.children.push(child);
+      }
+    }
+    return this;
+  }
+  remove(child) {
+    const children = this.children;
+    const indexOf = children.indexOf(child);
+    if (indexOf > -1) {
+      children.splice(indexOf, 1);
+    }
+    return this;
+  }
+  removeAll() {
+    this.children = [];
+    return this;
+  }
+  traverse(visitor) {
+    let {
+      worldMatrix = new Matrix4()
+    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    const modelMatrix = new Matrix4(worldMatrix).multiplyRight(this.matrix);
+    for (const child of this.children) {
+      if (child instanceof GroupNode) {
+        child.traverse(visitor, {
+          worldMatrix: modelMatrix
+        });
+      } else {
+        visitor(child, {
+          worldMatrix: modelMatrix
+        });
+      }
+    }
+  }
+}
+//# sourceMappingURL=group-node.js.map

package/dist/scenegraph/group-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-node.js","names":["Matrix4","Vector3","log","ScenegraphNode","GroupNode","constructor","props","arguments","length","undefined","Array","isArray","children","assert","every","child","getBounds","result","Infinity","traverse","node","_ref","worldMatrix","bounds","min","max","center","add","divide","transformAsPoint","halfSize","subtract","transformAsVector","v","position","multiply","i","Math","Number","isFinite","destroy","forEach","removeAll","_len","_key","push","remove","indexOf","splice","visitor","modelMatrix","multiplyRight","matrix"],"sources":["../../src/scenegraph/group-node.ts"],"sourcesContent":["import {Matrix4, Vector3} from '@math.gl/core';\nimport {log} from '@luma.gl/core';\nimport {ScenegraphNode, ScenegraphNodeProps} from './scenegraph-node';\n\nexport type GroupNodeProps = ScenegraphNodeProps & {\n  children?: ScenegraphNode[];\n}\n\nexport class GroupNode extends ScenegraphNode {\n  children: ScenegraphNode[];\n\n  constructor(children: ScenegraphNode[]);\n  constructor(props?: GroupNodeProps);\n\n  constructor(props: ScenegraphNode[] | GroupNodeProps = {}) {\n    props = Array.isArray(props) ? {children: props} : props;\n    const {children = []} = props;\n    log.assert(\n      children.every((child) => child instanceof ScenegraphNode),\n      'every child must an instance of ScenegraphNode'\n    );\n    super(props);\n    this.children = children;\n  }\n\n  override getBounds(): [number[], number[]] | null {\n    const result: [number[], number[]] = [[Infinity, Infinity, Infinity], [-Infinity, -Infinity, -Infinity]];\n\n    this.traverse((node, {worldMatrix}) => {\n      const bounds = node.getBounds();\n      if (!bounds) {\n        return;\n      }\n      const [min, max] = bounds;\n      const center = new Vector3(min).add(max).divide([2, 2, 2]);\n      worldMatrix.transformAsPoint(center, center);\n      const halfSize = new Vector3(max).subtract(min).divide([2, 2, 2]);\n      worldMatrix.transformAsVector(halfSize, halfSize);\n\n      for (let v = 0; v < 8; v++) {\n        // Test all 8 corners of the box\n        const position = new Vector3(\n          v & 0b001 ? -1 : 1,\n          v & 0b010 ? -1 : 1,\n          v & 0b100 ? -1 : 1\n        ).multiply(halfSize).add(center);\n\n        for (let i = 0; i < 3; i++) {\n          result[0][i] = Math.min(result[0][i], position[i]);\n          result[1][i] = Math.max(result[1][i], position[i]);\n        }\n      }\n    });\n    if (!Number.isFinite(result[0][0])) {\n      return null;\n    }\n    return result;\n  }\n\n  override destroy(): void {\n    this.children.forEach((child) => child.destroy());\n    this.removeAll();\n    super.destroy();\n  }\n\n  // Unpacks arrays and nested arrays of children\n  add(...children: (ScenegraphNode | ScenegraphNode[])[]): this {\n    for (const child of children) {\n      if (Array.isArray(child)) {\n        this.add(...child);\n      } else {\n        this.children.push(child);\n      }\n    }\n    return this;\n  }\n\n  remove(child: ScenegraphNode): this {\n    const children = this.children;\n    const indexOf = children.indexOf(child);\n    if (indexOf > -1) {\n      children.splice(indexOf, 1);\n    }\n    return this;\n  }\n\n  removeAll(): this {\n    this.children = [];\n    return this;\n  }\n\n  traverse(visitor: (node: ScenegraphNode, context: {worldMatrix: Matrix4}) => void, {worldMatrix = new Matrix4()} = {}) {\n    const modelMatrix = new Matrix4(worldMatrix).multiplyRight(this.matrix);\n\n    for (const child of this.children) {\n      if (child instanceof GroupNode) {\n        child.traverse(visitor, {worldMatrix: modelMatrix});\n      } else {\n        visitor(child, {worldMatrix: modelMatrix});\n      }\n    }\n  }\n}\n"],"mappings":"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"}