【讲解+样例】使用opencv对aruco Markers识别

news2024/11/16 8:45:37

aruco标记与传统棋盘格功能相似，但是更快更便捷。棋盘格使用移步：【鱼眼＋普通相机】相机标定

一、 aruco简介

aruco又称为aruco标记、aruco标签、aruco二维码。ArUco 标记通常是正方形的黑白图案。由黑色边框和内部的二进制矩阵组成。内部矩阵编码了一个唯一的 ID。
它有不同大小的 Aruco 标记，如 4x4, 5x5, 6x6, 7x7 等，指的是内部矩阵的尺寸。aruco二维码生成网站：https://chev.me/arucogen/
在这里插入图片描述

不同的字典定义了不同的标记集，如 DICT_6X6_250 表示 6x6 大小的 250 个唯一标记。
在这里插入图片描述

1.1 aruco码具有以下优点：

快速检测：设计允许快速、可靠的检测。
唯一识别：每个标记都有唯一的 ID。
姿态估计：可以用于计算相机相对于标记的位置和方向。
抗干扰：设计考虑了抗干扰性，如旋转、部分遮挡等。应用：

1.2 aruco码可以实现以下功能：

增强现实（AR）：作为参考点来放置虚拟对象。
机器人导航：帮助机器人定位和导航。
相机校准：用于相机参数的快速校准。
物体跟踪：在视频中跟踪物体的移动。

1.3 aruco码检测过程：

图像预处理（如灰度转换、阈值化）→ 轮廓检测 → 多边形近似（找到方形候选区域) → 透视变换 → 内部矩阵解码

二、样例

1.代码

import cv2
import numpy as np

print(cv2.__version__)

# 从文件读取图像
image = cv2.imread('./markers.jpg')
gray = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)

# 指定字典类型
dict_type = cv2.aruco.DICT_6X6_1000

# 加载预定义字典
dictionary = cv2.aruco.getPredefinedDictionary(dict_type)

# 创建Aruco参数
aruco_params = cv2.aruco.DetectorParameters()
aruco_params.adaptiveThreshWinSizeMin = 3  #
aruco_params.adaptiveThreshWinSizeMax = 80  #
aruco_params.adaptiveThreshWinSizeStep = 10  # 代表自适应阈值的窗口大小
aruco_params.adaptiveThreshConstant = 7  # 代表自适应阈值的常数
aruco_params.minMarkerPerimeterRate = 0.1  # 假设marker至少占图像的10%
aruco_params.maxMarkerPerimeterRate = 10.0  # 允许marker最大占图像的80%
aruco_params.polygonalApproxAccuracyRate = 0.1  # 代表多边形逼近的精度
aruco_params.minCornerDistanceRate = 0.05  # 代表marker的最小角距离
aruco_params.minDistanceToBorder = 0  # 代表marker的最小边界距离

# 创建Aruco检测器
detector = cv2.aruco.ArucoDetector(dictionary, aruco_params)

# 检测Aruco markers
corners, ids, rejected = detector.detectMarkers(gray)
print(f"Adaptive Threshold - Detected: {len(corners)}, Rejected: {len(rejected)}")

rej_img = image.copy()
for r in rejected:
    try:
        pts = r.reshape((-1, 1, 2)).astype(np.int32)
        cv2.polylines(rej_img, [pts], True, (0, 0, 255), 2)
    except Exception as e:
        print(f"Error drawing rejected candidate: {e}")

# 如果检测到markers，绘制它们
if ids is not None:
    print(f"Detected Aruco markers: {ids}")
    cv2.aruco.drawDetectedMarkers(image, corners, ids)

    # 遍历每个检测到的marker
    for i in range(len(ids)):
        c = corners[i][0]
        cv2.putText(image, f"id: {ids[i][0]}", (int(c[0][0]), int(c[0][1]) - 15),
                    cv2.FONT_HERSHEY_SIMPLEX, 0.5, (0, 255, 0), 2)

        # 绘制marker的边界框
        cv2.polylines(image, [np.int32(c)], True, (0, 255, 0), 2)

        # 计算marker的中心
        cx = int((c[0][0] + c[2][0]) / 2)
        cy = int((c[0][1] + c[2][1]) / 2)
        cv2.circle(image, (cx, cy), 2, (0, 0, 255), -1)

        # 计算marker的方向
        cv2.line(image, (cx, cy), (int(c[0][0]), int(c[0][1])), (255, 0, 0), 2)
        cv2.line(image, (cx, cy), (int(c[1][0]), int(c[1][1])), (0, 255, 0), 2)

        # 计算marker的旋转角度
        dx = c[0][0] - c[1][0]
        dy = c[0][1] - c[1][1]
        angle = np.arctan2(dy, dx)
        angle = np.degrees(angle)
        cv2.putText(image, f"angle: {angle:.1f}", (cx, cy + 15),
                    cv2.FONT_HERSHEY_SIMPLEX, 0.5, (0, 255, 0), 2)
        # 计算marker的尺寸
        size = np.sqrt(dx * dx + dy * dy)
        cv2.putText(image, f"size: {size:.1f}", (cx, cy + 30),
                    cv2.FONT_HERSHEY_SIMPLEX, 0.5, (0, 255, 0), 2)

        # 计算marker的坐标
        cv2.putText(image, f"({cx},{cy})", (cx, cy + 45),
                    cv2.FONT_HERSHEY_SIMPLEX, 0.5, (0, 255, 0), 2)

# 显示结果
cv2.imshow('gray', gray)
cv2.imshow('Image with rejected candidates', rej_img)
cv2.imshow("Aruco markers", image)
cv2.waitKey(0)
cv2.destroyAllWindows()