Potree / PotreeConverter (.cloud.js)(Web点云可视化格式)
2026年06月25日 09:08
GISBox是一站式三维 GIS 数据编辑、转换、发布平台,支持 OSGB/GEOTIFF/RVT 等多种 GIS 格式编辑,转换为 3DTiles/Terrain 等并发布。
简介
Potree / PotreeConverter(生成的 cloud.js 是核心配置文件)是一套开源的 Web 端大规模点云可视化方案:PotreeConverter 是一个命令行预处理工具,负责把原始点云(如 LAS/LAZ)按八叉树构建多分辨率 LOD 层级并分块压缩,输出包含 cloud.js 元数据的目录结构;而 potree.js 则在浏览器中通过 WebGL 按需加载这些数据块,实现数十亿点级别的流畅浏览、测量、剖面等交互,无需安装插件。
文件结构
IPotreeConverter转换完成后,输出目录通常包含以下文件/文件夹:
- cloud.js(核心入口文件):点云的"总目录",用 JS/JSON 描述整个八叉树的层级结构、包围盒(AABB)、LOD 信息、各节点数据文件路径等;potree.js 加载点云时首先读取它。
- metadata.json(元数据文件):描述点云的全局信息,如坐标系(WKT/proj4)、包围盒、点数量、颜色/强度/分类等属性范围,以及各层级节点的偏移/尺度等信息(新版本常以此为主入口替代 cloud.js)。
- data/目录(.bin点云数据块):按八叉树层级分块存放的二进制点云数据,每个文件对应八叉树的一个节点(如r0000/0/0/0.bin),文件内存储该节点所包含点的坐标(归一化+偏移量化)、颜色、强度、分类等属性。
- hierarchy.bin(八叉树结构文件):存储八叉树的拓扑结构信息(哪些节点存在、子节点索引关系等),用于快速判断视口内需要加载哪些节点,避免遍历全部数据块。
- .potree 文件(可选):Potree桌面查看器(PotreeDesktop)使用的工程文件,本质是把 cloud.js + metadata 等信息打包在一起,Web端一般不需要。
- sigeom.sa/.prj 等空间参考文件(可选):用于定义点云的坐标系统投影信息,potree.js 渲染时会据此进行坐标转换(如WGS84转局部笛卡尔坐标)。
- debug.log/日志文件(可选):转换过程的运行日志,排查转换错误时有用。
优点
- 超大规模点云支持:基于八叉树 + LOD 多分辨率金字塔结构,可流畅渲染数十亿点(如 CA13 数据集 180 亿点在普通工作站可浏览),远超传统桌面工具。
- 纯浏览器端运行:基于 WebGL 硬件加速,无需安装任何插件,跨平台(PC/移动端),零部署成本,方便分享和协作。
- 按需加载 + 视锥体剔除:只加载当前视口可见的数据块,结合视锥体剔除和 LOD 动态切换,带宽和内存占用极低,网络传输效率高。
- 多格式兼容:支持 LAS/LAZ(流式解压)、EPT(金字塔瓦片)、COPC(云优化)等多种输入/输出格式,PotreeConverter 可一键转换。
- 丰富的交互分析工具:内置测量(距离/面积/体积)、剖面分析、标注、分类着色(高程/强度/RGB)、裁剪盒等专业功能,API 开放可自定义工具。
- 开源免费、生态活跃:GitHub 开源项目,社区持续更新,支持与 Cesium.js 集成(地形+点云)、VR 浏览、iframe 嵌入等扩展场景。
- 数据压缩效果好:LAZ 格式可减少 70–80% 存储空间,八叉树量化压缩进一步降低传输量,适合网络分发和云端存储。
缺点
- 必须离线预处理:PotreeConverter 转换过程耗时较长(大数据集可能数小时),且是一次性的,原始数据更新后需重新转换,不支持实时流式增量更新。
- 生成文件数量多、目录结构复杂(1.x):经典格式会生成大量 .bin 小文件(如 r0000/0/0/0.bin),对 HTTP 服务器的并发连接数和文件系统 inode 有压力;2.x 改为单文件(octree.bin)但生态迁移成本高。
- 渲染存在部分失真:基于点云 rasterization 而非 true mesh,远处或高密度区域会有视觉失真(点重叠、闪烁),不适合需要精确几何表达的场景。
- 移动端性能受限:虽然支持移动浏览器,但 WebGL 渲染大量点仍消耗 GPU 资源,低端设备易卡顿或崩溃,需大幅降低分辨率。
- 编译部署门槛较高:PotreeConverter 依赖 LASzip、LASlib 等 C++ 库,Windows/Linux 编译常遇链接错误(如 LASzip 路径配置),对非开发人员不友好。
- 服务端需支持 Range Request:EPT/COPC 等格式依赖 HTTP 206 部分请求,若服务器不支持则无法按需加载,回退为全量下载。
- 功能偏"查看"而非"编辑":擅长浏览和测量,但不支持点云编辑、语义分割、实时分类等高级 GIS 分析,需配合其他工具使用。
应用场景
Potree/PotreeConverter主要应用于城市规划与智慧城市管理中浏览 LiDAR 扫描的城市三维模型,进行建筑量测、日照分析和城管巡查;在测绘与工程领域用于在线交付大范围航测点云,客户无需安装专业软件即可在浏览器中查看成果并做距离/面积/土方量等量测;在考古与文化遗产保护中用于高精度文物三维点云的线上公开展示与研究共享;在电力巡检、矿山监测、林业资源调查等行业中用于将大规模采集点云发布为 Web 可视化看板,实现远程协同查看与多人在线批注分析;同时也广泛用于高校教学和科研中作为点云算法的可视化验证工具。
示例图
1. Potree点云渲染效果视图。

2. Potree在web端显示大型点云模型文件。

文件打开方式
1. Potree在Web上显示效果。

相关 GIS 文件
MID
IMDF
STYLX
OpenDRIVE (.xodr)
参考资料
- https://blog.csdn.net/m0_63586335/article/details/152950519
- https://blog.csdn.net/silent702366/article/details/140622365
- https://www.cnblogs.com/marblemm/p/9242239.html