Yalnızca QR Tasarımı

QRCoder, veri oluşturma adımını render adımından ayırır. QRCodeGenerator bir QRCodeData ara nesneyi üretir ve bu daha sonra bir render sınıfına geçirilir. Bu desen, ek nesneler pahasına çıktı formatı üzerinde kesin kontrol sağlar:

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

' PNG bytes via PngByteQRCode
Dim pngQR As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = pngQR.GetGraphic(20) ' 20px per module
File.WriteAllBytes("qr.png", pngBytes)

' SVG string via SvgQRCode
Dim svgContent As String = New SvgQRCode(qrCodeData).GetGraphic(10)
File.WriteAllText("qr.svg", svgContent)

QRCodeGenerator.CreateQrCode yöntemi, kod oluşturma için tek giriş noktasıdır—CreateCode128, CreateDataMatrix, CreateEAN13 yoktur. Kütüphane, tasarlandığı kapsama tamamen bağlıdır.

Ayrıntılı Özellik Karşılaştırması

QRCoder Yaklaşımı

QRCoder, iki aşamalı bir desen kullanır: QRCodeGenerator.CreateQrCode, veri ve hata düzeltme seviyesini kodlayan bir QRCodeData ara nesnesi üretir ve ayrı bir render sınıfı bu ara nesneyi istenen çıktı formatına dönüştürür. ECC seviyesi, varsayılanı olmayan zorunlu bir parametredir — geliştiricilerin açıkça seçim yapması gerekir:

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

Dim qrCode As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = qrCode.GetGraphic(20) ' pixels per module
File.WriteAllBytes("qr.png", pngBytes)

Bu desenin faydası, kod verisini yeniden üretmeden birden fazla çıktı formatı için qrCodeData nesnesini yeniden kullanmaktır. Render sınıfları arasında, PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode ve BitmapByteQRCode bulunur.

IronBarcode Yaklaşımı

IronBarcode, statik BarcodeWriter sınıfı üzerinde akıcı bir zincir içine üretim ve render işlemlerini birleştirir. BarcodeEncoding.QRCode parametresi formatı seçer ve SaveAsPng veya ToPngBinaryData gibi terminal yöntemler, çıktıyı belirler:

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

Imports IronBarCode

' Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(400, 400) _
    .SaveAsPng("qr.png")

Belirli hata düzeltme kontrolü gerektiren durumlar için, QRCodeWriter sınıfı format-spesifik seçenekler sağlar:

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)
qr.SaveAsPng("qr.png")

IronBarcode 2D barkod oluşturma rehberi, QR Kod, DataMatrix,PDF417veAztekdahil olmak üzere tüm desteklenen 2D formatları, aynı BarcodeWriter giriş noktası üzerinden kapsar.

QRCoder Yaklaşımı

QRCoder logo gömme işlemi, PngByteQRCode'dan ayrı olan QRCode renderer sınıfı üzerinden yönlendirilir ve GetGraphic'nun System.Drawing.Bitmap'yı kabul eden bir aşımı açığa çıkarılır. Bu, çağrı yapan kodun logo dosyasını yüklemek için doğrudan System.Drawing ile çalışması gerektiği anlamına gelir:

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

Imports QRCoder
Imports System.Drawing

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H) ' High ECC required when logo occludes part of the code

Dim qrCode As New QRCode(qrCodeData)
Dim logoBitmap As New Bitmap("logo.png")
Dim qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap)
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png)

Renk özelleştirmesi, GetGraphic aşımının darkColor ve lightColor parametreleri üzerinden benzer bir deseni takip eder.

IronBarcode Yaklaşımı

IronBarcode, logo gömme ve renk değişikliklerini QRCodeWriter sonuç nesnesi üzerinde adlandırılmış yöntemler olarak açığa çıkarır. AddBrandLogo yöntemi bir dosya yolunu kabul eder ve ChangeBarCodeColor bir Color değerini kabul eder:

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

using IronBarCode;
using System.Drawing;

// Logo embedding
var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Highest
);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-logo.png");

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

Imports IronBarCode
Imports System.Drawing

' Logo embedding
Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-logo.png")

' Colour customisation
Dim coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500)
coloredQr.ChangeBarCodeColor(Color.DarkBlue)
coloredQr.SaveAsPng("colored-qr.png")

QR kod stili özelleştirme kılavuzu, logo boyutlandırma, renk kombinasyonları ve sessiz bölge kontrolünü ayrıntılı olarak ele alır.

QRCoder Yaklaşımı

QRCoder, bir barkod okuma API'sine sahip değil. QRCodeGenerator sınıfı ve tüm render sınıfları sadece üretim için vardır. Görüntüden, dosyadan veya akıştan bir QR kod çözmek için bir yöntem yoktur. Hem QR kodları üretmesi hem de okuması gereken uygulamalar, genellikle kendi API'sine, kendi ad alanına ve kendi bakım döngüsüne sahip başka bir kütüphane — genellikle ZXing.Net — eklemelidir:

//QRCoderhas no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

//QRCoderhas no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

'QRCoder has no reading API.
' These methods do not exist:
'   qrGenerator.Decode("image.png")
'   QRCodeReader.Read("image.png")
'
' A separate library (e.g., ZXing.Net) is required for decoding.

Bu bir tasarım kararıdır, ihmalkarlık değil —QRCoderaçıkça bir üretim kütüphanesidir.

IronBarcode Yaklaşımı

IronBarcode, aynı pakette bir okuma API'si içerir. BarcodeReader.Read, görüntü dosyalarını, PDF dosyalarını, akışları ve System.Drawing.Bitmap nesnelerini kabul eder. Barkod formatlarını hangi formatı arayacağını çağırandan istemeden otomatik olarak algılar ve görüntüde bulunan tüm barkodları geri döndürür:

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);       // decoded value
    Console.WriteLine(result.Format);      // QRCode, Code128, EAN13, etc.
}

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Value);       // decoded value
    Console.WriteLine(result.Format);      // QRCode, Code128, EAN13, etc.
}

Imports IronBarCode

' Reading a QR code — no separate library required
Dim results = BarcodeReader.Read("qr.png")
For Each result In results
    Console.WriteLine(result.Value)       ' decoded value
    Console.WriteLine(result.Format)      ' QRCode, Code128, EAN13, etc.
Next

görüntülerden barkod okuma kılavuzu, PDF'lerden, çok sayfalı belgelerden, akışlardan ve aynı giriş noktası aracılığıyla düşük çözünürlüklü veya gürültülü görüntülerden okuma işlemlerini kapsar.

QRCoder Yaklaşımı

QRCoder yalnızca QR kodları üretir — bu, tasarım gereği böyledir. QRCodeGenerator.CreateQrCode yöntemi kütüphanenin sağladığı tek üretim giriş noktasıdır. QR kodlarıyla başlayıp daha sonra Kod 128 gönderim etiketleri, EAN-13 ürün kodları veyaDataMatrixeczacılık uygunluk kodları gerektiren projeler, her ek formatı kapsamak için ikinci bir kütüphaneyi tanıtmak zorundadır:

using QRCoder;

//QRCoderis limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

//Code 128requires a different library (e.g., NetBarcode)
//DataMatrixrequires yet another library
// Reading any format requires yet another library

using QRCoder;

//QRCoderis limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

//Code 128requires a different library (e.g., NetBarcode)
//DataMatrixrequires yet another library
// Reading any format requires yet another library

Imports QRCoder

'QRCoder is limited to QR — other formats require separate packages
Dim qrGenerator As New QRCodeGenerator()
Dim qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M)

'Code 128 requires a different library (e.g., NetBarcode)
'DataMatrix requires yet another library
'Reading any format requires yet another library

IronBarcode Yaklaşımı

IronBarcode, aynı BarcodeWriter.CreateBarcode giriş noktası üzerinden tüm format ailelerini kapsar. QR koddan Code 128'e, DataMatrix'e geçiş yalnızca BarcodeEncoding parametresinin değişmesini gerektirir—ekstra paket yok, yeni ad alanı yok, ayrı API yok:

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

Imports IronBarCode

' All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode) _
    .SaveAsPng("campaign-qr.png")

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product-code.png")

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-code.png")

Format Gereksinimleri QR'ın Ötesinde Genişler

Çoğu barkod gerekliliği QR kodları ile başlar veQRCodero başlangıç kapsamını güvenilir bir şekilde ele alır. İkinci bir format konuşmaya girince tansiyon başlar. Gönderim için Kod 128 etiketler gereken lojistik ekipler, EAN-13 ürün kodları gerekli olan perakende işlemleri, seri numaralandırma içinDataMatrixzorunlu kılan eczacılık iş akışları — her yeni format, bir takımı başka bir NuGet bağımlılığı eklemeye iter. Her ek kütüphanenin entegrasyon maliyeti, öğrenilecek yeni bir ad alanını, izlenecek yeni bir sürüm döngüsünü ve .NET yükseltmelerinde potansiyel sürüm çatışmalarının yeni bir noktasını içerir.

Barkod Okuma Gerekliliği Olur

Bir kampanya için dışa dönük QR kodları üreten bir uygulama yalnızca üretim sistemidir. Aynı zamanda gelen gönderimleri işleyen, varışta ürün kodlarını doğrulayan veya bir etkinlikte biletleri doğrulayan bir uygulama üretim ve okuma sistemidir. QRCoder, tasarım gereği bir okuma yeteneğine sahip değil — bu boşluk başka bir kütüphaneyle doldurulmalıdır. Bir okuma kütüphanesi tanıtımı barkod alt sisteminin entegrasyon altyapısını önemli ölçüde değiştirir, özellikle okuma kütüphanesi kendi biçim-belirleyici gerekliliklerini veya iplik güvenliği kısıtlamalarını dayatıyorsa.

Çoklu Kütüphane Bakım Yükü

BirQRCodertabanlı proje için doğal birikim parçası öngörülebilir bir yolu izler: QR üretimi için QRCoder, gönderim etiketleri için bir 1D barkod kütüphanesi, kod çözme için bir okuma kütüphanesi. Her kütüphane kendi dökümantasyonunu, kendi sürümleme döngüsünü ve kendi kritik değişiklik tarihini taşır. .NET sürüm yükseltmesi bir kütüphane için küçük olabilecek bir şey, başka bir kütüphanede kritik bir değişiklikle aynı zamanda çakışabilir. Yıllar boyunca bu birikimi yöneten ekipler, gizli maliyetin başlangıç entegrasyonunda değil, birden fazla yükseltme döngüsü boyunca bulunan bileşik bakım yükünün içinde olduğunu bildirmektedir.

PDF Belge Desteği

PDF raporlarına gömülü barkodlar oluşturmak veya belge işleme hattında gelen PDF belgelerinden barkodlar çıkartmakQRCoderile mümkün değildir. PDF desteği, barkod yeteneklerine sahip tam bir PDF kütüphanesi veya özel bir kütüphane kombinasyonu gerektirir. Doküman merkezli iş akışları oluşturan ekipler — fatura işleme, uyumluluk raporları, şablonlu PDF'lerden etiket oluşturma — QRCoder'ın kapsam sınırının bir projenin yaşam döngüsünün başlarında PDF gereksinimleriyle kesiştiğini buluyor.

PayloadGenerator Dize Formatı

QRCoder'ın PayloadGenerator yardımcı sınıfları, genel QR kod yük standartlarına uyan dizeler üretir. Örneğin, WiFi formatı WIFI:T:WPA;S:NetworkName;P:Password;; üretir. Bu dizeler, QR kodu spesifikasyonu tarafından belgelenen bir genel standart olduğu için IronBarcode içinde bir yardımcı sınıfa gerek duymadan doğrudan oluşturulabilir. Çok sayıda PayloadGenerator kullanımı olan ekipler, dize yapımını çoğaltan küçük statik yardımcı yöntemler yazmayı planlamalıdır.

ECCLevel Enum Eşlemesi

QRCoder, L, M, Q, H değerleri ile QRCodeGenerator.ECCLevel kullanır. IronBarcode, QRCodeWriter.QrErrorCorrectionLevel ile, Low, Medium, Quartile ve Highest değerleri kullanır. Eşleme doğrudan, ancak enum referansları tüm çağrı noktalarında güncellenmelidir. QRCoder, her CreateQrCode çağrısında açık ECC seçimi gerektirirken,IronBarcodeBarcodeWriter.CreateBarcode yolu kullanıldığında mantıklı bir varsayılanı uygular.

Renderer Sınıfı Kaldırma

QRCoder'ın render sınıfları—PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode—migrasyon sonrasında gereksiz hale gelir. IronBarcode, GeneratedBarcode üzerinde akıcı bir zincire render işlemi inşa eder, bu yüzden ara yönlendirici nesne deseni devam etmez. Bu render sınıflarını oluşturan kod, BarcodeWriter sonuç üzerinde terminal metod çağrıları ile değiştirilebilir.