# hkCamera

**Repository Path**: blackcc/hk-camera

## Basic Information

- **Project Name**: hkCamera
- **Description**: 用于测试用工业相机演示
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-26
- **Last Updated**: 2025-11-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 海康威视相机控制软件

这是一个基于Qt的应用程序，用于控制海康威视相机。它提供了一个简单的图形用户界面来扫描、打开、关闭相机，并开始或停止图像采集。

## 特性

- 扫描连接的相机设备
- 打开和关闭选定的相机设备
- 开始和停止图像采集
- 实时显示采集到的图像帧
- 工业客户端简单示例（左侧“工业控制”面板按钮）

## 使用的技术

- C++
- Qt 框架
- 海康威视相机 SDK（MV_CC）

## 项目结构

```
hk-camera/
├── src/                 # C++ 源文件
├── include/             # 头文件
├── ui/                  # Qt Designer 生成的 .ui 布局文件
├── resources/           # Qt 资源集合以及静态资源
│   └── assets/          # 图标、样式表等静态资源
├── industrial_robot_system_client/   # 工业机器人 DDS 客户端模块（含 CommandClient 及生成代码）
├── translations/        # 多语言翻译文件
├── docs/                # 额外文档（如英文 README）
├── scripts/             # 常用开发脚本（如 IDL 代码生成）
├── hkCamera.pro         # qmake 工程文件
└── README.md            # 中文说明
```

### 工业机器人 DDS 客户端

该模块提供了面向步进电机、伺服电机与多路 IO 的 Cyclone DDS 控制客户端，核心类位于 `industrial_robot_system_client/CommandClient/`。

- IDL 转换后的 C 代码位于 `industrial_robot_system_client/generated/`。
- 若修改了 `industrial_robot_system_client/idl/*.idl`，请运行：

```bash
./scripts/generate_idl.sh
```

脚本将调用 `idlc` 重新生成 C 绑定文件。

## 安装

确保你已经安装了以下依赖项：

- Qt 开发环境（建议使用 Qt Creator）
- 海康威视相机 SDK

然后克隆仓库并使用 Qt Creator 打开项目文件 `hkCamera.pro`，构建并运行项目。

## 使用方法

1. 启动应用程序。
2. 点击 "扫描" 按钮来查找连接的相机设备。
3. 从列表中选择一个设备，点击 "打开" 按钮来打开相机。
4. 点击 "开始采集" 按钮来开始获取图像帧。
5. 点击 "停止采集" 按钮来停止获取图像帧。
6. 点击 "关闭" 按钮来关闭相机。

## 主要功能说明

- `on_btnEnum_clicked()`：扫描连接的相机设备并更新设备列表。
- `on_btnOpen_clicked()`：打开选定的相机设备。
- `on_btnClose_clicked()`：关闭当前打开的相机设备。
- `startGrabbing()` / `stopGrabbing()`：开始或停止图像采集。
- `onFrameTimer()`：定时器事件处理函数，用于获取并显示图像帧。

## 贡献

欢迎贡献代码和报告问题。请提交 Pull Request 或在项目的问题跟踪系统中报告问题。

## 许可证

该项目使用 MIT 许可证。详情请查看项目中的 LICENSE 文件。