Potree 中文使用手册（非官方，个人通过操作和查阅整理的）

Potree 是一个用于可视化点云数据的开源 JavaScript 库。它提供了丰富的功能和交互性，使用户可以以直观的方式浏览、分析和交互大规模点云数据集。

1 Appearance 功能

在 Potree 中，"Appearance"（外观）是一个功能强大的工具，它允许对点云的外观进行各种调整和定制，以满足您的可视化需求。下面是 Potree 中 Appearance 功能的一些详细介绍：

1. 1. "Point budget"（点数预算）

用于控制在可视化过程中加载和呈现的点云数量。它指定了场景中允许显示的最大点数。当点云的点数超过点预算时，Potree 会自动根据一定的策略进行点云的简化和采样，以确保性能和流畅的交互体验。

如图所示，点预算设置为 4,000,000，表示在场景中最多可以显示 4,000,000 个点。当点云的点数超过此限制时，Potree 会根据其内部算法对点云进行简化和采样，以确保点数在预算范围内。这有助于保持良好的性能和流畅的交互体验，同时仍然能够呈现大规模的点云数据。

1.2"Field of view"（视野）

它决定了在三维场景中可见的范围和角度。视野值表示相机视野的角度，通常以度数为单位。

在 Potree 中，视野值可以在 0 到 180 之间进行调整，其中 0 表示非常窄的视野，而 180 表示非常宽阔的视野。常见的视野值通常在 30 到 90 度之间。较小的视野值会产生较窄的视野范围，使您能够更加聚焦于特定区域或细节。而较大的视野值会产生更广阔的视野范围，允许您在场景中看到更多的内容。

如图1.2.1所示，此时Field of view参数为20，视野非常窄。如图1.2.2，此时Field of view参数为100，视野比较宽阔。

图1.2.1

图1.2.2

1.3 EDL

Eye-Dome Lighting(EDL)是一种非逼真、基于图像的着色技术，旨在改善科学可视化图像中的深度感知。它依赖于使用 GLSL 着色器在 GPU 上实现的高效后处理通道，以实现交互式渲染。仅需要投影深度信息来计算阴影函数，然后将其应用于彩色场景图像。

EDL可通过侧边栏设置EDL相关的参数，或通过API进行设置。 Enable：开启或关闭EDL

​ Radius：阴影半径，Strenght：阴影强度。Opacity:：整体透明度。（如图1.3.1所示）

图1.3.1

1.4 Background

在 Potree 中，"Background"（背景）是指用于呈现点云背后的环境或画布的部分。通过设置背景，您可以控制点云场景的外观和视觉效果。

Skybox（天空盒）是指将点云场景放置在一个具有自然或虚拟背景的立方体贴图中。天空盒可以提供更加逼真和沉浸的感觉，增强点云场景的环境氛围。

Gradient（渐变）：您可以定义一个颜色渐变，使天空盒背景从一种颜色平滑过渡到另一种颜色。通常，渐变天空盒用于在点云场景的顶部和底部创建一个渐变的天空效果，以增强视觉效果。

Black（黑色）：选择黑色天空盒将点云场景放置在一个纯黑色背景中。这种选项可以使点云更加突出，并且适用于需要强调点云形状和特征的场景。

White（白色）：选择白色天空盒将点云场景放置在一个纯白色背景中。这种选项通常用于需要增加整体亮度和对比度的场景，使点云更加清晰和鲜明。

None（无）：选择无天空盒将点云场景放置在一个透明背景中，没有额外的天空效果。这种选项通常用于需要将点云嵌入到其他环境或背景中的场景。

 

1.4 Other

在 Potree 中，"Other"（其他）选项提供了一些额外的外观设置，用于自定义点云的显示效果。具体而言，"Other" 选项通常包含以下设置：

1.4.1Splat Quality（点云绘制质量）

是 Potree 中的一个设置选项，用于控制点云渲染的质量和细节程度。具体而言，它影响了点云的点与点之间的插值和平滑度。

1.4.1.1 Standard（标准）：在标准质量级别下，点云的渲染会使用一种较快的插值算法，以提高渲染速度。这会在某种程度上牺牲一些细节和平滑度，但对于大多数场景来说，仍能提供足够好的视觉效果。

1.4.1.2High Quality（高质量）：在高质量级别下，点云的渲染会使用一种更精细的插值算法，以提供更高的细节和平滑度。这种设置适用于对点云细节要求较高的情况，但可能会牺牲一些渲染速度。

1.4.2 Min node size（最小节点大小）

是设置指定了 octree 中最小节点的尺寸。当设置较小的最小节点大小时，Potree 将尝试将点云数据细分到更小的节点中，以提供更高的精细度。

如图1.4.2.1所示Min node size为974时，点云模型较为模糊。如图1.4.2.2所示Min node size为0时，点云模型较为清晰。

1.4.2.1

1.4.2.2

1.4.3 Box

"Box" 是 Potree 中的一个外观选项，用于定义点云可视化中每个点的呈现形状。当选择 "Box" 时，每个点都会以立方体的形式进行渲染。如图1.4.3.1

1.4.3.1

1.4.4 Lock view

"Lock View" 是 Potree 中的一个功能，用于锁定视图，使其保持在特定的位置和方向。当启用 "Lock View" 后，您可以自由浏览点云数据而不会改变视图的位置和方向。

2  Measurement

"Measurement" 是 Potree 中的一个功能，用于在点云数据上进行测量和量化操作。它允许您测量点云中的距离、角度、面积和体积等尺寸属性。通过 "Measurement"，您可以选择不同的测量工具，如测量距离、测量角度、测量面积和测量体积。您可以在点云数据上选择起始点和终点、边界点或面片来执行测量操作。测量结果将以数字形式显示在屏幕上，并且可以根据需要进行调整和删除。

2.1 Angle measurement

"Angle measurement" 是 Potree 中的一个功能，用于测量点云数据中的角度。它允许您在点云中选择三个点，并计算它们之间的角度。使用 "Angle measurement"，您可以选择点云中的三个位置点，这些点可以是点云上的任意点。选择第一个点后，您可以继续选择第二个和第三个点来形成一个角度。测量结果将以度数或弧度的形式显示在屏幕上，并且可以根据需要进行调整和删除。

2.2 Point measurement

"Point measurement" 是 Potree 中的一个功能，用于测量点云数据中的某个点的坐标

通过 "Point measurement"，您可以在点云中选择一个点，并获取该点的三维坐标。您可以通过在点云上单击选择要测量的点。选定的点的坐标将以指定的坐标系（例如笛卡尔坐标系）显示在屏幕上。

2.3 Distance measurement

"Distance measurement" 是 Potree 中的一个功能，用于测量点云数据中两个点之间的距离。您可以在点云中选择两个点，然后使用该功能测量它们之间的距离。可以连续点击，左击结束绘制。这个距离通常以选定的坐标单位（例如米、英尺等）进行表示，具体取决于点云数据的坐标系统和单位设置。通过测量距离，您可以了解点云中不同点之间的空间间隔，并获得有关点云结构和形状的信息。

2.4 Height measurement

"Height measurement" 是 Potree 中的一个功能，用于测量点云数据中某个点的高度。您可以在点云中选择一个点作为参考点，然后选择另一个点作为测量点，该功能将计算出这两个点之间的高度差。高度通常是以选定的垂直坐标单位（例如米、英尺等）进行表示，具体取决于点云数据的坐标系统和单位设置。

2.4 Circle measurement

"Circle measurement" 功能，可以使用三个点来确定一个圆并计算其半径。

点击三个点以确定圆的周围。确保按照逆时针或顺时针的顺序选择点，以便正确确定圆。在选择完三个点后，Potree 将绘制一个圆并显示圆的半径。

2.6 Arc Measurement

"Arc Measurement"（弧度测量）用于测量点云数据中的弧线的弧度值。通过选择弧线上的点，Potree 将计算并显示出弧度的值。依次点击弧线上的两点，确保按照顺时针或逆时针的顺序选择点，以便正确测量弧度。在选择完所有点后，Potree 将绘制弧线并显示弧度值。

2.7 Area measurement

"Area Measurement"（面积测量）用于测量点云数据中的平面多边形的面积。依次点击区域内的点，左击结束绘制。以形成封闭的多边形区域。确保按照顺时针或逆时针的顺序选择点，以便正确测量面积。在选择完所有点后，Potree 将绘制多边形区域并显示面积值和各边的距离。

2.8 Volume measurement

"Volume Measurement（一）"（体积测量）用于测量点云数据中的三维体积。Potree会自动创建立方体，并计算该立方体的体积。该立方体的可以在三个方向进行距离与角度的变化，同时变化的立方体的体积也会随着变换而改变。

"Volume Measurement（二）"（体积测量）用于测量点云数据中的三维体积。Potree会自动创建球体，并计算该球体的体积。该球体的可以在三个方向进行距离与角度的变化，同时变化的立方体的体积也会随着变换而改变。结果在Scene模块中（如图所示）。

2.9 Height profile

"Height Profile"（高度剖面）用于创建点云数据的垂直高度剖面图。它可以帮助您分析点云数据在垂直方向上的高度分布和变化。

1. 单击"Height Profile"按钮，然后您可以开始创建高度剖面：

a. 单击并拖动鼠标在点云上选择一个起始点。

b. 继续拖动鼠标并选择剖面线上的其他点。您可以通过单击添加多个连接的点，以定义剖面线的形状。同时可以通过Width设置线路形状的宽度。

1. 完成选择后，选择sence图层，就可以看到每个点坐标信息，再点击show 2d profile。，您可以看到高度剖面图中点云的高度分布，以及剖面线上每个点的高度值。

2.10 Annotation

Annotation"（注释）是一项功能，允许用户在点云数据上添加文本标注，以便记录和描述特定位置、特征或信息。通过sence模块可以查看标注点的坐标，Title对标注内容进行修改以及通过Description对标注实体进行描述。

2.11 Remove all measurements

可以删除所有测量模块在测量时所建立模型与标记。

2.12 Show/Hide labels

使用"Show/Hide labels"功能来显示或隐藏标签。标签通常是点云数据中的注释或标识，可以显示在点云的某些位置上。

 

3 Clipping

"Clipping"功能允许您剪裁点云数据，以显示感兴趣的区域并去除不需要的部分。通过剪裁，您可以集中注意力在特定区域内的点云，并提供更清晰的视图。

3.1 Volume Clip

"Volume Clip"功能允许您通过定义一个立体体积来剪裁点云数据。这样可以将点云限制在指定的空间范围内，从而更好地展示感兴趣的区域。

并在Clip Task 中选择裁剪范围，

1. None（无）：选择None选项时，不进行任何裁剪操作，即显示完整的点云数据。
2. Highlight（高亮）：选择Highlight选项时，裁剪任务将突出显示位于裁剪区域内的点云数据，而将裁剪区域外的点云数据进行隐藏。这种方式可以帮助您将注意力集中在感兴趣的区域上。
3. Inside（内部）：选择Inside选项时，裁剪任务将仅显示位于裁剪区域内的点云数据，而将裁剪区域外的点云数据进行隐藏。这种方式适用于需要仅关注特定区域的情况。
4. Outside（外部）：选择Outside选项时，裁剪任务将仅显示位于裁剪区域外的点云数据，而将裁剪区域内的点云数据进行隐藏。这种方式适用于需要排除特定区域的情况。

3.2 Polygon Clip

Polygon Clip"功能用于通过绘制多边形来裁剪点云数据，以显示感兴趣区域的子集。这可以帮助您聚焦于特定区域，并排除不需要的点云数据。并在Clip Task 中选择裁剪范围，

3.3Draw a selection box, Requires you to be in orthographic camera mode

在Potree中绘制选择框需要您处于正交相机模式（Orthographic Camera Mode）。正交相机模式是一种相机视图模式，其中物体的大小和相对位置在视图中保持不变，不受远近的影响。

同样并在Clip Task 中选择裁剪范围，

3.4 Clip Method

Clip Method（裁剪方法）中的Inside Any（任一内部）和Inside All（全部内部）用于定义裁剪体积内部点的显示方式。

• Inside Any（任一内部）：选择Inside Any方法时，只要点云数据中的点位于裁剪体积的任意一个面内部，即使其他面外部的点也会被显示出来。这意味着只要有一个面包含点，该点就会被显示。
• Inside All（全部内部）：选择Inside All方法时，点云数据中的点必须同时位于裁剪体积的所有面内部，才会被显示出来。只有当点位于所有面内部时，它才会被认为是内部点。

4 .Navigation

在Potree中，Navigation（导航功能）用于浏览和探索点云数据。

4.1 Earth Control

"Earth Control"可以以某一点为控制中心来进行导航和观察。当您将视角锁定到某一点时，该点将成为地球模型的中心，围绕该点进行导航和旋转。

4.2 Fly Control

"Fly Control"是一种导航模式，可以使您以飞行的方式浏览点云数据。使用Fly Control，您可以在三维空间中自由移动和探索点云模型，类似于飞行的感觉。

4.3 Helicopter Control

Helicopter Contro模式视角保持在固定的高度，并以类似直升机俯视的方式查看点云数据。

4.4 Full extent

Full extent（全范围）是指在Potree中查看点云数据时，将整个点云数据显示在视图中的功能

4.4 Navigation cube

Navigation cube（导航立方体）是Potree中的一个导航工具，用于帮助您控制和导航点云数据的视图。它通常以立方体的形式显示在屏幕的角落或边缘，并提供了一种直观的方式来改变视图的方向和位置。

4.5 Compass

Compass（指南针）是Potree中的一个导航工具，用于指示当前视图的方向和朝向。它通常显示为一个小型圆形或方形图标，

4.6 Camera Animation

Camera Animation（相机动画）功能允许您创建和播放相机移动的动画序列。您可以定义相机的起始位置和朝向，并设置相机在一定时间内移动到目标位置或沿指定路径移动的动画效果。

通过sence模块中 other图层找到该动画路线，可以通过路线的节点编辑路线，以及Properties模块的其他参数设置，设置动画路线。最后点击play进行视角动画播放。

4.7 Stereo View

在Potree中，您可以选择不同的视角模式来实现立体视觉效果，其中包括以下几种视角：

1. Left view（左视图）：以左眼视角呈现点云数据，通过产生左右眼之间的视差来实现立体感。
2. Right view（右视图）：以右眼视角呈现点云数据，同样通过视差效果来实现立体感。
3. Front view（前视图）：以正面视角呈现点云数据，可以感知点云对象在前方的立体位置。
4. Back view（后视图）：以背面视角呈现点云数据，可以感知点云对象在后方的立体位置。
5. Top view（顶视图）：以俯视视角呈现点云数据，可以感知点云对象在上方的立体位置。
6. Bottom view（底视图）：以俯视视角呈现点云数据，可以感知点云对象在下方的立体位置。

4.8 Camera Projection

相机投影（Camera Projection）是指将三维场景映射到二维图像的过程。在点云可视化中，相机投影决定了如何将点云数据投影到屏幕上显示。

在Potree中，有两种常见的相机投影方式：

1. 透视投影（Perspective Projection）：透视投影模拟了人眼观察场景时的投影效果，使得远离相机的对象显得较小，近距离的对象显得较大。透视投影可以提供更加真实的观察体验，适用于模拟真实世界的场景。
2. 正交投影（Orthographic Projection）：正交投影将所有对象按照相同的比例投影到屏幕上，使得远近距离的对象保持相同的大小。正交投影消除了透视效果，使得观察者可以更好地观察场景中的尺寸和形状。正交投影常用于技术绘图和测量等需要精确尺寸和形状的场景。

4.9 Speed

用于控制视图缩进的距离。

5 Scene

在 Potree 中，"Scene"（场景）是指当前加载的点云数据集及其相关的对象和属性。它是您在 Potree 中进行数据可视化和分析的主要工作区域。下面是场景中的一些常见元素和功能：

5.1 Export

Export（导出）：通过导出功能，您可以将当前场景中的数据保存到不同的文件格式中。可以导出为 JSON 格式、DXF 格式（用于 CAD 软件）或 Potree 格式（用于 Potree Viewer）等。

5.2 Objects

在 Potree 中，"Objects"（对象）是指点云数据集中的不同类型的元素或数据。这些对象可以分为几个主要类别，包括：

1. Point Clouds（点云）：点云对象是最常见的对象类型，它们由大量的点构成，代表了三维空间中的实际物体或场景。每个点都具有位置信息和可能的其他属性，如颜色、强度、分类等。"CA13" 是一个点云对象的名称，表示具体的点云数据集。
2. Measurements（测量）：测量对象允许您在点云中进行各种测量操作，例如距离测量、角度测量和体积测量。您可以创建和管理多个测量对象，并对其进行编辑和删除。
3. Annotations（注释）：注释对象用于在点云中添加文本标签或符号，以标记特定的位置、特征或信息。您可以创建注释对象并设置其位置、文本内容和样式。
4. Other（其他）：这个类别包含其他类型的对象，如相机、矢量数据和图像等。相机对象用于控制观察视角和相机参数，矢量数据可以添加矢量图层或几何对象，而图像对象用于在点云中添加图像纹理。

5.3 Properties（属性）

属性部分显示了所选对象的属性和设置。您可以在此处编辑和调整对象的可视化属性、颜色、透明度等。

6 Filters

在Potree中，Filters（过滤器）用于筛选和控制点云数据的可见性和显示方式。

6.1在Potree中，Classification（分类）用于对点云数据中的地物进行分类和标记。

• Show/Hide All（显示/隐藏全部）：该设置可以切换点云数据的可见性，即显示或隐藏所有的点云。
• Never Classified（未分类）：选择该设置可以为未分类的点云数据应用特定的颜色。
• Unclassified（未标记）：选择该设置可以为已标记为未分类的点云数据应用特定的颜色。
• Ground（地面）：选择该设置可以为地面点云数据应用特定的颜色。
• Low Vegetation（低植被）：选择该设置可以为低植被点云数据应用特定的颜色。
• Medium Vegetation（中等植被）：选择该设置可以为中等植被点云数据应用特定的颜色。
• High Vegetation（高植被）：选择该设置可以为高植被点云数据应用特定的颜色。
• Building（建筑物）：选择该设置可以为建筑物点云数据应用特定的颜色。
• Low Point（噪点）：选择该设置可以为低点密度或噪点级别的点云数据应用特定的颜色。
• Key-Point（关键点）：选择该设置可以为关键点或重要特征点的点云数据应用特定的颜色。
• Water（水体）：选择该设置可以为水体区域的点云数据应用特定的颜色。
• Overlap（重叠）：选择该设置可以为重叠区域的点云数据应用特定的颜色。
• Default（默认）：选择该设置可以恢复默认的颜色设置。

"Invert"（反转）选项在Potree中确实是指将选中的项反转为未选中状态，未选中的项反转为选中状态。

6.2 Returns

在Potree中，以下是一些与点云数据相关的属性和筛选条件的解释：

1. Return Number（返回编号）：表示激光返回的次序编号，范围为0到6。激光束可能会经过多次反射并返回多个数据点，每个数据点都有一个返回编号来标识其所属的返回次序。
2. Number of Returns（返回数量）：表示激光束发出后实际返回的次数，范围为0到7。这个属性记录了激光束实际返回的次数，有助于分析激光束与地物之间的交互关系。
3. Point Source ID（点源ID）：表示生成点云的激光束编号或扫描线编号。每个激光束或扫描线都有一个唯一的标识符，可以通过该属性来区分不同的激光束或扫描线。
4. Range（距离）：表示点云数据点到激光发射器的距离，范围为0.000到64,434.000。该属性可以用于计算点云数据的三维空间位置或进行距离相关的分析。

6.3GPS Time（GPS时间）：

记录激光扫描的时间戳，用于精确定位和时间相关的分析。可以基于GPS时间来分析点云数据的时序特征或与其他时间相关的数据进行关联。