HeightLimitAnalysis

限高（超高检测）空间分析对象，用于对三维场景实现限高分析。

超过 limitHeight 的部分用 limitColor 着色标出，复用 FloodAnalysis 的水面渲染机制（分析类型 analysisType = 2）。

构造函数

import { HeightLimitAnalysis } from '@maptalks/gl-layers';

const heightLimitAnalysis = new HeightLimitAnalysis({
  limitHeight: 25,
  limitColor: [1, 0.2, 0.2]
});

heightLimitAnalysis.addTo(groupGLLayer);

详细信息

参数：

• options* Object 配置参数，可选的配置项如下：

配置名	类型	描述	默认值
limitHeight*	Number	限高值（米）	null
limitColor	Number[]	三位归一化数组，超高部分的着色（源码默认值 DEFAULT_LIMIT_COLOR）	[0.8, 0.1, 0.1]
boundary	Number[]	分析范围边界坐标环（可选，不设则全图分析，继承自 FloodAnalysis）	null

继承自FloodAnalysis的方法

HeightLimitAnalysis 继承 FloodAnalysis（包括 waterHeight、waterColor、waterOpacity 等选项与 update、renderAnalysis 等方法，2026 源码核对）。

继承自Analysis的方法

addTo(groupGLLayer)

添加到GroupGLLayer上。

空间分析对象只支持添加到GroupGLLayer上，无法添加到其他WebGL图层。

参数：

• groupGLLayer GroupGLLayer GroupGLLayer图层

返回：

• this

remove()

从图层上移除空间分析对象。

返回：

• void

update(name, value)

更新options数据。

参数：

• name String 设置名称
• value any 设置的值

返回：

• void

getAnalysisType()

获取Analysis的类型。

返回：

• String

getDefines()

内部调用方法。

返回Analysis绘制时在shader中添加的defines。

返回：

• Object

renderAnalysis(meshes)

内部调用方法。

绘制空间分析场景（各分析子类实现），返回渲染所需的 uniform 变量。

参数：

• meshes Mesh[] 场景网格

返回：

• Object

enable()

启用分析。

返回：

• void

disable()

禁用分析。

返回：

• void

isEnable()

分析是否已启用。

返回：

• Boolean

getExcludeLayers()

获取分析时排除的图层id列表（分析时忽略这些图层）。

返回：

• String[]

setExcludeLayers(layerIds)

设置分析时排除的图层id列表。

参数：

• layerIds String[] 图层id列表

返回：

• void

exportAnalysisMap(meshes)

导出分析结果图（RGBA像素数据），分析未启用时返回 null。

参数：

• meshes Mesh[] 场景网格

返回：

• Uint8Array

本文档已与 @maptalks/gl-layers 2026 源码核对（api-notes-others.md / api-notes-vt-gl.md）