SkylineAnalysis

天际线空间分析对象，用于对三维场景实现天际线分析。

构造函数

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

const skylineAnalysis = new SkylineAnalysis({
  lineColor: [1, 0, 0],
  lineWidth: 1
});

skylineAnalysis.addTo(groupGLLayer);

详细信息

参数：

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

配置名	类型	描述	默认值
lineColor	Number[]	三位归一化数组，天际线轮廓颜色	[1, 0, 0]
lineWidth	Number	轮廓线宽度	1

成员方法

exportSkylineMap(options)

导出天际线图片（透明背景），返回 dataURL（2026 源码核对补充）。

参数：

• options Object 导出选项，可选的属性： | 属性名 | 类型 | 描述 | 默认值 | | ------ | :----: | ---- | :-----------: | | save | Boolean | 是否弹出下载框 | false | | filename | String | 下载文件名 | 'export' |

返回：

• String dataURL（分析未启用时返回 null）

继承自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）