1. IronBarcode
  2. 방법
  3. 바코드 여백 설정

C#에서 바코드에 여백 추가하는 방법

커티스 차우
커티스 차우
업데이트됨:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronBarcode는 C#에서 바코드에 여백(조용한 영역)을 추가하는 두 가지 방법을 제공합니다: SetMargins()을(를) 단일 매개변수와 함께 사용하여 모든 면에 균일한 여백을 추가하거나, 오버로드된 SetMargins()을(를) 사용하여 상단, 오른쪽, 하단 및 왼쪽 면에 개별적인 여백을 설정할 수 있습니다.

바코드가 신뢰할 수 있으려면, 단순한 막대와 공간 이상이 필요합니다. 코드를 둘러싼 빈 영역은 "조용한 구역" 또는 여백으로 알려져 있으며, 이는 매우 중요합니다. 이 조용한 구역은 스캐너가 바코드를 텍스트나 그래픽과 같은 레이블의 다른 요소와 구별할 수 있도록 해줍니다.

충분한 여백이 없으면 스캔이 실패하거나 잘못된 데이터를 반환할 수 있습니다. 이것은 특히 실패한 스캔이 시간과 재정적 손실을 초래하는 물류 및 소매업에서 중요합니다. IronBarcode에서 지원하는 바코드 형식 각자는 최적의 스캔 성능을 보장하기 위해 구체적인 여백 요구 사항이 있습니다.

IronBarcode는 이러한 여백을 설정하는 간단한 방법을 제공하여 바코드가 매번 정확하게 스캔되도록 합니다. 이러한 여백 설정은 모든 바코드 이미지 생성 기능과 원활하게 작동합니다. 이 가이드에서는 IronBarcode가 제공하는 바코드 여백 설정 방법을 살펴보겠습니다.

빠른 시작: C#에서 바코드에 여백 추가

IronBarcode의 SetMargins() 메서드를 사용하여 한 줄의 코드로 모든 바코드 주변에 조용한 영역을 추가합니다. 즉시 시작하세요—바코드를 생성하고, 여백을 적용하고, 이미지 파일로 저장합니다.

  1. NuGet 패키지 관리자를 사용하여 https://www.nuget.org/packages/BarCode 설치하기

    PM > Install-Package BarCode

  2. 다음 코드 조각을 복사하여 실행하세요.

    IronBarCode.BarcodeWriter.CreateBarcode("Hello World", BarcodeEncoding.QRCode, 250, 250).SetMargins(50).SaveAsPng("barcode-with-margin.png");

  3. 실제 운영 환경에서 테스트할 수 있도록 배포하세요.

    무료 체험판으로 오늘 프로젝트에서 IronBarcode 사용 시작하기

    arrow pointer
## C#에서 바코드에 여백을 추가하는 방법
  1. IronBarcode C# 라이브러리를 다운로드하여 바코드에 여백을 추가하세요
  2. `CreateBarcode`로 문자열 값을 사용해 바코드 생성
  3. `SetMargins`을 사용하여 네 면 모두에 균일한 조용한 구역을 적용합니다.
  4. `SetMargins`을 사용하여 바코드의 각 면에 여백을 적용합니다.
  5. `SaveAsPng`으로 바코드를 이미지로 저장합니다.

네 면 모두에 균일한 여백을 어떻게 설정하나요?

올바른 조용한 영역을 보장하는 가장 간단한 방법은 SetMargins 메서드를 사용하는 것입니다. 이 방법은 모든 네면의 바코드에 빈 테두리를 추가할 픽셀 수를 나타내는 단일 정수를 받습니다. 이 접근법은 일관된 간격이 필요한 QR 코드 또는 기타 2D 바코드 형식을 생성할 때 특히 유용합니다.

이 예제에서는 바코드를 생성하고 여백을 100픽셀로 설정하며 SaveAsPng을(를) 사용하여 결과를 저장합니다. 여백 설정은 포괄적인 사용자 지정화를 위한 다른 바코드 스타일링 옵션과 결합될 수 있습니다.

:path=/static-assets/barcode/content-code-examples/how-to/setting-margin-barcode.cs
using IronBarCode;

// Create a QR code
GeneratedBarcode qrcode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode",
    BarcodeWriterEncoding.QRCode
);

// Set consistent margins around the QR code
qrcode.SetMargins(100);
// Save the QR code as a PNG image
qrcode.SaveAsPng("QRCode.png");
$vbLabelText   $csharpLabel

균일한 여백이 적용된 출력은 어떻게 보이나요?

바코드 요소 주위에 적절한 간격을 보여주는 네 면의 흰색 여백이 적용된 QR 코드

출력에서 보듯이, 바코드 주위에 100픽셀의 균일한 사각형 여백이 적용되었습니다. 이것은 다양한 바코드 읽기 시나리오에서 신뢰할 수 있는 스캔을 보장하는 최적의 조용한 구역을 만듭니다.

균일한 여백이 스캔에 중요한 이유는?

균일한 여백은 소매 환경에서 일반적으로 사용되는 전방향 스캐너에 필수적입니다. 일관된 조용한 구역은 부분적인 읽기와 근접한 그래픽이나 텍스트를 바코드 데이터로 잘못 해석하는 것을 방지합니다. 이는 불완전한 바코드 및 이미지 교정 시나리오를 처리할 때 특히 중요합니다.

전문적인 응용 프로그램용 바코드를 생성할 때, 적절한 여백은 바코드 시스템의 전반적인 결함 허용 범위에 기여합니다. 여백은 스캐너가 이상적인 스캔 조건이 아닐 때도 바코드의 시작과 끝을 명확히 식별하는데 도움이 되는 완충 구역 역할을 합니다.

각 면에 다른 여백을 어떻게 설정하나요?

균일한 여백을 적용하는 것 외에도, IronBarcode는 SetMargins 메서드의 오버로드를 사용하여 각 면에 개별적인 여백을 지정할 수 있게 합니다. 이 오버로드는 각각 상단, 우측, 하단 및 좌측 여백을 나타내는 네 개의 정수 파라미터를 수용합니다. 이 유연성은 정밀한 레이아웃 제어가 필수적인 PDF로 바코드 생성할 때 특히 유용합니다.

다음 예제에서는 상단 및 하단에 10픽셀, 좌우에 5픽셀로 특정 여백을 정의합니다. 이 비대칭 여백 구성은 기존 문서 레이아웃에 바코드를 통합하거나 커스텀 바코드 스타일 작업 시 유용합니다.

:path=/static-assets/barcode/content-code-examples/how-to/setting-multiple-margin.cs
using IronBarCode;

// Create a QR code
GeneratedBarcode qrcode = BarcodeWriter.CreateBarcode(
    "https://ironsoftware.com/csharp/barcode",
    BarcodeWriterEncoding.QRCode
);

// Set the QR code dimensions 10 pixel on top and bottom, 5 pixels on left and right
qrcode.SetMargins(10, 5, 10, 5);


// Save the QR code as a PNG file
qrcode.SaveAsPng("QRCodeValue.png");
$vbLabelText   $csharpLabel

개별 여백이 적용된 출력은 어떻게 보이나요?

위치 마커와 데이터 매트릭스 주위에 여백 간격을 보여주는 QR 코드 예제

각 면에 다른 여백을 언제 사용해야 하나요?

다른 여백은 특정 레이아웃 제한이 있는 기존 레이블 디자인에 바코드를 통합할 때 유용합니다. 예를 들어, 높이 제한을 맞추기 위해 최소한의 상하단 여백이 필요할 수 있으며, 동시에 스캐너 접근 각도를 맞추기 위해 좌우의 넓은 여백이 필요할 수 있습니다. 이 기법은 전문 수준의 바코드 솔루션을 만드는 데 사용되는 다른 바코드 생성 기능과 자주 결합됩니다.

개별적인 여백 제어는 특히 중요해질 때:

  • 문서에 좁은 공간 요구 사항에 맞춰 바코드를 삽입하는 것
  • 산업 전용 표준에 맞는 라벨을 생성하는 것
  • 특정 스캐너 유형이나 방향에 맞춰 바코드 배치를 최적화하는 것
  • 공간이 부족한 기존 인쇄 레이아웃에 통합하는 것

일반적인 여백 크기 가이드라인은 무엇인가요?

업계 표준은 일반적으로 선형 바코드의 경우 가장 좁은 막대(X-차원) 폭의 10배, QR과 같은 2D 코드의 경우 최소 4 모듈 폭의 최소 조용한 영역을 권장합니다. 그러나 넓은 여백은 특히 어려운 조건에서 스캔 신뢰성을 일반적으로 향상시킵니다.

실용적인 구현을 위해, 다음 지침을 고려하십시오:

  • QR 코드: 모든 면에서 최소 4 모듈 폭
  • Code 128: 최소 10X 조용한 영역 (좁은 막대 폭의 10배)
  • PDF417: 모든 면에서 최소 2 모듈 폭
  • Data Matrix: 모든 면에서 최소 1 모듈 폭

이러한 표준은 다양한 스캔 장비 및 환경 조건과의 호환성을 보장합니다. 의문이 있을 때는, 스캔 성공률을 높이기 위해 더 넓은 여백을 사용하세요.

IronBarcode의 여백 설정은 오류 수정 설정과 같은 다른 기능과 매끄럽게 통합되며 실제 애플리케이션에서 신뢰할 수 있는 바코드 솔루션)를 만듭니다.

자주 묻는 질문

C#에서 바코드에 여백을 추가하는 방법은 무엇인가요?

IronBarcode는 바코드에 여백을 추가하는 두 가지 방법을 제공합니다. 모든 면에 균일한 여백을 설정하려면 단일 매개변수를 사용하는 SetMargins() 메서드를 사용하고, 상단, 오른쪽, 하단 및 왼쪽 면에 개별 여백을 설정하려면 네 개의 매개변수를 사용하는 오버로드된 SetMargins() 메서드를 사용할 수 있습니다.

바코드 용어에서 콰이어트 존(Quiet Zone)이란 무엇인가요?

콰이어트 존(Quiet Zone)은 바코드를 둘러싼 빈 영역으로, 여백이라고도 합니다. IronBarcode는 SetMargins() 메서드를 사용하여 이러한 콰이어트 존을 구성함으로써 스캐너가 라벨의 다른 요소와 바코드를 명확하게 구분할 수 있도록 합니다.

바코드의 모든 면에 균일한 여백을 설정하려면 어떻게 해야 하나요?

모든 면에 균일한 여백을 설정하려면 픽셀을 나타내는 단일 정수 매개변수와 함께 SetMargins() 메서드를 사용하십시오. 예를 들어, IronBarcode를 사용할 때 barcode.SetMargins(50)은 네 면 모두에 50픽셀의 여백을 추가합니다.

바코드의 각 면에 서로 다른 여백 크기를 설정할 수 있나요?

예, IronBarcode는 바코드의 각 면에 개별 여백을 설정하기 위해 네 개의 매개변수(상단, 오른쪽, 하단, 왼쪽)를 받는 오버로드된 SetMargins() 메서드를 제공합니다.

바코드 스캔에서 여백이 중요한 이유는 무엇일까요?

바코드 스캔의 정확도를 높이려면 여백 또는 콰이어트 존이 매우 중요합니다. 여백이 충분하지 않으면 스캔이 실패하거나 잘못된 데이터가 반환될 수 있습니다. IronBarcode는 간편한 여백 설정 방법을 제공하여 바코드 스캔의 정확성을 보장합니다.

바코드에 여백을 추가하지 않으면 어떻게 되나요?

적절한 여백이 없으면 바코드 스캔이 실패하거나 잘못된 데이터가 반환될 수 있으며, 특히 물류 및 소매 환경에서 문제가 됩니다. IronBarcode의 SetMargins() 메서드는 바코드 주변에 충분한 여백을 확보하여 이러한 문제를 방지하는 데 도움을 줍니다.

여백이 있는 바코드 이미지를 저장하려면 어떻게 해야 하나요?

SetMargins() 함수를 사용하여 여백을 설정한 후에는 IronBarcode의 SaveAsPng() 메서드 또는 SaveAsJpeg()이나 SaveAsBmp()와 같은 다른 형식 메서드를 사용하여 바코드를 저장할 수 있습니다.

커티스 차우
커티스 차우
  지금 바로 엔지니어링 팀과 채팅하세요
기술 문서 작성자

커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.

커티스는 개발 분야 외에도 사물 인터넷(IoT)에 깊은 관심을 가지고 있으며, 하드웨어와 소프트웨어를 통합하는 혁신적인 방법을 연구합니다. 여가 시간에는 게임을 즐기거나 디스코드 봇을 만들면서 기술에 대한 애정과 창의성을 결합합니다.

시작할 준비 되셨나요?
Nuget 다운로드 2,108,094 | 버전: 2026.3 방금 출시되었습니다
Still Scrolling Icon

아직도 스크롤하고 계신가요?

빠른 증거를 원하시나요? PM > Install-Package BarCode
샘플을 실행하세요 실이 바코드로 변하는 모습을 지켜보세요.