@combeenation/3d-viewer 20.0.1 → 21.0.0-alpha1

package/src/manager/debug-manager.ts

@@ -25,6 +25,7 @@ export class DebugManager {
 
   protected _axesViewer: AxesViewer | null = null;
   protected _showBoundingSphereForAutofocus: boolean = false;
+  protected _parentDomElementForInspector: HTMLElement | null = null;
 
   /** @internal */
   public constructor(protected viewer: Viewer) {}
@@ -40,7 +41,16 @@ export class DebugManager {
   }
 
   /**
-   * Enables the Babylon.js [Inspector](https://doc.babylonjs.com/legacy/inspector/).\
+   * Registers a parent DOM element to use as root for the Babylon.js inspector.
+   * When set and no explicit `options` are passed to {@link showInspector}, this element will be used
+   * as `globalRoot`, which avoids interference with the surrounding application layout.
+   */
+  public registerParentDomElementForInspector(el: HTMLElement): void {
+    this._parentDomElementForInspector = el;
+  }
+
+  /**
+   * Enables the Babylon.js [Inspector](https://doc.babylonjs.com/legacy/inspector()).\
    * Due to the additional size of the inspector, this function is only available in "development" builds!
    *
    * @returns Signalizes if inspector could be loaded
@@ -49,12 +59,16 @@ export class DebugManager {
     if (process.env.NODE_ENV === 'development') {
       const inspModule = await import(/* webpackChunkName: "inspector"*/ '@babylonjs/inspector');
 
-      if (!options && window.Cbn) {
+      const parentEl =
+        this._parentDomElementForInspector ??
+        // fallback to legacy `window.Cbn` call to support "old" cfgrs (pre Editor V2)
+        window.Cbn?.utils?.Viewer3dHelper?.getCfgrParentDomElementForInspector?.();
+
+      if (!options && parentEl) {
         // special case for usage in Combeenation configurator:
         // if no options are set the inspector will be rendered into the parent element of the configurator
         // in this way the configurator layout itself will not be affected by the inspector
-        const cfgrParentEl = window.Cbn.utils.Viewer3dHelper.getCfgrParentDomElementForInspector();
-        inspModule.Inspector.Show(this.viewer.scene, { globalRoot: cfgrParentEl });
+        inspModule.Inspector.Show(this.viewer.scene, { globalRoot: parentEl });
       } else {
         inspModule.Inspector.Show(this.viewer.scene, options ?? {});
       }

package/src/manager/material-manager.ts

@@ -30,12 +30,17 @@ export class MaterialManager {
    */
   public static readonly CBN_FALLBACK_MATERIAL_NAME = '$fallback';
 
+  protected _materialDefinitions: { [materialId: string]: object } = {};
   protected _clonedMaterials: { [name: string]: Material } = {};
   protected _createMaterialPromises: { [materialId: string]: Promise<Material | null> } = {};
 
   /** @internal */
   public constructor(protected viewer: Viewer) {}
 
+  public registerMaterials(materialDefinitions: { [materialId: string]: object }): void {
+    this._materialDefinitions = materialDefinitions;
+  }
+
   /**
    * Assigns material with certain id to desired mesh.\
    * Creates the material if not already available (see {@link getOrCreateMaterial}).
@@ -56,9 +61,9 @@ export class MaterialManager {
 
   /**
    * Returns material with certain id if already available in the scene.\
-   * If this is not the case material is created from a
-   * "[Material asset](https://docs.combeenation.com/docs/howto-create-and-use-babylon-and-material-asset)"
-   * on the Combeenation server.\
+   * If this is not the case, material is created from registered material definitions, which are most likely coming
+   * from "[Material assets](https://docs.combeenation.com/docs/howto-create-and-use-babylon-and-material-asset)" on the
+   * Combeenation server.\
    * Waits until textures of material are fully loaded and shader is compiled. In this way "flickering" effects
    * will be avoided, since the material would be incomplete without its loaded textures.
    *
@@ -78,7 +83,7 @@ export class MaterialManager {
         this.viewer.eventManager.fireEvent(ViewerEvent.MaterialCreationStart, materialId);
 
         // request not pending, call the dedicated function
-        const newCreationProm = this._createFromMaterialAsset(materialId, mesh);
+        const newCreationProm = this._createFromMaterialDefinition(materialId, mesh);
         // store the promise in a global map, so that subsequent requests can reference it
         this._createMaterialPromises[materialId] = newCreationProm;
         chosenMaterial = await newCreationProm;
@@ -153,7 +158,28 @@ export class MaterialManager {
     Object.keys(this._clonedMaterials).forEach(materialId => this.deleteClonedMaterial(materialId));
   }
 
-  protected async _createFromMaterialAsset(materialId: string, mesh?: AbstractMesh): Promise<Material | null> {
+  /**
+   * Get material defintion from registered material definitions or from legacy `Cbn.Assets.getMaterial` call
+   *
+   * @internal
+   */
+  public async getMaterialDefinition(materialId: string): Promise<object | undefined> {
+    let definition: object | undefined = this._materialDefinitions[materialId];
+    if (!definition && window.Cbn?.Assets?.getMaterial) {
+      // fallback to legacy `Cbn.Assets.getMaterial` call to support "old" cfgrs (pre Editor V2)
+      definition = await window.Cbn.Assets.getMaterial(materialId);
+    }
+
+    if (!definition) {
+      console.warn(
+        `Material definition for "${materialId}" couldn't be found. Material might not be registered or Material Asset from Combeenation server does not exist or is not connected to the configurator.`
+      );
+    }
+
+    return definition;
+  }
+
+  protected async _createFromMaterialDefinition(materialId: string, mesh?: AbstractMesh): Promise<Material | null> {
     if (materialId === MaterialManager.CBN_FALLBACK_MATERIAL_NAME) {
       const fallbackMaterial = new StandardMaterial(MaterialManager.CBN_FALLBACK_MATERIAL_NAME, this.viewer.scene);
       fallbackMaterial.disableLighting = true;
@@ -161,16 +187,8 @@ export class MaterialManager {
       return fallbackMaterial;
     }
 
-    if (!window.Cbn) {
-      return null;
-    }
-
-    const materialDefinition = await window.Cbn.Assets.getMaterial(materialId);
-
+    const materialDefinition = await this.getMaterialDefinition(materialId);
     if (!materialDefinition) {
-      console.warn(
-        `Trying to create material "${materialId}" from Combeenation asset but according asset does not exist or is not connected to the configurator.`
-      );
       return null;
     }
 

package/src/manager/parameter-manager.ts

@@ -584,7 +584,7 @@ export class ParameterManager {
    */
   protected _addBuiltInParameterObservers(): void {
     createBuiltInParameter(this, this.viewer.materialManager);
-    createBuiltInTextureParameter(this, this.viewer.scene);
+    createBuiltInTextureParameter(this, this.viewer.materialManager, this.viewer.scene);
     createPaintableParameter(this, this.viewer.scene);
   }