大华 sdk 坐标

### 大华SDK坐标处理API解析

大华SDK提供了丰富的接口用于处理PTZ（Pan-Tilt-Zoom）控制和其他坐标相关的操作。这些接口允许开发者精确地调整摄像机的角度和缩放级别，从而更好地满足监控需求。

#### PTZ 控制函数
为了实现对摄像机角度的精准控制，通常会使用`HCNetSDK.dll`中的相关函数来发送命令给DVR/NVR设备。具体来说：

- `CLIENT_ControlDevice_PTZ` 函数可用于执行具体的PTZ动作[^2]。

LONG CLIENT_ControlDevice_PTZ(
    LONG lUserID,          // 用户ID
    DWORD dwChannelID,     // 通道号
    int nCommand,          // 命令编号
    BYTE bySpeed           // 移动速度 (0~8)
);

此函数通过参数`nCommand`指定想要执行的具体PTZ指令，例如向上移动、向下移动等；而`bySpeed`则决定了运动的速度等级。

#### 获取当前PTZ位置
有时需要知道当前摄像机的确切方位角和俯仰角，在这种情况下可以调用如下API:

- `NET_DVR_GetDevConfig` 结合配置项`NET_DVR_PTZPOS_CONFIG_V40` 可以查询到当前位置信息.

BOOL NET_DVR_GetDevConfig(
    LONG lUserID,
    DWORD dwWaitTime,
    LPDWORD lpReturnedSize,
    void* pOutBuffer
);

这里需要注意的是返回的数据结构体包含了多个字段描述了不同类型的坐标系下的数值，如水平方向的角度(`fPanAngle`) 和垂直方向的角度 (`fTiltAngle`) 等。

#### 设置预置位
除了实时操控外，还可以预先设定若干个特定视角作为“预置位”，之后只需简单触发就能快速回到那些保存好的视图中去。

- 使用`NET_DVR_SetPresetV30` 来创建新的预置点并赋予名称；
- 利用`NET_DVR_GotoPresetV30` 实现一键切换至选定的位置。

以上便是关于如何利用大华SDK来进行坐标处理的一些基础介绍以及常用的方法示例。