# wrapper.dll — SDK C 接口封装

## 这是什么

将结构光双目 3D 扫描 SDK 封装为 5 个简洁的 C 函数，供 Python ctypes 调用。

**SDK 架构（2026-05-18 从 DLL 导出表确认）：**

| DLL | 作用 |
|-----|------|
| `ICDevice.dll` | 🛡️ 加密狗 (IC_Start/Stop/Get/Set) |
| `xhcv2011.dll` | 📷 相机硬件 (InitUseCam2011) |
| `OpenNI2.dll` | 🔄 标准 OpenNI 2.x 采集 (oni*) |
| `TwoEyeApi.dll` | 🧮 3D 重建 (ComputeAndSaveWorld) |
| `HandScanDll.dll` | 🚀 GPU KinFu 管线 (PCL + CUDA) |

## 程序员的最小工作量

函数名已全部从 DLL 导出表确认，**不需要你提供函数名**。

你只需要在**有相机和加密狗的 Windows 机器上**回答几个运行时问题：

### 必须回答的问题

| # | 问题 | 在哪 |
|---|------|------|
| 1 | `InitUseCam2011()` 需要参数吗？ | wrapper_camera_init |
| 2 | 相机的 URI 是什么？ | oniDeviceOpen 的参数 |
| 3 | 深度流的 sensor_type 是几？ | ONI_SENSOR_DEPTH=1? IR=2? |
| 4 | 双目左右图怎样从 OpenNI2 拿到？ | 两个流还是一个帧里带两份？ |

### 步骤

1. 在 Windows 上打开 "Developer Command Prompt for VS 2022"
2. `cd wrapper\`
3. `build.bat`
4. 把 `Release\wrapper.dll` 复制到 SDK bin 目录（和所有 DLL 放一起）
5. **插上相机 + 加密狗，跑 Xhk_demo.exe 确认硬件正常**
6. 告诉我们需要修正的接口参数

预计工作量：**30-60 分钟**（主要是编译和测试环境搭建）

## 编译

```
cd wrapper\
build.bat
```

输出: `Release\wrapper.dll` (~25KB)
