@xtctwins/tctwins-core 1.0.19 → 1.0.21

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xtctwins/tctwins-core",
-	"version": "1.0.19",
+	"version": "1.0.21",
 	"private": false,
 	"description": "Web Programming Toolkit for 3D/2D BIM and CAD",
 	"module": "./dist/tctwins-core.es.js",

package/types/extras/PointerCircle/PointerCircle.d.ts

@@ -0,0 +1,51 @@
+import { Viewer } from "../../viewer";
+export class PointerCircle {
+	/**
+	 * Constructs a new PointerCircle.
+	 *
+	 * @param {Viewer} viewer The Viewer instance.
+	 * @param {Object} [cfg] PointerCircle configuration.
+	 * @param {boolean} [cfg.active=true] Whether PointerCircle is active. The PointerCircle can only be shown when this is `true` (default).
+	 * @param {number} [cfg.zoomFactor=2] The zoom factor for the lens.
+	 */
+	constructor(
+		viewer: Viewer,
+		cfg?: {
+			active?: boolean;
+			zoomFactor?: number;
+		}
+	);
+
+	/**
+	 * Show the circle at the given canvas coordinates and begin shrinking it.
+	 */
+	start(circlePos: any): void;
+
+	/**
+	 * Stop the shricking circle and hide it.
+	 */
+	stop(): void;
+
+	/**
+	 * Sets the zoom factor for the lens.
+	 *
+	 * This is `2` by default.
+	 *
+	 * @param durationMs
+	 */
+	set durationMs(durationMs: number);
+
+	/**
+	 * Gets the zoom factor for the lens.
+	 *
+	 * This is `2` by default.
+	 *
+	 * @returns Number
+	 */
+	get durationMs(): number;
+
+	/**
+	 * Destroys this PointerLens.
+	 */
+	destroy(): void;
+}

package/types/extras/PointerCircle/index.d.ts

@@ -0,0 +1 @@
+export * from "./PointerCircle";

package/types/extras/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./ContextMenu";
 export * from "./PointerLens";
+export * from "./PointerCircle";

package/types/plugins/AngleMeasurementsPlugin/AngleMeasurementsPlugin.d.ts

@@ -110,4 +110,18 @@ export declare class AngleMeasurementsPlugin extends Plugin {
 	 * @param {Function} callback Callback fired on the event
 	 */
 	on(event: "measurementDestroyed", callback: (measurement: AngleMeasurement) => void): void;
+
+	/**
+	 * trigger when hover measure object
+	 * @param event
+	 * @param e
+	 */
+	on(event: "mouseOver", e: any): void;
+
+	/**
+	 * trigger when leave measure object
+	 * @param event
+	 * @param e
+	 */
+	on(event: "mouseLeave", e: any): void;
 }

package/types/plugins/AngleMeasurementsPlugin/AngleMeasurementsTouchControl.d.ts

@@ -0,0 +1,117 @@
+import { AngleMeasurementsControl } from "./AngleMeasurementsControl.js";
+import { AngleMeasurementsPlugin } from "./AngleMeasurementsPlugin.js";
+import { PointerLens } from "../../extras/PointerLens/PointerLens.js";
+import { PointerCircle } from "../../extras/PointerCircle/PointerCircle.js";
+/**
+ * Creates {@link AngleMeasurement}s in an {@link AngleMeasurementsPlugin} from mouse input.
+ *
+ * @example
+ * import { Viewer, XKTLoaderPlugin, AngleMeasurementsPlugin, AngleMeasurementsMouseControl, PointerLens } from "xeokit-sdk.es.js";
+ *
+ * const viewer = new Viewer({
+ *     canvasId: "myCanvas",
+ * });
+ *
+ * viewer.camera.eye = [-3.93, 2.85, 27.01];
+ * viewer.camera.look = [4.40, 3.72, 8.89];
+ * viewer.camera.up = [-0.01, 0.99, 0.039];
+ *
+ * const xktLoader = new XKTLoaderPlugin(viewer);
+ *
+ * const sceneModel = xktLoader.load({
+ *     id: "myModel",
+ *     src: "Duplex.xkt"
+ * });
+ *
+ * const angleMeasurements = new AngleMeasurementsPlugin(viewer);
+ *
+ * const pointerLens = new PointerLens(viewer); // Create a PointerLens instance
+ *
+ * const angleMeasurementsMouseControl = new AngleMeasurementsMouseControl(angleMeasurements, {
+ *     pointerLens: pointerLens,
+ *     snapping: true
+ * });
+ *
+ * angleMeasurementsMouseControl.activate();
+ */
+export class AngleMeasurementsTouchControl extends AngleMeasurementsControl {
+	/**
+	 * Creates a AngleMeasurementsTouchControl bound to the given AngleMeasurementsPlugin.
+	 * @param {PointerLens} [cfg.pointerLens] A PointerLens to use to provide a magnified view of the cursor when snapping is enabled.
+	 * @param {boolean} [cfg.snapToEdge=true] Whether to initially enable snap-to-vertex and snap-to-edge for this AngleMeasurementsMouseControl.
+	 * @param {boolean} [cfg.snapToVertex=true] Whether to initially enable snap-to-vertex and snap-to-edge for this AngleMeasurementsMouseControl.
+	 * @param {_offsetX} [cfg._offsetX] _offsetX of the mouse
+	 * @param {_offsetY} [cfg._offsetY] _offsetY of the mouse
+	 */
+	constructor(
+		angleMeasurementsPlugin: AngleMeasurementsPlugin,
+		cfg?: {
+			pointerLens?: PointerLens;
+			snapToEdge?: boolean;
+			snapToVertex?: boolean;
+			offsetX?: number;
+			offsetY?: number;
+		}
+	);
+
+	/**
+	 * @return {number}  mouse offset
+	 */
+	get offsetX(): number;
+
+	/**
+	 * @param {number} offsetX
+	 */
+	set offsetX(offsetX: number);
+
+	/**
+	 * @return {number}  mouse offset
+	 */
+	get offsetY(): number;
+
+	/**
+	 * @param {number} offsetY
+	 */
+	set offsetY(offsetY: number);
+
+	/**
+	 * Gets whether this AngleMeasurementsMouseControl is currently active, responding to input.
+	 *
+	 * @returns {boolean} True if active, false otherwise.
+	 */
+	get active(): boolean;
+
+	/**
+	 * Sets whether snap-to-vertex and snap-to-edge are enabled for this AngleMeasurementsMouseControl.
+	 *
+	 * @param {boolean} snapping True to enable snap-to-vertex and snap-to-edge, false to disable.
+	 */
+	set snapping(snapping: boolean);
+
+	/**
+	 * Gets whether snap-to-vertex and snap-to-edge are enabled for this AngleMeasurementsMouseControl.
+	 *
+	 * @returns {boolean} True if snap-to-vertex and snap-to-edge are enabled, false otherwise.
+	 */
+	get snapping(): boolean;
+
+	/**
+	 * Activates this AngleMeasurementsMouseControl, making it responsive to input.
+	 */
+	activate(): void;
+
+	/**
+	 * Deactivates this AngleMeasurementsMouseControl, making it unresponsive to input.
+	 */
+	deactivate(): void;
+
+	/**
+	 * Resets this AngleMeasurementsMouseControl, destroying any AngleMeasurement under construction.
+	 */
+	reset(): void;
+
+	/**
+	 * Destroys this AngleMeasurementsMouseControl.
+	 */
+	destroy(): void;
+}

package/types/plugins/AngleMeasurementsPlugin/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./AngleMeasurementsPlugin";
 export * from "./AngleMeasurementsControl";
-export * from "./AngleMeasurementsMouseControl";
+export * from "./AngleMeasurementsMouseControl";
+export * from "./AngleMeasurementsTouchControl";

package/types/plugins/AnnotationsPlugin/AnnotationsPlugin.d.ts

@@ -3,148 +3,155 @@ import { Entity, Plugin, Viewer } from "../../viewer";
 import { Annotation } from "./Annotation";
 
 export declare type AnnotationsPluginConfiguration = {
-  /** Optional ID for this plugin, so that we can find it within {@link Viewer.plugins}. */
-  id?: string;
-  /** HTML text template for Annotation markers. Defaults to ````<div></div>````. Ignored on {@link Annotation}s configured with a ````markerElementId````. */
-  markerHTML?: string;
-  /** HTML text template for Annotation labels. Defaults to ````<div></div>````.  Ignored on {@link Annotation}s configured with a ````labelElementId````. */
-  labelHTML?: string;
-  /** Container DOM element for markers and labels. Defaults to ````document.body````. */
-  container?: HTMLElement;
-  /** Map of default values to insert into the HTML templates for the marker and label. */
-  values?: { [key: string]: string | number };
-  /** The amount by which each {@link Annotation} is offset from the surface of its {@link Entity} when we create the Annotation by supplying a {@link PickResult} to {@link AnnotationsPlugin.createAnnotation}.*/
-  surfaceOffset?: number;
+	/** Optional ID for this plugin, so that we can find it within {@link Viewer.plugins}. */
+	id?: string;
+	/** HTML text template for Annotation markers. Defaults to ````<div></div>````. Ignored on {@link Annotation}s configured with a ````markerElementId````. */
+	markerHTML?: string;
+	/** HTML text template for Annotation labels. Defaults to ````<div></div>````.  Ignored on {@link Annotation}s configured with a ````labelElementId````. */
+	labelHTML?: string;
+	/** Container DOM element for markers and labels. Defaults to ````document.body````. */
+	container?: HTMLElement;
+	/** Map of default values to insert into the HTML templates for the marker and label. */
+	values?: { [key: string]: string | number };
+	/** The amount by which each {@link Annotation} is offset from the surface of its {@link Entity} when we create the Annotation by supplying a {@link PickResult} to {@link AnnotationsPlugin.createAnnotation}.*/
+	surfaceOffset?: number;
 };
 
 /**
  * {@link Viewer} plugin that creates {@link Annotation}s.
  */
 export declare class AnnotationsPlugin extends Plugin {
-  /**
-   * @constructor
-   * @param {Viewer} viewer The Viewer.
-   * @param {AnnotationsPluginConfiguration} cfg  Plugin configuration.
-   */
-  constructor(viewer: Viewer, cfg: AnnotationsPluginConfiguration);
+	/**
+	 * @constructor
+	 * @param {Viewer} viewer The Viewer.
+	 * @param {AnnotationsPluginConfiguration} cfg  Plugin configuration.
+	 */
+	constructor(viewer: Viewer, cfg: AnnotationsPluginConfiguration);
 
-  /**
-   * The {@link Annotation}s created by {@link AnnotationsPlugin.createAnnotation}, each mapped to its {@link Annotation.id}.
-   * @type {{String:Annotation}}
-   */
-  annotations: { [key:string]: Annotation };
+	/**
+	 * The {@link Annotation}s created by {@link AnnotationsPlugin.createAnnotation}, each mapped to its {@link Annotation.id}.
+	 * @type {{String:Annotation}}
+	 */
+	annotations: { [key: string]: Annotation };
 
-  /**
-   * Sets the amount by which each {@link Annotation} is offset from the surface of its {@link Entity}, when we
-   * create the Annotation by supplying a {@link PickResult} to {@link AnnotationsPlugin.createAnnotation}.
-   *
-   * See the class comments for more info.
-   *
-   * This is ````0.3```` by default.
-   *
-   * @param {Number} surfaceOffset The surface offset.
-   */
-  set surfaceOffset(arg: number);
-  
-  /**
-   * Gets the amount by which an {@link Annotation} is offset from the surface of its {@link Entity} when
-   * created by {@link AnnotationsPlugin.createAnnotation}, when we
-   * create the Annotation by supplying a {@link PickResult} to {@link AnnotationsPlugin.createAnnotation}.
-   *
-   * This is ````0.3```` by default.
-   *
-   * @returns {Number} The surface offset.
-   */
-  get surfaceOffset(): number;
+	/**
+	 * Sets the amount by which each {@link Annotation} is offset from the surface of its {@link Entity}, when we
+	 * create the Annotation by supplying a {@link PickResult} to {@link AnnotationsPlugin.createAnnotation}.
+	 *
+	 * See the class comments for more info.
+	 *
+	 * This is ````0.3```` by default.
+	 *
+	 * @param {Number} surfaceOffset The surface offset.
+	 */
+	set surfaceOffset(arg: number);
 
-  /**
-   * Creates an {@link Annotation}.
-   *
-   * The Annotation is then registered by {@link Annotation.id} in {@link AnnotationsPlugin.annotations}.
-   *
-   * @param {Object} params Annotation configuration.
-   * @param {String} params.id Unique ID to assign to {@link Annotation.id}. The Annotation will be registered by this in {@link AnnotationsPlugin.annotations} and {@link Scene.components}. Must be unique among all components in the {@link Viewer}.
-   * @param {String} [params.markerElementId] ID of pre-existing DOM element to render the marker. This overrides ````markerHTML```` and does not support ````values```` (data is baked into the label DOM element).
-   * @param {String} [params.labelElementId] ID of pre-existing DOM element to render the label. This overrides ````labelHTML```` and does not support ````values```` (data is baked into the label DOM element).
-   * @param {String} [params.markerHTML] HTML text template for the Annotation marker. Defaults to the marker HTML given to the AnnotationsPlugin constructor. Ignored if you provide ````markerElementId````.
-   * @param {String} [params.labelHTML] HTML text template for the Annotation label. Defaults to the label HTML given to the AnnotationsPlugin constructor. Ignored if you provide ````labelElementId````.
-   * @param {Number[]} [params.worldPos=[0,0,0]] World-space position of the Annotation marker, assigned to {@link Annotation.worldPos}.
-   * @param {Entity} [params.entity] Optional {@link Entity} to associate the Annotation with. Causes {@link Annotation.visible} to be ````false```` whenever {@link Entity.visible} is also ````false````.
-   * @param {PickResult} [params.pickResult] Sets the Annotation's World-space position and direction vector from the given {@link PickResult}'s {@link PickResult.worldPos} and {@link PickResult.worldNormal}, and the Annotation's Entity from {@link PickResult.entity}. Causes ````worldPos```` and ````entity```` parameters to be ignored, if they are also given.
-   * @param {Boolean} [params.occludable=false] Indicates whether or not the {@link Annotation} marker and label are hidden whenever the marker occluded by {@link Entity}s in the {@link Scene}. The
-   * {@link Scene} periodically occlusion-tests all Annotations on every 20th "tick" (which represents a rendered frame). We can adjust that frequency via property {@link Scene.ticksPerOcclusionTest}.
-   * @param  {{String:(String|Number)}} [params.values={}] Map of values to insert into the HTML templates for the marker and label. These will be inserted in addition to any values given to the AnnotationsPlugin constructor.
-   * @param {Boolean} [params.markerShown=true] Whether to initially show the {@link Annotation} marker.
-   * @param {Boolean} [params.labelShown=false] Whether to initially show the {@link Annotation} label.
-   * @param {Number[]} [params.eye] Optional World-space position for {@link Camera.eye}, used when this Annotation is associated with a {@link Camera} position.
-   * @param {Number[]} [params.look] Optional World-space position for {@link Camera.look}, used when this Annotation is associated with a {@link Camera} position.
-   * @param {Number[]} [params.up] Optional World-space position for {@link Camera.up}, used when this Annotation is associated with a {@link Camera} position.
-   * @param {String} [params.projection] Optional projection type for {@link Camera.projection}, used when this Annotation is associated with a {@link Camera} position.
-   * @returns {Annotation} The new {@link Annotation}.
-   */
-  createAnnotation(params: {
-      id: string;
-      markerElementId?: string;
-      labelElementId?: string;
-      markerHTML?: string;
-      labelHTML?: string;
-      worldPos?: number[];
-      entity?: Entity;
-      pickResult?: PickResult;
-      occludable?: boolean;
-      values?: { [key: string]: string | number };
-      markerShown?: boolean;
-      labelShown?: boolean;
-      eye?: number[];
-      look?: number[];
-      up?: number[];
-      projection?: string;
-  }): Annotation;
-  
-  /**
-   * Destroys an {@link Annotation}.
-   *
-   * @param {String} id ID of Annotation to destroy.
-   */
-  destroyAnnotation(id: string): void;
+	/**
+	 * Gets the amount by which an {@link Annotation} is offset from the surface of its {@link Entity} when
+	 * created by {@link AnnotationsPlugin.createAnnotation}, when we
+	 * create the Annotation by supplying a {@link PickResult} to {@link AnnotationsPlugin.createAnnotation}.
+	 *
+	 * This is ````0.3```` by default.
+	 *
+	 * @returns {Number} The surface offset.
+	 */
+	get surfaceOffset(): number;
 
-  /**
-   * Destroys all {@link Annotation}s.
-   */
-  clear(): void;
+	/**
+	 * Creates an {@link Annotation}.
+	 *
+	 * The Annotation is then registered by {@link Annotation.id} in {@link AnnotationsPlugin.annotations}.
+	 *
+	 * @param {Object} params Annotation configuration.
+	 * @param {String} params.id Unique ID to assign to {@link Annotation.id}. The Annotation will be registered by this in {@link AnnotationsPlugin.annotations} and {@link Scene.components}. Must be unique among all components in the {@link Viewer}.
+	 * @param {String} [params.markerElementId] ID of pre-existing DOM element to render the marker. This overrides ````markerHTML```` and does not support ````values```` (data is baked into the label DOM element).
+	 * @param {String} [params.labelElementId] ID of pre-existing DOM element to render the label. This overrides ````labelHTML```` and does not support ````values```` (data is baked into the label DOM element).
+	 * @param {String} [params.markerHTML] HTML text template for the Annotation marker. Defaults to the marker HTML given to the AnnotationsPlugin constructor. Ignored if you provide ````markerElementId````.
+	 * @param {String} [params.labelHTML] HTML text template for the Annotation label. Defaults to the label HTML given to the AnnotationsPlugin constructor. Ignored if you provide ````labelElementId````.
+	 * @param {Number[]} [params.worldPos=[0,0,0]] World-space position of the Annotation marker, assigned to {@link Annotation.worldPos}.
+	 * @param {Entity} [params.entity] Optional {@link Entity} to associate the Annotation with. Causes {@link Annotation.visible} to be ````false```` whenever {@link Entity.visible} is also ````false````.
+	 * @param {PickResult} [params.pickResult] Sets the Annotation's World-space position and direction vector from the given {@link PickResult}'s {@link PickResult.worldPos} and {@link PickResult.worldNormal}, and the Annotation's Entity from {@link PickResult.entity}. Causes ````worldPos```` and ````entity```` parameters to be ignored, if they are also given.
+	 * @param {Boolean} [params.occludable=false] Indicates whether or not the {@link Annotation} marker and label are hidden whenever the marker occluded by {@link Entity}s in the {@link Scene}. The
+	 * {@link Scene} periodically occlusion-tests all Annotations on every 20th "tick" (which represents a rendered frame). We can adjust that frequency via property {@link Scene.ticksPerOcclusionTest}.
+	 * @param  {{String:(String|Number)}} [params.values={}] Map of values to insert into the HTML templates for the marker and label. These will be inserted in addition to any values given to the AnnotationsPlugin constructor.
+	 * @param {Boolean} [params.markerShown=true] Whether to initially show the {@link Annotation} marker.
+	 * @param {Boolean} [params.labelShown=false] Whether to initially show the {@link Annotation} label.
+	 * @param {Number[]} [params.eye] Optional World-space position for {@link Camera.eye}, used when this Annotation is associated with a {@link Camera} position.
+	 * @param {Number[]} [params.look] Optional World-space position for {@link Camera.look}, used when this Annotation is associated with a {@link Camera} position.
+	 * @param {Number[]} [params.up] Optional World-space position for {@link Camera.up}, used when this Annotation is associated with a {@link Camera} position.
+	 * @param {String} [params.projection] Optional projection type for {@link Camera.projection}, used when this Annotation is associated with a {@link Camera} position.
+	 * @returns {Annotation} The new {@link Annotation}.
+	 */
+	createAnnotation(params: {
+		id: string;
+		markerElementId?: string;
+		labelElementId?: string;
+		markerHTML?: string;
+		labelHTML?: string;
+		worldPos?: number[];
+		entity?: Entity;
+		pickResult?: PickResult;
+		occludable?: boolean;
+		values?: { [key: string]: string | number };
+		markerShown?: boolean;
+		labelShown?: boolean;
+		eye?: number[];
+		look?: number[];
+		up?: number[];
+		projection?: string;
+	}): Annotation;
 
-  /**
-   * Fires when a annotation is created.
-   * @param {String} event The annotationCreated event
-   * @param {Function} callback Callback fired on the event
-   */
-  on(event: "annotationCreated", callback: (annotationId: string)=> void): void;
+	/**
+	 * Destroys an {@link Annotation}.
+	 *
+	 * @param {String} id ID of Annotation to destroy.
+	 */
+	destroyAnnotation(id: string): void;
 
-  /**
-   * Fires when a annotation is destroyed.
-   * @param {String} event The annotationDestroyed event
-   * @param {Function} callback Callback fired on the event
-   */
-  on(event: "annotationDestroyed", callback: (annotationId: string)=> void): void;
+	/**
+	 * Destroys all {@link Annotation}s.
+	 */
+	clear(): void;
 
-  /**
-   * Fires when a mouse enters a annotation.
-   * @param {String} event The markerMouseEnter event
-   * @param {Function} callback Callback fired on the event
-   */
-   on(event: "markerMouseEnter", callback: (annotation: Annotation)=> void): void;
+	/**
+	 * Fires when a annotation is created.
+	 * @param {String} event The annotationCreated event
+	 * @param {Function} callback Callback fired on the event
+	 */
+	on(event: "annotationCreated", callback: (annotationId: string) => void): void;
 
-  /**
-   * Fires when a mouse leave an annotation.
-   * @param {String} event The markerMouseLeave event
-   * @param {Function} callback Callback fired on the event
-   */
-  on(event: "markerMouseLeave", callback: (annotation: Annotation)=> void): void;
+	/**
+	 * Fires when a annotation is destroyed.
+	 * @param {String} event The annotationDestroyed event
+	 * @param {Function} callback Callback fired on the event
+	 */
+	on(event: "annotationDestroyed", callback: (annotationId: string) => void): void;
 
-  /**
-   * Fires when a mouse leave an annotation.
-   * @param {String} event The markerClicked event
-   * @param {Function} callback Callback fired on the event
-   */
-  on(event: "markerClicked", callback: (annotation: Annotation)=> void): void;
+	/**
+	 * Fires when a mouse enters a annotation.
+	 * @param {String} event The markerMouseEnter event
+	 * @param {Function} callback Callback fired on the event
+	 */
+	on(event: "markerMouseEnter", callback: (annotation: Annotation) => void): void;
+
+	/**
+	 * Fires when a mouse leave an annotation.
+	 * @param {String} event The markerMouseLeave event
+	 * @param {Function} callback Callback fired on the event
+	 */
+	on(event: "markerMouseLeave", callback: (annotation: Annotation) => void): void;
+
+	/**
+	 * Fires when a mouse click an annotation.
+	 * @param {String} event The markerClicked event
+	 * @param {Function} callback Callback fired on the event
+	 */
+	on(event: "markerClicked", callback: (annotation: Annotation) => void): void;
+
+	/**
+	 * Fires when a mouse dbclick an annotation.
+	 * @param {String} event The markerDoubleClicked event
+	 * @param {Function} callback Callback fired on the event
+	 */
+	on(event: "markerDoubleClicked", callback: (annotation: Annotation) => void): void;
 }

package/types/plugins/DistanceMeasurementsPlugin/DistanceMeasurementsMouseControl.d.ts

@@ -1,5 +1,4 @@
 import { DistanceMeasurementsControl } from "./DistanceMeasurementsControl.js";
-
 import { DistanceMeasurementsPlugin } from "./DistanceMeasurementsPlugin";
 import { PointerLens } from "../../extras/PointerLens/PointerLens";