什么是 Pywayne AprilTag 检测器？

Pywayne AprilTag 检测器是一款专门用于高精度识别和跟踪 AprilTag 基准标记的计算机视觉工具。作为 Openclaw Skills 生态系统中的一个稳健组件，它为开发者提供了一个流线型接口，用于从图像中提取空间数据，包括标记 ID、中心点和角点坐标。

该技能对于从事相机标定、增强现实或机器人技术的研发人员和工程师特别有价值。通过自动化检测过程并通过集成工具处理依赖管理，它使用户能够专注于高层逻辑，而不是底层图像处理的实现。

下载入口:https://github.com/openclaw/skills/tree/main/skills/wangyendt/apriltag-detector

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Pywayne AprilTag 检测器 应用场景

• 使用 AprilTag 网格进行高精度相机标定。
• 为自主机器人提供实时位姿估计和定位。
• 在工业自动化环境中进行物体跟踪和识别。
• 通过视觉标记叠加实现自动化图像标注和调试。

1. 该技能初始化 ApriltagCornerDetector 并检查必要的二进制库。
2. 它处理以本地文件路径或预加载的 numpy 数组形式提供的输入图像。
3. 检测器执行内部灰度转换以优化标记扫描过程。
4. 它识别 AprilTag 36h11 标记并计算元数据，包括汉明距离和精确的像素角点。
5. 结果以结构化的检测对象列表形式返回，或直接渲染到源图像上进行可视化。

Pywayne AprilTag 检测器 配置指南

要使用此技能，请确保已安装核心 Python 依赖项。该模块将自动尝试使用 gettool 获取底层的检测库。

pip install opencv-python numpy gettool

安装完成后，您可以在脚本中初始化检测器：

from pywayne.cv.apriltag_detector import ApriltagCornerDetector
detector = ApriltagCornerDetector()

Pywayne AprilTag 检测器 数据架构与分类体系

该技能返回检测结果列表。列表中的每个条目遵循以下架构：

name: pywayne-cv-apriltag-detector
description: AprilTag corner detection for camera calibration and pose estimation. Use when working with pywayne.cv.apriltag_detector module to detect AprilTag fiducial markers in images, with automatic library installation via gettool, drawing detection results with corners and IDs, and support for both file paths and numpy arrays.

Pywayne AprilTag Detector

This module detects AprilTag fiducial markers for camera calibration and pose estimation.

Quick Start

from pywayne.cv.apriltag_detector import ApriltagCornerDetector

# Create detector
detector = ApriltagCornerDetector()

# Detect from file path
detections = detector.detect('test.png', show_result=True)

# Detect from numpy array
import cv2
image = cv2.imread('test.png')
detections = detector.detect(image)

Detection Methods

detect()

Detect AprilTags in an image:

detections = detector.detect(
    image,           # File path, Path object, or numpy array
    show_result=False  # Show visualization window
)

Returns list of detection results with:

• id: Tag ID
• hamming_distance: Detection confidence
• center: Tag center coordinates (x, y)
• corners: 4 corner coordinates

detect_and_draw()

Detect AprilTags and draw results on original image:

result_image = detector.detect_and_draw(image)
cv2.imshow('Detection Result', result_image)
cv2.waitKey(0)

Visualization includes:

• Green polygon outlines
• Red corner circles
• Red ID labels at tag centers

Requirements

• cv2 (OpenCV) - Image processing
• numpy - Array operations
• gettool - Downloads apriltag_detection library automatically

Library Installation

The detector automatically checks for and installs the apriltag_detection library using gettool if not found.

Detection Result Format

Each detection contains:

Notes

• Supports both grayscale and BGR images
• Automatic grayscale conversion for detection
• Visualization sizes scale with image dimensions
• Uses AprilTag 36h11 tag family