Python（Linux）

示例程序简介

Python 示例程序位于 VcameraSDK-X.X.X/python/samples，包含：

DepthTextureRegistration.py：设置相机工作在软触发模式，将输出的深度图与彩色图对齐。
DepthToPointCloud.py：设置相机工作在连续采集模式下，将深度图实时转换为点云数据。
FetchFrame.py：设置相机工作在连续采集模式下采集深度图。
ListDevices.py：列举所有连接到电脑上的相机。
SoftTrigger.py：设置相机工作在软触发模式，发送软触发指令后，相机采集深度图。
GetVersion.py：显示当前 SDK 的版本。
DumpAllFeatures.py：列举相机支持的全部属性。
DumpDeviceInfo.py：列举相机的信息。
ReadWriteFeatures.py：示范如何获取相机属性的类型、名称、取值及范围，以及如何设值。
SetIpAddress.py：设置静态 IP 地址。
UserSetSelector.py：选择用户配置。
LogConfig.py：配置 Vcamera SDK 软件日志系统。
SaveFeaturesToStorage.py：将参数配置保存到设备存储 Storage 区，但仅适用于不支持用户集（userset）的相机。
LoadFeaturesFromStorage.py：从 Storage 区中加载参数配置并应用到相机，仅适用于不支持用户集（userset）的相机。
SaveFeaturesToFile.py：将修改后的参数配置保存到指定 JSON 文件。
LoadFeaturesFromFile.py：从指定 JSON 文件加载相机参数配置并应用到相机。

构建 Wheel 包

注意

请勿更改 VcameraSDK-X.X.X/python 目录与 VcameraSDK-X.X.X/cpp 目录的相对位置。

在 VcameraSDK-X.X.X/python 目录下打开终端，依次执行以下步骤：

运行构建脚本
```
python build_wheel.py
```
根据网络速度判断

若网速 ≥ 200 KB/s：脚本将直接完成构建，无需额外操作。

若网速 < 200 KB/s：脚本会询问是否配置国内镜像源，输入 Y 确认，然后根据提示选择镜像源（如输入 1 选择阿里云）。
配置完成后，重新运行脚本即可完成构建。
```
python build_wheel.py
```
构建完成后，Wheel 包位于 VcameraSDK-X.X.X/python/dist 目录。

安装 Wheel 包

在 VcameraSDK-X.X.X/python/dist 目录下，找到构建好的 Wheel 包。
打开终端并进入该目录，执行以下命令安装 Wheel 包：
```
pip install <wheel_file_name>.whl
```
例如：
```
pip install vcamera_python-26.1.5-cp38-cp38-linux_x86_64.whl
```
注解

如果在终端中看到类似如下输出：

vcamera-python is already installed with the same version as the provided wheel. Use –force-reinstall to force an installation of the wheel.

则表示系统中已安装相同版本的 Wheel 包，无需重复安装。若需要强制重装，请在上述命令中添加 --force-reinstall 参数：
```
pip install --force-reinstall <wheel_file_name>.whl
```

验证安装是否成功

在终端中输入以下命令验证安装是否成功：

python -c "import vcamera as vcam; print(vcam.GetVersionString())"

运行示例程序

安装完成后，在 VcameraSDK-X.X.X/python/samples 目录下打开终端，运行示例程序：

python samples/ListDevices.py
python samples/FetchFrame.py

卸载

pip uninstall vcamera-python