Barcodes

Namespace MiPdf.Barcodes. All barcodes are drawn as vector graphics (one filled path), so they stay sharp in print.

Class Symbology Notes
QrCode QR Code model 2, versions 1–40, levels L/M/Q/H numeric/alphanumeric/byte (UTF-8) mode chosen automatically, optional UTF-8 ECI
EpcQrCode EPC QR ("GiroCode", "Zahlen mit Code") SEPA credit transfer payload per EPC069-12
DataMatrix Data Matrix ECC 200, square and rectangular ASCII (digit pairs) / Base 256, GS1 Data Matrix via CreateGs1
Code128 Code 128 (sets A/B/C automatic) GS1-128 via CreateGs1("(01)...(10)...")
Ean EAN-13, EAN-8, UPC-A check digit calculated or verified, guard bars and digit groups
Code39 Code 39 optional modulo 43 check character
Interleaved2Of5 ITF / ITF-14 optional GS1 check digit

All encoders were verified by rendering the output with Ghostscript and decoding it with zxing-cpp (all QR versions/levels/masks, all Data Matrix sizes, GS1, every 1D symbology).

Drawing

using MiPdf.Barcodes;

using (var canvas = page.GetCanvas())
{
    // 2D codes: square of 80 pt including the quiet zone
    canvas.DrawBarcode(QrCode.Create("https://example.com"), 450, 700, 80);

    // linear codes: rectangle including quiet zone and human-readable text
    canvas.DrawBarcode(Ean.CreateEan13("400638133393"), 72, 700, 150, 70);

    // fixed module size (0.5 pt per module), height 40 pt
    Code128.CreateGs1("(01)09501101530003(10)ABC").DrawWithModuleSize(canvas, 72, 600, 0.5, 40);
}

Options on every barcode: Color, Background, QuietZone (modules). Linear barcodes: ShowText, Font, FontSize.

Layout

layout.Add(new BarcodeElement(DataMatrix.Create("ORDER-4711"), width: 60) { Alignment = TextAlignment.Right });

In tagged documents (PDF/UA) a BarcodeElement becomes a Figure whose alternate text defaults to the encoded text; set AlternateText for a better description.

Payment QR code (EPC / GiroCode)

var qr = EpcQrCode.Create(new EpcPayment
{
    Name = "Example Ltd.",
    Iban = "AT61 1904 3002 3457 3201",
    Bic = "BKAUATWW",          // optional within the EEA
    Amount = 123.45m,
    Text = "Invoice 2026-0042", // or Reference = "RF18..." (structured)
});
canvas.DrawBarcode(qr, 450, 60, 90);

Inspecting modules

MatrixBarcode exposes Rows, Columns and an indexer [row, column]; LinearBarcode.Modules returns the bar/space sequence. Both can be used to render barcodes elsewhere (e.g. into a bitmap).

Edit this page