CodeGlyphX logo
CodeGlyphX
Edit on GitHub

CodeGlyphX Documentation

CodeGlyphX is a pure-managed .NET library for generating and decoding QR codes, linear barcodes, and 2D matrix codes. It does not require native graphics libraries.

Key Features

  • No native graphics dependencies - No System.Drawing, SkiaSharp, or ImageSharp required
  • Encode and decode - Supported symbologies have explicit APIs and documented limits
  • Multiple output formats - PNG, SVG, PDF, EPS, HTML, and many more
  • Cross-platform - Windows, Linux, macOS
  • AOT validated - CI publishes and executes a net8.0 NativeAOT consumer

Supported Symbologies

2D Matrix Codes

QR Code, Micro QR, Data Matrix, PDF417 / MicroPDF417, Aztec, GS1 DataBar (Omni/Stacked), and postal 4-state (IMB/RM4SCC/AusPost)

1D Linear Barcodes

Code 128, GS1-128, Code 39/93/11, Codabar, MSI, Plessey, Telepen, Pharmacode, Code 32, EAN/UPC, ITF and 2-of-5 variants, GS1 DataBar (Truncated/Expanded)

Documentation Map

  • QR & Micro QR - Core encoding, error correction, and QR specifics. QR docs
  • Styling & presets - Module shapes, palettes, logos, and the style board gallery. Styling options
  • Payload helpers - WiFi, vCards, OTP, SEPA, and more. Payload helpers
  • Image decoding - Decode from images and screenshots. Image decoding
  • Capability matrix - Compare encoding, module decoding, image scanning, multi-result, and payload support for every format. Symbol capabilities
  • Output formats - PNG, SVG, PDF, EPS, HTML, and more. Output formats
  • API Reference - Full type and method documentation. API reference
  • FAQ - Common questions and troubleshooting. FAQ
  • 2.0 migration - Removed aliases and behavior changes. Migration guide

Quick Example

using CodeGlyphX;

// Generate a QR code
QR.Save("https://evotec.xyz", "website.png");

// Generate a barcode
Barcode.Save(BarcodeType.Code128, "PRODUCT-123", "barcode.png");

// Decode an image
if (QrImageDecoder.TryDecodeImage(imageBytes, out var result))
{
    Console.WriteLine(result.Text);
}

Getting Help

If you encounter issues or have questions, please visit the GitHub Issues page.

For planned work and known gaps, see the ROADMAP.