Acontplus.Barcode 1.0.3

Acontplus.Barcode

Advanced barcode generation library with ZXing.Net integration. Supports QR codes, 1D/2D barcodes, custom styling, and high-performance image generation using SkiaSharp for cross-platform applications.

🚀 Features

📱 Barcode Formats

• QR Codes - High-capacity 2D barcodes with error correction
• Code 128 - High-density linear barcode for alphanumeric data
• Code 39 - Industrial barcode standard for alphanumeric data
• EAN-13 - European Article Number for retail products
• EAN-8 - Compact version of EAN for small products
• UPC-A - Universal Product Code for retail products
• UPC-E - Compact UPC for small products
• PDF417 - High-capacity 2D barcode for large data
• Data Matrix - Compact 2D barcode for small items

🎨 Customization Options

• Custom Colors - Foreground and background color customization
• Size Control - Adjustable width, height, and margins
• Error Correction - Configurable error correction levels for QR codes
• Format Options - PNG, JPEG, and other image formats
• Cross-Platform - SkiaSharp rendering for consistent output

📦 Installation

NuGet Package Manager

Install-Package Acontplus.Barcode

.NET CLI

dotnet add package Acontplus.Barcode

PackageReference

<PackageReference Include="Acontplus.Barcode" Version="1.0.2" />

🎯 Quick Start

1. Basic QR Code Generation

using Acontplus.Barcode.Utils;

// Generate a simple QR code
var qrCode = BarcodeGen.GenerateQRCode("https://example.com", 300, 300);
await File.WriteAllBytesAsync("qr-code.png", qrCode);

2. Customized Barcode

// Generate a Code 128 barcode with custom styling
var config = new BarcodeConfig
{
    Text = "123456789",
    Width = 400,
    Height = 100,
    Format = BarcodeFormat.CODE_128,
    ForegroundColor = System.Drawing.Color.Black,
    BackgroundColor = System.Drawing.Color.White,
    Margin = 10
};

var barcode = BarcodeGen.GenerateBarcode(config);
await File.WriteAllBytesAsync("barcode.png", barcode);

3. Multiple Barcode Formats

// Generate different barcode types
var formats = new[]
{
    BarcodeFormat.QR_CODE,
    BarcodeFormat.CODE_128,
    BarcodeFormat.CODE_39,
    BarcodeFormat.EAN_13,
    BarcodeFormat.PDF_417
};

foreach (var format in formats)
{
    var config = new BarcodeConfig
    {
        Text = "Sample Data",
        Format = format,
        Width = 300,
        Height = 100
    };
    
    var barcode = BarcodeGen.GenerateBarcode(config);
    await File.WriteAllBytesAsync($"{format}.png", barcode);
}

🔧 Advanced Usage

QR Code with Error Correction

var config = new BarcodeConfig
{
    Text = "Important data that needs error correction",
    Format = BarcodeFormat.QR_CODE,
    Width = 400,
    Height = 400,
    ErrorCorrection = ErrorCorrectionLevel.H,
    Margin = 20
};

var qrCode = BarcodeGen.GenerateBarcode(config);

Custom Color Schemes

var config = new BarcodeConfig
{
    Text = "Custom colored barcode",
    Format = BarcodeFormat.CODE_128,
    Width = 350,
    Height = 80,
    ForegroundColor = System.Drawing.Color.DarkBlue,
    BackgroundColor = System.Drawing.Color.LightGray
};

var barcode = BarcodeGen.GenerateBarcode(config);

Batch Generation

var items = new[]
{
    "Item001",
    "Item002", 
    "Item003",
    "Item004"
};

for (int i = 0; i < items.Length; i++)
{
    var config = new BarcodeConfig
    {
        Text = items[i],
        Format = BarcodeFormat.CODE_128,
        Width = 300,
        Height = 80
    };
    
    var barcode = BarcodeGen.GenerateBarcode(config);
    await File.WriteAllBytesAsync($"item_{i + 1}.png", barcode);
}

📊 Barcode Format Comparison

🎨 Configuration Options

BarcodeConfig Properties

public class BarcodeConfig
{
    public string Text { get; set; } = string.Empty;
    public BarcodeFormat Format { get; set; } = BarcodeFormat.QR_CODE;
    public int Width { get; set; } = 300;
    public int Height { get; set; } = 300;
    public int Margin { get; set; } = 10;
    public Color ForegroundColor { get; set; } = Color.Black;
    public Color BackgroundColor { get; set; } = Color.White;
    public ErrorCorrectionLevel ErrorCorrection { get; set; } = ErrorCorrectionLevel.M;
}

Error Correction Levels (QR Codes)

• L (Low) - 7% recovery capacity
• M (Medium) - 15% recovery capacity
• Q (Quartile) - 25% recovery capacity
• H (High) - 30% recovery capacity

🔍 Best Practices

1. Choose the Right Format

// For URLs and general data
var qrConfig = new BarcodeConfig { Format = BarcodeFormat.QR_CODE };

// For inventory systems
var code128Config = new BarcodeConfig { Format = BarcodeFormat.CODE_128 };

// For retail products
var eanConfig = new BarcodeConfig { Format = BarcodeFormat.EAN_13 };

2. Optimize Size and Quality

// High-quality QR code for printing
var highQuality = new BarcodeConfig
{
    Text = "https://example.com",
    Format = BarcodeFormat.QR_CODE,
    Width = 600,
    Height = 600,
    ErrorCorrection = ErrorCorrectionLevel.H
};

// Compact barcode for web display
var compact = new BarcodeConfig
{
    Text = "123456789",
    Format = BarcodeFormat.CODE_128,
    Width = 200,
    Height = 60
};

3. Handle Large Data Sets

// For large amounts of data, use 2D formats
var largeData = new BarcodeConfig
{
    Text = "Large amount of data that needs to be encoded...",
    Format = BarcodeFormat.PDF_417, // or QR_CODE
    Width = 400,
    Height = 200
};

🚀 Performance Tips

1. Reuse Configuration Objects

var baseConfig = new BarcodeConfig
{
    Format = BarcodeFormat.CODE_128,
    Width = 300,
    Height = 100
};

// Reuse for multiple barcodes
foreach (var item in items)
{
    baseConfig.Text = item;
    var barcode = BarcodeGen.GenerateBarcode(baseConfig);
}

2. Batch Processing

// Process multiple barcodes efficiently
var tasks = items.Select(async item =>
{
    var config = new BarcodeConfig
    {
        Text = item,
        Format = BarcodeFormat.CODE_128,
        Width = 300,
        Height = 100
    };
    
    return await Task.Run(() => BarcodeGen.GenerateBarcode(config));
});

var barcodes = await Task.WhenAll(tasks);

📚 API Reference

BarcodeGen Class

public static class BarcodeGen
{
    // Generate QR code with default settings
    public static byte[] GenerateQRCode(string text, int width, int height);
    
    // Generate barcode with custom configuration
    public static byte[] GenerateBarcode(BarcodeConfig config);
    
    // Generate barcode with specific format
    public static byte[] GenerateBarcode(string text, BarcodeFormat format, int width, int height);
}

BarcodeConfig Class

public class BarcodeConfig
{
    public string Text { get; set; }
    public BarcodeFormat Format { get; set; }
    public int Width { get; set; }
    public int Height { get; set; }
    public int Margin { get; set; }
    public Color ForegroundColor { get; set; }
    public Color BackgroundColor { get; set; }
    public ErrorCorrectionLevel ErrorCorrection { get; set; }
}

🔧 Dependencies

• .NET 9.0+ - Advanced .NET framework
• ZXing.Net - Barcode generation library
• SkiaSharp - Cross-platform graphics library
• System.Drawing.Common - Image processing support

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

git clone https://github.com/Acontplus-S-A-S/acontplus-dotnet-libs.git
cd acontplus-dotnet-libs
dotnet restore
dotnet build

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• 📧 Email: proyectos@acontplus.com
• 🐛 Issues: GitHub Issues
• 📖 Documentation: Wiki

👨‍💻 Author

Ivan Paz - @iferpaz7

🏢 Company

Acontplus S.A.S. - Enterprise software solutions

Built with ❤️ for the .NET community using cutting-edge .NET 9 features