# PointCloudCamera

**Repository Path**: YDoIt/point-cloud-camera

## Basic Information

- **Project Name**: PointCloudCamera
- **Description**: 点云相机控制接口库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-06-22
- **Last Updated**: 2025-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PointCloudCamera

## 1.接口声明

### 1.1 连接相机

```cpp
int Connect(const char* config_path);
```

- 函数参数：
  - `config_path`: 传入参数，表示 JSON 配置文件路径
- 返回值：连接成功返回0，否则表示连接失败，具体见【错误码】部分。

> 相机使用完成后，务必调用 Close() 接口关闭相机，防止内存泄漏。

### 1.2 拍取点云数据

```cpp
int CapturePointCloud(const char* output_path);
```

- 函数参数：
  - `output_path`: 传入参数，表示要输出的点云文件的名称
- 返回值：拍照成功返回0，否则表示拍照识别，具体见【错误码】部分。

### 1.3 关闭相机

```cpp
void Close();
```

## 2.错误码

| 错误码 | 错误说明         |
| ------ | ---------------- |
| 0      | 无错误           |
| 1      | 配置文件不存在   |
| 2      | 配置文件无效     |
| 3      | 日志初始化失败   |
| 4      | 相机参数设置失败 |
| 5      | 相机连接失败     |
| 6      | 点云范围设置失败 |
| 7      | 相机增益设置失败 |
| 8      | 相机未连接       |
| 9      | 相机扫描失败     |
| 10     | 打光图像生成失败 |

## 3.目录说明

```text
├─3rdparty								# 第三方库目录，即点云相机所需要的第三方库
│  ├─include							# 第三方库头文件目录
│  └─lib									# 第三方库库文件目录
├─CameraController				# 封装库项目目录
├─CameraControllerTest		# 封装库测试项目目录
├─CSharpExample						# C#程序加载示例项目目录
└─Dependency							# 依赖项文件夹
   ├─config.json					# 连接相机时需要加载的 JSON 配置文件
   ├─log.conf							# 连接相机时所需要的日志配置文件
   ├─left.cam							# 连接相机所需要的左侧镜头配置文件
   ├─right.cam						# 连接相机所需要的右侧镜头配置文件
   ├─*.dll								# 其余相机内部所需要的第三方库
   └─CameraControllerd.dll	# Debug模式下生成的相机接口封装库
```

> 由于点云相机所提供的第三方库本身存在问题，所以目前该库只能使用 Debug 版本，使用 Release 版本会存在诸多的接口问题。