mars3d 3.10.12 → 3.11.1

package/README.md

@@ -34,7 +34,7 @@ Github：[https://github.com/marsgis/mars3d](https://github.com/marsgis/mars3d)
 
 ## 平台介绍
  
- `Mars3D平台` 是[火星科技](http://marsgis.cn/)研发的一款基于 WebGL 技术实现的三维客户端开发平台，基于[Cesium](https://cesium.com/cesiumjs/)优化提升与B/S架构设计，支持多行业扩展的轻量级高效能GIS开发平台，能够免安装、无插件地在浏览器中高效运行，并可快速接入与使用多种GIS数据和三维模型，呈现三维空间的可视化，完成平台在不同行业的灵活应用。
+ `Mars3D平台` 是一款基于 WebGL 技术实现的三维客户端开发平台，基于[Cesium](https://cesium.com/cesiumjs/)优化提升与B/S架构设计，支持多行业扩展的轻量级高效能GIS开发平台，能够免安装、无插件地在浏览器中高效运行，并可快速接入与使用多种GIS数据和三维模型，呈现三维空间的可视化，完成平台在不同行业的灵活应用。
  
 
 
@@ -143,6 +143,6 @@ Github：[https://github.com/marsgis/mars3d](https://github.com/marsgis/mars3d)
 
 
 ## 版权说明
-1. Mars3D平台由[火星科技](http://marsgis.cn/)自主研发，拥有所有权利。
+1. Mars3D平台由[mars3d团队](http://mars3d.cn/)自主研发，拥有所有权利。
 2. 任何个人或组织可以在遵守相关要求下可以免费无限制使用。
 

package/mars3d.css

@@ -1,10 +1,10 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.10.12
- * 编译日期：2026-01-21 13:09
- * 版权所有：Copyright by 火星科技  http://mars3d.cn
- * 使用单位：火星科技免费公开版 ，2025-07-01
+ * 版本信息：v3.11.1
+ * 编译日期：2026-03-17 19:22
+ * 版权所有：Copyright by http://mars3d.cn
+ * 使用单位：免费公开版 ，2026-02-01
  */
 
 /**地球容器div*/

package/mars3d.d.ts

@@ -2,10 +2,10 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.10.12
- * 编译日期：2026-01-21 13:09
- * 版权所有：Copyright by 火星科技  http://mars3d.cn
- * 使用单位：火星科技免费公开版 ，2025-07-01
+ * 版本信息：v3.11.1
+ * 编译日期：2026-03-17 19:22
+ * 版权所有：Copyright by http://mars3d.cn
+ * 使用单位：免费公开版 ，2026-02-01
  */
 
 import * as Cesium from "mars3d-cesium"
@@ -5391,12 +5391,14 @@ declare class BaseGraphic extends BaseClass {
      * 将矢量数据导出为GeoJSON格式规范对象。
      * @param [options] - 参数对象:
      * @param [options.noAlt] - 不导出高度值
+     * @param [options.closure] - 是否闭合，true时增加第1个点 【仅对Polygon类型有效】
      * @param [options.noStyle] - 不导出style样式，后期使用时在图层配置symbol
      * @param [options.standard] - 不导出options等mars3d属性，仅导出坐标和attr属性的标准简洁GeoJSON
      * @returns GeoJSON格式规范对象
      */
     toGeoJSON(options?: {
         noAlt?: boolean;
+        closure?: boolean;
         noStyle?: boolean;
         standard?: boolean;
     }): any;
@@ -12756,7 +12758,7 @@ declare namespace ModelEntity {
      * @property [incrementallyLoadTextures = true] - 确定模型加载后纹理是否会继续流进来。
      * @property [runAnimations = true] - 指定模型中指定的glTF动画是否应该启动。
      * @property [clampAnimations = true] - 指定在没有关键帧的情况下，glTF动画是否应该保持最后一个姿势。
-     * @property [lightColor] - 在为模型着色时指定光的颜色的属性。当undefined场景的浅色被使用代替。
+     * @property [lightColor] - 控制模型自身接收的光源颜色的参数，核心作用是为模型的光照计算指定一个 “滤镜色”—— 所有照射到该模型上的光源（定向光、环境光、太阳光等）都会先与这个颜色相乘，最终改变模型呈现的整体色调和亮度。
      * @property [nodeTransformations] - 一个对象，其中键是节点的名称，值是{@link TranslationRotationScale}属性，描述要应用到该节点的转换。该转换是在节点的现有转换之后(如glTF中指定的那样)应用的，并且不会替换节点的现有转换。
      * @property [articulations] - An object, where keys are composed of an articulation name, a single space, and a stage name, and the values are numeric properties.
      * @property [clippingPlanes] - 用于裁剪模型的Plane平面集合
@@ -16044,12 +16046,14 @@ declare class GroupGraphic extends BaseGraphic {
      * 将矢量数据导出为GeoJSON格式规范对象。
      * @param [options] - 参数对象:
      * @param [options.noAlt] - 不导出高度值
+     * @param [options.closure] - 是否闭合，true时增加第1个点 【仅对Polygon类型有效】
      * @param [options.noStyle] - 不导出style样式，后期使用时在图层配置symbol
      * @param [options.standard] - 不导出options等mars3d属性，仅导出坐标和attr属性的标准简洁GeoJSON
      * @returns GeoJSON格式规范对象
      */
     toGeoJSON(options?: {
         noAlt?: boolean;
+        closure?: boolean;
         noStyle?: boolean;
         standard?: boolean;
     }): any;
@@ -19402,8 +19406,8 @@ declare class EllipsoidPrimitive extends BasePointPrimitive {
 declare namespace FrustumPrimitive {
     /**
      * 四棱锥体 支持的样式信息
-     * @property [angle] - 四棱锥体张角（角度值，取值范围 0.01-89.99）
-     * @property [angle2 = angle] - 四棱锥体张角2，（角度值，取值范围 0.01-89.99）
+     * @property [angle] - 四棱锥体张角,竖直角（角度值，取值范围 0.01-89.99）。 已知问题：垂直角建议小于10°-80°，超出这个范围会出现明显的透视畸变。
+     * @property [angle2 = angle] - 四棱锥体张角2，水平角（角度值，取值范围 0.01-89.99）, 水平角计算为aspectRatio宽高比传给视锥体对象，如果你的宽高比必须匹配画布（避免画面拉伸），就不能同时强制匹配水平角 —— 二者只能选其一，这是透视投影的数学特性；
      * @property [heading = 0] - 方向角 （度数值，0至360度），没有指定targetPosition时有效
      * @property [pitch = 0] - 俯仰角（度数值，0至360度），没有指定targetPosition时有效
      * @property [roll = 0] - 翻滚角（度数值，0至360度），没有指定targetPosition时有效
@@ -19830,7 +19834,7 @@ declare namespace ModelPrimitive {
      * @property [runAnimations = true] - 指定模型中指定的glTF动画是否应该启动。
      * @property [clampAnimations = true] - 指定在没有关键帧的情况下，glTF动画是否应该保持最后一个姿势。
      * @property [releaseGltfJson = false] - When true, the glTF JSON is released once the glTF is loaded. This is is especially useful for cases like 3D Tiles, where each .gltf model is unique and caching the glTF JSON is not effective.
-     * @property [lightColor] - 在为模型着色时指定光的颜色的属性。当undefined场景的浅色被使用代替。
+     * @property [lightColor] - 控制模型自身接收的光源颜色的参数，核心作用是为模型的光照计算指定一个 “滤镜色”—— 所有照射到该模型上的光源（定向光、环境光、太阳光等）都会先与这个颜色相乘，最终改变模型呈现的整体色调和亮度。
      * @property [imageBasedLighting] - The properties for managing image-based lighting on this model.
      * @property [nodeTransformations] - 一个对象，其中键是节点的名称，值是{@link TranslationRotationScale}属性，描述要应用到该节点的转换。该转换是在节点的现有转换之后(如glTF中指定的那样)应用的，并且不会替换节点的现有转换。
      * @property [articulations] - An object, where keys are composed of an articulation name, a single space, and a stage name, and the values are numeric properties.
@@ -19910,7 +19914,7 @@ declare namespace ModelPrimitive {
         runAnimations?: boolean;
         clampAnimations?: boolean;
         releaseGltfJson?: boolean;
-        lightColor?: Cesium.Color;
+        lightColor?: Cesium.Color | number;
         imageBasedLighting?: Cesium.ImageBasedLighting;
         nodeTransformations?: Cesium.PropertyBag | {
             [key: string]: Cesium.TranslationRotationScale;
@@ -24054,6 +24058,7 @@ declare class GraphicLayer extends BaseGraphicLayer {
      * 将图层数据导出为GeoJSON格式规范对象。
      * @param [options] - 参数对象:
      * @param [options.noAlt] - 不导出高度值
+     * @param [options.closure] - 是否闭合，true时增加第1个点 【仅对Polygon类型有效】
      * @param [options.noStyle] - 不导出style样式，后期使用时在图层配置symbol
      * @param [options.standard] - 不导出options等mars3d属性，仅导出坐标和attr属性的标准简洁GeoJSON
      * @param [options.stopEdit = false] - 是否停止绘制或编辑
@@ -24061,6 +24066,7 @@ declare class GraphicLayer extends BaseGraphicLayer {
      */
     toGeoJSON(options?: {
         noAlt?: boolean;
+        closure?: boolean;
         noStyle?: boolean;
         standard?: boolean;
         stopEdit?: boolean;
@@ -33798,7 +33804,7 @@ declare class CylinderWaveMaterial extends Cesium.Material {
  *   style: {
  *     diffHeight: 5,
  *     material: new mars3d.material.TextMaterial({
- *       text: "火星科技",
+ *       text: "欢迎使用Mars3D平台",
  *       color: "#3388cc",
  *       outlineWidth: 4,
  *     }),
@@ -41806,6 +41812,7 @@ declare namespace PolyUtil {
     function updateVolume(resultInter: VolumeResult, cutHeight: number): VolumeResult;
     /**
      * 获取 圆（或椭圆）边线上的坐标点数组
+     * (依赖cesium内部算法：Cesium.EllipseGeometryLibrary.computeEllipsePositions)
      * @param options - 参数对象:
      * @param options.position - 圆的中心坐标
      * @param [options.radius] - 如是圆时，半径（单位：米）
@@ -41825,6 +41832,19 @@ declare namespace PolyUtil {
         granularity?: number;
         rotation?: number;
     }): Cesium.Cartesian3[];
+    /**
+     * 获取 圆 边线上的坐标点数组
+     * @param options - 参数对象:
+     * @param options.position - 圆的中心坐标
+     * @param [options.radius] - 半径（单位：米）
+     * @param [options.count = 60] - 分割返回的点数量
+     * @returns 边线上的坐标点数组
+     */
+    function getCircleOuterPositions(options: {
+        position: Cesium.Cartesian3 | LngLatPoint;
+        radius?: number;
+        count?: number;
+    }): Cesium.Cartesian3[];
     /**
      * 提取 地球视野 的中心点坐标
      * @param scene - 三维地图场景对象，一般用map.scene或viewer.scene
@@ -42296,8 +42316,8 @@ declare namespace Util {
     /**
      * 根据数据和格式化字符串模板，返回字符串
      * @example
-     * let str = mars3d.Util.template("<div>名称：{name}</div>", { name:"火星科技", date:"2017-8-25"} );
-     *  //str结果为 : "<div>名称：火星科技</div>"
+     * let str = mars3d.Util.template("<div>名称：{name}</div>", { name:"欢迎使用Mars3D平台", date:"2017-8-25"} );
+     *  //str结果为 : "<div>名称：欢迎使用Mars3D平台</div>"
      * @param str - 格式化字符串模版，属性字段为大括号，如 {name}
      * @param data - 数据对象
      * @param [toEmpty = false] - 是否将模板中未匹配项转为空值