mars3d 3.11.0 → 3.11.2

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.11.0
- * 编译日期：2026-02-14 19:28
- * 版权所有：Copyright by 火星科技  http://mars3d.cn
- * 使用单位：火星科技免费公开版 ，2026-02-01
+ * 版本信息：v3.11.2
+ * 编译日期：2026-04-08 16:12
+ * 版权所有：Copyright by http://mars3d.cn
+ * 使用单位：免费公开版 ，2026-02-01
  */
 
 /**地球容器div*/

package/mars3d.d.ts

@@ -2,10 +2,10 @@
 /**
  * Mars3D三维可视化平台  mars3d
  *
- * 版本信息：v3.11.0
- * 编译日期：2026-02-14 19:28
- * 版权所有：Copyright by 火星科技  http://mars3d.cn
- * 使用单位：火星科技免费公开版 ，2026-02-01
+ * 版本信息：v3.11.2
+ * 编译日期：2026-04-08 16:12
+ * 版权所有：Copyright by http://mars3d.cn
+ * 使用单位：免费公开版 ，2026-02-01
  */
 
 import * as Cesium from "mars3d-cesium"
@@ -10354,10 +10354,14 @@ declare namespace BillboardEntity {
      * @property [setHeight] - 指定坐标高度值（对编辑时无效，仅初始化传入有效，常用于图层中配置）,也支持字符串模版配置
      * @property [addHeight] - 在现有坐标基础上增加的高度值（对编辑时无效，仅初始化传入有效，常用于图层中配置）,也支持字符串模版配置
      * @property [highlight] - 鼠标移入或单击(type:'click')后的对应高亮的部分样式，提示：原有style的配置项需要与highlightStyle配置有一一对应关系，否则无法清除
-     * //  * @param {string} [highlight.type] 事件方式，鼠标移入高亮 或 单击高亮(type:'click')
-     * //  * @param {boolean} [highlight.enabled=true] 是否启用
+     * //  * @property {string} [highlight.type] 事件方式，鼠标移入高亮 或 单击高亮(type:'click')
+     * //  * @property {boolean} [highlight.enabled=true] 是否启用
      * @property [label] - 支持附带文字的显示
-     * //  * @param {boolean} [label.combine=false] 文本是否使用Entity附带文本，比如使用动态坐标时，请传入true
+     * //  * @property {boolean} [label.combine=false] 文本是否使用Entity附带文本，比如使用动态坐标时，请传入true
+     * @property [bounce] - 是否构造后自动调用弹跳效果  {@link BillboardEntity#startBounce}
+     * @property [bounce.maxHeight = 50] - 弹跳的最大高度, 单位：像素
+     * @property [bounce.step = 1] - 弹跳增量, 控制速度，单位：像素
+     * @property [bounce.autoStop] - 是否自动停止，true时：会逐渐减弱至停止状态
      */
     type StyleOptions = any | {
         image?: string | HTMLCanvasElement;
@@ -10401,6 +10405,11 @@ declare namespace BillboardEntity {
         addHeight?: number | string;
         highlight?: BillboardEntity.StyleOptions | any;
         label?: LabelEntity.StyleOptions | any;
+        bounce?: {
+            maxHeight?: number;
+            step?: number;
+            autoStop?: boolean;
+        };
     };
 }
 
@@ -12575,6 +12584,10 @@ declare namespace LabelEntity {
      * @property [highlight] - 鼠标移入或单击(type:'click')后的对应高亮的部分样式，提示：原有style的配置项需要与highlightStyle配置有一一对应关系，否则无法清除
      * //  * @param {string} [highlight.type] 事件方式，鼠标移入高亮 或 单击高亮(type:'click')
      * //  * @param {boolean} [highlight.enabled=true] 是否启用
+     * @property [bounce] - 是否构造后自动调用弹跳效果  {@link BillboardEntity#startBounce}
+     * @property [bounce.maxHeight = 50] - 弹跳的最大高度, 单位：像素
+     * @property [bounce.step = 1] - 弹跳增量, 控制速度，单位：像素
+     * @property [bounce.autoStop] - 是否自动停止，true时：会逐渐减弱至停止状态
      */
     type StyleOptions = any | {
         text?: string;
@@ -12625,6 +12638,11 @@ declare namespace LabelEntity {
         addHeight?: number | string;
         templateEmptyStr?: string;
         highlight?: LabelEntity.StyleOptions | any;
+        bounce?: {
+            maxHeight?: number;
+            step?: number;
+            autoStop?: boolean;
+        };
     };
 }
 
@@ -12758,7 +12776,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平面集合
@@ -19406,8 +19424,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时有效
@@ -19573,6 +19591,117 @@ declare class FrustumPrimitive extends BasePointPrimitive {
     roll: number;
 }
 
+declare namespace HollowCylinder {
+    /**
+     * 中空圆柱体 支持的样式信息
+     * @property [radius = 10] - 半径(单位：米)
+     * @property [thicknes = radius/3] - 壁厚(单位：米)，空心管的外层厚度
+     * @property [diffHeight] - 高度
+     * @property [heading = 0] - 方向角 （度数值，0至360度）
+     * @property [pitch = 0] - 俯仰角（度数值，0至360度）
+     * @property [roll = 0] - 翻滚角（度数值，0至360度）
+     * @property [materialType = "Color"] - 填充材质类型 ,可选项：{@link MaterialType}
+     * @property [materialOptions] - materialType对应的{@link MaterialType}中材质参数
+     * @property [slices = 64] - 边数
+     *
+     * //以下是 这是MaterialAppearance的参数
+     * @property [flat = false] - 当true时，在片段着色器中使用平面着色，不考虑光照。
+     * @property [faceForward = !closed] - 当true时，片段着色器根据需要翻转表面的法线，以确保法线面向查看器以避免黑点。
+     * @property [translucent = true] - 当true时，几何图形将显示为半透明，因此{@link Cesium.PerInstanceColorAppearance#renderState}将启用alpha混合。
+     * @property [closed = false] - 当true时，几何图形将被关闭，因此{@link Cesium.PerInstanceColorAppearance#renderState}启用了背面剔除。
+     * @property [vertexShaderSource] - 可选的GLSL顶点着色器源，覆盖默认的顶点着色器。
+     * @property [fragmentShaderSource] - 可选的GLSL片段着色器源覆盖默认的片段着色器。
+     * @property [renderState] - 可选渲染状态，以覆盖默认渲染状态。
+     * @property [label] - 支持附带文字的显示
+     */
+    type StyleOptions = any | {
+        radius?: number;
+        thicknes?: number;
+        diffHeight?: number;
+        heading?: number;
+        pitch?: number;
+        roll?: number;
+        materialType?: string;
+        materialOptions?: any;
+        slices?: number;
+        flat?: boolean;
+        faceForward?: boolean;
+        translucent?: boolean;
+        closed?: boolean;
+        vertexShaderSource?: string;
+        fragmentShaderSource?: string;
+        renderState?: any;
+        label?: LabelEntity.StyleOptions | any;
+    };
+}
+
+/**
+ * 中空圆柱体 Primitive图元矢量对象
+ * @param options - 参数对象，包括以下：
+ * @param [options.position] - 坐标位置
+ * @param [options.modelMatrix] - 将图元(所有几何实例)从模型转换为世界坐标的4x4变换矩阵,可以替代position。
+ * @param options.style - 样式信息
+ * @param [options.attr] - 附件的属性信息，可以任意附加属性，导出geojson或json时会自动处理导出。
+ * @param [options.appearance] - [cesium原生]用于渲染图元的外观。
+ * @param [options.attributes] - [cesium原生]每个实例的属性。
+ * @param [options.depthFailAppearance] - 当深度测试失败时，用于为该图元着色的外观。
+ * @param [options.vertexCacheOptimize = false] - 当true，几何顶点优化前和后顶点着色缓存。
+ * @param [options.interleave = false] - 当true时，几何顶点属性被交叉，这可以略微提高渲染性能，但会增加加载时间。
+ * @param [options.compressVertices = true] - 当true时，几何顶点被压缩，这将节省内存。提升效率。
+ * @param [options.releaseGeometryInstances = true] - 当true时，图元不保留对输入geometryInstances的引用以节省内存。
+ * @param [options.allowPicking = true] - 当true时，每个几何图形实例只能通过{@link Scene#pick}进行挑选。当false时，保存GPU内存。
+ * @param [options.cull = true] - 当true时，渲染器会根据图元的边界体积来剔除它们的截锥和地平线。设置为false，如果你手动剔除图元，可以获得较小的性能提升。
+ * @param [options.asynchronous = true] - 确定该图元是异步创建还是阻塞创建，直到就绪。
+ * @param [options.debugShowBoundingVolume = false] - 仅供调试。确定该图元命令的边界球是否显示。
+ * @param [options.debugShowShadowVolume = false] - 仅供调试。贴地时，确定是否绘制了图元中每个几何图形的阴影体积。必须是true创建卷之前要释放几何图形或选项。releaseGeometryInstance必须是false。
+ * @param [options.popup] - 绑定的popup弹窗值，也可以bindPopup方法绑定
+ * @param [options.popupOptions] - popup弹窗时的配置参数，也支持如pointerEvents等{@link Popup}构造参数
+ * @param [options.tooltip] - 绑定的tooltip弹窗值，也可以bindTooltip方法绑
+ * @param [options.tooltipOptions] - tooltip弹窗时的配置参数，也支持如pointerEvents等{@link Tooltip}构造参数
+ * @param [options.contextmenuItems] - 当矢量数据支持右键菜单时，也可以bindContextMenu方法绑定
+ * @param [options.id = createGuid()] - 矢量数据id标识
+ * @param [options.name] - 矢量数据名称
+ * @param [options.show = true] - 矢量数据是否显示
+ * @param [options.availability] - 指定时间范围内显示该对象
+ * @param [options.eventParent] - 指定的事件冒泡对象，默认为所加入的图层对象，false时不冒泡事件
+ * @param [options.allowDrillPick] - 是否允许鼠标穿透拾取
+ * @param [options.flyTo] - 加载完成数据后是否自动飞行定位到数据所在的区域。
+ * @param [options.flyToOptions] - 加载完成数据后是否自动飞行定位到数据所在的区域的对应 {@link BaseGraphic#flyTo}方法参数。
+ */
+declare class HollowCylinder extends BasePointPrimitive {
+    constructor(options: {
+        position?: LngLatPoint | Cesium.Cartesian3 | Cesium.PositionProperty | BaseGraphic.AjaxPosition | BaseGraphic.TimePosition | number[] | string;
+        modelMatrix?: Cesium.Matrix4;
+        style: HollowCylinder.StyleOptions | any;
+        attr?: any | BaseGraphic.AjaxAttr;
+        appearance?: Cesium.Appearance;
+        attributes?: Cesium.Appearance;
+        depthFailAppearance?: Cesium.Appearance;
+        vertexCacheOptimize?: boolean;
+        interleave?: boolean;
+        compressVertices?: boolean;
+        releaseGeometryInstances?: boolean;
+        allowPicking?: boolean;
+        cull?: boolean;
+        asynchronous?: boolean;
+        debugShowBoundingVolume?: boolean;
+        debugShowShadowVolume?: boolean;
+        popup?: string | any[] | ((...params: any[]) => any);
+        popupOptions?: Popup.StyleOptions | any;
+        tooltip?: string | any[] | ((...params: any[]) => any);
+        tooltipOptions?: Tooltip.StyleOptions | any;
+        contextmenuItems?: any;
+        id?: string | number;
+        name?: string;
+        show?: boolean;
+        availability?: Cesium.TimeIntervalCollection | Cesium.TimeInterval | any[] | any;
+        eventParent?: BaseClass | boolean;
+        allowDrillPick?: boolean | ((...params: any[]) => any);
+        flyTo?: boolean;
+        flyToOptions?: any;
+    });
+}
+
 /**
  * 文字 Primitive矢量数据
  * @param options - 参数对象，包括以下：
@@ -19834,7 +19963,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.
@@ -19914,7 +20043,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;
@@ -33804,7 +33933,7 @@ declare class CylinderWaveMaterial extends Cesium.Material {
  *   style: {
  *     diffHeight: 5,
  *     material: new mars3d.material.TextMaterial({
- *       text: "火星科技",
+ *       text: "欢迎使用Mars3D平台",
  *       color: "#3388cc",
  *       outlineWidth: 4,
  *     }),
@@ -40508,6 +40637,30 @@ declare class PolylineVolumeStyleConver extends BaseStyleConver {
     static toJSON(czmVal: any, style?: any, isEntity?: boolean): any;
 }
 
+/**
+ * 通用 矢量数据style转换处理类
+ * @param [options] - 控制参数
+ */
+declare class PolyStyleConver extends BaseStyleConver {
+    constructor(options?: any);
+    /**
+     * 转换style到Cesium对象需要的格式
+     * @param style - 样式配置
+     * @param [czmVal = {}] - Cesium属性值
+     * @param [isEntity] - 是否为Entity对象
+     * @returns Cesium属性值
+     */
+    static toCesiumVal(style: any, czmVal?: any, isEntity?: boolean): any;
+    /**
+     * 导出Cesium的样式对象到json可以保存的格式
+     * @param czmVal - Cesium属性值
+     * @param [style = {}] - json简单对象
+     * @param [isEntity] - 是否为Entity对象
+     * @returns json简单对象
+     */
+    static toJSON(czmVal: any, style?: any, isEntity?: boolean): any;
+}
+
 /**
  * Rectangle 矢量数据style转换处理类
  * @param [options] - 控制参数
@@ -42316,8 +42469,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] - 是否将模板中未匹配项转为空值
@@ -43100,6 +43253,7 @@ declare namespace graphic {
   export { DoubleSidedPlane }
   export { ReflectionWater }
   export { VideoPrimitive }
+  export { HollowCylinder }
 
   //批量大数据primitive
   export { BaseCombine }