@lijuhong1981/cesium.utils 0.0.0-stage → 0.1.0

package/src/revisions/POI.revise.js

@@ -0,0 +1,178 @@
+import { Billboard, BillboardCollection, BoundingSphere, BoundingSphereState, Check, Label, LabelCollection, PointPrimitive, PointPrimitiveCollection } from "cesium";
+
+/**
+ * 扩展 Cesium 的 Billboard 类，补充类型标识与从集合移除的便捷方法。
+ * @class Billboard
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/Billboard.html}
+*/
+/**
+ * 扩展 Cesium 的 BillboardCollection 类，补充计算包围球的方法。
+ * @class BillboardCollection
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/BillboardCollection.html}
+*/
+/**
+ * 扩展 Cesium 的 Label 类，补充类型标识与从集合移除的便捷方法。
+ * @class Label
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/Label.html}
+*/
+/**
+ * 扩展 Cesium 的 LabelCollection 类，补充计算包围球的方法。
+ * @class LabelCollection
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/LabelCollection.html}
+*/
+/**
+ * 扩展 Cesium 的 PointPrimitive 类，补充类型标识与从集合移除的便捷方法。
+ * @class PointPrimitive
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/PointPrimitive.html}
+*/
+/**
+ * 扩展 Cesium 的 PointPrimitiveCollection 类，补充计算包围球的方法。
+ * @class PointPrimitiveCollection
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/PointPrimitiveCollection.html}
+*/
+
+/**
+ * Billboard 实例的 isBillboard 标识属性，值恒为 true。
+ * @name isBillboard
+ * @type {boolean}
+ * @memberof Billboard
+*/
+Object.defineProperties(Billboard.prototype, {
+    isBillboard: {
+        writable: false,
+        configurable: false,
+        value: true,
+    }
+});
+
+/**
+ * 将当前 Billboard 从其所属的 BillboardCollection 中移除。
+ * @memberof Billboard
+*/
+Billboard.prototype._removeFromCollection = function () {
+    if (this._billboardCollection)
+        this._billboardCollection.remove(this);
+};
+
+/**
+ * 计算 BillboardCollection 的包围球。
+ * @param {boolean} [allowPartial=false] 是否允许仅使用部分已就绪的图元计算包围球。
+ * @param {BoundingSphere} result 用于存储包围球的对象。
+ * @returns {BoundingSphereState} 包围球的计算状态。
+ * @memberof BillboardCollection
+*/
+BillboardCollection.prototype.getBoundingSphere = function (allowPartial = false, result) {
+    Check.defined('result', result);
+
+    const length = this.length;
+    if (length === 0)
+        return BoundingSphereState.FAILED;
+
+    const boundingSpheres = [];
+    for (let i = length - 1; i >= 0; i--) {
+        const billboard = this.get(i);
+        boundingSpheres[i] = new BoundingSphere(billboard.position);
+    }
+
+    BoundingSphere.fromBoundingSpheres(boundingSpheres, result);
+    // console.log('getBoundingSphere:', this.id, result);
+    return BoundingSphereState.DONE;
+};
+
+/**
+ * Label 实例的 isLabel 标识属性，值恒为 true。
+ * @name isLabel
+ * @type {boolean}
+ * @memberof Label
+*/
+Object.defineProperties(Label.prototype, {
+    isLabel: {
+        writable: false,
+        configurable: false,
+        value: true,
+    }
+});
+
+/**
+ * 将当前 Label 从其所属的 LabelCollection 中移除。
+ * @memberof Label
+*/
+Label.prototype._removeFromCollection = function () {
+    if (this._labelCollection)
+        this._labelCollection.remove(this);
+};
+
+/**
+ * 计算 LabelCollection 的包围球。
+ * @param {boolean} [allowPartial=false] 是否允许仅使用部分已就绪的图元计算包围球。
+ * @param {BoundingSphere} result 用于存储包围球的对象。
+ * @returns {BoundingSphereState} 包围球的计算状态。
+ * @memberof LabelCollection
+*/
+LabelCollection.prototype.getBoundingSphere = function (allowPartial = false, result) {
+    Check.defined('result', result);
+
+    const length = this.length;
+    if (length === 0)
+        return BoundingSphereState.FAILED;
+
+    const boundingSpheres = [];
+    for (let i = length - 1; i >= 0; i--) {
+        const label = this.get(i);
+        boundingSpheres[i] = new BoundingSphere(label.position);
+    }
+
+    BoundingSphere.fromBoundingSpheres(boundingSpheres, result);
+    // console.log('getBoundingSphere:', this.id, result);
+    return BoundingSphereState.DONE;
+};
+
+/**
+ * PointPrimitive 实例的 isPointPrimitive 标识属性，值恒为 true。
+ * @name isPointPrimitive
+ * @type {boolean}
+ * @memberof PointPrimitive
+*/
+Object.defineProperties(PointPrimitive.prototype, {
+    isPointPrimitive: {
+        writable: false,
+        configurable: true,
+        value: true,
+    }
+});
+
+/**
+ * 将当前 PointPrimitive 从其所属的 PointPrimitiveCollection 中移除。
+ * @memberof PointPrimitive
+*/
+PointPrimitive.prototype._removeFromCollection = function () {
+    if (this._pointPrimitiveCollection)
+        this._pointPrimitiveCollection.remove(this);
+};
+
+/**
+ * 计算 PointPrimitiveCollection 的包围球。
+ * @param {boolean} [allowPartial=false] 是否允许仅使用部分已就绪的图元计算包围球。
+ * @param {BoundingSphere} result 用于存储包围球的对象。
+ * @returns {BoundingSphereState} 包围球的计算状态。
+ * @memberof PointPrimitiveCollection
+*/
+PointPrimitiveCollection.prototype.getBoundingSphere = function (allowPartial = false, result) {
+    Check.defined('result', result);
+
+    const length = this.length;
+    if (length === 0)
+        return BoundingSphereState.FAILED;
+
+    const boundingSpheres = [];
+    for (let i = length - 1; i >= 0; i--) {
+        const point = this.get(i);
+        boundingSpheres[i] = new BoundingSphere(point.position);
+    }
+
+    BoundingSphere.fromBoundingSpheres(boundingSpheres, result);
+    // console.log('getBoundingSphere:', this.id, result);
+    return BoundingSphereState.DONE;
+};
+
+export { Billboard, BillboardCollection, Label, LabelCollection, PointPrimitive, PointPrimitiveCollection };

package/src/revisions/Plane.revise.js

@@ -0,0 +1,43 @@
+import { Cartesian3, Plane } from "cesium";
+import Scratch from "../utils/Scratch.js";
+
+/**
+ * 扩展 Cesium 的 Plane 类，补充通过共面点创建平面、克隆等方法。
+ * @class Plane
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/Plane.html}
+*/
+
+/**
+ * 通过三个共面点创建平面。
+ * @param {Cartesian3} a 平面上第一个点。
+ * @param {Cartesian3} b 平面上第二个点。
+ * @param {Cartesian3} c 平面上第三个点。
+ * @param {Plane} [result] 用于存储结果的可选对象。
+ * @returns {Plane} 生成的平面。
+ * @memberof Plane
+ * @static
+*/
+Plane.fromCoplanarPoints = function (a, b, c, result) {
+
+    // from threejs
+    // const normal = _vector1.subVectors(c, b).cross(_vector2.subVectors(a, b)).normalize();
+    const vectorA = Cartesian3.subtract(c, b, Scratch.scratchLeftCartesian3);
+    const vectorB = Cartesian3.subtract(a, b, Scratch.scratchRightCartesian3);
+    const normal = Cartesian3.cross(vectorA, vectorB, Scratch.scratchNormal);
+    normal.normalize();
+
+    return Plane.fromPointNormal(a, normal, result);
+};
+
+/**
+ * 克隆当前平面。
+ * @param {Plane} [result] 用于存储结果的可选对象。
+ * @returns {Plane} 克隆得到的平面。
+ * @memberof Plane
+*/
+Plane.prototype.clone = function (result) {
+    return Plane.clone(this, result);
+};
+
+export default Plane;
+export { Plane };

package/src/revisions/PolylinePipeline.revise.js

@@ -0,0 +1,54 @@
+import { Cartesian3, Check, PolylinePipeline } from "cesium";
+
+/**
+ * 扩展 Cesium 的 PolylinePipeline 类，补充计算线段空间长度与地面长度的方法。
+ * @class PolylinePipeline
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/PolylinePipeline.html}
+*/
+
+/**
+ * 计算线段的空间长度，即各顶点间的直线距离之和。
+ * @param {Array} positions 构成线段的笛卡尔坐标点数组（Cartesian3 数组）。
+ * @returns {number} 线段的空间长度，单位米。
+ * @memberof PolylinePipeline
+ * @static
+*/
+PolylinePipeline.computeLength = function (positions) {
+    Check.typeOf.array('positions', positions);
+    if (positions.length < 2)
+        return 0;
+    let length = 0,
+        a, b, distance;
+    for (let i = 1; i < positions.length; i++) {
+        a = positions[i - 1];
+        b = positions[i];
+        distance = Cartesian3.distance(a, b);
+        length += distance;
+    }
+    return length;
+};
+
+/**
+ * 计算线段的地面长度，即各顶点间沿地表（椭球面）距离之和。
+ * @param {Array} positions 构成线段的笛卡尔坐标点数组（Cartesian3 数组）。
+ * @returns {number} 线段的地面长度，单位米。
+ * @memberof PolylinePipeline
+ * @static
+*/
+PolylinePipeline.computeSurfaceLength = function (positions) {
+    Check.typeOf.array('positions', positions);
+    if (positions.length < 2)
+        return 0;
+    let length = 0,
+        a, b, distance;
+    for (let i = 1; i < positions.length; i++) {
+        a = positions[i - 1];
+        b = positions[i];
+        distance = Cartesian3.surfaceDistance(a, b);
+        length += distance;
+    }
+    return length;
+};
+
+export default PolylinePipeline;
+export { PolylinePipeline };