C#을 사용하여 PDF에 텍스트 및 비트맵을 그리는 방법

좌표계 이해하기

텍스트를 입력하기 전에 PDF 좌표계를 이해하십시오. 원점(0,0)은 페이지의 왼쪽 아래 모서리에 위치하며 X 값은 오른쪽으로 갈수록 증가하고 Y 값은 위쪽으로 갈수록 증가합니다. 이는 원점이 왼쪽 상단에 있는 많은 그래픽 시스템과는 다릅니다.

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-text.cs

using IronPdf;
using IronSoftware.Drawing;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Draw text on PDF
pdf.DrawText("Some text", FontTypes.TimesNewRoman.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 100, Color.Black, Rotation: 0);

pdf.SaveAs("drawText.pdf");

어떤 글꼴을 사용할 수 있나요?

현재 DrawText 메서드는 Courier, Arial(또는 Helvetica), @@ -- CODE-661--@@, Symbol 및 ZapfDingbats를 포함한 IronPDF의 모든 표준 글꼴을 지원합니다. IronPDF의 표준 글꼴에 대한 자세한 내용은 글꼴 관리 문서의 ' IronPDF의 표준 글꼴 ' 섹션을 참조하십시오.

ZapfDingbats 글꼴은 ▲와 같은 기호를 표시할 수 있습니다. 지원되는 기호의 전체 목록을 보려면 위키백과 Zapf Dingbats 항목을 참조하세요.

PDF에 출력되는 글꼴 샘플

줄 바꿈이 포함된 텍스트를 추가하려면 어떻게 해야 하나요?

텍스트 그리기 작업은 줄 바꿈 문자를 지원하므로 서식 지정 및 시각적 명확성을 높이기 위해 내장된 줄 바꿈을 사용하여 텍스트를 렌더링할 수 있습니다. 이 기능은 여러 줄로 된 주석을 추가하거나 구조화된 텍스트 레이아웃을 만들 때 유용합니다.

이를 위해서는 텍스트 문자열에 newline characters (\n)를 추가하십시오. 위의 예시를 사용하면 다음과 같습니다.

// Multi-line text example with proper spacing
string textWithNewlines = "Some text\nSecond line\nThird line with more content";
pdfDoc.DrawText(textWithNewlines, font, position);

// You can also use Environment.NewLine for platform-specific line breaks
string platformText = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3";
pdfDoc.DrawText(platformText, font, position);

// Multi-line text example with proper spacing
string textWithNewlines = "Some text\nSecond line\nThird line with more content";
pdfDoc.DrawText(textWithNewlines, font, position);

// You can also use Environment.NewLine for platform-specific line breaks
string platformText = $"Line 1{Environment.NewLine}Line 2{Environment.NewLine}Line 3";
pdfDoc.DrawText(platformText, font, position);

사용자 지정 글꼴은 어떻게 사용하나요?

사용자 지정 글꼴은 DrawText 방식을 통해 지원되므로 표준 글꼴 외에도 다양한 타이포그래피 옵션을 활용할 수 있습니다. 이 기능은 브랜드 일관성을 유지하거나 특수 글꼴을 사용할 때 필수적입니다. 고급 글꼴 관리에 대해서는 PDF에서 글꼴 관리하기 가이드를 참조하세요.

아래는 Pixelify Sans 글꼴을 텍스트에 적용한 예시입니다.

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-custom-font.cs

using IronPdf;
using IronSoftware.Drawing;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Add custom font to the PDF
byte[] fontByte = File.ReadAllBytes(@".\PixelifySans-VariableFont_wght.ttf");
var addedFont = pdf.Fonts.Add(fontByte);

// Draw text on PDF
pdf.DrawText("Iron Software", addedFont.Name, FontSize: 12, PageIndex: 0, X: 100, Y: 600, Color.Black, Rotation: 0);

pdf.SaveAs("drawCustomFont.pdf");

고급 텍스트 위치 지정

텍스트를 정확하게 배치할 때는 다음 팁을 참고하세요.

• 페이지 크기 : 페이지 크기를 얻으려면 pdf.Pages[pageIndex].Width 및 pdf.Pages[pageIndex].Height를 사용하십시오.
• 회전 : 회전 매개변수는 기울어진 텍스트에 대해 도 단위(0~360도)의 값을 허용합니다.
• 색상 옵션 : 기본 색상 외에 RGB 값을 사용하세요: Color.FromArgb(255, 100, 100)

IronPDF의 DrawBitmap 메서드를 사용하면 기존 PDF 문서에 비트맵을 추가할 수 있습니다. 이 방법은 이미지 스탬퍼 기능과 유사하게 작동하며, 기존 PDF에 이미지를 삽입할 수 있도록 해줍니다. 복잡한 이미지 편집이 필요한 경우, PDF에 이미지를 추가하는 방법 에 대한 가이드를 참조하세요.

[{i:(DrawBitmap 방법은 큰 이미지에 가장 적합합니다. 해상도가 낮은 이미지를 사용할 때 다음과 같은 예외가 발생할 수 있습니다. IronPdf.Exceptions.IronPdfNativeException: '이미지 그리기 중 오류: 데이터 길이(567000)가 예상(756000)보다 작습니다.' 이 문제를 해결하려면 모든 크기의 이미지를 처리하는 이미지 스탬퍼를 사용하십시오.

샘플 이미지

구현 방식은 어떻게 되나요?

:path=/static-assets/pdf/content-code-examples/how-to/draw-text-and-bitmap-draw-bitmap.cs

using IronPdf;
using IronSoftware.Drawing;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Open the image from file
AnyBitmap bitmap = AnyBitmap.FromFile("ironSoftware.png");

// Draw the bitmp on PDF
pdf.DrawBitmap(bitmap, 0, 50, 250, 500, 300);

pdf.SaveAs("drawImage.pdf");

PDF 출력

추가로 사용할 수 있는 매개변수는 무엇입니까?

• PixelFormat : PixelFormat 속성은 비트맵의 색상 데이터 형식을 지정하며, 주로 투명도 지원을 제어합니다. 기본값은 Format32bppArgb입니다. 매개변수를 옵션으로 전달하여 픽셀 열거형 형식 Format32bppRgb 및 Format32bppArgb 중에서 선택하십시오. 이 기능은 PDF에서 배경 및 전경 요소를 다룰 때 유용합니다.

• IgnorePageRotation : 이 속성은 비트맵을 그릴 때 페이지 회전을 무시할지 여부를 결정합니다. 기본값은 false입니다. 특히 페이지 회전 여부와 관계없이 모든 페이지에 워터마크를 일관되게 적용할 때 유용합니다.

일반적인 사용 사례 및 모범 사례

PDF에 텍스트와 이미지를 그릴 때 다음과 같은 실용적인 활용법을 고려해 보세요.

1. 동적 워터마킹 : 중요한 문서에 회사 로고 또는 "기밀" 스탬프를 추가합니다.
2. 페이지 번호 매기기 : 모든 페이지에 걸쳐 일관된 위치에 페이지 번호를 기입하십시오.
3. 서명 배치 : 양식의 지정된 위치에 서명 이미지를 추가합니다.
4. 헤더/푸터 개선 : 기존 헤더에 동적 콘텐츠를 추가합니다.

PDF 작업의 디버깅 및 모니터링을 위해, 그리기 작업을 추적하고 올바른 실행을 보장하기 위해 사용자 지정 로깅을 구현하십시오.

성능 고려 사항

여러 페이지 또는 대용량 문서를 작업할 때:

• 가능한 경우 일괄 처리를 통해 메모리 사용량을 최소화합니다.
• 사용 후 비트맵 객체를 폐기하여 리소스를 해제하십시오.
• 성능 향상을 위해 자주 사용하는 이미지를 미리 로드하는 것을 고려해 보세요.

당신이 할 수 있는 다른 일들을 알아볼 준비가 되셨나요? PDF 편집 방법 튜토리얼 페이지는 여기에서 확인하세요.