@xeokit/xeokit-sdk 2.5.2-beta-23 → 2.5.2-beta-24

package/dist/xeokit-sdk.cjs.js

@@ -194009,7 +194009,7 @@ const MAX_VERTICES = 500000; // TODO: Rough estimate
  *
  * ## Summary
  *
- * * Loads [LAS 1.4 Format](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) from both *.las* and *.laz* files.
+ * * Loads [LAS Formats](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) up to v1.3 from both *.las* and *.laz* files. It does not support LAS v1.4.
  * * Loads lidar point cloud positions, colors and intensities.
  * * Supports 32 and 64-bit positions.
  * * Supports 8 and 16-bit color depths.

package/dist/xeokit-sdk.es.js

@@ -194005,7 +194005,7 @@ const MAX_VERTICES = 500000; // TODO: Rough estimate
  *
  * ## Summary
  *
- * * Loads [LAS 1.4 Format](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) from both *.las* and *.laz* files.
+ * * Loads [LAS Formats](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) up to v1.3 from both *.las* and *.laz* files. It does not support LAS v1.4.
  * * Loads lidar point cloud positions, colors and intensities.
  * * Supports 32 and 64-bit positions.
  * * Supports 8 and 16-bit color depths.

package/dist/xeokit-sdk.es5.js

@@ -28465,7 +28465,7 @@ var headerBlockItems=[{item:'FileSignature',format:'char',size:4},{item:'FileSou
  *
  * ## Summary
  *
- * * Loads [LAS 1.4 Format](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) from both *.las* and *.laz* files.
+ * * Loads [LAS Formats](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) up to v1.3 from both *.las* and *.laz* files. It does not support LAS v1.4.
  * * Loads lidar point cloud positions, colors and intensities.
  * * Supports 32 and 64-bit positions.
  * * Supports 8 and 16-bit color depths.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xeokit/xeokit-sdk",
-  "version": "2.5.2-beta-23",
+  "version": "2.5.2-beta-24",
   "description": "Web Programming Toolkit for 3D/2D BIM and AEC Graphics",
   "module": "./dist/xeokit-sdk.es.js",
   "main": "./dist/xeokit-sdk.cjs.js",

package/src/plugins/LASLoaderPlugin/LASLoaderPlugin.js

@@ -18,7 +18,7 @@ const MAX_VERTICES = 500000; // TODO: Rough estimate
  *
  * ## Summary
  *
- * * Loads [LAS 1.4 Format](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) from both *.las* and *.laz* files.
+ * * Loads [LAS Formats](https://www.asprs.org/divisions-committees/lidar-division/laser-las-file-format-exchange-activities) up to v1.3 from both *.las* and *.laz* files. It does not support LAS v1.4.
  * * Loads lidar point cloud positions, colors and intensities.
  * * Supports 32 and 64-bit positions.
  * * Supports 8 and 16-bit color depths.

package/src/viewer/scene/geometry/builders/buildPolylineGeometry.js

@@ -84,4 +84,123 @@ function buildPolylineGeometry(cfg = {}) {
     });
 }
 
-export {buildPolylineGeometry};
+/**
+ * @desc Creates a 3D polyline from curve {@link Geometry}.
+ *
+ * ## Usage
+ *
+ * In the example below we'll create a {@link Mesh} with a polyline {@link ReadableGeometry} created from curves.
+ *
+ * [[Run this example](/examples/#geometry_builders_buildPolylineGeometryFromCurve)]
+ *
+ * ````javascript
+ * //------------------------------------------------------------------------------------------------------------------
+ * // Import the modules we need for this example
+ * //------------------------------------------------------------------------------------------------------------------
+ *
+ * import {buildPolylineGeometryFromCurve, Viewer, Mesh, PhongMaterial, NavCubePlugin, CubicBezierCurve, SplineCurve, QuadraticBezierCurve, ReadableGeometry} from "../../dist/xeokit-sdk.min.es.js";
+ *
+ * //------------------------------------------------------------------------------------------------------------------
+ * // Create a Viewer and arrange the camera
+ * //------------------------------------------------------------------------------------------------------------------
+ *
+ * const viewer = new Viewer({
+ *     canvasId: "myCanvas"
+ * });
+ *
+ * new NavCubePlugin(viewer, {
+ *     canvasId: "myNavCubeCanvas",
+ *     visible: true,
+ *     size: 250,
+ *     alignment: "bottomRight",
+ *     bottomMargin: 100,
+ *     rightMargin: 10
+ * });
+ *
+ * viewer.camera.eye = [0, -250, 1];
+ * viewer.camera.look = [0, 0, 0];
+ * viewer.camera.up = [0, 1, 0];
+ *
+ * //------------------------------------------------------------------------------------------------------------------
+ * // Create a mesh with polyline shape from Spline
+ * //------------------------------------------------------------------------------------------------------------------
+ *
+ * new Mesh(viewer.scene, {
+ *     geometry: new ReadableGeometry(viewer.scene, buildPolylineGeometryFromCurve({
+ *         id: "SplineCurve",
+ *         curve: new SplineCurve(viewer.scene, {
+ *             points: [
+ *                 [-65.77614, 0, -88.881992],
+ *                 [90.020852, 0, -61.589088],
+ *                 [-67.766247, 0, -22.071238],
+ *                 [93.148164, 0, -13.826507],
+ *                 [-14.033343, 0, 3.231558],
+ *                 [32.592034, 0, 9.20188],
+ *                 [3.309023, 0, 22.848332],
+ *                 [23.210098, 0, 28.818655],
+ *             ],
+ *         }),
+ *         divisions: 100,
+ *     })),
+ *     material: new PhongMaterial(viewer.scene, {
+ *         emissive: [1, 0, 0]
+ *     })
+ * });
+ *
+ * //------------------------------------------------------------------------------------------------------------------
+ * // Create a mesh with polyline shape from CubicBezier
+ * //------------------------------------------------------------------------------------------------------------------
+ *
+ * new Mesh(viewer.scene, {
+ *     geometry: new ReadableGeometry(viewer.scene, buildPolylineGeometryFromCurve({
+ *         id: "CubicBezierCurve",
+ *         curve: new CubicBezierCurve(viewer.scene, {
+ *             v0: [120, 0, 100],
+ *             v1: [120, 0, 0],
+ *             v2: [80, 0, 100],
+ *             v3: [80, 0, 0],
+ *         }),
+ *         divisions: 50,
+ *     })),
+ *     material: new PhongMaterial(viewer.scene, {
+ *         emissive: [0, 1, 0]
+ *     })
+ * });
+ *
+ * //------------------------------------------------------------------------------------------------------------------
+ * // Create a mesh with polyline shape from QuadraticBezier
+ * //------------------------------------------------------------------------------------------------------------------
+ *
+ * new Mesh(viewer.scene, {
+ *     geometry: new ReadableGeometry(viewer.scene, buildPolylineGeometryFromCurve({
+ *         id: "QuadraticBezierCurve",
+ *         curve: new QuadraticBezierCurve(viewer.scene, {
+ *             v0: [-100, 0, 100],
+ *             v1: [-50, 0, 150],
+ *             v2: [-50, 0, 0],
+ *         }),
+ *         divisions: 20,
+ *     })),
+ *     material: new PhongMaterial(viewer.scene, {
+ *         emissive: [0, 0, 1]
+ *     })
+ * });
+ * ````
+ *
+ * @function buildPolylineGeometryFromCurve
+ * @param {*} [cfg] Configs
+ * @param {String} [cfg.id] Optional ID, unique among all components in the parent {@link Scene}, generated automatically when omitted.
+ * @param {Object} [cfg.curve]  Curve for which polyline will be created.
+ * @param {Number} [cfg.divisions]  The number of divisions.
+ * @returns {Object} Configuration for a {@link Geometry} subtype.
+ */
+function buildPolylineGeometryFromCurve(cfg = {}) {
+
+    let polylinePoints = cfg.curve.getPoints(cfg.divisions).map(a => [...a]).flat();
+    return buildPolylineGeometry({
+        id: cfg.id,
+        points: polylinePoints
+    });
+}
+
+export {buildPolylineGeometry, buildPolylineGeometryFromCurve};