@combeenation/3d-viewer 18.5.1 → 19.0.0

package/dist/lib-cjs/utils/node-utils.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeUtils = void 0;
+const __1 = require("..");
+/**
+ * Removes transformation data from the mesh and stores it in the geometry, which is called "baking".
+ * Also considers the geometry change from morph targets and skeletons.
+ *
+ * @param settings Optionally avoid baking the transformation, as this only works conveniently if the parent structure
+ *                 is baked as well. Baking morph targets only is a use case when preparing a mesh for CSG operations,
+ *                 which doesn't consider morph targets (yet).
+ */
+function bakeGeometryOfMesh(mesh, settings) {
+    const { keepTransformation } = settings !== null && settings !== void 0 ? settings : {};
+    if (!mesh.geometry) {
+        // no geometry available, nothing to do
+        return;
+    }
+    // geometries can be shared across multiple meshes, first make them unique to avoid side-effects
+    mesh.makeGeometryUnique();
+    // Babylon.js already provides a function for baking the current skeleton changes into the geometry
+    if (mesh.skeleton) {
+        mesh.applySkeleton(mesh.skeleton);
+        mesh.skeleton = null;
+    }
+    // NOTE: in difference to skeletons and transformations there is no baking function for morph targets (yet)
+    // however another approach could be to re-apply the position and normals data, as there are nice functions for it
+    // - `getPositionData(applySkeleton: boolean = false, applyMorph: boolean = false)`
+    // - `getNormalsData(applySkeleton: boolean = false, applyMorph: boolean = false)`
+    // you can decide if skeletons and morph targets can be added, which is exactly what we want
+    // I'm still hesitant to use it because "tangent" and "UV" kinds are not supported, whereas I'm not sure if it's
+    // required
+    // => try it out when there is enough time for detailed regression tests!
+    const morphTargetManager = mesh.morphTargetManager;
+    const geometry = mesh.geometry;
+    if (morphTargetManager === null || morphTargetManager === void 0 ? void 0 : morphTargetManager.numTargets) {
+        // apply morph target vertices data to mesh geometry
+        // mostly only the "PositionKind" is implemented
+        _bakeMorphTargetManagerIntoVertices(__1.VertexBuffer.PositionKind, morphTargetManager, geometry);
+        _bakeMorphTargetManagerIntoVertices(__1.VertexBuffer.NormalKind, morphTargetManager, geometry);
+        _bakeMorphTargetManagerIntoVertices(__1.VertexBuffer.TangentKind, morphTargetManager, geometry);
+        _bakeMorphTargetManagerIntoVertices(__1.VertexBuffer.UVKind, morphTargetManager, geometry);
+        // remove morph target manager with all it's morph targets
+        mesh.morphTargetManager = null;
+    }
+    // bake the transformation data in the mesh geometry, fortunately there is already a help function from Babylon.js
+    if (!keepTransformation) {
+        mesh.bakeCurrentTransformIntoVertices();
+    }
+}
+/**
+ * @param kind morph targets can affect various vertices kinds, whereas "position" is the most common one
+ * still other kinds (like normals or tangents) can be affected as well and can be provided on this input
+ */
+function _bakeMorphTargetManagerIntoVertices(kind, morphTargetManager, geometry) {
+    const origVerticesData = geometry.getVerticesData(kind);
+    if (!origVerticesData) {
+        // no vertices data for this kind availabe on the mesh geometry
+        return;
+    }
+    let verticesData = [...origVerticesData];
+    for (let i = 0; i < morphTargetManager.numTargets; i++) {
+        const target = morphTargetManager.getTarget(i);
+        const targetVerticesData = _getVerticesDataFromMorphTarget(kind, target);
+        if (targetVerticesData) {
+            // vertices data of this kind are implemented on the morph target
+            // add the influence of this morph target to the vertices data
+            // formula is taken from: https://doc.babylonjs.com/features/featuresDeepDive/mesh/morphTargets#basics
+            verticesData = verticesData.map((oldVal, idx) => oldVal + (targetVerticesData[idx] - origVerticesData[idx]) * target.influence);
+        }
+    }
+    // apply the updated vertices data
+    geometry.setVerticesData(kind, verticesData);
+}
+function _getVerticesDataFromMorphTarget(kind, morphTarget) {
+    switch (kind) {
+        case __1.VertexBuffer.PositionKind:
+            return morphTarget.getPositions();
+        case __1.VertexBuffer.NormalKind:
+            return morphTarget.getNormals();
+        case __1.VertexBuffer.TangentKind:
+            return morphTarget.getTangents();
+        case __1.VertexBuffer.UVKind:
+            return morphTarget.getUVs();
+    }
+    return null;
+}
+// export functions under "namespace", so that they can found easier in consuming code
+exports.NodeUtils = {
+    bakeGeometryOfMesh,
+};
+//# sourceMappingURL=node-utils.js.map

package/dist/lib-cjs/utils/node-utils.js.map

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

package/dist/lib-cjs/viewer.d.ts

@@ -1,5 +1,5 @@
 import * as Index from './index';
-import { AbstractEngine, CameraManager, DebugManager, DefaultSceneSettings, DimensionLineManager, DxfExportManager, EngineOptions, EventManager, GltfExportManager, HtmlAnchorManager, MaterialManager, ModelManager, NodeParameterSubject, ParameterManager, Scene, SceneManager, TagParameterSubject, TextureManager, TransformNode } from './index';
+import { AbstractEngine, CameraManager, DebugManager, DefaultSceneSettings, DimensionLineManager, EngineOptions, EventManager, ExportManager, HtmlAnchorManager, MaterialManager, ModelManager, NodeParameterSubject, ParameterManager, Scene, SceneManager, TagParameterSubject, TextureManager, TransformNode } from './index';
 /**
  * Use this type to select nodes directly or via node or tag name.\
  * This pattern is used for excluding nodes from autofocus, GLB export, etc.
@@ -52,9 +52,8 @@ export declare class Viewer {
     protected _cameraManager: CameraManager;
     protected _debugManager: DebugManager;
     protected _dimensionLineManager: DimensionLineManager;
-    protected _dxfExportManager: DxfExportManager;
     protected _eventManager: EventManager;
-    protected _gltfExportManager: GltfExportManager;
+    protected _exportManager: ExportManager;
     protected _htmlAnchorManager: HtmlAnchorManager;
     protected _materialManager: MaterialManager;
     protected _modelManager: ModelManager;
@@ -68,9 +67,8 @@ export declare class Viewer {
     get cameraManager(): CameraManager;
     get debugManager(): DebugManager;
     get dimensionLineManager(): DimensionLineManager;
-    get dxfExportManager(): DxfExportManager;
     get eventManager(): EventManager;
-    get gltfExportManager(): GltfExportManager;
+    get exportManager(): ExportManager;
     get htmlAnchorManager(): HtmlAnchorManager;
     get materialManager(): MaterialManager;
     get modelManager(): ModelManager;

package/dist/lib-cjs/viewer.js

@@ -87,14 +87,11 @@ class Viewer {
     get dimensionLineManager() {
         return this._dimensionLineManager;
     }
-    get dxfExportManager() {
-        return this._dxfExportManager;
-    }
     get eventManager() {
         return this._eventManager;
     }
-    get gltfExportManager() {
-        return this._gltfExportManager;
+    get exportManager() {
+        return this._exportManager;
     }
     get htmlAnchorManager() {
         return this._htmlAnchorManager;
@@ -181,9 +178,8 @@ class Viewer {
         this._cameraManager = new index_1.CameraManager(this);
         this._debugManager = new index_1.DebugManager(this);
         this._dimensionLineManager = new index_1.DimensionLineManager(this);
-        this._dxfExportManager = new index_1.DxfExportManager(this);
         this._eventManager = new index_1.EventManager(this);
-        this._gltfExportManager = new index_1.GltfExportManager(this);
+        this._exportManager = new index_1.ExportManager(this);
         this._htmlAnchorManager = new index_1.HtmlAnchorManager(this);
         this._materialManager = new index_1.MaterialManager(this);
         this._modelManager = new index_1.ModelManager(this);

package/dist/lib-cjs/viewer.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combeenation/3d-viewer",
-  "version": "18.5.1",
+  "version": "19.0.0",
   "description": "Combeenation 3D Viewer",
   "homepage": "https://github.com/Combeenation/3d-viewer#readme",
   "bugs": {

package/src/index.ts

@@ -52,6 +52,7 @@ export * from '@babylonjs/gui/2D/advancedDynamicTexture';
 export * from '@babylonjs/gui/2D/controls/textBlock';
 export * from '@babylonjs/loaders/glTF/2.0/glTFLoader';
 export * from '@babylonjs/serializers/glTF/2.0/glTFSerializer';
+export * from '@babylonjs/serializers/OBJ';
 
 // Additional Babylon.js modules
 // These are not used in the "@combeenation/3d-viewer" repository directly, but required in consuming code for various
@@ -72,13 +73,13 @@ export * from './viewer-error';
 export * from './manager/camera-manager';
 export * from './manager/dimension-line-manager';
 export * from './manager/debug-manager';
-export * from './manager/dxf-export-manager';
 export * from './manager/event-manager';
-export * from './manager/gltf-export-manager';
+export * from './manager/export-manager';
 export * from './manager/html-anchor-manager';
 export * from './manager/material-manager';
 export * from './manager/model-manager';
 export * from './manager/parameter-manager';
 export * from './manager/scene-manager';
 export * from './manager/texture-manager';
-export * from './helper/decals-helper';
+export * from './utils/decal-utils';
+export * from './utils/node-utils';

package/src/internal/cbn-custom-babylon-loader-plugin.ts

@@ -1,6 +1,7 @@
 import {
   AssetContainer,
   Color4,
+  DecalUtils,
   ISceneLoaderPlugin,
   InstancedMesh,
   ParsedDecalConfiguration,
@@ -8,7 +9,6 @@ import {
   SceneLoader,
   ViewerError,
   ViewerErrorIds,
-  createDecalMesh,
 } from '../index';
 import { setInternalMetadataValue } from './metadata-helper';
 import { deleteAllTags, getTagsAsStrArr, setTagsAsString } from './tags-helper';
@@ -226,7 +226,7 @@ function _createDecals(dataParsed: unknown, container: AssetContainer): void {
 
   validatedDecals.forEach(decalConfig => {
     const { materialId, tags, ...decalMeshConfig } = decalConfig;
-    const decalMesh = createDecalMesh(decalMeshConfig, container, false);
+    const decalMesh = DecalUtils.createDecalMesh(decalMeshConfig, container, false);
 
     // optionally set material and tags directly
     if (materialId) {

package/src/internal/export-helper.ts

@@ -1,18 +1,14 @@
 import {
   DynamicTexture,
-  FloatArray,
-  Geometry,
   InstancedMesh,
   Material,
   Mesh,
-  MorphTarget,
-  MorphTargetManager,
   Node,
   NodeDescription,
+  NodeUtils,
   RenderTargetTexture,
   TransformNode,
   Vector3,
-  VertexBuffer,
   Viewer,
 } from '../index';
 import { getIsScaledDownDevice } from './device-helper';
@@ -71,7 +67,7 @@ export async function exportPreProcess(viewer: Viewer, settings?: ExportPreProce
   // bake transformation of all meshes, so that no negative scalings are left
   // it's important that this is done AFTER instanced meshes have been converted (`_prepareNodeForExport`)
   nodesForExport.forEach(node => {
-    if (node instanceof Mesh) _bakeGeometryOfMesh(node);
+    if (node instanceof Mesh) NodeUtils.bakeGeometryOfMesh(node);
   });
 
   // reset transformation of all "TransformNodes", as transform nodes are not considered by the `_bakeGeometryOfMesh`
@@ -273,52 +269,6 @@ function _createMeshFromInstancedMesh(
   return newMesh;
 }
 
-/**
- * Removes transformation data from the mesh and stores it in the geometry, which is called "baking".
- * Also considers the geometry change from morph targets.
- */
-function _bakeGeometryOfMesh(mesh: Mesh): void {
-  if (!mesh.geometry) {
-    // no geometry available, nothing to do
-    return;
-  }
-
-  // geometries can be shared across multiple meshes, first make them unique to avoid side-effects
-  mesh.makeGeometryUnique();
-
-  // Babylon.js already provides a function for baking the current skeleton changes into the geometry
-  if (mesh.skeleton) {
-    mesh.applySkeleton(mesh.skeleton);
-    mesh.skeleton = null;
-  }
-
-  // NOTE: in difference to skeletons and transformations there is no baking function for morph targets (yet)
-  // however another approach could be to re-apply the position and normals data, as there are nice functions for it
-  // - `getPositionData(applySkeleton: boolean = false, applyMorph: boolean = false)`
-  // - `getNormalsData(applySkeleton: boolean = false, applyMorph: boolean = false)`
-  // you can decide if skeletons and morph targets can be added, which is exactly what we want
-  // I'm still hesitant to use it because "tangent" and "UV" kinds are not supported, whereas I'm not sure if it's
-  // required
-  // => try it out when there is enough time for detailed regression tests!
-  const morphTargetManager = mesh.morphTargetManager;
-  const geometry = mesh.geometry;
-
-  if (morphTargetManager?.numTargets) {
-    // apply morph target vertices data to mesh geometry
-    // mostly only the "PositionKind" is implemented
-    _bakeMorphTargetManagerIntoVertices(VertexBuffer.PositionKind, morphTargetManager, geometry);
-    _bakeMorphTargetManagerIntoVertices(VertexBuffer.NormalKind, morphTargetManager, geometry);
-    _bakeMorphTargetManagerIntoVertices(VertexBuffer.TangentKind, morphTargetManager, geometry);
-    _bakeMorphTargetManagerIntoVertices(VertexBuffer.UVKind, morphTargetManager, geometry);
-
-    // remove morph target manager with all it's morph targets
-    mesh.morphTargetManager = null;
-  }
-
-  // bake the transformation data in the mesh geometry, fortunately there is already a help function from Babylon.js
-  mesh.bakeCurrentTransformIntoVertices();
-}
-
 /**
  * Resets transformation to initial state
  */
@@ -328,51 +278,3 @@ function _resetTransformation(node: TransformNode): void {
   node.rotationQuaternion = null;
   node.scaling = new Vector3(1, 1, 1);
 }
-
-/**
- * @param kind morph targets can affect various vertices kinds, whereas "position" is the most common one
- * still other kinds (like normals or tangents) can be affected as well and can be provided on this input
- */
-function _bakeMorphTargetManagerIntoVertices(
-  kind: string,
-  morphTargetManager: MorphTargetManager,
-  geometry: Geometry
-): void {
-  const origVerticesData = geometry.getVerticesData(kind);
-  if (!origVerticesData) {
-    // no vertices data for this kind availabe on the mesh geometry
-    return;
-  }
-
-  let verticesData = [...origVerticesData];
-  for (let i = 0; i < morphTargetManager.numTargets; i++) {
-    const target = morphTargetManager.getTarget(i);
-    const targetVerticesData = _getVerticesDataFromMorphTarget(kind, target);
-    if (targetVerticesData) {
-      // vertices data of this kind are implemented on the morph target
-      // add the influence of this morph target to the vertices data
-      // formula is taken from: https://doc.babylonjs.com/features/featuresDeepDive/mesh/morphTargets#basics
-      verticesData = verticesData.map(
-        (oldVal, idx) => oldVal + (targetVerticesData[idx] - origVerticesData[idx]) * target.influence
-      );
-    }
-  }
-
-  // apply the updated vertices data
-  geometry.setVerticesData(kind, verticesData);
-}
-
-function _getVerticesDataFromMorphTarget(kind: string, morphTarget: MorphTarget): FloatArray | null {
-  switch (kind) {
-    case VertexBuffer.PositionKind:
-      return morphTarget.getPositions();
-    case VertexBuffer.NormalKind:
-      return morphTarget.getNormals();
-    case VertexBuffer.TangentKind:
-      return morphTarget.getTangents();
-    case VertexBuffer.UVKind:
-      return morphTarget.getUVs();
-  }
-
-  return null;
-}

package/src/manager/export-manager.ts

@@ -0,0 +1,273 @@
+import {
+  Animation,
+  GLTF2Export,
+  IExportOptions,
+  Mesh,
+  Node,
+  NodeDescription,
+  OBJExport,
+  Vector3,
+  VertexBuffer,
+  Viewer,
+} from '../index';
+import {
+  downloadFile,
+  exportPostProcess,
+  exportPreProcess,
+  isExportableTransformNode,
+  normalizeFileName,
+} from '../internal/export-helper';
+import { getInternalMetadataValue } from '../internal/metadata-helper';
+import { nodeMatchesAnyCriteria } from '../internal/node-helper';
+import DRAWING, { Unit } from 'dxf-writer';
+
+export type GltfExportSettings = {
+  fileName?: string;
+  /** List of nodes that should be excluded from the DXF export */
+  excludeNodes?: NodeDescription[];
+  /**
+   * Adjusts the exported GLB so that known issues get automatically fixed, this is mostly targeting Apples .usdz format
+   */
+  optimizeForAR?: boolean;
+};
+
+export type DxfUnit = Unit;
+
+export type DxfExportSettings = {
+  fileName?: string;
+  /** List of nodes that should be excluded from the DXF export */
+  excludeNodes?: NodeDescription[];
+  /**
+   * Unit of the 3d model.\
+   * If a unit is set, CAD tools are able to convert the values from the DXF into the configured unit of the CAD tool.
+   */
+  unit?: DxfUnit;
+};
+
+export type ObjExportSettings = {
+  fileName?: string;
+  /** List of nodes that should be excluded from the DXF export */
+  excludeNodes?: NodeDescription[];
+};
+
+/**
+ * Manager for creating exports for glTF, DXF and OBJ of the current viewer scene
+ */
+export class ExportManager {
+  protected _maxTextureSize: number;
+
+  /**
+   * Defines options for the export.
+   * We don't allow the user to overwrite certain settings, since we rely on properties like `removeNoopRootNodes` to
+   * stay `true` in order to make the AR export work.
+   * We could theoretically allow it if AR optimization is not desired, but this may confuse the user.
+   */
+  protected static _gltfExportOptions(settings?: GltfExportSettings): IExportOptions {
+    const { excludeNodes, optimizeForAR } = settings ?? {};
+
+    return {
+      shouldExportNode: function (node: Node): boolean {
+        if (optimizeForAR) {
+          // we explicitely marked nodes, that should be exported in AR mode
+          return !!getInternalMetadataValue(node, 'exportNode');
+        } else {
+          // use the default export node check (enabled state, exclusion list, etc...)
+          return isExportableTransformNode(node, excludeNodes);
+        }
+      },
+
+      shouldExportAnimation: (animation: Animation) => !optimizeForAR,
+    };
+  }
+
+  /** @internal */
+  public constructor(protected viewer: Viewer) {
+    // store initial max texture size, so that we can restore it in the post processing
+    this._maxTextureSize = viewer.engine.getCaps().maxTextureSize;
+  }
+
+  /**
+   * Return GLB export of current scene as `File` for further processing. (e.g. upload on AR endpoint)
+   */
+  public async createGlb(settings?: GltfExportSettings): Promise<File | undefined> {
+    const { fileName, excludeNodes, optimizeForAR } = settings ?? {};
+
+    if (optimizeForAR) await exportPreProcess(this.viewer, { excludeNodes, scaleDownTextures: true });
+    const glbData = await GLTF2Export.GLBAsync(this.viewer.scene, 'dummy', ExportManager._gltfExportOptions(settings));
+    if (optimizeForAR) await exportPostProcess(this.viewer, { initialTextureSize: this._maxTextureSize });
+
+    const resBlob = glbData.glTFFiles['dummy.glb'];
+    // check if result is valid, according to the typings this could also be a string
+    if (resBlob instanceof Blob) {
+      const normalizedFileName = normalizeFileName(fileName, 'glb', 'glb-export');
+      return new File([resBlob], normalizedFileName);
+    } else {
+      // result was not a valid blob
+      return undefined;
+    }
+  }
+
+  /**
+   * Exports and downloads current scene to GLB
+   */
+  public async downloadGlb(settings?: GltfExportSettings): Promise<void> {
+    const { fileName = 'glb-export', excludeNodes, optimizeForAR } = settings ?? {};
+
+    if (optimizeForAR) await exportPreProcess(this.viewer, { excludeNodes, scaleDownTextures: true });
+    const glb = await GLTF2Export.GLBAsync(this.viewer.scene, fileName, ExportManager._gltfExportOptions(settings));
+    glb.downloadFiles();
+    if (optimizeForAR) await exportPostProcess(this.viewer, { initialTextureSize: this._maxTextureSize });
+  }
+
+  /**
+   * Exports and downloads current scene to glTF.\
+   * This may result in more than one file, since textures are exported seperately.
+   */
+  public async downloadGltf(settings?: GltfExportSettings): Promise<void> {
+    const { fileName = 'gltf-export', excludeNodes, optimizeForAR } = settings ?? {};
+
+    if (optimizeForAR) await exportPreProcess(this.viewer, { excludeNodes, scaleDownTextures: true });
+    const gltf = await GLTF2Export.GLTFAsync(
+      this.viewer.scene,
+      // no need to add .glb, as Babylon.js does that internally
+      fileName,
+      ExportManager._gltfExportOptions(settings)
+    );
+    gltf.downloadFiles();
+    if (optimizeForAR) await exportPostProcess(this.viewer, { initialTextureSize: this._maxTextureSize });
+  }
+
+  /**
+   * Returns DXF export of current scene as `File` for further processing. (e.g upload as Cfgn file)
+   */
+  public async createDxf(settings?: DxfExportSettings): Promise<File> {
+    const normalizedFileName = normalizeFileName(settings?.fileName, 'dxf', 'dxf-export');
+
+    const dxfBlob = await this._createDxfBlob(settings);
+    const dxfFile = new File([dxfBlob], normalizedFileName, { type: 'application/dxf' });
+
+    return dxfFile;
+  }
+
+  /**
+   * Creates DXF export of current scene and downloads the resulting file right away
+   */
+  public async downloadDxf(settings?: DxfExportSettings): Promise<void> {
+    const normalizedFileName = normalizeFileName(settings?.fileName, 'dxf', 'dxf-export');
+
+    const dxfBlob = await this._createDxfBlob(settings);
+
+    const url = URL.createObjectURL(dxfBlob);
+    downloadFile(url, normalizedFileName);
+    URL.revokeObjectURL(url);
+  }
+
+  /**
+   * Creates OBJ export of current scene and downloads the resulting file right away
+   */
+  // TODO 1: (optionally) create a MTL file as well
+  // TODO 2: add `createObj` function if required, for usage as cfgn file etc...
+  public async downloadObj(settings?: ObjExportSettings): Promise<void> {
+    const { fileName, excludeNodes } = settings ?? {};
+    const normalizedFileName = normalizeFileName(fileName, 'obj', 'obj-export');
+
+    await exportPreProcess(this.viewer, { excludeNodes });
+    const objString = this._createObj();
+    await exportPostProcess(this.viewer);
+
+    const objBlob = new Blob([objString], { type: 'text/plain' });
+    const url = URL.createObjectURL(objBlob);
+    downloadFile(url, normalizedFileName);
+    URL.revokeObjectURL(url);
+  }
+
+  /**
+   * Help function for creating a blob with the DXF string, as this is needed for both public interface functions
+   * (`exportDxf` & `exportDxfToFile`)
+   */
+  protected async _createDxfBlob(settings?: DxfExportSettings): Promise<Blob> {
+    const { excludeNodes, unit } = settings ?? {};
+
+    // Transformation baking pre process is required for DXF exports, as we take the plain vertex information for the
+    // DXF conversion, therefore the vertices need to be located in world already
+    await exportPreProcess(this.viewer, { excludeNodes });
+    const dxfString = this._createDxf(unit);
+    await exportPostProcess(this.viewer);
+
+    const dxfBlob = new Blob([dxfString], { type: 'application/dxf' });
+    return dxfBlob;
+  }
+
+  /**
+   * DXF creation process.\
+   * We go through all vertices of all meshes and create DXF 3d faces accordingly.
+   */
+  protected _createDxf(unit?: DxfUnit): string {
+    const DXF = new DRAWING();
+    if (unit) {
+      DXF.setUnits(unit);
+    }
+
+    const meshesToExport = this.viewer.scene.meshes.filter(
+      mesh =>
+        getInternalMetadataValue(mesh, 'exportNode') &&
+        // NOTE: can't add this criteria in pre export process, as pre export process works recursively and childs of
+        // transforms nodes or meshes without geometry can still have geometries and therefore be valid for the export
+        !nodeMatchesAnyCriteria(mesh, { hasInvalidBoundingInfo: true })
+    );
+
+    meshesToExport.forEach(mesh => {
+      const positions = mesh.getVerticesData(VertexBuffer.PositionKind);
+      const indices = mesh.getIndices();
+      if (!positions || !indices) {
+        console.warn(`Can't create DXF export of mesh "${mesh.name}", as there is no vertex data available`);
+        return;
+      }
+
+      for (let i = 0; i < indices.length; i += 3) {
+        // A face always consists of 3 vertices.
+        // First we need to get the indizes of the vertices.
+        const idx1 = indices[i];
+        const idx2 = indices[i + 1];
+        const idx3 = indices[i + 2];
+
+        // Now get the x, y, z data of the associated index.
+        // One index stores 3 vertices, thats why the index is multiplied with 3 before accessing the actual vertex
+        // position.
+        // > and z components have dedicated offsets 1 and 2.
+        // ===============
+        // Important NOTE:
+        // ===============
+        // DXF is right-handed, according to tests in AutoDesk it seems like y and z components are just switched.
+        // So we use offset 2 for y and offset 1 for z.
+        const p1 = new Vector3(positions[idx1 * 3], positions[idx1 * 3 + 2], positions[idx1 * 3 + 1]);
+        const p2 = new Vector3(positions[idx2 * 3], positions[idx2 * 3 + 2], positions[idx2 * 3 + 1]);
+        const p3 = new Vector3(positions[idx3 * 3], positions[idx3 * 3 + 2], positions[idx3 * 3 + 1]);
+
+        // Add a 3D face to the DXF (3DFACE entity).
+        // The library works with 4 points per face, but we only have 3.
+        // Using the last point 3 times is fine though.
+        DXF.drawFace(p1.x, p1.y, p1.z, p2.x, p2.y, p2.z, p3.x, p3.y, p3.z, p3.x, p3.y, p3.z);
+      }
+    });
+
+    const dxfString = DXF.toDxfString();
+    return dxfString;
+  }
+
+  /**
+   * Creates OBJ export string from meshes, which are marked for the export
+   */
+  protected _createObj(): string {
+    const meshesToExport = this.viewer.scene.meshes.filter(
+      mesh =>
+        getInternalMetadataValue(mesh, 'exportNode') &&
+        // NOTE: can't add this criteria in pre export process, as pre export process works recursively and childs of
+        // transforms nodes or meshes without geometry can still have geometries and therefore be valid for the export
+        !nodeMatchesAnyCriteria(mesh, { hasInvalidBoundingInfo: true })
+    ) as Mesh[];
+
+    const objString = OBJExport.OBJ(meshesToExport, true, 'materials', false);
+    return objString;
+  }
+}

package/src/{helper/decals-helper.ts → utils/decal-utils.ts}

@@ -78,7 +78,7 @@ export type DecalConfiguration = {
  * - overwrite decal mesh side orientation (important for glTF models)
  * - move decal along the "normal" to avoid clipping
  */
-export function createDecalMesh(config: DecalConfiguration, assetContainer: IAssetContainer, addToScene = true): Mesh {
+function createDecalMesh(config: DecalConfiguration, assetContainer: IAssetContainer, addToScene = true): Mesh {
   const sourceMesh = assetContainer.meshes.find(mesh => mesh.name === config.sourceMeshName);
   if (!sourceMesh) {
     throw new ViewerError({
@@ -127,3 +127,8 @@ export function createDecalMesh(config: DecalConfiguration, assetContainer: IAss
 
   return decalMesh;
 }
+
+// export functions under "namespace", so that they can found easier in consuming code
+export const DecalUtils = {
+  createDecalMesh,
+};