QRCoder.NET과 IronBarcode: C# 바코드 라이브러리 비교

QR 코드 전용 디자인

QRCoder는 데이터 생성 단계와 렌더링 단계를 분리합니다. QRCodeGenerator는 QRCodeData 중간 객체를 생성한 다음 렌더러 클래스로 전달합니다. 이 패턴은 추가 객체를 사용하는 대신 출력 형식을 정밀하게 제어할 수 있도록 해줍니다.

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 방식이 유일한 진입점이며, CreateCode128, CreateDataMatrix, CreateEAN13은 없습니다. 이 도서관은 애초에 의도했던 범위를 완벽하게 준수하고 있습니다.

상세 기능 비교

QR코더 접근 방식

QRCoder는 2단계 패턴을 사용합니다: QRCodeGenerator.CreateQrCode은 데이터와 오류 수정 수준을 인코딩하는 QRCodeData 중간 개체를 생성하고, 별도의 렌더러 클래스가 해당 중간 개체를 원하는 출력 형식으로 변환합니다. ECC 레벨은 기본값이 없는 필수 매개변수이므로 개발자는 명시적으로 선택해야 합니다.

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)

이 패턴은 코드 데이터를 다시 생성하지 않고 qrCodeData 개체를 여러 출력 형식에 재사용할 수 있다는 이점이 있습니다. 렌더러 클래스에는 PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, BitmapByteQRCode 등이 포함됩니다.

IronBarcode접근법

IronBarcode는 생성 및 렌더링을 정적 BarcodeWriter 클래스의 유창한 체인으로 축소합니다. BarcodeEncoding.QRCode 매개변수는 형식을 선택하고, SaveAsPng 또는 ToPngBinaryData와 같은 터미널 메서드는 출력을 결정합니다:

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")

명시적인 오류 수정 제어가 필요한 경우 QRCodeWriter 클래스는 형식별 옵션을 제공합니다:

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 바코드 생성 가이드는 동일한 BarcodeWriter 진입점을 통해 QR코드, DataMatrix, PDF417및 Aztec을 포함한 모든 지원 2D 형식을 다룹니다.

QR코더 접근 방식

QRCoder 로고 임베딩은 QRCode 렌더러 클래스(PngByteQRCode와는 별개)를 통해 GetGraphic가 System.Drawing.Bitmap를 받아들이는 오버로드를 노출합니다. 즉, 로고 파일을 로드하려면 호출 코드가 System.Drawing에서 직접 작동해야 합니다:

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)

색상 사용자 지정은 GetGraphic 오버로드의 darkColor 및 lightColor 매개 변수를 통해 유사한 패턴을 따릅니다.

IronBarcode접근법

IronBarcode는 로고 삽입 및 색상 변경을 QRCodeWriter 결과 객체에 명명된 메서드로 노출합니다. AddBrandLogo 메서드는 파일 경로를, ChangeBarCodeColor는 Color 값을 받습니다:

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 코드 스타일 맞춤 설정 가이드 에서는 로고 크기, 색상 조합 및 콰이어트 존 제어에 대해 자세히 다룹니다.

QR코더 접근 방식

QRCoder에는 바코드 읽기 API가 없습니다. 코드-51814--@@ 클래스와 모든 렌더러 클래스는 세대 전용입니다. 이미지, 파일 또는 스트림에서 QR 코드를 해독하는 방법은 없습니다. QR 코드를 생성하고 읽어야 하는 애플리케이션은 별도의 라이브러리(일반적으로 ZXing .NET )를 추가해야 하며, 이 라이브러리는 자체 API, 네임스페이스 및 유지 관리 주기를 갖습니다.

// QR코더 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.

// QR코더 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.

' QR코더 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.

이는 설계상의 결정이지, 실수가 아닙니다. QRCoder는 명시적으로 QR 코드 생성 라이브러리입니다.

IronBarcode접근법

IronBarcode 동일한 패키지 내에 읽기 API를 포함하고 있습니다. BarcodeReader.Read는 이미지 파일, PDF 파일, 스트림 및 System.Drawing.Bitmap 객체를 허용합니다. 이 함수는 호출자가 어떤 바코드 형식을 찾을지 지정할 필요 없이 자동으로 바코드 형식을 감지하고 이미지에서 발견된 모든 바코드를 반환합니다.

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // 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.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // 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.Text)        ' decoded value
    Console.WriteLine(result.BarcodeType) ' QRCode, Code128, EAN13, etc.
Next

이미지에서 바코드를 읽는 방법에 대한 가이드는 동일한 진입점을 통해 PDF, 여러 페이지로 구성된 문서, 스트림 및 저해상도 또는 노이즈가 많은 이미지에서 바코드를 읽는 방법을 다룹니다.

QR코더 접근 방식

QRCoder는 의도적으로 QR 코드만 생성합니다. QRCodeGenerator.CreateQrCode 방식은 라이브러리에서 제공하는 유일한 세대 진입점입니다. QR 코드로 시작하여 나중에 코드 128 배송 라벨, EAN-13 제품 코드 또는 데이터매트릭스 의약품 규정 준수 코드가 필요한 프로젝트의 경우, 각 추가 형식을 지원하기 위해 두 번째 라이브러리를 도입해야 합니다.

using QRCoder;

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

// 코드 128 requires a different library (e.g., NetBarcode)
// 데이터매트릭스 requires yet another library
// Reading any format requires yet another library

using QRCoder;

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

// 코드 128 requires a different library (e.g., NetBarcode)
// 데이터매트릭스 requires yet another library
// Reading any format requires yet another library

Imports QRCoder

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

' 코드 128 requires a different library (e.g., NetBarcode)
' 데이터매트릭스 requires yet another library
' Reading any format requires yet another library

IronBarcode접근법

IronBarcode는 동일한 BarcodeWriter.CreateBarcode 엔트리 포인트를 통해 모든 형식군을 다룹니다. QR 코드에서 Code 128로 전환하려면 BarcodeEncoding 매개변수만 변경하면 되며, 추가 패키지나 새로운 네임스페이스, 별도의 API가 필요하지 않습니다:

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")

QR 코드 외에도 다양한 형식 요구 사항이 있습니다.

대부분의 바코드 요구사항은 QR 코드로 시작되며, QRCoder는 이러한 초기 범위를 안정적으로 처리합니다. 긴장감은 두 번째 형식이 대화에 등장할 때 발생합니다. 배송을 위해 코드 128 라벨이 필요한 물류 팀, EAN-13 제품 코드가 필요한 소매 운영, 직렬화를 위해 DataMatrix가 필수적인 제약 워크플로 등 새로운 형식이 추가될 때마다 팀은 새로운 NuGet 종속성을 추가해야 합니다. 라이브러리를 추가할 때마다 발생하는 통합 비용에는 새로운 네임스페이스 학습, 새로운 릴리스 주기 모니터링, 그리고 .NET 업그레이드 시 발생할 수 있는 새로운 버전 충돌 문제가 포함됩니다.

바코드 판독이 필수적이 되었습니다

캠페인용 발신 QR 코드를 생성하는 애플리케이션은 생성 전용 시스템입니다. 입고되는 화물을 처리하고, 도착 시 제품 코드를 확인하거나, 행사에서 티켓을 검증하는 기능까지 갖춘 애플리케이션은 생성 및 판독 시스템입니다. QRCoder는 설계상 QR 코드 읽기 기능을 제공하지 않으므로, 해당 기능은 별도의 라이브러리를 통해 보완해야 합니다. 읽기 라이브러리를 도입하면 바코드 하위 시스템의 통합 규모가 상당히 달라지는데, 특히 읽기 라이브러리가 자체적인 형식 지정 요구 사항이나 스레드 안전성 제약 조건을 부과하는 경우 더욱 그렇습니다.

다중 라이브러리 유지 관리 부담

QRCoder 기반 프로젝트의 자연스러운 축적 패턴은 예측 가능한 경로를 따릅니다. QR 코드 생성을 위한 QRCoder, 배송 라벨용 1D 바코드 라이브러리, 디코딩을 위한 읽기 라이브러리 순으로 진행됩니다. 각 라이브러리는 자체 문서, 자체 버전 관리 주기 및 자체 호환성 파괴 변경 이력을 가지고 있습니다. 한 라이브러리에서는 사소한 .NET 버전 업그레이드가 다른 라이브러리에서는 호환성을 깨뜨리는 변경 사항과 동시에 발생할 수 있습니다. 수년에 걸쳐 이러한 누적 비용을 관리하는 팀들은 숨겨진 비용이 초기 통합에 있는 것이 아니라 여러 업그레이드 주기에 걸쳐 누적되는 유지 관리 오버헤드에 있다고 보고합니다.

PDF 문서 지원

QRCoder로는 PDF 보고서에 삽입할 바코드를 생성하거나 문서 처리 파이프라인에서 들어오는 PDF 문서에서 바코드를 추출할 수 없습니다. PDF를 지원하려면 바코드 기능을 포함한 전체 PDF 라이브러리 또는 전용 라이브러리 조합이 필요합니다. 송장 처리, 규정 준수 보고, 템플릿 PDF에서 라벨 생성 등 문서 중심 워크플로를 구축하는 팀은 QRCoder의 기능 범위가 프로젝트 초기 단계에서 PDF 요구 사항과 겹치는 것을 발견합니다.

PayloadGenerator 문자열 형식

QRCoder의 PayloadGenerator 헬퍼 클래스는 공개 QR 코드 페이로드 표준을 준수하는 문자열을 생성합니다. 예를 들어 WiFi 형식은 WIFI:T:WPA;S:NetworkName;P:Password;;를 생성합니다. 이러한 문자열은 QR 코드 사양에 문서화된 공개 표준 형식이므로 헬퍼 클래스 없이IronBarcode에서 직접 구성할 수 있습니다. 코드 51845--@@를 많이 사용하는 팀은 문자열 구조를 복제하는 작은 정적 헬퍼 메서드를 작성할 계획을 세워야 합니다.

ECCLevel 열거형 매핑

QRCoder는 QRCodeGenerator.ECCLevel와 값 L, M, Q, H를 사용합니다. IronBarcode는 QRCodeWriter.QrErrorCorrectionLevel와 Low, Medium, Quartile, Highest 값을 사용하며, QRCodeWriter.QrErrorCorrectionLevel는 Low, Medium, Quartile를 사용합니다. 매핑은 직접적이지만, 열거형 참조는 모든 호출 사이트에서 업데이트되어야 합니다. QRCoder가 모든 CreateQrCode 호출에서 명시적인 ECC 선택을 요구했다면, IronBarcode는 BarcodeWriter.CreateBarcode 경로가 사용될 때 합리적인 기본값을 적용합니다.

렌더러 클래스 제거

QRCoder의 렌더러 클래스(PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode)는 이전 후 불필요하게 됩니다. IronBarcode는 GeneratedBarcode에서 유창한 체인으로 렌더링을 빌드하므로 중간 렌더러 개체 패턴이 이월되지 않습니다. 이러한 렌더러 클래스를 인스턴스화하는 코드는 BarcodeWriter 결과의 터미널 메서드 호출로 대체할 수 있습니다.