图层预览（View Layer）

VS Code / Cursor 里的图像查看器，同时适用于 GIS 栅格预览。

支持 PNG / JPEG / BMP / TIFF / GeoTIFF：普通图片可快速浏览与叠图；带地理参考的数据可按地图坐标查看、拉伸与调色。渲染基于 OpenLayers WebGLTile。

GITCODE：https://gitcode.com/dpgis/dpviewlayer.git GITHUB: git@github.com:dpgis/dpviewlayer.git

能做什么

• 作为日常图像查看器打开常见栅格格式
• 预览遥感 / 分类 mask / RGB 影像（含 GeoTIFF、world file）
• 灰度、多波段彩色、调色板（唯一值）样式与对比度拉伸
• 多图层叠加、透明度、识别像元、仿射与显示 CRS

安装

cd dpviewlayer && npm install && npm run package

在 VS Code / Cursor 中「从 VSIX 安装」生成的 dpviewlayer-*.vsix。

npm run compile   # 递增版本 + 打包 webview + tsc
npm run smoke     # 本地叠层冒烟测试（可选）

打开方式

• 资源管理器 / 编辑器标题右键 → 在新视图中打开 / 添加为图层
• 命令面板 → 图层预览: 在新视图中打开 / 添加为图层 / 新建空视图

不再占用默认编辑器：点文件不会自动抢开，需通过上述命令打开。

支持格式

渲染与样式

• 单波段灰度 / 多波段彩色 / 调色板（唯一值）
• 对比度：无增强、MinMax、百分比截断、均值±标准差
• 调色板：Random colors（每次选择换一批色）、渐变色带、反转、透明度
• 色表可另存 / 加载 JSON 文件，或导出索引色 PNG（PLTE；多波段按颜色表所选波段）

地图与地理参考

• 地图显示 CRS（含自定义 EPSG）；切换时有 CRS 图层重投影，无 CRS 图层直接改标显示
• 打开有 CRS 的图层时地图保持当前 CRS，并自动定位到重投影后的范围
• 仿射：GDAL GeoTransform，默认 0,1,0,0,0,1
• 自动读取 world file / GeoTIFF 内嵌地理参考
• 有 CRS：图层保持文件 CRS，打开与切换地图 CRS 时都重投影到当前地图 CRS（不会把地图改成图层 CRS）
• 无 CRS：赋当前地图 CRS；切换地图 CRS 时不重投影，直接按新坐标系显示（仿射数值不变）

图层

同一视图可叠加多个文件。新图层叠在最上方。

识别

在地图上单击，侧栏「识别」列出各图层在该点的波段像元值。

金字塔 / 大图

插件不创建 overview。大图（总像素 > 2500 万）需要金字塔才能打开：

• GeoTIFF 内置金字塔（gdaladdo 写入同一 .tif）即可，不需要旁侧 .ovr
• 或旁侧外部概览：*.tif.ovr / *.ovr
• PNG / JPEG / BMP：内存全分辨率显示（外部 .ovr 不参与大图放行）
• 无内置金字塔且无外部 .ovr：拒绝打开并提示

有地理参考的 GeoTIFF 会读取文件内 CRS（如 EPSG:32649）与仿射，不会当成空 CRS / 像素坐标。

色表文件

通过侧栏「加载色表 / 保存色表」选择任意 JSON 文件（默认建议与栅格同目录的 *.colormap.json）。

行 ID 为数组下标，不写入每行。区间为半开 [min, max)（即 ≥ min 且 < max）。

{
  "colorTable": [
    { "min": 0, "max": 1, "color": "#e6194b" },
    { "min": 1, "max": 2, "color": [60, 180, 75] },
    { "min": 4, "max": 5, "color": "#4363d8" }
  ]
}

命令

TODO

• [ ] 添加矢量支持（如 GeoJSON / Shapefile 等，与栅格叠置显示）
• [ ] 更多栅格格式与dtype覆盖
• [ ] 大图性能与外部 overview 体验优化