@lijuhong1981/cesium.utils 0.0.0-stage → 0.1.1

package/src/revisions/Primitive.revise.js

@@ -0,0 +1,83 @@
+import { BoundingSphere, BoundingSphereState, Check, ClassificationPrimitive, GroundPolylinePrimitive, GroundPrimitive, Primitive } from "cesium";
+
+/**
+ * 扩展 Cesium 的 Primitive 类，补充获取包围球的方法。
+ * @class Primitive
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/Primitive.html}
+*/
+/**
+ * 扩展 Cesium 的 GroundPrimitive 类，补充获取包围球的方法。
+ * @class GroundPrimitive
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/GroundPrimitive.html}
+*/
+/**
+ * 扩展 Cesium 的 ClassificationPrimitive 类，补充获取包围球的方法。
+ * @class ClassificationPrimitive
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/ClassificationPrimitive.html}
+*/
+/**
+ * 扩展 Cesium 的 GroundPolylinePrimitive 类，补充获取包围球的方法。
+ * @class GroundPolylinePrimitive
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/GroundPolylinePrimitive.html}
+*/
+
+/**
+ * 获取当前图元的包围球。
+ * @param {boolean} allowPartial 是否允许仅使用部分已就绪的几何数据计算包围球。
+ * @param {BoundingSphere} result 用于存储包围球的对象。
+ * @returns {BoundingSphereState} 包围球的计算状态。
+ * @memberof Primitive
+*/
+Primitive.prototype.getBoundingSphere = function (allowPartial, result) {
+    Check.defined('result', result);
+    if (!this._ready || this._recomputeBoundingSpheres)
+        return BoundingSphereState.PENDING;
+    BoundingSphere.fromBoundingSpheres(this._boundingSphereWC, result);
+    return BoundingSphereState.DONE;
+};
+
+/**
+ * 获取当前地面图元的包围球。
+ * @param {boolean} allowPartial 是否允许仅使用部分已就绪的几何数据计算包围球。
+ * @param {BoundingSphere} result 用于存储包围球的对象。
+ * @returns {BoundingSphereState} 包围球的计算状态。
+ * @memberof GroundPrimitive
+*/
+GroundPrimitive.prototype.getBoundingSphere = function (allowPartial, result) {
+    Check.defined('result', result);
+    if (!this._ready)
+        return BoundingSphereState.PENDING;
+    BoundingSphere.fromBoundingSpheres(this._boundingSpheres, result);
+    return BoundingSphereState.DONE;;
+};
+
+/**
+ * 获取当前分类图元的包围球。
+ * @param {boolean} allowPartial 是否允许仅使用部分已就绪的几何数据计算包围球。
+ * @param {BoundingSphere} result 用于存储包围球的对象。
+ * @returns {BoundingSphereState} 包围球的计算状态。
+ * @memberof ClassificationPrimitive
+*/
+ClassificationPrimitive.prototype.getBoundingSphere = function (allowPartial, result) {
+    Check.defined('result', result);
+    if (!this._ready || !this._primitive || !this._primitive._ready)
+        return BoundingSphereState.PENDING;
+    return this._primitive.getBoundingSphere(allowPartial, result);
+};
+
+/**
+ * 获取当前地面线图元的包围球。
+ * @param {boolean} allowPartial 是否允许仅使用部分已就绪的几何数据计算包围球。
+ * @param {BoundingSphere} result 用于存储包围球的对象。
+ * @returns {BoundingSphereState} 包围球的计算状态。
+ * @memberof GroundPolylinePrimitive
+*/
+GroundPolylinePrimitive.prototype.getBoundingSphere = function (allowPartial, result) {
+    Check.defined('result', result);
+    if (!this._ready || !this._primitive || !this._primitive._ready)
+        return BoundingSphereState.PENDING;
+    return this._primitive.getBoundingSphere(allowPartial, result);
+};
+
+export default Primitive;
+export { ClassificationPrimitive, GroundPolylinePrimitive, GroundPrimitive, Primitive };

package/src/revisions/Property.revise.js

@@ -0,0 +1,37 @@
+import { defined, Property } from "cesium";
+
+/**
+ * 扩展 Cesium 的 Property 类，补充属性判断与取值的方法。
+ * @class Property
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/Property.html}
+*/
+
+/**
+ * 判断给定对象是否为一个 Property（具有 getValue 方法且定义了 isConstant）。
+ * @param {object} property 待判断的对象。
+ * @returns {boolean} 若为 Property 返回 true；否则返回 undefined。
+ * @memberof Property
+ * @static
+*/
+Property.isProperty = function (property) {
+    if (typeof property.getValue === 'function' && defined(property.isConstant))
+        return true;
+};
+
+/**
+ * 获取属性在指定时间的值，若对象非 Property 则直接返回其本身。
+ * @param {object|Property} property 属性对象或普通值。
+ * @param {JulianDate} [time] 取值的时间。
+ * @param {object} [result] 用于存储结果的可选对象。
+ * @returns {object} 属性在指定时间的值。
+ * @memberof Property
+ * @static
+*/
+Property.getValue = function (property, time, result) {
+    if (typeof property.getValue === 'function')
+        return property.getValue(time, result);
+    return property;
+};
+
+export default Property;
+export { Property };

package/src/revisions/Quaternion.revise.js

@@ -0,0 +1,66 @@
+import { HeadingPitchRoll, Matrix3, Quaternion } from "cesium";
+import Scratch from "../utils/Scratch.js";
+
+/**
+ * 扩展 Cesium 的 Quaternion 类，补充通过航向俯仰横滚角创建四元数、
+ * 四元数向量变换以及转换为航向俯仰横滚角的方法。
+ * @class Quaternion
+ * @see {@link https://cesium.com/learn/cesiumjs/ref-doc/Quaternion.html}
+*/
+
+/**
+ * 从以角度表示的航向、俯仰、横滚角创建四元数。
+ * @param {number} heading 航向角，单位度。
+ * @param {number} pitch 俯仰角，单位度。
+ * @param {number} roll 横滚角，单位度。
+ * @param {Quaternion} [result] 用于存储结果的可选对象。
+ * @returns {Quaternion} 生成的四元数。
+ * @memberof Quaternion
+ * @static
+*/
+Quaternion.fromDegrees = function (heading, pitch, roll, result) {
+    const hpr = HeadingPitchRoll.fromDegrees(heading, pitch, roll, Scratch.scratchHeadingPitchRoll);
+    return Quaternion.fromHeadingPitchRoll(hpr, result);
+};
+
+/**
+ * 从以弧度表示的航向、俯仰、横滚角创建四元数。
+ * @param {number} heading 航向角，单位弧度。
+ * @param {number} pitch 俯仰角，单位弧度。
+ * @param {number} roll 横滚角，单位弧度。
+ * @param {Quaternion} [result] 用于存储结果的可选对象。
+ * @returns {Quaternion} 生成的四元数。
+ * @memberof Quaternion
+ * @static
+*/
+Quaternion.fromRadians = function (heading, pitch, roll, result) {
+    const hpr = HeadingPitchRoll.fromRadians(heading, pitch, roll, Scratch.scratchHeadingPitchRoll);
+    return Quaternion.fromHeadingPitchRoll(hpr, result);
+};
+
+/**
+ * 使用四元数表示的旋转对笛卡尔坐标向量进行变换。
+ * @param {Quaternion} quaterion 旋转四元数。
+ * @param {Cartesian3} cartesian 待变换的向量。
+ * @param {Cartesian3} [result] 用于存储结果的可选对象。
+ * @returns {Cartesian3} 变换后的向量。
+ * @memberof Quaternion
+ * @static
+*/
+Quaternion.multiplyByVector = function (quaterion, cartesian, result) {
+    const rotationMatrix = Matrix3.fromQuaternion(quaterion, Scratch.scratchMatrix3);
+    return Matrix3.multiplyByVector(rotationMatrix, cartesian, result);
+};
+
+/**
+ * 将当前四元数转换为航向、俯仰、横滚角。
+ * @param {HeadingPitchRoll} [result] 用于存储结果的可选对象。
+ * @returns {HeadingPitchRoll} 对应的航向俯仰横滚角。
+ * @memberof Quaternion
+*/
+Quaternion.prototype.toHeadingPitchRoll = function (result) {
+    return HeadingPitchRoll.fromQuaternion(this, result);
+};
+
+export default Quaternion;
+export { Quaternion };