krilla-rxing 0.1.1

Render barcodes (QR Codes, Aztec, Data Matrix, etc) using rxing into a krilla Surface (PDF)
Documentation
  • Coverage
  • 80%
    12 out of 15 items documented1 out of 14 items with examples
  • Size
  • Source code size: 60.66 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 866.58 kB This is the summed size of all files generated by rustdoc for all configured targets
  • Ø build duration
  • this release: 55s Average build duration of successful builds.
  • all releases: 1m 4s Average build duration of successful builds in releases after 2024-10-23.
  • Links
  • Repository
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • msrd0

krilla-rxing License: EUPL-1.2 krilla-rxing on crates.io krilla-rxing on docs.rs Source Code Repository

krilla-rxing extends the PDF creation library krilla with support for drawing barcodes based on the rxing library. This library aims to make barcode creation easy while optimising the PDF strokes s.t. the output file is as small as possible.

CLI

If all you need is a tool that creates a PDF for you, take a look at qrcode2pdf. Contrary to the name of the crate, it comes with a tool for all barcode formats supported by this library.

To create a PDF containing a QR Code, you can run

qrcode2pdf -o barcode.pdf https://codeberg.org/msrd0/krilla-rxing/src/branch/main/cli

Library

If you want to embed barcodes into your existing PDF-writing code, there are two APIs you can use. The simplest way is to call draw_qr_code on krilla’s Surface:

use krilla_rxing::SurfaceExt as _;

const PDF_UNITS_PER_MM: f32 = 72.0 / 25.4;

// draw a 10 x 10 cm QR Code at the top left of the surface
surface
	.draw_qr_code(
		"https://codeberg.org/msrd0/krilla-rxing",
		Point::from_xy(0.0, 0.0),
		100.0 * PDF_UNITS_PER_MM
	)
	.expect("Failed to draw QR Code");

Some other barcode are not necessarily square, and you might want to know the height of the barcode. In these cases, you need to create the barcode and then draw it using the draw_barcode function:

use krilla_rxing::{Barcode, SurfaceExt as _};

const PDF_UNITS_PER_MM: f32 = 72.0 / 25.4;

// draw a 10 x 10 cm PDF417 barcode at the top left of the surface
let barcode_width = 100.0 * PDF_UNITS_PER_MM;
let barcode =
	Barcode::new_pdf417("https://codeberg.org/msrd0/krilla-rxing", barcode_width)
		.expect("Failed to create PDF417 barcode");
let barcode_height = barcode.height();
surface.draw_barcode(&barcode, Point::from_xy(0.0, 0.0));