added support for 3d plans from png and pdfs.

package.json

@@ -53,6 +53,7 @@
     "@types/three": "^0.143.0",
     "deepmerge": "^4.2.2",
     "is-plain-object": "^5.0.0",
+    "pdfjs-dist": "^4.6.82",
     "ste-events": "^3.0.7",
     "ste-signals": "^3.0.9",
     "ste-simple-events": "^3.0.7",

src/main.ts

@@ -1,4 +1,5 @@
-import { Viewer, open, THREE, getViewerSettingsFromUrl } from '.'
+import { Viewer, open, getViewerSettingsFromUrl } from '.'
+import * as THREE from 'three'
 
 // Parse URL for source file
 const params = new URLSearchParams(window.location.search)
@@ -36,6 +37,10 @@ async function load (url: string | ArrayBuffer) {
   viewer.camera.save()
   viewer.gizmos.loading.visible = false
 
+  const plan = await viewer.gizmos.plans.addPlan('https://vimdevelopment01storage.blob.core.windows.net/samples/floor_plan.png')
+  const plan2 = await viewer.gizmos.plans.addPlan('https://vimdevelopment01storage.blob.core.windows.net/samples/floor_plan.pdf')
+  plan.color = new THREE.Color(0x00ff00)
+
   // Useful for debuging in console.
   globalThis.THREE = THREE
   globalThis.vim = vim

src/vim-loader/colorAttributes.ts

@@ -3,7 +3,7 @@
  */
 
 import * as THREE from 'three'
-import { MergedSubmesh } from './mesh'
+import { MergedSubmesh, SimpleMesh } from './mesh'
 import { Vim } from './vim'
 import { InsertableSubmesh } from './progressive/insertableSubmesh'
 import { AttributeTarget } from './objectAttributes'
@@ -101,6 +101,9 @@ export class ColorAttribute {
       this.resetMergedInsertableColor(sub)
       return
     }
+    if (sub instanceof SimpleMesh) {
+      return
+    }
 
     const colors = sub.three.geometry.getAttribute(
       'color'

src/vim-loader/mesh.ts

@@ -115,7 +115,7 @@ export class Mesh {
    * Returns submesh for given index.
    */
   getSubMesh (index: number) {
-    return new StandardSubmesh(this, index)
+    return new SealedSubmesh(this, index)
   }
 
   /**
@@ -126,15 +126,15 @@ export class Mesh {
       throw new Error('Can only be called when mesh.merged = true')
     }
     const index = this.binarySearch(this.submeshes, faceIndex * 3)
-    return new StandardSubmesh(this, index)
+    return new SealedSubmesh(this, index)
   }
 
   /**
    *
    * @returns Returns all submeshes
    */
   getSubmeshes () {
-    return this.instances.map((s, i) => new StandardSubmesh(this, i))
+    return this.instances.map((s, i) => new SealedSubmesh(this, i))
   }
 
   private binarySearch (array: number[], element: number) {
@@ -164,7 +164,8 @@ export class Mesh {
 }
 
 // eslint-disable-next-line no-use-before-define
-export type MergedSubmesh = StandardSubmesh | InsertableSubmesh
+export type MergedSubmesh = SealedSubmesh | InsertableSubmesh | SimpleMesh
+// eslint-disable-next-line no-use-before-define
 export type Submesh = MergedSubmesh | InstancedSubmesh
 
 export class SimpleInstanceSubmesh {
@@ -179,7 +180,21 @@ export class SimpleInstanceSubmesh {
   }
 }
 
-export class StandardSubmesh {
+export class SimpleMesh {
+  mesh: THREE.Mesh
+  get three () { return this.mesh }
+  readonly index : number = 0
+  readonly merged = true
+  readonly meshStart = 0
+  readonly meshEnd : number
+
+  constructor (mesh: THREE.Mesh) {
+    this.mesh = mesh
+    this.meshEnd = mesh.geometry.index!.count
+  }
+}
+
+export class SealedSubmesh {
   mesh: Mesh
   index: number
 

src/vim-loader/objectAttributes.ts

@@ -3,9 +3,9 @@
  */
 
 import * as THREE from 'three'
-import { MergedSubmesh, SimpleInstanceSubmesh, Submesh } from './mesh'
+import { MergedSubmesh, SimpleInstanceSubmesh, SimpleMesh, Submesh } from './mesh'
 
-export type AttributeTarget = Submesh | SimpleInstanceSubmesh
+export type AttributeTarget = Submesh | SimpleInstanceSubmesh | SimpleMesh
 
 export class ObjectAttribute<T> {
   readonly vertexAttribute: string
@@ -51,7 +51,7 @@ export class ObjectAttribute<T> {
     for (let m = 0; m < this._meshes.length; m++) {
       const sub = this._meshes[m]
       if (sub.merged) {
-        this.applyMerged(sub as MergedSubmesh, number)
+        this.applyMerged(sub, number)
       } else {
         this.applyInstanced(sub, number)
       }

src/vim-loader/progressive/insertableSubmesh.ts

@@ -9,6 +9,7 @@ export class InsertableSubmesh {
   mesh: InsertableMesh
   index: number
   private _colors: Float32Array
+  readonly merged = true
 
   constructor (mesh: InsertableMesh, index: number) {
     this.mesh = mesh
@@ -26,13 +27,6 @@ export class InsertableSubmesh {
     return this.mesh.mesh
   }
 
-  /**
-   * True if parent mesh is merged.
-   */
-  get merged () {
-    return true
-  }
-
   private get submesh () {
     return this.mesh.geometry.submeshes[this.index]
   }

src/vim-loader/progressive/instancedSubmesh.ts

@@ -8,6 +8,7 @@ import { InstancedMesh } from './instancedMesh'
 export class InstancedSubmesh {
   mesh: InstancedMesh
   index: number
+  readonly merged = false
 
   constructor (mesh: InstancedMesh, index: number) {
     this.mesh = mesh
@@ -25,13 +26,6 @@ export class InstancedSubmesh {
     return this.mesh.mesh
   }
 
-  /**
-   * True if parent mesh is merged.
-   */
-  get merged () {
-    return false
-  }
-
   /**
    * Returns vim instance associated with this submesh.
    */

src/vim-webgl-viewer/camera/camera.ts

@@ -115,6 +115,11 @@ export interface ICamera {
    */
   stop () : void
 
+  /**
+   * Immediately stops the camera movement. And prevents any further movement until set to false.
+   */
+  freeze: boolean
+
   /**
    * The target at which the camera is looking at and around which it rotates.
    */
@@ -152,6 +157,7 @@ export class Camera implements ICamera {
   private _inputVelocity = new THREE.Vector3()
   private _velocity = new THREE.Vector3()
   private _speed: number = 0
+  private _freeze: boolean = false
 
   // orbit
   private _orthographic: boolean = false
@@ -204,13 +210,25 @@ export class Camera implements ICamera {
   /** Ignore movement permissions when true */
   private _force: boolean = false
 
+  get freeze () {
+    return this._freeze
+  }
+
+  set freeze (value: boolean) {
+    this._freeze = value
+  }
+
   /**
    * Represents allowed movement along each axis using a Vector3 object.
    * Each component of the Vector3 should be either 0 or 1 to enable/disable movement along the corresponding axis.
    */
   private _allowedMovement = new THREE.Vector3(1, 1, 1)
   get allowedMovement () {
-    return this._force ? new THREE.Vector3(1, 1, 1) : this._allowedMovement
+    return this._force
+      ? new THREE.Vector3(1, 1, 1)
+      : this._freeze
+        ? new THREE.Vector3(0, 0, 0)
+        : this._allowedMovement
   }
 
   set allowedMovement (axes: THREE.Vector3) {
@@ -225,7 +243,11 @@ export class Camera implements ICamera {
    * Each component of the Vector2 should be either 0 or 1 to enable/disable rotation around the corresponding axis.
    */
   get allowedRotation () {
-    return this._force ? new THREE.Vector2(1, 1) : this._allowedRotation
+    return this._force
+      ? new THREE.Vector2(1, 1)
+      : this._freeze
+        ? new THREE.Vector2(0, 0)
+        : this._allowedRotation
   }
 
   set allowedRotation (axes: THREE.Vector2) {

src/vim-webgl-viewer/gizmos/gizmos.ts

@@ -7,6 +7,7 @@ import { IMeasure, Measure } from './measure/measure'
 import { SectionBox } from './sectionBox/sectionBox'
 import { GizmoMarkers } from './markers/gizmoMarkers'
 import { Camera } from '../camera/camera'
+import { Plans2D } from './plans2D'
 
 /**
  * Represents a collection of gizmos used for various visualization and interaction purposes within the viewer.
@@ -53,6 +54,8 @@ export class Gizmos {
    */
   readonly markers: GizmoMarkers
 
+  readonly plans : Plans2D
+
   constructor (viewer: Viewer, camera : Camera) {
     this.viewer = viewer
     this._measure = new Measure(viewer)
@@ -67,6 +70,7 @@ export class Gizmos {
     this.rectangle = new GizmoRectangle(viewer)
     this.axes = new GizmoAxes(camera, viewer.viewport, viewer.settings.axes)
     this.markers = new GizmoMarkers(viewer)
+    this.plans = new Plans2D(viewer)
     viewer.viewport.canvas.parentElement?.prepend(this.axes.canvas)
   }