@lijuhong1981/cesium.utils 0.0.0-stage → 0.1.1

package/src/utils/getPositionFromTarget.js

@@ -0,0 +1,29 @@
+import { Check, defined } from "cesium";
+import parseToCartesian3 from "../parses/parseToCartesian3.js";
+
+/**
+ * 获取目标对象在指定时刻的世界坐标位置。
+ * 目标本身可直接是位置，也可通过其 position 属性获取；若为 Property 则按时刻求值。
+ * @param {object|Cartesian3} target 目标对象或位置
+ * @param {JulianDate} time 查询时刻
+ * @param {Cartesian3} result 用于存储结果的对象
+ * @returns {Cartesian3} 获取到的世界坐标位置
+ */
+function getPositionFromTarget(target, time, result) {
+    Check.defined('target', target);
+    let position;
+    if (defined(target.position))
+        position = target.position;
+    else
+        position = target;
+
+    if (typeof position.getValue === 'function')
+        position = position.getValue(time, result);
+    else
+        position = parseToCartesian3(position, result, false);
+
+    return position;
+};
+
+export default getPositionFromTarget;
+export { getPositionFromTarget };

package/src/utils/getRenderState.js

@@ -0,0 +1,35 @@
+import { Check, CullFace, defined } from "cesium";
+
+/**
+ * 根据选项构建 Cesium 渲染状态对象（RenderState）。
+ * @param {object} options 参数对象
+ * @param {boolean} [options.depthTest] 是否启用深度测试
+ * @param {CullFace} [options.cullFace] 背面剔除模式
+ * @param {object} [result={}] 用于存储结果的渲染状态对象
+ * @returns {object} 构建的渲染状态对象
+ */
+function getRenderState(options, result = {}) {
+    Check.defined('options', options);
+
+    if (defined(options.depthTest)) {
+        result.depthTest = {
+            enabled: options.depthTest,
+        };
+    }
+    if (defined(options.cullFace)) {
+        if (options.cullFace !== CullFace.NONE)
+            result.cull = {
+                enabled: true,
+                face: options.cullFace,
+            };
+        else {
+            result.cull = {
+                enabled: false,
+            };
+        }
+    }
+    return result;
+};
+
+export default getRenderState;
+export { getRenderState };

package/src/utils/index.js

@@ -0,0 +1,13 @@
+export * from "./Scratch.js";
+export * from "./computeCirclePositions.js";
+export * from "./computeCircleRadius.js";
+export * from "./computeModelMatrix.js";
+export * from "./computeStTransform.js";
+export * from "./createGeometry.js";
+export * from "./createPointCloudGeometry.js";
+export * from "./getGeometryInstanceAttributes.js";
+export * from "./getPositionFromTarget.js";
+export * from "./getRenderState.js";
+export * from "./isColorMaterial.js";
+export * from "./isTranslucent.js";
+export * from "./resolveModelMatrixByFixedFrame.js";

package/src/utils/isColorMaterial.js

@@ -0,0 +1,13 @@
+import { defined, Material } from "cesium";
+
+/**
+ * 判断材质是否为颜色材质（未定义或类型为 Material.ColorType）。
+ * @param {Material} material 待判断的材质
+ * @returns {boolean} 是否为颜色材质
+ */
+function isColorMaterial(material) {
+    return !defined(material) || material.type === Material.ColorType;
+};
+
+export default isColorMaterial;
+export { isColorMaterial };

package/src/utils/isTranslucent.js

@@ -0,0 +1,13 @@
+import { defined } from "cesium";
+
+/**
+ * 判断颜色是否为半透明（存在且 alpha 小于 1）。
+ * @param {Color} color 待判断的颜色
+ * @returns {boolean} 是否半透明
+ */
+function isTranslucent(color) {
+    return defined(color) && (typeof color.alpha === 'number') && color.alpha < 1.0;
+};
+
+export default isTranslucent;
+export { isTranslucent };

package/src/utils/resolveModelMatrixByFixedFrame.js

@@ -0,0 +1,30 @@
+import { Cartesian3, Check, HeadingPitchRoll, Matrix4, Transforms } from "cesium";
+
+/**
+ * 将世界坐标下的模型矩阵分解为固定参考系下的位置、缩放与航向俯仰翻滚。
+ * @param {Matrix4} modelMatrix 待分解的模型矩阵
+ * @param {Ellipsoid} ellipsoid 参考椭球体
+ * @param {Matrix4} fixedFrameTransform 固定参考系到世界坐标的变换矩阵
+ * @param {object} [result={}] 用于存储结果的对象
+ * @returns {object} 含 position（Cartesian3）、scale（Cartesian3）、rotation（HeadingPitchRoll）的结果对象
+ */
+function resolveModelMatrixByFixedFrame(modelMatrix, ellipsoid, fixedFrameTransform, result = {}) {
+    Check.instanceOf('modelMatrix', modelMatrix, Matrix4);
+
+    if (!result.position)
+        result.position = new Cartesian3();
+    result.position = Matrix4.getTranslation(modelMatrix, result.position);
+
+    if (!result.scale)
+        result.scale = new Cartesian3();
+    result.scale = Matrix4.getScale(modelMatrix, result.scale);
+
+    if (!result.rotation)
+        result.rotation = new HeadingPitchRoll();
+    result.rotation = Transforms.fixedFrameToHeadingPitchRoll(modelMatrix, ellipsoid, fixedFrameTransform, result.rotation);
+
+    return result;
+};
+
+export default resolveModelMatrixByFixedFrame;
+export { resolveModelMatrixByFixedFrame };