@xeokit/xeokit-sdk 2.6.0-beta-16 → 2.6.0

package/package.json

@@ -1,14 +1,13 @@
 {
   "name": "@xeokit/xeokit-sdk",
-  "version": "2.6.0-beta-16",
+  "version": "2.6.0",
   "description": "Web Programming Toolkit for 3D/2D BIM and AEC Graphics",
   "module": "./dist/xeokit-sdk.es.js",
   "main": "./dist/xeokit-sdk.cjs.js",
   "types": "./types/index.d.ts",
   "scripts": {
-    "build": "rollup --config rollup.config.js; rollup --config rollup.minified.config.js; cp node_modules/web-ifc/web-ifc.wasm dist/.",
-    "dev-build": "rollup --config rollup.dev.config.js; cp node_modules/web-ifc/web-ifc.wasm dist/.",
-    "test": "percy exec -- node ./snapshots.js",
+    "build": "rollup --config rollup.config.js; rollup --config rollup.minified.config.js",
+    "dev-build": "rollup --config rollup.dev.config.js",
     "docs": "rm -Rf ./docs/*; ./node_modules/.bin/esdoc",
     "typedocs": "rm -Rf ./docs/*; typedoc --tsconfig tsconfig.json",
     "publish": "npm publish --access public"

package/src/extras/ContextMenu/ContextMenu.js

@@ -47,9 +47,9 @@ class Item {
 /**
  * @desc A customizable HTML context menu.
  *
- * [<img src="http://xeokit.io/img/docs/ContextMenu/ContextMenu.gif">](https://xeokit.github.io/xeokit-sdk/examples/#ContextMenu_Canvas_TreeViewPlugin_Custom)
+ * [<img src="http://xeokit.io/img/docs/ContextMenu/ContextMenu.gif">](https://xeokit.github.io/xeokit-sdk/examples/index.html#ContextMenu_Canvas_TreeViewPlugin_Custom)
  *
- * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#ContextMenu_Canvas_TreeViewPlugin_Custom)]
+ * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#ContextMenu_Canvas_TreeViewPlugin_Custom)]
  *
  * ## Overview
  *
@@ -92,7 +92,7 @@ class Item {
  *
  * We'll also initially enable the ````ContextMenu````.
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#ContextMenu_Canvas_Custom)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#ContextMenu_Canvas_Custom)]
  *
  * ````javascript
  * const canvasContextMenu = new ContextMenu({
@@ -183,7 +183,7 @@ class Item {
  * In the example below, we'll create a simple ````ContextMenu```` that allows us to toggle the selection of an object
  * via its first item, which changes text depending on whether we are selecting or deselecting the object.
  *
- * [[Run an example](https://xeokit.github.io/xeokit-sdk/examples/#ContextMenu_dynamicItemTitles)]
+ * [[Run an example](https://xeokit.github.io/xeokit-sdk/examples/index.html#ContextMenu_dynamicItemTitles)]
  *
  * ````javascript
  * const canvasContextMenu = new ContextMenu({
@@ -224,7 +224,7 @@ class Item {
  * Note that our "Effects" item has no ````doAction```` callback, because an item with a sub-menu performs no
  * action of its own.
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#ContextMenu_subMenus)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#ContextMenu_subMenus)]
  *
  * ````javascript
  * const canvasContextMenu = new ContextMenu({

package/src/extras/PointerLens/PointerLens.js

@@ -5,7 +5,7 @@
  * This component is used by {@link DistanceMeasurementsControl} and {@link AngleMeasurementsControl}
  * to help position the pointer when snap-to-vertex or snap-toedge is enabled.
  *
- * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/measurements/#distance_modelWithMeasurements)]
+ * [[Run an example](https://xeokit.github.io/xeokit-sdk/examples/measurement/#distance_createWithMouse_snapping)]
  *
  * ````JavaScript
  *

package/src/plugins/AngleMeasurementsPlugin/AngleMeasurementsPlugin.js

@@ -5,10 +5,10 @@ import {AngleMeasurementsMouseControl} from "./AngleMeasurementsMouseControl.js"
 /**
  * {@link Viewer} plugin for measuring angles.
  *
- * [<img src="https://user-images.githubusercontent.com/83100/63641903-61488180-c6b6-11e9-8e00-895b9d16dc4b.gif">](https://xeokit.github.io/xeokit-sdk/examples/#measurements_angle_createWithMouse)
+ * [<img src="https://user-images.githubusercontent.com/83100/63641903-61488180-c6b6-11e9-8e00-895b9d16dc4b.gif">](https://xeokit.github.io/xeokit-sdk/examples/index.html#measurements_angle_createWithMouse)
  *
- * * [[Example 1: Model with angle measurements](https://xeokit.github.io/xeokit-sdk/examples/#measurements_angle_modelWithMeasurements)]
- * * [[Example 2: Create angle measurements with mouse](https://xeokit.github.io/xeokit-sdk/examples/#measurements_angle_createWithMouse)]
+ * * [[Example 1: Model with angle measurements](https://xeokit.github.io/xeokit-sdk/examples/index.html#measurements_angle_modelWithMeasurements)]
+ * * [[Example 2: Create angle measurements with mouse](https://xeokit.github.io/xeokit-sdk/examples/measurement/#angle_createWithMouse_snapping)]
  *
  * ## Overview
  *
@@ -28,7 +28,7 @@ import {AngleMeasurementsMouseControl} from "./AngleMeasurementsMouseControl.js"
  * Note how each AngleMeasurement has ````origin````, ````corner```` and  ````target````, which each indicate a 3D World-space
  * position on the surface of an {@link Entity}. These can be aon the same Entity, or on different Entitys.
  *
- * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#measurements_angle_modelWithMeasurements)]
+ * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#measurements_angle_modelWithMeasurements)]
  *
  * ````JavaScript
  * import {Viewer, XKTLoaderPlugin, AngleMeasurementsPlugin} from "xeokit-sdk.es.js";
@@ -99,7 +99,7 @@ import {AngleMeasurementsMouseControl} from "./AngleMeasurementsMouseControl.js"
  * The AngleMeasurementControl will then wait for the next click on any Entity, to begin constructing
  * another AngleMeasurement, and so on, until deactivated again.
  *
- * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#measurements_angle_createWithMouse)]
+ * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/measurement/#angle_createWithMouse_snapping)]
  *
  * ````JavaScript
  * import {Viewer, XKTLoaderPlugin, AngleMeasurementsPlugin, AngleMeasurementsMouseControl, PointerLens} from "xeokit-sdk.es.js";

package/src/plugins/AnnotationsPlugin/AnnotationsPlugin.js

@@ -10,13 +10,13 @@ const tempVec3c = math.vec3();
 /**
  * {@link Viewer} plugin that creates {@link Annotation}s.
  *
- * [<img src="https://user-images.githubusercontent.com/83100/58403089-26589280-8062-11e9-8652-aed61a4e8c64.gif">](https://xeokit.github.io/xeokit-sdk/examples/#annotations_clickFlyToPosition)
+ * [<img src="https://user-images.githubusercontent.com/83100/58403089-26589280-8062-11e9-8652-aed61a4e8c64.gif">](https://xeokit.github.io/xeokit-sdk/examples/index.html#annotations_clickFlyToPosition)
  *
- * * [[Example 1: Create annotations with mouse](https://xeokit.github.io/xeokit-sdk/examples/#annotations_createWithMouse)]
- * * [[Example 2: Click annotations to toggle labels](https://xeokit.github.io/xeokit-sdk/examples/#annotations_clickShowLabels)]
- * * [[Example 3: Hover annotations to show labels](https://xeokit.github.io/xeokit-sdk/examples/#annotations_hoverShowLabels)]
- * * [[Example 4: Click annotations to fly to viewpoint](https://xeokit.github.io/xeokit-sdk/examples/#annotations_clickFlyToPosition)]
- * * [[Example 5: Create Annotations with externally-created elements](https://xeokit.github.io/xeokit-sdk/examples/#annotations_externalElements)]
+ * * [[Example 1: Create annotations with mouse](https://xeokit.github.io/xeokit-sdk/examples/index.html#annotations_createWithMouse)]
+ * * [[Example 2: Click annotations to toggle labels](https://xeokit.github.io/xeokit-sdk/examples/index.html#annotations_clickShowLabels)]
+ * * [[Example 3: Hover annotations to show labels](https://xeokit.github.io/xeokit-sdk/examples/index.html#annotations_hoverShowLabels)]
+ * * [[Example 4: Click annotations to fly to viewpoint](https://xeokit.github.io/xeokit-sdk/examples/index.html#annotations_clickFlyToPosition)]
+ * * [[Example 5: Create Annotations with externally-created elements](https://xeokit.github.io/xeokit-sdk/examples/index.html#annotations_externalElements)]
  *
  * ## Overview
  *
@@ -46,7 +46,7 @@ const tempVec3c = math.vec3();
  *
  * Finally, we'll query the Annotation's position occlusion/visibility status, and subscribe to change events on those properties.
  *
- * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#annotations_clickShowLabels)]
+ * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#annotations_clickShowLabels)]
  *
  * ````JavaScript
  * import {Viewer, XKTLoaderPlugin,AnnotationsPlugin} from "xeokit-sdk.es.js";
@@ -319,7 +319,7 @@ const tempVec3c = math.vec3();
  *
  * Let's now extend our example to create an Annotation wherever we click on the surface of of our model:
  *
- * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#annotations_createWithMouse)]
+ * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#annotations_createWithMouse)]
  *
  * ````javascript
  * var i = 1; // Used to create unique Annotation IDs

package/src/plugins/AxisGizmoPlugin/AxisGizmoPlugin.js

@@ -15,7 +15,7 @@ import {math} from "../../viewer/scene/math/math.js";
  *
  * ## Usage
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#gizmos_AxisGizmoPlugin)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#gizmos_AxisGizmoPlugin)]
  *
  * ````JavaScript````
  * import {Viewer, XKTLoaderPlugin, AxisGizmoPlugin} from "xeokit-sdk.es.js";

package/src/plugins/BCFViewpointsPlugin/BCFViewpointsPlugin.js

@@ -13,10 +13,10 @@ const tempVec3c = math.vec3();
 /**
  * {@link Viewer} plugin that saves and loads BCF viewpoints as JSON objects.
  *
- * [<img src="http://xeokit.github.io/xeokit-sdk/assets/images/BCFViewpointsPlugin.png">](/examples/#BCF_SaveViewpoint)
+ * [<img src="http://xeokit.github.io/xeokit-sdk/assets/images/BCFViewpointsPlugin.png">](/examples/index.html#BCF_SaveViewpoint)
  *
- * * [[Example 1: Saving viewer state to a BCF viewpoint](https://xeokit.github.io/xeokit-sdk/examples/#BCF_SaveViewpoint)]
- * * [[Example 2: Loading viewer state from a BCF viewpoint](https://xeokit.github.io/xeokit-sdk/examples/#BCF_LoadViewpoint)]
+ * * [[Example 1: Saving viewer state to a BCF viewpoint](https://xeokit.github.io/xeokit-sdk/examples/index.html#BCF_SaveViewpoint)]
+ * * [[Example 2: Loading viewer state from a BCF viewpoint](https://xeokit.github.io/xeokit-sdk/examples/index.html#BCF_LoadViewpoint)]
  *
  * ## Overview
  *
@@ -48,7 +48,7 @@ const tempVec3c = math.vec3();
  * plan view using a {@link Bitmap}, then use a {@link BCFViewpointsPlugin#getViewpoint}
  * to save a viewpoint to JSON, which we'll log to the JavaScript developer console.
  *
- * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#BCF_SaveViewpoint)]
+ * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#BCF_SaveViewpoint)]
  *
  * ````javascript
  * import {Viewer, XKTLoaderPlugin, SectionPlanesPlugin,
@@ -277,7 +277,7 @@ const tempVec3c = math.vec3();
  * });
  * ````
  *
- * [[Run an example](/examples/#BCF_LoadViewpoint_defaultInvisible)]
+ * [[Run an example](/examples/index.html#BCF_LoadViewpoint_defaultInvisible)]
  *
  * ## Behaviour with XKTLoaderPlugin globalizeObjectIds
  *
@@ -295,8 +295,8 @@ const tempVec3c = math.vec3();
  * capture the states of the individual ````Entitys```` that represent the duplicate IFC elements. Take a look at the
  * following two examples to learn more.
  *
- * * [Example: Saving a BCF viewpoint containing duplicate models](https://xeokit.github.io/xeokit-sdk/examples/#BCF_SaveViewpoint_MultipleModels)
- * * [Example: Loading a BCF viewpoint containing duplicate models](https://xeokit.github.io/xeokit-sdk/examples/#BCF_LoadViewpoint_MultipleModels)
+ * * [Example: Saving a BCF viewpoint containing duplicate models](https://xeokit.github.io/xeokit-sdk/examples/index.html#BCF_SaveViewpoint_MultipleModels)
+ * * [Example: Loading a BCF viewpoint containing duplicate models](https://xeokit.github.io/xeokit-sdk/examples/index.html#BCF_LoadViewpoint_MultipleModels)
  *
  * **Caveat:** when loading a BCF viewpoint, we always assume that we have loaded in our target BIM viewer the same models that were
  * loaded in the viewpoint's original authoring application when the viewpoint was created.  In the case of multi-model

package/src/plugins/CityJSONLoaderPlugin/CityJSONLoaderPlugin.js

@@ -11,9 +11,9 @@ const tempVec3c = math.vec3();
 /**
  * {@link Viewer} plugin that loads models from CityJSON files.
  *
- * <a href="https://xeokit.github.io/xeokit-sdk/examples/#loading_CityJSONLoaderPlugin_Railway"><img src="https://xeokit.io/img/docs/CityJSONLoaderPlugin/CityJSONLoaderPlugin.png"></a>
+ * <a href="https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_CityJSONLoaderPlugin_Railway"><img src="https://xeokit.io/img/docs/CityJSONLoaderPlugin/CityJSONLoaderPlugin.png"></a>
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_CityJSONLoaderPlugin_Railway)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_CityJSONLoaderPlugin_Railway)]
  *
  * ## Overview
  *
@@ -53,7 +53,7 @@ const tempVec3c = math.vec3();
  * We'll also scale our model to half its size, rotate it 90 degrees about its local X-axis, then
  * translate it 100 units along its X axis.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#loading_CityJSONLoaderPlugin_Railway)]
+ * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_CityJSONLoaderPlugin_Railway)]
  *
  * ````javascript
  * import {Viewer, CityJSONLoaderPlugin} from "xeokit-sdk.es.js";

package/src/plugins/DistanceMeasurementsPlugin/DistanceMeasurementsPlugin.js

@@ -5,11 +5,11 @@ import {DistanceMeasurementsMouseControl} from "./DistanceMeasurementsMouseContr
 /**
  * {@link Viewer} plugin for measuring point-to-point distances.
  *
- * [<img src="https://user-images.githubusercontent.com/83100/63047331-867a0a80-bed4-11e9-892f-398740013c5f.gif">](https://xeokit.github.io/xeokit-sdk/examples/#measurements_distance_createWithMouse)
+ * [<img src="https://user-images.githubusercontent.com/83100/63047331-867a0a80-bed4-11e9-892f-398740013c5f.gif">](https://xeokit.github.io/xeokit-sdk/examples/index.html#measurements_distance_createWithMouse)
  *
- * * [[Example 1: Model with distance measurements](https://xeokit.github.io/xeokit-sdk/examples/#measurements_distance_modelWithMeasurements)]
- * * [[Example 2: Create distance measurements with mouse](https://xeokit.github.io/xeokit-sdk/examples/#measurements_distance_createWithMouse)]
- * * [[Example 3: Configuring units and scale](https://xeokit.github.io/xeokit-sdk/examples/#measurements_distance_unitsAndScale)
+ * * [[Example 1: Model with distance measurements](https://xeokit.github.io/xeokit-sdk/examples/index.html#measurements_distance_modelWithMeasurements)]
+ * * [[Example 2: Create distance measurements with mouse](https://xeokit.github.io/xeokit-sdk/examples/measurement/#distance_createWithMouse_snapping)]
+ * * [[Example 3: Configuring units and scale](https://xeokit.github.io/xeokit-sdk/examples/measurement/#distance_unitsAndScale)
  *
  * ## Overview
  *
@@ -29,7 +29,7 @@ import {DistanceMeasurementsMouseControl} from "./DistanceMeasurementsMouseContr
  * Note how each DistanceMeasurement has ````origin```` and ````target```` endpoints, which each indicate a 3D World-space
  * position on the surface of an {@link Entity}. The endpoints can be attached to the same Entity, or to different Entitys.
  *
- * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/measurements/#distance_modelWithMeasurements)]
+ * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/measurement/#distance_modelWithMeasurements)]
  *
  * ````JavaScript
  * import {Viewer, XKTLoaderPlugin, DistanceMeasurementsPlugin} from "xeokit-sdk.es.js";
@@ -94,7 +94,7 @@ import {DistanceMeasurementsMouseControl} from "./DistanceMeasurementsMouseContr
  * The DistanceMeasurementsMouseControl will then wait for the next click on any Entity, to begin constructing
  * another DistanceMeasurement, and so on, until deactivated again.
  *
- * [[Run example](/examples/measurement/#distance_createWithMouse)]
+ * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/measurement/#distance_createWithMouse_snapping)]
  *
  * ````JavaScript
  * import {Viewer, XKTLoaderPlugin, DistanceMeasurementsPlugin, DistanceMeasurementsMouseControl, PointerLens} from "xeokit-sdk.es.js";
@@ -132,7 +132,7 @@ import {DistanceMeasurementsMouseControl} from "./DistanceMeasurementsMouseContr
  *
  * The wires belonging to our DistanceMeasurements show their lengths in Real-space coordinates, in the current unit of measurement. They will dynamically update as we set these configurations.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#measurements_distance_unitsAndScale)]
+ * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#measurements_distance_unitsAndScale)]
  *
  * ````JavaScript
  * const metrics = viewer.scene.metrics;
@@ -146,7 +146,7 @@ import {DistanceMeasurementsMouseControl} from "./DistanceMeasurementsMouseContr
  * In our fourth example, we'll attach event handlers to our plugin, to catch when the user
  * hovers or right-clicks over our measurements.
  *
- * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#measurements_distance_modelWithMeasurements)]
+ * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#measurements_distance_modelWithMeasurements)]
  *
  * ````javascript
  * import {Viewer, XKTLoaderPlugin, DistanceMeasurementsPlugin, DistanceMeasurementsMouseControl, PointerLens} from "xeokit-sdk.es.js";

package/src/plugins/FaceAlignedSectionPlanesPlugin/FaceAlignedSectionPlanesPlugin.js

@@ -10,9 +10,9 @@ const tempVec3 = math.vec3();
 /**
  * FaceAlignedSectionPlanesPlugin is a {@link Viewer} plugin that creates and edits face-aligned {@link SectionPlane}s.
  *
- * [<img src="https://xeokit.github.io/xeokit-sdk/assets/images/FaceAlignedSectionPlanesPlugin.gif">](https://xeokit.github.io/xeokit-sdk/examples/#gizmos_FaceAlignedSectionPlanesPlugin)
+ * [<img src="https://xeokit.github.io/xeokit-sdk/assets/images/FaceAlignedSectionPlanesPlugin.gif">](https://xeokit.github.io/xeokit-sdk/examples/index.html#gizmos_FaceAlignedSectionPlanesPlugin)
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#gizmos_FaceAlignedSectionPlanesPlugin)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/slicing/#FaceAlignedSectionPlanesPlugin)]
  *
  * ## Overview
  *

package/src/plugins/FastNavPlugin/FastNavPlugin.js

@@ -4,7 +4,7 @@ import {Plugin} from "../../viewer/Plugin.js";
  * {@link Viewer} plugin that makes interaction smoother with large models, by temporarily switching
  * the Viewer to faster, lower-quality rendering modes whenever we interact.
  *
- * [<img src="https://xeokit.io/img/docs/FastNavPlugin/FastNavPlugin.gif">](https://xeokit.github.io/xeokit-sdk/examples/#performance_FastNavPlugin)
+ * [<img src="https://xeokit.io/img/docs/FastNavPlugin/FastNavPlugin.gif">](https://xeokit.github.io/xeokit-sdk/examples/index.html#performance_FastNavPlugin)
  *
  * FastNavPlugin works by hiding specified Viewer rendering features, and optionally scaling the Viewer's canvas
  * resolution, whenever we interact with the Viewer. Then, once we've finished interacting, FastNavPlugin restores those
@@ -38,7 +38,7 @@ import {Plugin} from "../../viewer/Plugin.js";
  * not continually flipping between low and high quality as we interact. Since we're only rendering ambient shadows when not interacting, we'll also treat ourselves
  * to expensive, high-quality SAO settings, that we wouldn't normally configure for an interactive SAO effect.
  *
- * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#performance_FastNavPlugin)]
+ * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#performance_FastNavPlugin)]
  *
  * ````javascript
  * import {Viewer, XKTLoaderPlugin, FastNavPlugin} from "xeokit-sdk.es.js";

package/src/plugins/LASLoaderPlugin/LASLoaderPlugin.js

@@ -12,9 +12,9 @@ const MAX_VERTICES = 500000; // TODO: Rough estimate
 /**
  * {@link Viewer} plugin that loads lidar point cloud geometry from LAS files.
  *
- * <a href="https://xeokit.github.io/xeokit-sdk/examples/#loading_LASLoaderPlugin_Autzen"><img src="https://xeokit.github.io/xeokit-sdk/assets/images/autzen.png"></a>
+ * <a href="https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_LASLoaderPlugin_Autzen"><img src="https://xeokit.github.io/xeokit-sdk/assets/images/autzen.png"></a>
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_LASLoaderPlugin_Autzen)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_LASLoaderPlugin_Autzen)]
  *
  * ## Summary
  *
@@ -53,7 +53,7 @@ const MAX_VERTICES = 500000; // TODO: Rough estimate
  * a [LAS file](/assets/models/las/). Once the model has
  * loaded, we'll then find its {@link MetaModel}, and the {@link MetaObject} and {@link Entity} that represent its point cloud.
  *
- * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_LASLoaderPlugin_Autzen)]
+ * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_LASLoaderPlugin_Autzen)]
  *
  * ````javascript
  * import {Viewer, LASLoaderPlugin} from "xeokit-sdk.es.js";

package/src/plugins/NavCubePlugin/NavCubePlugin.js

@@ -17,9 +17,9 @@ const tempMat4a = math.mat4();
 /**
  * {@link Viewer} plugin that lets us look at the entire {@link Scene} from along a chosen axis or diagonal.
  *
- *  [<img src="https://user-images.githubusercontent.com/83100/55674490-c93c2e00-58b5-11e9-8a28-eb08876947c0.gif">](https://xeokit.github.io/xeokit-sdk/examples/#gizmos_NavCubePlugin)
+ *  [<img src="https://user-images.githubusercontent.com/83100/55674490-c93c2e00-58b5-11e9-8a28-eb08876947c0.gif">](https://xeokit.github.io/xeokit-sdk/examples/index.html#gizmos_NavCubePlugin)
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#gizmos_NavCubePlugin)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#gizmos_NavCubePlugin)]
  *
  * ## Overview
  *

package/src/plugins/OBJLoaderPlugin/OBJLoaderPlugin.js

@@ -22,7 +22,7 @@ import {OBJSceneGraphLoader} from "./OBJSceneGraphLoader.js";
  *
  * ## Usage
  *
- * [[Run this example](/examples/#loading_OBJ_SportsCar)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/cad/#OBJ_SportsCar_ExplodeModel)]
  *
  * ````javascript
  * import {Viewer, OBJLoaderPlugin} from "xeokit-sdk.es.js";

package/src/plugins/STLLoaderPlugin/STLLoaderPlugin.js

@@ -43,7 +43,7 @@ import {STLDefaultDataSource} from "./STLDefaultDataSource.js";
  * we'll use the {@link CameraFlightAnimation} to fly the {@link Camera} to look at boundary of the model. We'll
  * then get the model's {@link Entity} from the {@link Scene} and highlight the whole model.
  *
- *  * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_STL_SpurGear)]
+ *  * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_STL_SpurGear)]
  *
  * ````javascript
  * // Create a xeokit Viewer
@@ -88,7 +88,7 @@ import {STLDefaultDataSource} from "./STLDefaultDataSource.js";
  * file data straight into the {@link STLLoaderPlugin#load} method. In the example below, to show how it's done, we'll pre-load
  * our STL file data, then pass it straight into that method.
  *
- *  * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_STL_dataAsParam)]
+ *  * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_STL_dataAsParam)]
  *
  * ````javascript
  * loadSTL("./models/stl/binary/spurGear.stl", (stlData) =>{
@@ -131,7 +131,7 @@ import {STLDefaultDataSource} from "./STLDefaultDataSource.js";
  * custom data source object, through which it can load STL files. For this example, our data source just loads
  * them via HTTP, for simplicity. Once we've created the STLLoaderPlugin, we'll load our STL file as before.
  *
- *  * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_STL_dataSource)]
+ *  * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_STL_dataSource)]
  *
  * ````javascript
  * // Our custom STL data access strategy - implementation happens to be the same as STLDefaultDataSource

package/src/plugins/SectionPlanesPlugin/SectionPlanesPlugin.js

@@ -10,9 +10,9 @@ const tempVec3 = math.vec3();
 /**
  * SectionPlanesPlugin is a {@link Viewer} plugin that manages {@link SectionPlane}s.
  *
- * [<img src="https://user-images.githubusercontent.com/83100/57724962-406e9a00-768c-11e9-9f1f-3d178a3ec11f.gif">](https://xeokit.github.io/xeokit-sdk/examples/#gizmos_SectionPlanesPlugin)
+ * [<img src="https://user-images.githubusercontent.com/83100/57724962-406e9a00-768c-11e9-9f1f-3d178a3ec11f.gif">](https://xeokit.github.io/xeokit-sdk/examples/index.html#gizmos_SectionPlanesPlugin)
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#gizmos_SectionPlanesPlugin)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#gizmos_SectionPlanesPlugin)]
  *
  * ## Overview
  *

package/src/plugins/TreeViewPlugin/TreeViewPlugin.js

@@ -7,9 +7,9 @@ const treeViews = [];
  * @desc A {@link Viewer} plugin that provides an HTML tree view to navigate the IFC elements in models.
  * <br>
  *
- * <a href="https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_XKT_WestRiverSideHospital" style="border: 1px solid black;"><img src="http://xeokit.io/img/docs/TreeViewPlugin/TreeViewPlugin.png"></a>
+ * <a href="https://xeokit.github.io/xeokit-sdk/examples/index.html#BIMOffline_XKT_WestRiverSideHospital" style="border: 1px solid black;"><img src="http://xeokit.io/img/docs/TreeViewPlugin/TreeViewPlugin.png"></a>
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_XKT_WestRiverSideHospital)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#BIMOffline_XKT_WestRiverSideHospital)]
  *
  * ## Overview
  *
@@ -33,7 +33,7 @@ const treeViews = [];
  * Then we'll use an {@link XKTLoaderPlugin} to load the Schependomlaan model from an
  * [.xkt file](https://github.com/xeokit/xeokit-sdk/tree/master/examples/models/xkt/schependomlaan).
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_XKT_Schependomlaan)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/navigation/#TreeViewPlugin_Containment)]
  *
  * ````javascript
  * import {Viewer, XKTLoaderPlugin, TreeViewPlugin} from "xeokit-sdk.es.js";
@@ -215,7 +215,7 @@ const treeViews = [];
  *
  * Let's use {@link ContextMenu} to show a simple context menu for the node we clicked.
  *
- * [[Run an example](https://xeokit.github.io/xeokit-sdk/examples/#ContextMenu_Canvas_TreeViewPlugin_Custom)]
+ * [[Run an example](https://xeokit.github.io/xeokit-sdk/examples/index.html#ContextMenu_Canvas_TreeViewPlugin_Custom)]
  *
  * ````javascript
  * import {ContextMenu} from "../src/extras/ContextMenu/ContextMenu.js";
@@ -306,7 +306,7 @@ const treeViews = [];
  * Let's register a callback to isolate and fit-to-view the {@link Entity}(s) represented by the node. This callback is
  * going to X-ray all the other Entitys, fly the camera to fit the Entity(s) for the clicked node, then hide the other Entitys.
  *
- * [[Run an example](https://xeokit.github.io/xeokit-sdk/examples/#ContextMenu_Canvas_TreeViewPlugin_Custom)]
+ * [[Run an example](https://xeokit.github.io/xeokit-sdk/examples/index.html#ContextMenu_Canvas_TreeViewPlugin_Custom)]
  *
  * ````javascript
  * treeView.on("nodeTitleClicked", (e) => {

package/src/plugins/WebIFCLoaderPlugin/WebIFCLoaderPlugin.js

@@ -9,9 +9,9 @@ import {worldToRTCPositions} from "../../viewer/scene/math/rtcCoords.js";
 /**
  * {@link Viewer} plugin that uses [web-ifc](https://github.com/tomvandig/web-ifc) to load BIM models directly from IFC files.
  *
- * <a href="https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_WebIFCLoaderPlugin_Duplex"><img src="https://xeokit.io/img/docs/WebIFCLoaderPlugin/WebIFCLoaderPlugin.png"></a>
+ * <a href="https://xeokit.github.io/xeokit-sdk/examples/index.html#BIMOffline_WebIFCLoaderPlugin_Duplex"><img src="https://xeokit.io/img/docs/WebIFCLoaderPlugin/WebIFCLoaderPlugin.png"></a>
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_WebIFCLoaderPlugin_Duplex)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#BIMOffline_WebIFCLoaderPlugin_Duplex)]
  *
  * ## Overview
  *
@@ -55,7 +55,7 @@ import {worldToRTCPositions} from "../../viewer/scene/math/rtcCoords.js";
  * Since this model contains IFC types, the WebIFCLoaderPlugin will set the initial appearance of each object
  * {@link Entity} according to its IFC type in {@link WebIFCLoaderPlugin#objectDefaults}.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_WebIFCLoaderPlugin_isolateStorey)]
+ * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#BIMOffline_WebIFCLoaderPlugin_isolateStorey)]
  *
  * ````javascript
  * import {Viewer, WebIFCLoaderPlugin} from "xeokit-sdk.es.js";

package/src/plugins/XKTLoaderPlugin/XKTLoaderPlugin.js

@@ -33,9 +33,9 @@ parsers[ParserV10.version] = ParserV10;
 /**
  * {@link Viewer} plugin that loads models from xeokit's optimized *````.XKT````* format.
  *
- * <a href="https://xeokit.github.io/xeokit-sdk/examples/#loading_XKT_OTCConferenceCenter"><img src="http://xeokit.io/img/docs/XKTLoaderPlugin/XKTLoaderPlugin.png"></a>
+ * <a href="https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_XKT_OTCConferenceCenter"><img src="http://xeokit.io/img/docs/XKTLoaderPlugin/XKTLoaderPlugin.png"></a>
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_XKT_OTCConferenceCenter)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_XKT_OTCConferenceCenter)]
  *
  * # Overview
  *
@@ -91,7 +91,7 @@ parsers[ParserV10.version] = ParserV10;
  *
  * Read more about this example in the user guide on [Viewing BIM Models Offline](https://www.notion.so/xeokit/Viewing-an-IFC-Model-with-xeokit-c373e48bc4094ff5b6e5c5700ff580ee).
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_XKT_metadata_Schependomlaan)]
+ * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#BIMOffline_XKT_metadata_Schependomlaan)]
  *
  * ````javascript
  * import {Viewer, XKTLoaderPlugin} from "xeokit-sdk.es.js";
@@ -178,9 +178,9 @@ parsers[ParserV10.version] = ParserV10;
  * KTX2TextureTranscoder altogether, and let the XKTLoaderPlugin use its internal default KTX2TextureTranscoder, which is configured to
  * load the Codec from the CDN. We'll stick with loading our own Codec, in case we want to run our app without an Internet connection.
  *
- * <a href="https://xeokit.github.io/xeokit-sdk/examples/#loading_XKT_Textures_HousePlan"><img src="https://xeokit.github.io/xeokit-sdk/assets/images/xktWithTextures.png"></a>
+ * <a href="https://xeokit.github.io/xeokit-sdk/examples/buildings/#xkt_vbo_textures_HousePlan"><img src="https://xeokit.github.io/xeokit-sdk/assets/images/xktWithTextures.png"></a>
  *
- * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_XKT_Textures_HousePlan)]
+ * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/buildings/#xkt_vbo_textures_HousePlan)]
  *
  * ````javascript
  * const viewer = new Viewer({
@@ -216,8 +216,6 @@ parsers[ParserV10.version] = ParserV10;
  * In the example below, we'll scale our model to half its size, rotate it 90 degrees about its local X-axis, then
  * translate it 100 units along its X axis.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#loading_XKT_Duplex_transform)]
- *
  * ````javascript
  * xktLoader.load({
  *      src: "./models/xkt/Duplex.ifc.xkt",
@@ -233,8 +231,6 @@ parsers[ParserV10.version] = ParserV10;
  *
  * In the example below, we'll load only the objects that represent walls.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_XKT_includeTypes)]
- *
  * ````javascript
  * const model2 = xktLoader.load({
  *     id: "myModel2",
@@ -247,8 +243,6 @@ parsers[ParserV10.version] = ParserV10;
  *
  * In the example below, we'll load only the objects that do not represent empty space.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_XKT_excludeTypes)]
- *
  * ````javascript
  * const model3 = xktLoader.load({
  *     id: "myModel3",
@@ -270,8 +264,6 @@ parsers[ParserV10.version] = ParserV10;
  * In the example below, we'll load a model, while configuring ````IfcSpace```` elements to be always initially invisible,
  * and ````IfcWindow```` types to be always translucent blue.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#BIMOffline_XKT_objectDefaults)]
- *
  * ````javascript
  * const myObjectDefaults = {
  *
@@ -332,8 +324,6 @@ parsers[ParserV10.version] = ParserV10;
  * In the example below, we'll customize the way XKTLoaderPlugin loads the files by configuring it with our own data source
  * object. For simplicity, our custom data source example also uses HTTP, using a couple of xeokit utility functions.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#loading_XKT_dataSource)]
- *
  * ````javascript
  * import {utils} from "xeokit-sdk.es.js";
  *
@@ -384,7 +374,7 @@ parsers[ParserV10.version] = ParserV10;
  *
  * As shown in the example below, we do this by setting {@link XKTLoaderPlugin#globalizeObjectIds} ````true```` before we load our models.
  *
- * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#TreeViewPlugin_Containment_MultipleModels)]
+ * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#TreeViewPlugin_Containment_MultipleModels)]
  *
  * ````javascript
  * xktLoader.globalizeObjectIds = true;
@@ -490,6 +480,8 @@ parsers[ParserV10.version] = ParserV10;
  * Now, to load all those XKT files into a single SceneModel and MetaModel in one operation, we pass a path to the XKT
  * manifest to `XKTLoaderPlugin.load`, as shown in the example below:
  *
+ * * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/buildings/#xkt_manifest_KarhumakiBridge)]
+ *
  * ````javascript
  * import {
  *   Viewer,

package/src/plugins/XML3DLoaderPlugin/XML3DLoaderPlugin.js

@@ -6,9 +6,9 @@ import {XML3DSceneGraphLoader} from "./XML3DSceneGraphLoader.js";
 /**
  * {@link Viewer} plugin that loads models from [3DXML](https://en.wikipedia.org/wiki/3DXML) files.
  *
- * [<img src="https://xeokit.io/img/docs/XML3DLoaderPlugin/XML3DPluginTreeView.png">](https://xeokit.github.io/xeokit-sdk/examples/#loading_3DXML_TreeView)
+ * [<img src="https://xeokit.io/img/docs/XML3DLoaderPlugin/XML3DPluginTreeView.png">](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_3DXML_TreeView)
  *
- * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_3DXML_TreeView)]
+ * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_3DXML_TreeView)]
  *
  * ## Overview
  *
@@ -32,7 +32,7 @@ import {XML3DSceneGraphLoader} from "./XML3DSceneGraphLoader.js";
  * we'll use the {@link CameraFlightAnimation} to fly the {@link Camera} to look at boundary of the model. We'll
  * then get the model's {@link Entity} from the {@link Scene} and highlight the whole model.
  *
- * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_3DXML_Widget)]
+ * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_3DXML_Widget)]
  *
  * ````javascript
  * // Create a xeokit Viewer
@@ -123,7 +123,7 @@ import {XML3DSceneGraphLoader} from "./XML3DSceneGraphLoader.js";
  * does not make sense because XML3DLoaderPlugin will set each {@link MetaObject#type} to "Default", and "storeys"
  * does not make sense because that requires some of the MetaObject#type values to be "IfcBuildingStorey".
  *
- * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_3DXML_TreeView)]
+ * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_3DXML_TreeView)]
  *
  * ## Material Type
  *
@@ -133,9 +133,9 @@ import {XML3DSceneGraphLoader} from "./XML3DSceneGraphLoader.js";
  *
  * | Material Type | Material Components Loaded  | Description | Example |
  * |:--------:|:----:|:-----:|:-----:|
- * | "PhongMaterial" (default) | {@link PhongMaterial}  | Non-physically-correct Blinn-Phong shading model | [Run example](https://xeokit.github.io/xeokit-sdk/examples/#loading_3DXML_materialType_Phong) |
- * | "MetallicMaterial" | {@link MetallicMaterial} | Physically-accurate specular-glossiness shading model | [Run example](https://xeokit.github.io/xeokit-sdk/examples/#loading_3DXML_materialType_Metallic) |
- * | "SpecularMaterial" | {@link SpecularMaterial} | Physically-accurate metallic-roughness shading model | [Run example](https://xeokit.github.io/xeokit-sdk/examples/#loading_3DXML_materialType_Specular) |
+ * | "PhongMaterial" (default) | {@link PhongMaterial}  | Non-physically-correct Blinn-Phong shading model | [Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_3DXML_materialType_Phong) |
+ * | "MetallicMaterial" | {@link MetallicMaterial} | Physically-accurate specular-glossiness shading model | [Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_3DXML_materialType_Metallic) |
+ * | "SpecularMaterial" | {@link SpecularMaterial} | Physically-accurate metallic-roughness shading model | [Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_3DXML_materialType_Specular) |
  *
  * <br>
  * Let's load our model again, this time converting the 3DXML Blinn-Phong materials to {@link SpecularMaterial}s:
@@ -148,7 +148,7 @@ import {XML3DSceneGraphLoader} from "./XML3DSceneGraphLoader.js";
  * });
  * ````
  *
- * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/#loading_3DXML_materialType_Specular)]
+ * * [[Run this example](https://xeokit.github.io/xeokit-sdk/examples/index.html#loading_3DXML_materialType_Specular)]
  *
  * @class XML3DLoaderPlugin
  */

package/src/viewer/Configs.js

@@ -13,7 +13,7 @@ let maxGeometryBatchSize = 5000000
  *
  * That's OK if we know that we're not going to view models that are geographically vast, or offset far from the World coordinate origin.
  *
- * [[Run this example](/examples/#Configs_disableDoublePrecisionAndRAF)]
+ * [[Run this example](/examples/index.html#Configs_disableDoublePrecisionAndRAF)]
  *
  * ````javascript
  * import {Configs, Viewer, XKTLoaderPlugin} from "https://cdn.jsdelivr.net/npm/@xeokit/xeokit-sdk/dist/xeokit-sdk.es.min.js";

package/src/viewer/localization/LocaleService.js

@@ -39,7 +39,7 @@ import {Map} from "./../scene/utils/Map.js";
  * If we didn't provide that particular translation in our LocaleService, or any translations for that locale,
  * then the NavCubePlugin will just fall back on its own default hard-coded translation, which in this case is "BACK".
  *
- * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/#localization_NavCubePlugin)]
+ * [[Run example](https://xeokit.github.io/xeokit-sdk/examples/index.html#localization_NavCubePlugin)]
  *
  * ````javascript
  * import {Viewer, LocaleService, NavCubePlugin, XKTLoaderPlugin} from "xeokit-sdk.es.js";