# Apriltag

**Repository Path**: openwcs/apriltag

## Basic Information

- **Project Name**: Apriltag
- **Description**: AGV 定位识别：Apriltag
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-30
- **Last Updated**: 2025-07-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎯 AprilTag 识别工具

一个基于PyQt5开发的炫酷AprilTag识别工具，支持摄像头实时识别和图片文件识别。


![预览](images/01.gif)
![预览](images/02.jpg)


## ✨ 特性

- 🎨 **炫酷界面**: 现代化深色主题，梯度按钮和动画效果
- 📹 **实时识别**: 支持摄像头实时AprilTag检测
- 🖼️ **图片识别**: 支持加载图片文件进行识别
- 📊 **详细结果**: 显示标签ID、位置坐标和置信度
- ⚙️ **参数调节**: 可调节检测参数和标签族
- 📸 **截图保存**: 一键保存检测结果截图
- 📈 **实时状态**: 显示FPS、分辨率等系统信息

## 🔧 安装

### 1. 克隆项目

```bash
git clone https://gitee.com/openwcs/apriltag.git
cd UApriltag
```

### 2. 安装依赖

```bash
pip install -r requirements.txt
```

### 3. 运行程序

```bash
python main.py
```

## 📋 依赖库

- **PyQt5**: GUI界面框架
- **OpenCV**: 计算机视觉库
- **pupil-apriltags**: AprilTag检测库
- **NumPy**: 数值计算库
- **Pillow**: 图像处理库

## 🎮 使用说明

### 界面布局

- **左侧控制面板**: 包含所有控制功能
- **右侧显示区域**: 显示实时图像和检测结果

### 功能说明

#### 📥 输入源选择
- **启动摄像头**: 开启/关闭摄像头实时检测
- **选择图片**: 加载本地图片文件进行检测
- **保存截图**: 保存当前检测结果到文件

#### ⚙️ 检测参数
- **检测阈值**: 调节检测灵敏度（1-100）
- **标签族**: 选择不同的AprilTag类型
  - tag36h11 (推荐)
  - tag25h9
  - tag16h5
  - tagCircle21h7
  - tagStandard41h12

#### 📊 检测结果
- 表格显示所有检测到的标签信息
- 包含标签ID、中心坐标和置信度
- 实时更新检测计数

#### 📈 系统状态
- **FPS**: 实时帧率显示
- **分辨率**: 当前图像分辨率
- **时间**: 最后更新时间

### 检测结果显示

- 🟢 **绿色边框**: 标签检测边界
- 🔴 **红色圆点**: 标签中心点
- 🟡 **黄色文字**: 标签ID
- ⚪ **白色文字**: 置信度数值

## 🎨 界面特色

- **深色主题**: 护眼的深色配色方案
- **渐变按钮**: 炫酷的按钮渐变效果
- **实时状态**: 动态更新的状态信息
- **响应式布局**: 自适应窗口大小调整
- **表情符号**: 友好的图标和表情符号

## 📁 文件结构

```
UApriltag/
├── main.py              # 主程序文件
├── requirements.txt     # 依赖库列表
├── README.md           # 项目说明文档
└── apriltag_screenshot_*.jpg  # 保存的截图文件
```

## 🔍 支持的图片格式

- JPEG (.jpg, .jpeg)
- PNG (.png)
- BMP (.bmp)
- TIFF (.tiff)

## ⚠️ 注意事项

1. **摄像头权限**: 确保程序有摄像头访问权限
2. **依赖库版本**: 建议使用推荐的库版本
3. **标签质量**: 标签打印质量影响检测效果
4. **光照条件**: 良好的光照条件有助于提高检测精度

## 🐛 故障排除

### 摄像头无法打开
- 检查摄像头是否被其他程序占用
- 确认摄像头驱动是否正常
- 尝试更换摄像头索引（修改代码中的0为1或2）

### 检测效果不佳
- 调整检测阈值
- 更换标签族类型
- 改善光照条件
- 确保标签清晰完整

### 依赖库安装失败
- 更新pip: `pip install --upgrade pip`
- 使用国内镜像: `pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt`

## 📄 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

## 🤝 贡献

欢迎提交问题报告和功能请求！

---

**开发者**: UKIOT Team  
**版本**: 1.0  
**更新时间**: 2025年