zxing-cpp

zxing-cpp is a Rust wrapper for the C++ library zxing-cpp.

It is an open-source, multi-format linear/matrix barcode image processing library implemented in C++. It was originally ported from the Java ZXing Library but has been developed further and now includes many improvements in terms of runtime and detection performance.

Usage

In your Cargo.toml:

[dependencies]
# `bundled` causes cargo to compile and statically link in an up to
# date version of the c++ core library. This is the most convient
# and safe way to build the library.
zxing-cpp = { version = "0.2.1", features = ["bundled", "image"] }

Simple example usage:

use zxing_cpp::{ImageView, ReaderOptions, BarcodeFormat, read_barcodes};

fn main() -> anyhow::Result<()> {
	let image = image::open("some-image-file.jpg")?;
	let iv = ImageView::try_from(&image)?;
	let opts = ReaderOptions::new()
		.formats(BarcodeFormat::QRCode | BarcodeFormat::LinearCodes)
		.try_invert(false);

	let results = read_barcodes(&iv, &opts)?;

	if results.is_empty() {
		println!("No barcode found.");
	} else {
		for result in results {
			println!("{}: {}", result.format(), result.text());
		}
	}

	Ok(())
}

Note: This should currently be considered a pre-release. The API may change slightly to be even more "rusty" depending on community feedback.

Optional Features

zxing-cpp provides features that are behind Cargo features. They are:

• bundled uses a bundled version of the zxing-cpp c++ library.
• image allows convenient ImageView::from(&GreyImage) conversion.