apriltag-rust

High-level API for AprilTag library built on top of apriltag-sys.

Usage

Follow the install instructions on official repository to install AprilTag library.

Import apriltag-sys dependency in your Cargo.toml

[dependencies]
apriltag = "0.3"

The feature flags control the supported conversions from/to third-party types. It includes

full: Enable most available features.
nalgebra: Get type conversions from/to two dimensional byte matrix from nalgebra crate.
image: Get type conversions from/to image types from image crate.

If you would like to customize the way to link the AprilTag library, please read the notes in apriltag-sys README.

To run detection on an image, run

cargo run --features full --example detector -- input.jpg

It accepts additional arguments:

--family tag36h11 specifies the tag36h11 tag family
--tag-params 1,2.1,2.2,4,5 sets the tag size, fx, fy, cx and cy parameters. It enable pose estimation feature.

cargo run --features full --example detector -- \
    --family tag36h11 \
    --tag-params 1,2.1,2.2,4,5 \
    input.jpg

The demo implementation can be found in examples directory.

BSD 2-Clause License. See LICENSE file.