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을 한 번 호출하는 것만으로 어떤 페이지의 어느 위치에나 QR 코드를 삽입할 수 있습니다.

이 가이드는 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

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

기존 PDF에 QR 코드를 삽입하려면 QrWriter.Write을 사용하여 QR 코드를 생성하고, AnyBitmapSave()로 저장하십시오. PdfDocument.FromFile을 사용하여 대상 PDF를 불러온 다음, DrawBitmap을 사용하여 QR 코드를 정확한 좌표에 배치하십시오. x 및 y 값은 PDF 포인트 단위이며(A4 페이지의 크기는 595 × 842 pts), desiredWidthdesiredHeight는 스탬프 크기를 제어합니다.

입력

아래 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 포인트 크기로 삽입됩니다.


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

xy 매개변수는 페이지의 왼쪽 상단 모서리에서 측정된 PDF 포인트 단위입니다. x을 늘리면 스탬프가 오른쪽으로 이동합니다; y을 위로 올리면 아래로 이동합니다. pageIndex 매개변수는 0을 기준으로 하므로, pageIndex: 0은 첫 번째 페이지를 가리킵니다.

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

입력

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

QR code encoding https://ironsoftware.com/verify
QR code encoding https://ironsoftware.com/support
: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 기능 세트를 탐색하세요.

자주 묻는 질문

IronQR 이란 무엇인가요?

IronQR은 .NET 애플리케이션에서 QR 코드를 생성 및 조작할 수 있는 강력한 라이브러리로, PDF를 포함한 다양한 문서 형식에서 QR 코드를 생성, 사용자 정의 및 통합할 수 있습니다.

IronQR을 사용하여 기존 PDF에 QR 코드를 삽입할 수 있는 방법은 무엇입니까?

IronQR의 QrWriter.Write 메서드를 사용하여 QR 코드를 생성한 다음 StampToExistingPdfPage 함수로 특정 좌표에 PDF 페이지에 찍어 넣음으로써 기존 PDF에 QR 코드를 삽입할 수 있습니다.

StampToExistingPdfPage 함수는 무엇입니까?

IronQR의 StampToExistingPdfPage 함수는 기존 PDF 페이지의 특정 위치에 QR 코드를 정확히 배치할 수 있으며, 이를 통해 문서에 워터마크를 추가하거나 동적 데이터를 매끄럽게 추가할 수 있습니다.

IronQR은 문서에 워터마크를 추가하는 데 사용할 수 있습니까?

예, IronQR은 PDF 페이지에 QR 코드를 찍어 넣어 문서에 워터마크를 추가하는 데 사용할 수 있습니다. 이 기능은 문서에 동적 정보나 브랜딩을 추가하는 데 활용할 수 있습니다.

IronQR을 사용하여 PDF 내 QR 코드 통합의 이점은 무엇입니까?

IronQR은 QR 코드를 PDF에 생성 및 찍어 넣는 것이 쉬운 메서드를 제공하여 QR 코드 배치와 사용자 정의에 대한 정확한 제어가 가능해 문서에 동적 콘텐츠를 추가하는 데 이상적입니다.

PDF에 삽입하기 전에 QR 코드를 사용자 정의할 수 있습니까?

예, IronQR을 사용하면 QR 코드의 크기, 색상 및 오류 수정 레벨과 같은 다양한 측면을 사용자 정의한 다음 PDF 페이지에 찍어 넣을 수 있습니다.

IronQR은 PDF에 대한 동적 QR 코드 생성을 지원합니까?

IronQR은 동적 QR 코드 생성을 지원하여 최신 정보를 담고 있는 QR 코드를 PDF 문서에 찍어 넣을 수 있어 실시간 데이터 업데이트가 필요한 상황에 적합합니다.

IronQR을 사용하여 PDF에 QR 코드를 찍어 넣기 위해 필요한 프로그래밍 언어는 무엇입니까?

IronQR은 C#과 함께 사용되도록 설계되어 있으며, .NET 애플리케이션에 QR 코드 기능을 통합하는 데 사용할 수 있는 강력한 라이브러리를 제공합니다.

IronQR을 사용하여 PDF의 QR 코드 배치 좌표를 어떻게 지정합니까?

IronQR에서는 StampToExistingPdfPage 함수를 사용하여 PDF 페이지 상의 QR 코드 배치 좌표를 정확히 지정할 수 있어 QR 코드의 정확한 위치를 보장합니다.

커티스 차우
기술 문서 작성자

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

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

시작할 준비 되셨나요?
Nuget 다운로드 67,270 | 버전: 2026.5 just released
Still Scrolling Icon

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

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