GeoLibre 图层管理完全指南图层面板、混合模式、图层组与样式互操作实战【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibreGeoLibre 的Layers 面板图层面板位于主界面左侧是管理项目中每一个图层的核心入口——从最顶层的绘制图层一直到最底部的底图。本文基于 docs/user-guide/layers.md 系统讲解图层的可见性、堆叠顺序、不透明度、五种 WebGL 混合模式Blend Modes、逐图层操作、样式导入导出、图层组、实时刷新机制与 DuckDB 图层等能力并结合仓库源码packages/map/src/layer-blend-modes.ts、packages/core/src/types.ts 等深入剖析底层实现原理。读完本文你将能熟练完成图层的增删改查、叠置渲染调优、跨 GIS 平台的样式搬运以及多图层项目的组织管理。图层面板总览驱动样式与属性表的唯一入口在 GeoLibre 中Layers 面板列出项目中的全部图层从上到下按绘制顺序排列最底端始终是底图Background。选中一个图层后样式面板Style panel 与 属性表Attribute table 会随之切换展示并编辑该图层的符号化参数与要素记录。从源码结构看桌面端的面板实现位于 apps/geolibre-desktop/src/components/panels/LayerPanel.tsx约 5000 行它通过geolibre/core提供的useAppStore订阅全局图层存储同时集成了插件系统的能力如GEO_EDITOR_PLUGIN_ID、TIME_SLIDER_PLUGIN_ID、BASEMAP_CONTROL_PLUGIN_ID等因此面板上大量操作实际上是通过插件注册表动态派发的。图层顺序、可见性与不透明度可见性点击图层卡片上的眼睛按钮即可显示或隐藏该图层面板顶部的Hide all layers隐藏全部图层按钮可一次性隐藏所有图层。顺序直接拖拽图层卡片可调整堆叠顺序也可使用卡片上的上移 / 下移按钮逐位调整。列表位置越靠上的图层绘制时越靠前覆盖在下层之上底图Background永远固定在列表底部不可被移走。不透明度每个图层都带有一个0%100% 的不透明度滑杆用于整体淡化图层。混合模式Blend Modes让地形起伏透过主题色使用方式与核心场景在 样式面板 的符号化控件上方有一个Blend混合菜单用于设定图层颜色与下方地图的组合方式。不透明度是稀释图层而混合模式是混合图层——下层内容仍以完整饱和度透出。最经典的用途是着色/晕渲shading把山体阴影hillshade、地形栅格或深色底图放在主题填充或航拍影像之下将顶层设为Multiply正片叠底起伏感便透过颜色显现出来而不是被颜色完全盖住如果改用降低不透明度的方式则上下两层都会被洗淡。模式作用典型用途Normal普通透明合成——默认模式其他所有场景Multiply变暗两色相乘山体阴影上叠加颜色或影像添加阴影Screen变亮Multiply 的反运算把深色图层从深色底图中提亮出来Lighten保留更亮的一侧颜色叠加亮色要素而不使地图变暗Add颜色相加向白色裁剪发光效果、热力与密度叠加混合作用于图层的填充、轮廓、点、标记与栅格瓦片标签Labels被刻意排除在外始终以普通方式绘制因此地名在正片叠底的山体阴影上依然清晰可读。源码级原理五种模式的边界从何而来这五种模式并非随意挑选而是被渲染管线物理限制所框定的。源码注释packages/core/src/types.ts明确说明MapLibre 将所有样式图层绘制进同一个 WebGL 画布不提供公开的逐图层混合 API上游草案见 maplibre-gl-js#8073GeoLibre 只能借助 GPU 的固定函数混合阶段fixed-function blend stage——即一对blendFunc因子加一个blendEquation——在单个图层绘制期间临时替换 MapLibre 常规的 alpha 合成。因此需要在片元着色器内读取画布上已有颜色的模式Overlay、Color Dodge、Soft Light、Difference 以及非分离 HSL 模式无法实现——MapLibre 直接绘制到地图帧缓冲着色器无法采样除非每次绘制多做一次全帧拷贝。Darken 与 Subtract虽然理论上可用MIN和FUNC_REVERSE_SUBTRACT表达但二者会同时作用于透明度通道MIN会把画布在图层未覆盖处变成min(0, dst)0而擦除地图FUNC_REVERSE_SUBTRACT则会在画布内留下dstA - srcA修正两者需要blendEquationSeparate/blendFuncSeparate而 MapLibre 的状态跟踪器并不提供。最终BLEND_MODES常量的完整定义在 packages/core/src/types.ts[normal, multiply, screen, lighten, add]默认值为DEFAULT_BLEND_MODE normal同文件 L424。每种模式到 GL 状态的映射集中在 packages/map/src/layer-blend-modes.ts 的blendSpecFor函数中case multiply: // src*dst dst*(1-srcA) return { func: [gl.DST_COLOR, gl.ONE_MINUS_SRC_ALPHA], equation: gl.FUNC_ADD }; case screen: // src dst*(1-src) return { func: [gl.ONE, gl.ONE_MINUS_SRC_COLOR], equation: gl.FUNC_ADD }; case lighten: // 逐通道取最大值 MAX return { func: [gl.ONE, gl.ONE], equation: gl.MAX }; case add: // src dst return { func: [gl.ONE, gl.ONE], equation: gl.FUNC_ADD };一个关键不变量是任何模式在图层未覆盖处都必须保持目的地不动。因为 MapLibre 会把一个混合后的 fill/line 图层作为一张铺满视口的四边形进行一次合成若透明源色被模式改写整个地图都会被重绘。所以srcAlpha 0时每个模式都自动退化为不动目的地——这正是MIN和反相减模式被排除的根本原因。tests/layer-blend-modes.test.ts 用真实 GL 常量逐条断言了blendSpecFor的映射关系、画布不透明性与透明处不碰地图这两条安全不变量。整层合成与混合两次警告对于Polygon、Line 与栅格瓦片混合是整层级的同一图层中两个重叠的多边形只与下方地图混合彼此之间不重复混合。这是因为 MapLibre 在渲染fill/line图层时当fill-layer-opacity/line-layer-opacity低于 1 时会先渲染到临时帧缓冲scratch framebuffer再以layerOpacity程序一次性合成到地图layer-blend-modes.ts 中COMPOSITE_LAYER_TYPES new Set([fill, line])与COMPOSITE_PROGRAM layerOpacity正是利用了这一机制把混合模式只施加在最终合成的那一次绘制上写入临时缓冲的中间绘制仍走普通 alpha 混合。为此style-mapper 会把混合图层的fill-layer-opacity/line-layer-opacity钉在LAYER_OPACITY_FOR_BLEND 0.999layer-blend-modes.ts——足够接近不透明让额外乘法在 8-bit 颜色中不可见同时足以触发合成路径。但Pointscircle与 3D 挤出fill-extrusion没有这种合成通道——样式规范只定义了 fill/line 两种图层级不透明度属性因此每个点符号都单独混合。当两个点符号在屏幕上重叠时重叠区域会被混合两次在 Multiply 模式下会明显更暗源码注释实测重叠处rgb(23, 77, 220)vs 单个符号上rgb(76, 136, 222)而普通 alpha 合成的差异只有几分之一。若你的地图出现这种现象建议缩小符号半径、开启聚类、设置随缩放变化的显示阈值或把点转成多边形。这些语义在 packages/map/src/layer-blend-modes.ts 有完整注释并由 e2e/blend-modes.spec.ts 端到端测试断言真实像素随模式变化、画布保持不透明。哪些图层没有 Blend 菜单混合只在 MapLibre 绘制图层时生效因此只有 GeoLibre 自己参与样式化的图层才具备混合能力3D Tiles、Gaussian splats、LiDAR 点云与 deck.gl 叠加层——它们使用各自的 WebGL 渲染器而非 MapLibre通过Add Data Raster Layer添加的Cloud-Optimized GeoTIFF——默认渲染引擎同理通过Add Data Vector Layer添加的矢量图层——它们虽然走 MapLibre 渲染但样式由其专属控件管理混合无从施加。其余图层本地/远程 GeoJSON、普通栅格 XYZ/WMS/WMTS、PMTiles、MBTiles、矢量瓦片均支持混合。混合模式的持久化与导出限制混合模式会随项目保存也会随复制样式/粘贴样式一起传递。但它是GeoLibre 专属的渲染设置在 MapLibre/Mapbox 样式规范中没有对应字段因此在把图层样式导出为样式文件、SLD 或 QML 时会被丢弃。packages/map/src/mapbox-style-export.ts 的注释也确认导出时删除混合模式不会造成任何视觉丢失因为它是渲染循环层的设置而非样式数据。实现细节两个内部接缝与运行时探测从源码结构看installLayerBlendModes 通过包装 MapLibrePainter与Context原型上的两个内部接缝实现混合Painter.prototype.renderLayer——每层每次 pass 都会调用可在图层绘制前后夹住其绘制Context.prototype.setColorMode——每个程序绘制的 GL 混合状态最终都在此解析。包装时以Symbol.for(geolibre.layerBlendModes.patched)标记防止重复安装。由于这些内部方法都未导出tests/layer-blend-modes.test.ts 会针对真实maplibre-gl构建断言其形状一旦升级导致接口变动即报错同时运行时会对每个接缝做特性探测缺失时优雅降级——混合功能关闭、地图照常渲染并记录console.warn。标签类子图层-text、-label、-cluster-count后缀被UNBLENDED_SUFFIXES排除在混合之外L146而图标标记属于符号化内容与图层其余部分一起混合。逐图层操作卡片按钮与 Layer actions 菜单选中图层后卡片上会展开一排图标按钮按钮作用上移 / 下移在堆叠中把图层移动一位缩放到图层将地图视野适配到图层范围仅适用于范围已知的图层识别要素点击地图上的要素在弹出的气泡中查看属性栅格图层上则读取像素值多波段栅格还会构建光谱剖面打开样式面板选中图层并打开其样式控件图层操作Layer actions打开完整菜单见下表元数据检视图层的来源与配置移除图层从项目中删除该图层Layer actions…按钮菜单则收纳其余所有操作菜单项作用重命名修改图层的显示名称打开样式面板与卡片上的调色板按钮相同从图层新建组把该图层包进一个新的图层组编辑几何将图层交给 GeoEditor 进行顶点级编辑将要素载入编辑器…把本图层的要素复制进 GeoEditor 的草图图层打开属性表在属性表中显示该图层记录快速分析无需对话框即可对整个图层执行缓冲区、质心、凸包或包围盒分析参见右键快捷操作选择要素交互式选择单击、矩形、多边形、手绘或半径另有清除选择按住Shift加选、Alt减选、ShiftAlt求交、Esc取消按表达式选择… / 按位置选择…基于属性表达式或空间关系构建选择按表达式选择还可将表达式作为持久图层过滤器应用隐藏不匹配要素而无需新建图层。两者也位于顶部工具栏的 Edit 菜单绑定时间滑块…用该图层的某个日期或数字字段驱动时间滑块导出导出为 GeoJSON、GeoParquet、GeoPackage、KML、KMZ、ZIP 压缩 Shapefile 或 CSV仅属性样式导入与导出符号化详见下文保存到我的数据把配置完整的图层存入个人库之后可在任意项目中从浏览器面板重新添加复制样式 / 粘贴样式在图层间搬运符号化配置刷新 / 自动刷新立即重载数据源或按时间间隔定时刷新见下文实时刷新部分菜单项在不适用的图层上不可用按位置选择需要一个用于比较的第二图层粘贴样式需要剪贴板中已有样式。样式导入导出四种格式的互操作矢量图层在Layer actions → Styles子菜单中提供完整的符号化互操作能力导出 GeoLibre URL 样式写出紧凑的.geolibre.style.json文件专为data与styleURL 参数设计不含要素数据。其 MapLibre 渲染图层以原 GeoJSON 文件名主干作为source使一份样式文档能够区分 ZIP 中的多个 GeoJSON 成员。导出为 Mapbox GL 样式写出自包含的 Mapbox/MapLibre 样式图层 GeoJSON 直接内嵌其中。导出为 OGC SLD与导出为 QGIS QML为其他桌面/服务器 GIS 软件生成样式。从文件导入样式GeoLibre URL / Mapbox GL / SLD / QML…将支持的样式文件应用到所选图层。交互式导入 GeoLibre URL 样式时基于文件名的source关联会被忽略因为所选图层就是目标。从文本导入样式…打开一个文本框粘贴样式例如从 QGIS、gist 或目录页复制出来的它读取同样的四种格式——依据文本内容而非文件扩展名判定格式并报告同样的警告。样式面板头部也带有同一输入框无需离开面板即可触达。已保存样式样式管理器…从样式库应用预设或将当前符号化存入库中。同一库也可在Settings → Style Manager访问。使用 GeoLibre URL 样式时将其上传到启用 CORS 的 Web 主机然后用两个 URL 打开 GeoLibrehttps://web.geolibre.app/?datahttps://assets.geolibre.app/data/places.geojsonstylehttps://assets.geolibre.app/data/sample.style.jsonGeoParquet 与 PMTiles 深度链接、ZIP 源匹配、REST API 响应、栅格样式 JSON 与嵌套 URL 编码等细节参见嵌入与分享。图层组Layer Groups真正的层级结构图层组是图层堆叠中的文件夹支持嵌套因此项目可以承载真正的层级结构而非一条扁平列表创建New group添加空文件夹New group from layer包裹当前所在图层New group from selected layers一次包裹多选图层。填充Move to group移动单个图层Move selected layers to group一步移动整个多选保持其相对顺序Add data to group打开添加数据对话框并将新图层直接定位到该组。组织重命名组、折叠/展开、上下移动并可设置组级不透明度作用于组内所有图层。可见性隐藏组会隐藏其内部图层组内被隐藏的图层会标记为Hidden because its group is not visible以便与手动关闭的图层区分。移除Ungroup (keep layers)解散文件夹但保留其中图层Delete group and layers连组带图层一并删除。图层组及其嵌套随项目一起保存导入 QGIS 项目时也会把 QGIS 项目的组树一并带入。相关的批量移动、深度与可移动性逻辑如layerGroupDepth、layerGroupMoveability封装在 packages/core 中由 LayerPanel 消费并有 tests/layer-groups.test.ts 等测试覆盖。实时刷新Refreshing Live LayersWFS 与 GeoJSON URL 图层可以自动刷新使地图与不断变化的数据源保持同步。打开图层的刷新配置并选择间隔例如关闭、15 秒、30 秒、1 分钟、5 分钟、15 分钟或自定义值也可以随时手动触发一次刷新。每个可刷新图层都会在项目中持久化一条connection 记录因此刷新节奏在保存并重新打开后依然有效。该记录还携带图层的同步状态——上次成功时间与最近一次错误——显示在 Layers 面板上以及一个失败策略决定刷新失败时是保留上一次的好数据还是清空它。完整的 schema 定义见项目格式文档。从 docs/project-format.md 可见其存储结构兼容旧项目的metadata.refresh仍作为遗留字段保留而顶层connection记录是刷新节奏与同步状态的权威来源{ connection: { interval: 60, status: { lastSucceededAt: ..., lastError: null }, onFailure: keepLastGood } }其中interval为秒null表示关闭自动刷新。手动刷新使用同一份已保存的源 URL无需这些元数据。DuckDB 图层分析结果即图层从 DuckDB 数据源添加的图层或由 SQL 工作区产出的图层与任何矢量图层一样支持识别、选择与属性表操作。当你需要编辑其几何或属性时还可以把 DuckDB 查询结果物化为可编辑的 GeoJSON 图层。面板实现通过isDuckDBQueryLayerpackages/core等工具识别此类图层并启用对应能力。底图The Basemap面板底部的Background条目就是底图可在此切换其可见性、调整不透明度。更换底图本身需要使用Plugins 菜单中的Basemaps 插件详见添加数据与插件。若要在Background之上再叠加其他底图风格可将它们作为普通图层添加进堆叠。编辑几何激活 GeoEditor要在图上直接绘制或编辑要素从Plugins 菜单激活GeoEditor插件即可它为 GeoJSON 图层提供绘制、顶点编辑与删除工具。该插件与图层面板深度集成——面板中的编辑几何将要素载入编辑器…等操作正是通过GEO_EDITOR_PLUGIN_ID派发给 GeoEditor 的见 LayerPanel.tsx 的插件注册逻辑。小结GeoLibre 的图层体系把管理—样式化—分析—导出整合在同一条工作流里Layers 面板负责顺序、可见性与分组Blend 菜单在固定函数混合的物理边界内提供了五种实用的叠置模式并借由临时帧缓冲实现了整层合成语义样式子菜单打通了 GeoLibre URL、Mapbox GL、SLD、QML 四种格式的互操作connection 记录让实时刷新与同步状态得以持久化。结合本文引用的源码与测试路径你可以进一步深入每个机制的实现细节并将其直接应用到自己的项目中。【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibre创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 GeoLibre 图层管理完全指南：图层面板、混合模式、图层组与样式互操作实战
GeoLibre 图层管理完全指南图层面板、混合模式、图层组与样式互操作实战【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibreGeoLibre 的Layers 面板图层面板位于主界面左侧是管理项目中每一个图层的核心入口——从最顶层的绘制图层一直到最底部的底图。本文基于 docs/user-guide/layers.md 系统讲解图层的可见性、堆叠顺序、不透明度、五种 WebGL 混合模式Blend Modes、逐图层操作、样式导入导出、图层组、实时刷新机制与 DuckDB 图层等能力并结合仓库源码packages/map/src/layer-blend-modes.ts、packages/core/src/types.ts 等深入剖析底层实现原理。读完本文你将能熟练完成图层的增删改查、叠置渲染调优、跨 GIS 平台的样式搬运以及多图层项目的组织管理。图层面板总览驱动样式与属性表的唯一入口在 GeoLibre 中Layers 面板列出项目中的全部图层从上到下按绘制顺序排列最底端始终是底图Background。选中一个图层后样式面板Style panel 与 属性表Attribute table 会随之切换展示并编辑该图层的符号化参数与要素记录。从源码结构看桌面端的面板实现位于 apps/geolibre-desktop/src/components/panels/LayerPanel.tsx约 5000 行它通过geolibre/core提供的useAppStore订阅全局图层存储同时集成了插件系统的能力如GEO_EDITOR_PLUGIN_ID、TIME_SLIDER_PLUGIN_ID、BASEMAP_CONTROL_PLUGIN_ID等因此面板上大量操作实际上是通过插件注册表动态派发的。图层顺序、可见性与不透明度可见性点击图层卡片上的眼睛按钮即可显示或隐藏该图层面板顶部的Hide all layers隐藏全部图层按钮可一次性隐藏所有图层。顺序直接拖拽图层卡片可调整堆叠顺序也可使用卡片上的上移 / 下移按钮逐位调整。列表位置越靠上的图层绘制时越靠前覆盖在下层之上底图Background永远固定在列表底部不可被移走。不透明度每个图层都带有一个0%100% 的不透明度滑杆用于整体淡化图层。混合模式Blend Modes让地形起伏透过主题色使用方式与核心场景在 样式面板 的符号化控件上方有一个Blend混合菜单用于设定图层颜色与下方地图的组合方式。不透明度是稀释图层而混合模式是混合图层——下层内容仍以完整饱和度透出。最经典的用途是着色/晕渲shading把山体阴影hillshade、地形栅格或深色底图放在主题填充或航拍影像之下将顶层设为Multiply正片叠底起伏感便透过颜色显现出来而不是被颜色完全盖住如果改用降低不透明度的方式则上下两层都会被洗淡。模式作用典型用途Normal普通透明合成——默认模式其他所有场景Multiply变暗两色相乘山体阴影上叠加颜色或影像添加阴影Screen变亮Multiply 的反运算把深色图层从深色底图中提亮出来Lighten保留更亮的一侧颜色叠加亮色要素而不使地图变暗Add颜色相加向白色裁剪发光效果、热力与密度叠加混合作用于图层的填充、轮廓、点、标记与栅格瓦片标签Labels被刻意排除在外始终以普通方式绘制因此地名在正片叠底的山体阴影上依然清晰可读。源码级原理五种模式的边界从何而来这五种模式并非随意挑选而是被渲染管线物理限制所框定的。源码注释packages/core/src/types.ts明确说明MapLibre 将所有样式图层绘制进同一个 WebGL 画布不提供公开的逐图层混合 API上游草案见 maplibre-gl-js#8073GeoLibre 只能借助 GPU 的固定函数混合阶段fixed-function blend stage——即一对blendFunc因子加一个blendEquation——在单个图层绘制期间临时替换 MapLibre 常规的 alpha 合成。因此需要在片元着色器内读取画布上已有颜色的模式Overlay、Color Dodge、Soft Light、Difference 以及非分离 HSL 模式无法实现——MapLibre 直接绘制到地图帧缓冲着色器无法采样除非每次绘制多做一次全帧拷贝。Darken 与 Subtract虽然理论上可用MIN和FUNC_REVERSE_SUBTRACT表达但二者会同时作用于透明度通道MIN会把画布在图层未覆盖处变成min(0, dst)0而擦除地图FUNC_REVERSE_SUBTRACT则会在画布内留下dstA - srcA修正两者需要blendEquationSeparate/blendFuncSeparate而 MapLibre 的状态跟踪器并不提供。最终BLEND_MODES常量的完整定义在 packages/core/src/types.ts[normal, multiply, screen, lighten, add]默认值为DEFAULT_BLEND_MODE normal同文件 L424。每种模式到 GL 状态的映射集中在 packages/map/src/layer-blend-modes.ts 的blendSpecFor函数中case multiply: // src*dst dst*(1-srcA) return { func: [gl.DST_COLOR, gl.ONE_MINUS_SRC_ALPHA], equation: gl.FUNC_ADD }; case screen: // src dst*(1-src) return { func: [gl.ONE, gl.ONE_MINUS_SRC_COLOR], equation: gl.FUNC_ADD }; case lighten: // 逐通道取最大值 MAX return { func: [gl.ONE, gl.ONE], equation: gl.MAX }; case add: // src dst return { func: [gl.ONE, gl.ONE], equation: gl.FUNC_ADD };一个关键不变量是任何模式在图层未覆盖处都必须保持目的地不动。因为 MapLibre 会把一个混合后的 fill/line 图层作为一张铺满视口的四边形进行一次合成若透明源色被模式改写整个地图都会被重绘。所以srcAlpha 0时每个模式都自动退化为不动目的地——这正是MIN和反相减模式被排除的根本原因。tests/layer-blend-modes.test.ts 用真实 GL 常量逐条断言了blendSpecFor的映射关系、画布不透明性与透明处不碰地图这两条安全不变量。整层合成与混合两次警告对于Polygon、Line 与栅格瓦片混合是整层级的同一图层中两个重叠的多边形只与下方地图混合彼此之间不重复混合。这是因为 MapLibre 在渲染fill/line图层时当fill-layer-opacity/line-layer-opacity低于 1 时会先渲染到临时帧缓冲scratch framebuffer再以layerOpacity程序一次性合成到地图layer-blend-modes.ts 中COMPOSITE_LAYER_TYPES new Set([fill, line])与COMPOSITE_PROGRAM layerOpacity正是利用了这一机制把混合模式只施加在最终合成的那一次绘制上写入临时缓冲的中间绘制仍走普通 alpha 混合。为此style-mapper 会把混合图层的fill-layer-opacity/line-layer-opacity钉在LAYER_OPACITY_FOR_BLEND 0.999layer-blend-modes.ts——足够接近不透明让额外乘法在 8-bit 颜色中不可见同时足以触发合成路径。但Pointscircle与 3D 挤出fill-extrusion没有这种合成通道——样式规范只定义了 fill/line 两种图层级不透明度属性因此每个点符号都单独混合。当两个点符号在屏幕上重叠时重叠区域会被混合两次在 Multiply 模式下会明显更暗源码注释实测重叠处rgb(23, 77, 220)vs 单个符号上rgb(76, 136, 222)而普通 alpha 合成的差异只有几分之一。若你的地图出现这种现象建议缩小符号半径、开启聚类、设置随缩放变化的显示阈值或把点转成多边形。这些语义在 packages/map/src/layer-blend-modes.ts 有完整注释并由 e2e/blend-modes.spec.ts 端到端测试断言真实像素随模式变化、画布保持不透明。哪些图层没有 Blend 菜单混合只在 MapLibre 绘制图层时生效因此只有 GeoLibre 自己参与样式化的图层才具备混合能力3D Tiles、Gaussian splats、LiDAR 点云与 deck.gl 叠加层——它们使用各自的 WebGL 渲染器而非 MapLibre通过Add Data Raster Layer添加的Cloud-Optimized GeoTIFF——默认渲染引擎同理通过Add Data Vector Layer添加的矢量图层——它们虽然走 MapLibre 渲染但样式由其专属控件管理混合无从施加。其余图层本地/远程 GeoJSON、普通栅格 XYZ/WMS/WMTS、PMTiles、MBTiles、矢量瓦片均支持混合。混合模式的持久化与导出限制混合模式会随项目保存也会随复制样式/粘贴样式一起传递。但它是GeoLibre 专属的渲染设置在 MapLibre/Mapbox 样式规范中没有对应字段因此在把图层样式导出为样式文件、SLD 或 QML 时会被丢弃。packages/map/src/mapbox-style-export.ts 的注释也确认导出时删除混合模式不会造成任何视觉丢失因为它是渲染循环层的设置而非样式数据。实现细节两个内部接缝与运行时探测从源码结构看installLayerBlendModes 通过包装 MapLibrePainter与Context原型上的两个内部接缝实现混合Painter.prototype.renderLayer——每层每次 pass 都会调用可在图层绘制前后夹住其绘制Context.prototype.setColorMode——每个程序绘制的 GL 混合状态最终都在此解析。包装时以Symbol.for(geolibre.layerBlendModes.patched)标记防止重复安装。由于这些内部方法都未导出tests/layer-blend-modes.test.ts 会针对真实maplibre-gl构建断言其形状一旦升级导致接口变动即报错同时运行时会对每个接缝做特性探测缺失时优雅降级——混合功能关闭、地图照常渲染并记录console.warn。标签类子图层-text、-label、-cluster-count后缀被UNBLENDED_SUFFIXES排除在混合之外L146而图标标记属于符号化内容与图层其余部分一起混合。逐图层操作卡片按钮与 Layer actions 菜单选中图层后卡片上会展开一排图标按钮按钮作用上移 / 下移在堆叠中把图层移动一位缩放到图层将地图视野适配到图层范围仅适用于范围已知的图层识别要素点击地图上的要素在弹出的气泡中查看属性栅格图层上则读取像素值多波段栅格还会构建光谱剖面打开样式面板选中图层并打开其样式控件图层操作Layer actions打开完整菜单见下表元数据检视图层的来源与配置移除图层从项目中删除该图层Layer actions…按钮菜单则收纳其余所有操作菜单项作用重命名修改图层的显示名称打开样式面板与卡片上的调色板按钮相同从图层新建组把该图层包进一个新的图层组编辑几何将图层交给 GeoEditor 进行顶点级编辑将要素载入编辑器…把本图层的要素复制进 GeoEditor 的草图图层打开属性表在属性表中显示该图层记录快速分析无需对话框即可对整个图层执行缓冲区、质心、凸包或包围盒分析参见右键快捷操作选择要素交互式选择单击、矩形、多边形、手绘或半径另有清除选择按住Shift加选、Alt减选、ShiftAlt求交、Esc取消按表达式选择… / 按位置选择…基于属性表达式或空间关系构建选择按表达式选择还可将表达式作为持久图层过滤器应用隐藏不匹配要素而无需新建图层。两者也位于顶部工具栏的 Edit 菜单绑定时间滑块…用该图层的某个日期或数字字段驱动时间滑块导出导出为 GeoJSON、GeoParquet、GeoPackage、KML、KMZ、ZIP 压缩 Shapefile 或 CSV仅属性样式导入与导出符号化详见下文保存到我的数据把配置完整的图层存入个人库之后可在任意项目中从浏览器面板重新添加复制样式 / 粘贴样式在图层间搬运符号化配置刷新 / 自动刷新立即重载数据源或按时间间隔定时刷新见下文实时刷新部分菜单项在不适用的图层上不可用按位置选择需要一个用于比较的第二图层粘贴样式需要剪贴板中已有样式。样式导入导出四种格式的互操作矢量图层在Layer actions → Styles子菜单中提供完整的符号化互操作能力导出 GeoLibre URL 样式写出紧凑的.geolibre.style.json文件专为data与styleURL 参数设计不含要素数据。其 MapLibre 渲染图层以原 GeoJSON 文件名主干作为source使一份样式文档能够区分 ZIP 中的多个 GeoJSON 成员。导出为 Mapbox GL 样式写出自包含的 Mapbox/MapLibre 样式图层 GeoJSON 直接内嵌其中。导出为 OGC SLD与导出为 QGIS QML为其他桌面/服务器 GIS 软件生成样式。从文件导入样式GeoLibre URL / Mapbox GL / SLD / QML…将支持的样式文件应用到所选图层。交互式导入 GeoLibre URL 样式时基于文件名的source关联会被忽略因为所选图层就是目标。从文本导入样式…打开一个文本框粘贴样式例如从 QGIS、gist 或目录页复制出来的它读取同样的四种格式——依据文本内容而非文件扩展名判定格式并报告同样的警告。样式面板头部也带有同一输入框无需离开面板即可触达。已保存样式样式管理器…从样式库应用预设或将当前符号化存入库中。同一库也可在Settings → Style Manager访问。使用 GeoLibre URL 样式时将其上传到启用 CORS 的 Web 主机然后用两个 URL 打开 GeoLibrehttps://web.geolibre.app/?datahttps://assets.geolibre.app/data/places.geojsonstylehttps://assets.geolibre.app/data/sample.style.jsonGeoParquet 与 PMTiles 深度链接、ZIP 源匹配、REST API 响应、栅格样式 JSON 与嵌套 URL 编码等细节参见嵌入与分享。图层组Layer Groups真正的层级结构图层组是图层堆叠中的文件夹支持嵌套因此项目可以承载真正的层级结构而非一条扁平列表创建New group添加空文件夹New group from layer包裹当前所在图层New group from selected layers一次包裹多选图层。填充Move to group移动单个图层Move selected layers to group一步移动整个多选保持其相对顺序Add data to group打开添加数据对话框并将新图层直接定位到该组。组织重命名组、折叠/展开、上下移动并可设置组级不透明度作用于组内所有图层。可见性隐藏组会隐藏其内部图层组内被隐藏的图层会标记为Hidden because its group is not visible以便与手动关闭的图层区分。移除Ungroup (keep layers)解散文件夹但保留其中图层Delete group and layers连组带图层一并删除。图层组及其嵌套随项目一起保存导入 QGIS 项目时也会把 QGIS 项目的组树一并带入。相关的批量移动、深度与可移动性逻辑如layerGroupDepth、layerGroupMoveability封装在 packages/core 中由 LayerPanel 消费并有 tests/layer-groups.test.ts 等测试覆盖。实时刷新Refreshing Live LayersWFS 与 GeoJSON URL 图层可以自动刷新使地图与不断变化的数据源保持同步。打开图层的刷新配置并选择间隔例如关闭、15 秒、30 秒、1 分钟、5 分钟、15 分钟或自定义值也可以随时手动触发一次刷新。每个可刷新图层都会在项目中持久化一条connection 记录因此刷新节奏在保存并重新打开后依然有效。该记录还携带图层的同步状态——上次成功时间与最近一次错误——显示在 Layers 面板上以及一个失败策略决定刷新失败时是保留上一次的好数据还是清空它。完整的 schema 定义见项目格式文档。从 docs/project-format.md 可见其存储结构兼容旧项目的metadata.refresh仍作为遗留字段保留而顶层connection记录是刷新节奏与同步状态的权威来源{ connection: { interval: 60, status: { lastSucceededAt: ..., lastError: null }, onFailure: keepLastGood } }其中interval为秒null表示关闭自动刷新。手动刷新使用同一份已保存的源 URL无需这些元数据。DuckDB 图层分析结果即图层从 DuckDB 数据源添加的图层或由 SQL 工作区产出的图层与任何矢量图层一样支持识别、选择与属性表操作。当你需要编辑其几何或属性时还可以把 DuckDB 查询结果物化为可编辑的 GeoJSON 图层。面板实现通过isDuckDBQueryLayerpackages/core等工具识别此类图层并启用对应能力。底图The Basemap面板底部的Background条目就是底图可在此切换其可见性、调整不透明度。更换底图本身需要使用Plugins 菜单中的Basemaps 插件详见添加数据与插件。若要在Background之上再叠加其他底图风格可将它们作为普通图层添加进堆叠。编辑几何激活 GeoEditor要在图上直接绘制或编辑要素从Plugins 菜单激活GeoEditor插件即可它为 GeoJSON 图层提供绘制、顶点编辑与删除工具。该插件与图层面板深度集成——面板中的编辑几何将要素载入编辑器…等操作正是通过GEO_EDITOR_PLUGIN_ID派发给 GeoEditor 的见 LayerPanel.tsx 的插件注册逻辑。小结GeoLibre 的图层体系把管理—样式化—分析—导出整合在同一条工作流里Layers 面板负责顺序、可见性与分组Blend 菜单在固定函数混合的物理边界内提供了五种实用的叠置模式并借由临时帧缓冲实现了整层合成语义样式子菜单打通了 GeoLibre URL、Mapbox GL、SLD、QML 四种格式的互操作connection 记录让实时刷新与同步状态得以持久化。结合本文引用的源码与测试路径你可以进一步深入每个机制的实现细节并将其直接应用到自己的项目中。【免费下载链接】GeoLibreA lightweight, cloud-native GIS platform for visualizing, exploring, and analyzing geospatial data. It runs in the web browser, on the desktop, on mobile, and inside Jupyter notebooks.项目地址: https://gitcode.com/GitHub_Trending/ge/GeoLibre创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考