操作指南

该部分内容主要介绍 Viewer 软件的常用操作。

设置相机 IP

Viewer 支持修改网络相机的 IP 地址为静态或动态 IP 地址。相机与上位机 IP 地址处于同一网段时，Viewer 才可打开相机。若目标相机图标显示红色且显示 “InvalidNetCam”，建议查看相机信息，如相机与上位机 IP 地址不在同一网段，请按照以下步骤修改相机 IP 地址。

前提条件

设置静态 IP 地址前，请确保上位机 IP 地址在目标网段上。
若当前相机已与软件连接，需要先断开连接再设置 IP。

操作步骤

在 相机列表 页面点击，刷新相机列表。
点击目标相机的序列号选中相机。
点击 修改IP，弹出 修改IP 对话框。

修改IP 对话框
设置相机IP。

设置为静态IP
1. 选择 “静态IP”。
2. 根据界面提示设置 “IP地址”、“子网掩码” 和 “网关”。
设置为动态IP
1. 选择 “DHCP”。
点击 确定。

弹出以下提示对话框，表示 IP 设置成功。

IP设置成功

连接/断开相机

在相机列表中，双击相机列表行或点击，即可连接相机。

注解

若相机序列号后无图标，则表示当前相机不可连接。请点击相机序列号，根据相机详细信息中的状态，排查无法连接的原因。

连接相机后自动跳转至 相机页面。点击页面上方的，可断开连接。

也可切换回 相机列表 页面，点击相机序列号后的断开相机连接。

设置采图模式并开始采图

软件支持如下几种采图模式：

在该模式下，软件将以系统允许的最高帧率连续输出已使能的数据流。

在 工作模式 页面的 数据流 区域，使能相应数据流，如“深度”与“彩色”。

启用数据流
选择 采图模式 为“最大帧率连续”。

设置采图模式为最大帧率连续
点击图像采集区的开始采集图像。然后点击和，即可开启/关闭彩色和深度视图。

开始采集图像
在彩色和深度视图下方，可查看当前的出图帧率。

查看出图帧率

查看数据

切换视图

点击图像采集区的视图显示按钮，可查看对应视图。最多支持同时显示两个视图。

开启彩色数据流，点击，再点击图像采集区上方的，可查看彩色图。再点击一次，可关闭彩色图视图。

查看深度值

显示深度视图时，可查看单个像素点的深度值。

具体操作如下 ：将鼠标放置于深度图上，即可查看鼠标所处像素点对应的像素坐标与实际深度值（单位：mm）。

调节深度图渲染效果

切换渲染配色

开启深度图显示时,可点击图像采集区右侧的调出深度图渲染区域，在“配色”选项中切换不同配色。

软件目前支持以下几种渲染配色：Rainbow，Autumn，Turbo。选择不同的配色时，渲染效果不同。

调节渲染范围

深度图支持动态渲染范围调整，开启深度图显示时，可点击图像采集区右侧的调出深度图渲染区域。

深度值位于最小值 Min 和最大值 Max 之间时，色彩梯度均匀分布；深度值小于最小值的像素显示为红色，深度值大于最大值的像素显示为紫色。通过优化目标深度区间的色彩映射，可增强深度细节的辨识度。

具体调节方法如下：

勾选“自动范围”时，系统会根据深度图的统计结果，自动确定渲染所用的最大最小值。
当“自动范围”未勾选时，可通过上下滑块调节渲染深度上下限，或通过输入框设置上下限值。

调节示例：

当目标物体集中分布在 1100-1450 mm 区间时：

使用默认渲染范围（0-5000 mm）：色彩梯度平缓，细节难以区分。
缩小范围至 1100-1450 mm 间：如下图所示，色彩对比鲜明，可清晰辨识物体的深度差异。

调节渲染范围后

调整点云视图

显示点云视图时，可进行如下操作：

缩放点云：将鼠标置于点云视图，滚动鼠标滚轮。
旋转点云：按住鼠标左键并拖动。
平移点云：按住鼠标右键并拖动。
复位点云：按键盘“R”键或点击点云视图右下角的图标，可使点云恢复至初始位置。

保存数据

Percipio Viewer支持按照设定的存储数量与容量限制保存图像数据到本地，可同时存储彩色图、深度图、左图、右图以及点云数据。

操作步骤

开启待保存数据对应的数据流。
点击，弹出 图片保存设置 对话框。

图片保存设置对话框
在“保存路径”栏输入文件夹路径或点击选择存图文件夹，然后点击 确定。若输入的路径不存在，系统将自动创建该文件夹。

若无提示信息，表示路径设置成功。图片将以 “类型_日期-时间戳” 的命名方式保存至目标路径。
设置连续存储数量，即存图帧数。
设置所选文件夹的存储容量限制。设置为0时，表示不限制。

注解

软件的连续存图功能受两项限制：连续存储数量与存储容量上限。当任一条件先达到其设定值时，存图将立即停止。

勾选所需的存储对象，支持选择单个或多个。

存储对象选项与存储数据 的对应关系如下：

勾选的存储对象	存储数据
存储 RGB 图	彩色图（PNG）、彩色组件内外参及畸变矩阵（TXT）
存储深度图	原始深度图（PNG）、渲染过的深度图（PNG）、深度组件内外参及畸变矩阵（TXT）
存储 IR 图	左图（PNG）、右图（PNG），左图组件内外参及畸变系数矩阵（TXT）、右图组件内外参及畸变矩阵（TXT）
存储点云	点云（PLY 或 PCD）、深度组件内外参及畸变系数矩阵（TXT）

注解

点云格式说明：

该款软件支持将点云保存为 PLY 格式或 PCD 格式，用户可根据后续点云处理所需要的格式自行选择。

PLY：二进制格式，存储点云每个点的空间坐标`x, y, z`、颜色`r, g, b`等信息。
PCD：二进制格式，专为点云库 (Point Cloud Library, PCL) 设计的高效格式。

点击 确定 。
点击，相机开始采图（也可在相机开始采图后再配置图片保存设置）。再点击，该按钮将高亮，表示存图进行中。若该按钮高亮状态消失，则表示存图结束。

管理参数集

参数集（用户配置）可保存用于不同场景下的参数设置。场景发生变化时，加载对应的参数集即可快速完成参数调整。

查看当前参数集

进入 相机页面 后，即可在 当前参数集 区域查看如下信息：“名称” 显示当前生效的参数集；“说明” 则是对软件该参数集的描述。

如下图所示，当前参数集的名称为 “0.Standard Accuracy”，说明为“高精度模式”。

保存参数集到相机

保存参数集前，确保相机处于停止采图状态。

操作步骤如下：

针对某一场景，调节相机参数。
进入 相机页面，点击 当前参数集 区域的 保存到相机 按钮。

保存参数集
在弹出的 保存参数集 对话框中，选择一个用户集（用户配置），并根据需要在“详情”中输入信息。最终保存的用户集名称将由“序号+详情”组合而成。

注解

若“详情”字段留空，软件将自动使用默认名称”Default description”作为该用户集的详情。

保存参数集
点击 确定 。

保存参数集到本地

保存参数集前，确保相机处于停止采图状态。

操作步骤如下：

针对某一场景，调节相机参数。
进入 相机页面，点击 当前参数集 区域的 导出到文件 按钮。

导出到文件
在弹出的 保存参数集 对话框中，点击选择目标文件夹，并设置文件名。

保存参数集对话框
点击 确定 。

从相机加载参数集

加载参数集前，确保相机处于停止采图状态。

操作步骤如下：

进入 相机页面 ，点击 当前参数集 区域的 从相机加载 按钮。

从相机加载
在弹出的 加载参数集 对话框中，选择目标参数集。

加载参数集
点击 确定。

设置完成后，当前参数集更新显示，相机参数同步更新数值。

当前参数集更新

从本地加载参数集

加载参数集前，确保相机处于停止采图状态。

操作步骤如下：

进入 相机页面 ，点击 当前参数集 区域的 从文件导入 按钮。

从文件导入
在弹出的 加载参数集 对话框中，点击选择目标 json 文件。

加载参数集
点击 确定。

设置完成后，相机参数同步更新数值。

设置上电参数集

Percipio Viewer 支持设置相机上电后自动加载的参数集。

设置上电参数集前，确保相机处于停止采图状态。

进入 相机页面，在 上电参数集 区域可查看当前的上电参数集。

加载参数集
点击 更换 按钮。在弹出的 更换启动配置 对话框中，选择需更换的参数集并点击 确定。

更换启动配置

更换参数集后，上电参数集名称会自动更新显示。
相机断电重启后，用 Viewer 打开相机，“当前参数集” 更新为设定的上电参数集，相机参数同步更新数值。

当前参数集更新