1. IronQR
  2. 방법
  3. PDF에 QR 코드 찍기

PDF 페이지에 QR 코드 만들기: 문서에 직접 삽입하는 방법

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

QR 코드를 PDF 문서에 직접 임베드하여 페이지에 즉시 워터마크를 추가하거나 URL, 추적 ID 또는 디지털 서명과 같은 동적 정보를 추가하십시오.

기존 PDF에 QR 코드를 추가하는 것은 문서 워크플로의 일반적인 요구사항입니다. 송장 PDF는 결제 포털로 연결되는 QR 코드를 포함할 수 있습니다. 정부 기록은 검증 코드를 임베드할 수 있습니다. 이벤트 티켓은 문서 레이아웃 전체를 재구성하지 않고 스캔 가능 ID를 포함할 수 있습니다. IronQR은 이를 간단히 만들어 줍니다: QrWriter.Write로 QR 코드를 생성하고 DrawBitmap를 단일 호출로 원하는 위치에 페이지에 스탬프합니다.

이 가이드는 IronQR 라이브러리를 사용하여 기존 PDF 파일에 QR 코드를 임베드하는 방법을 시연합니다. 아직 QR 코드를 생성하지 않은 개발자는 먼저 QR 코드 이미지를 생성하는 방법 가이드를 시작해야 합니다.

빠른 시작: QR 코드를 PDF에 삽입

QR 코드를 생성하여 기존 PDF 페이지의 특정 위치에 삽입합니다.

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

    PM > Install-Package IronQR

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

    var qrBitmap = QrWriter.Write("https://example.com").Save();
var pdf = PdfDocument.FromFile("document.pdf");
pdf.Pages[0].DrawBitmap(qrBitmap, 505, 20, 70, 70);
pdf.SaveAs("stamped.pdf");

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

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

    arrow pointer
### 최소 워크플로우(5단계)
  1. QR 코드를 PDF에 삽입하기 위한 IronQR C# 라이브러리를 다운로드합니다
  2. `QrWriter.Write().Save()`를 사용하여 QR 코드 비트맵을 생성합니다
  3. `PdfDocument.FromFile()`로 PDF를 로드합니다
  4. 페이지 인덱스, x/y 좌표, 및 크기로 `DrawBitmap()`을 호출합니다
  5. `SaveAs()`로 수정된 PDF를 저장합니다

PDF 페이지에 QR 코드 삽입하기

기존 PDF에 QR 코드를 삽입하려면 QrWriter.Write로 QR 코드를 생성하고, Save()와 함께 AnyBitmap로 저장합니다. 목표 PDF를 PdfDocument.FromFile로 로드한 다음 DrawBitmap를 사용하여 QR 코드를 정확한 좌표에 배치합니다. x 및 y 값은 PDF 포인트 단위입니다(A4 페이지는 595 × 842 pts)이며, desiredWidth 및 desiredHeight는 스탬프 크기를 제어합니다.

입력

아래 QR 코드는 https://ironsoftware.com을(를) 인코딩하며, PDF에 스탬프됩니다.

QR 코드 비트맵 인코딩 https://ironsoftware.com 
:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf.cs
using IronQr;
using IronPdf;
using IronSoftware.Drawing;

// Generate QR code bitmap
AnyBitmap qrBitmap = QrWriter.Write("hello world").Save();

// Load the existing PDF
PdfDocument pdf = PdfDocument.FromFile("sample.pdf");

// Stamp the QR code at the top-right corner of page 1
// A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70);

pdf.SaveAs("sample.pdf");

Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

' Generate QR code bitmap
Dim qrBitmap As AnyBitmap = QrWriter.Write("hello world").Save()

' Load the existing PDF
Dim pdf As PdfDocument = PdfDocument.FromFile("sample.pdf")

' Stamp the QR code at the top-right corner of page 1
' A4 page is 595 x 842 PDF points; x:505, y:20 places a 70pt QR near the top-right
pdf.DrawBitmap(qrBitmap, 0, 505, 20, 70, 70)

pdf.SaveAs("sample.pdf")
$vbLabelText   $csharpLabel

수정된 PDF는 SaveAs로 저장됩니다. 소스를 덮어쓰지 않으려면 다른 출력 경로를 전달하세요.

산출

QR 코드는 페이지 1의 오른쪽 상단 모서리에 좌표 (505, 20)에서 70 × 70 PDF 포인트 크기로 삽입됩니다.

위치 및 페이지 번호 제어하기

x 및 y 매개변수는 페이지 왼쪽 상단 모서리에서 측정한 PDF 포인트 단위입니다. x를 증가시키면 스탬프가 오른쪽으로 이동합니다; y를 증가시키면 스탬프가 아래로 이동합니다. pageIndex 매개변수는 0부터 시작하므로, pageIndex: 0는 첫 번째 페이지를 대상으로 합니다.

다음 예제는 다른 페이지에 두 개의 QR 코드를 삽입합니다 — 페이지 1의 오른쪽 상단에 검증 링크와 페이지 2의 왼쪽 하단에 지원 링크:

입력

아래 두 QR 코드는 분리된 페이지에 삽입될 검증 및 지원 URL을 인코딩합니다.

QR code encoding https://ironsoftware.com/verify

페이지 1 입력 — ironsoftware.com/verify의 QR 코드

QR code encoding https://ironsoftware.com/support

페이지 2 입력 — ironsoftware.com/support의 QR 코드 

:path=/static-assets/qr/content-code-examples/how-to/stamp-qr-code-to-pdf-positions.cs
using IronQr;
using IronPdf;
using IronSoftware.Drawing;

PdfDocument pdf = PdfDocument.FromFile("document.pdf");

// Page 1: stamp a verification QR at the top-right corner
AnyBitmap qrVerify = QrWriter.Write("https://ironsoftware.com/verify").Save();
pdf.DrawBitmap(qrVerify, 0, 505, 20, 70, 70);

// Page 2: stamp a support QR at the bottom-left corner
AnyBitmap qrSupport = QrWriter.Write("https://ironsoftware.com/support").Save();
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70);

pdf.SaveAs("document.pdf");

Imports IronQr
Imports IronPdf
Imports IronSoftware.Drawing

Dim pdf As PdfDocument = PdfDocument.FromFile("document.pdf")

' Page 1: stamp a verification QR at the top-right corner
Dim qrVerify As AnyBitmap = QrWriter.Write("https://ironsoftware.com/verify").Save()
pdf.DrawBitmap(qrVerify, 0, 505, 20, 70, 70)

' Page 2: stamp a support QR at the bottom-left corner
Dim qrSupport As AnyBitmap = QrWriter.Write("https://ironsoftware.com/support").Save()
pdf.DrawBitmap(qrSupport, 1, 20, 752, 70, 70)

pdf.SaveAs("document.pdf")
$vbLabelText   $csharpLabel

참고해 주세요PDF 포인트는 PDF 페이지에서 좌표의 측정 단위입니다. 한 A4 페이지는 595 pts 너비와 842 pts 높이이며, 왼쪽 상단 모서리에 (0, 0)이 있습니다. 오른쪽 상단 모서리에서 70 pt QR 코드를 20 pt 여백과 함께 배치하려면 페이지 너비에서 QR 크기와 여백을 빼세요: x = 595 − 70 − 20 = 505, 그리고 상단에 가까이 앉히려면 y = 20을 유지합니다. 왼쪽 하단 모서리의 경우, x = 20이고 페이지 높이에서 빼면 됩니다: y = 842 − 70 − 20 = 752.

산출

각 QR 코드는 해당 모서리에 배치됩니다 — 검증은 페이지 1의 오른쪽 상단, 지원은 페이지 2의 왼쪽 하단.

사용 사례

  • 송장 결제 링크: 결제 포털 URL을 인코딩하여 페이지 1의 오른쪽 상단에 삽입하여 고객이 즉시 스캔 후 결제를 할 수 있도록 합니다.
  • 문서 검증: 기록 ID 또는 해시값을 인코딩하여 모든 페이지 하단에 삽입하여 수신자가 진위 여부를 확인할 수 있도록 합니다.
  • 이벤트 티켓: 참석자 ID 또는 예약 정보를 인코딩하여 페이지 1의 중앙에 배치하여 입장 시 쉽게 스캔할 수 있도록 합니다.
  • 제품 라벨: 제품 URL 또는 일련 번호를 인코딩하여 신속한 재고 조회를 위해 위의 왼쪽 모서리 또는 아래의 오른쪽 모서리에 배치합니다.
  • 법적 기록: 사건 번호 또는 제출 참고사항을 인코딩하여 각 페이지의 하단에 삽입하여 추적 가능하게 합니다.

QR 코드를 스탬프하기 전에 오류 수정 수준 설정이나 출력 크기 조정과 같은 추가적인 제어를 위해, QrOptions 객체를 구성하고 QrWriter.Write에 전달한 후 StampToExistingPdfPage를 호출합니다.

더 많은 QR 코드 생성 패턴을 위해, C# QR 코드 생성기 튜토리얼과 전체 IronQR 기능 세트를 탐색하세요.

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

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

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

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

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

빠른 증거를 원하시나요? PM > Install-Package IronQR
샘플을 실행하세요 URL이 QR 코드로 바뀌는 것을 확인해 보세요.