Java를 사용하여 PDF에 배경 및 오버레이 전경을 추가하는 방법

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF for Java를 사용하면 addBackgroundPdfaddForegroundPdf 메서드를 사용하여 PDF에 배경을 추가하고 전경을 오버레이할 수 있으므로 기존 PDF 콘텐츠 뒤 또는 위에 이미지, 워터마크 또는 디자인 요소를 삽입할 수 있습니다.

빠른 시작: PDF에 배경 및 전경 추가

```java :title=빠른 시작 com.ironsoftware.ironpdf.*를 가져옵니다. import com.ironsoftware.ironpdf.edit.PageSelection; import java.nio.file.Paths;

// 1. Maven을 사용하거나 수동으로 IronPDF for Java를 설치합니다. // 2. PdfDocument.fromFile()을 사용하여 대상 PDF 파일을 가져옵니다. PdfDocument pdf = PdfDocument.fromFile(Paths.get("document.pdf"));

// 3. PdfDocument.renderHtmlAsPdf()를 사용하여 배경/전경 PDF를 생성합니다. PdfDocument background = PdfDocument.renderHtmlAsPdf(" "); PdfDocument foreground = PdfDocument.renderHtmlAsPdf("");

// 4. pdf.addBackgroundPdf(background)를 사용하여 배경을 적용합니다. pdf.addBackgroundPdf(background);

// 5. pdf.addForegroundPdf(foreground)를 사용하여 전경색을 적용합니다. pdf.addForegroundPdf(foreground);

pdf.saveAs(Paths.get("output.pdf"));


<div class="hsg-featured-snippet">  
## Java를 사용하여 PDF에 배경 및 오버레이 전경을 추가하는 방법
  <ol>
    <li><a class="js-modal-open" data-modal-id="download-modal" href="#download-modal">배경과 전경을 추가하는 Java 라이브러리를 설치하세요.</a></li>
    <li>대상 PDF 파일을 가져옵니다.</li>
    <li>배경 또는 전경을 렌더링하거나 가져옵니다.</li>
    <li>Use the `addBackgroundPdf` method to add the background</li>
    <li>Use the `addForegroundPdf` method to add the foreground</li>
  </ol>
</div>

## PDF에 배경을 추가하는 방법은 무엇인가요?

기존 또는 새로 렌더링된 PDF에 배경을 추가하려면 `addBackgroundPdf` 메서드를 사용하십시오. 이 예제는 PDF 파일을 가져오고, 배경을 렌더링하고, 이를 PDF에 적용하는 방법을 보여줍니다. 시작하기 전에 [라이선스 키를 사용하여 IronPDF를 설정](https://ironpdf.com/java/get-started/license-keys/) 했는지 확인하십시오.

```java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for using IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the target PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a background PDF from HTML content
PdfDocument background = PdfDocument.renderHtmlAsPdf("<body style='background-color: cyan;'></body>");

// Add the rendered background to all pages of the target PDF
pdf.addBackgroundPdf(background);

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("addBackground.pdf"));

좀 더 복잡한 HTML 배경을 만들려면 사용자 지정 글꼴과 CSS 스타일을 사용하여 전문적인 문서를 만들 수 있습니다. HTML 렌더링 엔진은 최신 CSS 속성을 지원하므로 그라데이션 배경, 패턴 또는 배경 이미지를 쉽게 만들 수 있습니다.

생성된 PDF 파일은 어떤 모습인가요?

생성된 PDF 파일의 내용은 다음과 같습니다.

배경 이미지를 만들 때 HTML을 사용하는 이유는 무엇일까요?

PDF에 배경을 추가하면 기존 콘텐츠 뒤에 이미지나 다른 PDF 문서를 삽입하여 레터헤드, 워터마크 또는 디자인 요소와 같은 요소로 콘텐츠를 향상시킬 수 있습니다. 전경 오버레이 기능을 사용하면 주석, 스탬프 또는 서명과 같은 추가 콘텐츠를 PDF 위에 배치할 수 있습니다.

IronPDF for Java는 이 두 가지 목표를 달성하기 위한 간단한 방법을 제공합니다. 렌더링된 PDF 또는 기존 PDF를 배경이나 전경 오버레이로 사용할 수 있으며, 모든 페이지 또는 특정 페이지에 변경 사항을 적용할 수 있는 유연성을 제공합니다. 이 가이드는 Java 기반의 IronPDF를 사용하여 배경을 추가하고 전경을 오버레이하는 방법을 보여줍니다. 이 기능은 회사 레터헤드가 포함된 양식을 만들 거나 문서에 사용자 지정 워터마크를 추가 해야 할 때 유용합니다.

HTML을 PDF로 변환하는 방식은 다음과 같은 몇 가지 장점을 제공합니다.

  • 유연성 : CSS를 사용하여 정밀한 스타일링 및 위치 지정을 구현하세요.
  • 반응형 디자인 : 다양한 페이지 크기에 맞춰 자동으로 조정되는 배경을 만드세요
  • 동적 콘텐츠 : 데이터를 기반으로 배경 이미지를 프로그래밍 방식으로 생성합니다.
  • 리소스 효율성 : 이미지 기반 배경보다 가볍습니다.

특정 페이지에 배경을 추가하려면 어떻게 해야 하나요?

동일한 addBackgroundPdf 방법을 사용하면 선택한 페이지에 배경을 추가할 수 있습니다. 이 기능은 표지나 특정 브랜드 레이아웃과 같은 맞춤 디자인을 적용하는 데 유용합니다. PageSelection 클래스는 필수이며 allPages, singlePage, pageRange 등과 같은 유용한 메서드를 포함합니다. 페이지 조작에 대한 자세한 내용은 API 참조를 참조하십시오.

com.ironsoftware.ironpdf.*를 가져옵니다.
import com.ironsoftware.ironpdf.edit.PageSelection;

// Load the target PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Load the background PDF from a file
PdfDocument background = PdfDocument.fromFile(Paths.get("background.pdf"));

// Add the first page of the background PDF to the first page of the target PDF
pdf.addBackgroundPdf(background, 0, PageSelection.firstPage());

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));
com.ironsoftware.ironpdf.*를 가져옵니다.
import com.ironsoftware.ironpdf.edit.PageSelection;

// Load the target PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Load the background PDF from a file
PdfDocument background = PdfDocument.fromFile(Paths.get("background.pdf"));

// Add the first page of the background PDF to the first page of the target PDF
pdf.addBackgroundPdf(background, 0, PageSelection.firstPage());

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("addBackgroundToSpecificPage.pdf"));
JAVA

이 기술을 PDF 병합 이나 PDF 분할 과 같은 다른 PDF 작업과 결합하여 복잡한 문서 워크플로를 만들 수 있습니다.

backgroundPdfPageIndex 매개변수는 무엇입니까?

backgroundPdfPageIndex 매개변수는 배경으로 사용할 배경 PDF의 페이지를 지정합니다. 이 매개변수는 0부터 시작하는 인덱스를 사용하여 배경/전경 PDF에서 복사할 페이지를 지정하며, 기본값은 0입니다. 이 기능은 여러 페이지로 구성된 배경 템플릿이 있고 문서의 각 부분에 서로 다른 배경 디자인을 적용하려는 경우에 유용합니다.

특정 페이지에 배경을 적용해야 하는 경우는 언제인가요?

특정 페이지에 배경을 적용하는 것은 여러 상황에서 유용합니다.

  • 표지 : 첫 페이지에만 브랜드 배경을 추가하세요
  • 장 구분선 : 각 장 시작 부분에 장식적인 배경을 적용합니다.
  • 법률 문서 : 인증이 필요한 페이지에 공식 레터헤드를 추가하세요
  • 보고서 : 요약 보고서와 상세 내용 부분에 서로 다른 배경을 적용하세요.
  • 마케팅 자료 : 제품 섹션별로 다양한 배경을 사용하세요

페이지별 배경 이미지를 사용할 때는, 특히 고품질 배경 이미지를 사용하는 경우, 최종 PDF 파일 크기를 최적화하기 위해 압축하는 것을 고려하십시오.


PDF에 전경색을 추가하는 방법은 무엇인가요?

addForegroundPdf 메서드는 PDF의 기존 페이지 위에 콘텐츠를 겹쳐 표시합니다. 이는 워터마크나 시각적 표시기와 같은 요소를 추가하는 데 유용합니다. 배경 부분과 마찬가지로 전경을 렌더링하고 PDF 문서에 적용합니다. 콘텐츠 겹치기의 더 많은 예시를 보려면 배경 및 전경 코드 예제를 확인하세요.

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for using IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the target PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render the foreground content from HTML
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>");

// Add the rendered foreground to all pages of the PDF
pdf.addForegroundPdf(foreground);

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("overlayForeground.pdf"));
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;

// Set the license key for using IronPDF
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// Load the target PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render the foreground content from HTML
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>");

// Add the rendered foreground to all pages of the PDF
pdf.addForegroundPdf(foreground);

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("overlayForeground.pdf"));
JAVA

전경 출력은 어떤 모습인가요?

출력된 PDF 파일은 다음과 같습니다.

배경 대신 전경 오버레이를 사용하는 이유는 무엇일까요?

전경 오버레이는 배경과는 다른 용도로 사용되며 다음과 같은 경우에 적합합니다.

  • 워터마크 : "기밀", "초안" 또는 회사 로고를 추가하세요.
  • 주석 : 검토 의견 또는 승인 스탬프를 겹쳐 표시할 수 있습니다.
  • 보안 기능 : 고유 식별자 또는 추적 코드 추가
  • 시각적 표시 : 만료된 문서 또는 특별 공지 사항을 강조 표시합니다.
  • 브랜딩 : 회사 인장 또는 인증 마크를 부착하세요

배경과 달리 전경은 기존 콘텐츠 위에 나타나므로 아래 문서를 가리지 않고 정보를 추가하는 데 적합합니다. 이 기법은 PDF 양식 에 상태 표시기나 승인 도장을 겹쳐 표시해야 할 때 유용합니다.

특정 페이지에 전경색을 추가하려면 어떻게 해야 하나요?

PageSelection.pageRange 메서드를 사용하면 특정 페이지 범위에 전경 이미지를 겹쳐 표시할 수 있습니다. 다음은 2페이지부터 8페이지까지 전경색을 적용하는 방법입니다.

com.ironsoftware.ironpdf.*를 가져옵니다.
import com.ironsoftware.ironpdf.edit.PageSelection;

// Load the target PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render the foreground content from HTML
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>");

// Add the foreground to a specific page range (from page 2 to page 8)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("overlayForeground.pdf"));
com.ironsoftware.ironpdf.*를 가져옵니다.
import com.ironsoftware.ironpdf.edit.PageSelection;

// Load the target PDF file
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render the foreground content from HTML
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>");

// Add the foreground to a specific page range (from page 2 to page 8)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

// Save the modified PDF with a new name
pdf.saveAs(Paths.get("overlayForeground.pdf"));
JAVA

전경색에 페이지 범위를 사용해야 하는 경우는 언제인가요?

전경색의 페이지 범위를 지정하는 것은 다음과 같은 경우에 유용합니다.

  • 문서 섹션 : 특정 장이나 섹션에만 워터마크를 적용합니다.
  • 버전 관리 : 업데이트된 페이지에만 수정 스탬프를 표시합니다.
  • 조건부 서식 : 콘텐츠 유형에 따라 다른 서식을 적용합니다.
  • 단계적 정보 공개 : 민감한 부분에만 "기밀" 스탬프를 추가하세요.
  • 다국어 문서 : 관련 페이지에 언어별 오버레이를 적용합니다.

선택적 포그라운드 애플리케이션의 일반적인 사용 사례는 무엇입니까?

선택적 포그라운드 애플리케이션은 다양한 시나리오에서 문서 관리를 향상시킵니다.

  1. Contract Management: 만료된 계약서 페이지에 "무효" 도장을 찍으십시오.
  2. Educational Materials: 특정 연습 문제 페이지에 정답을 오버레이로 추가합니다.
  3. Medical Records: 관련 양식에 환자 동의 도장을 겹쳐 찍으십시오.
  4. Financial Reports: 검증된 섹션에 감사 승인 스탬프 추가
  5. Technical Documentation: 업데이트된 페이지에 개정 번호 오버레이

이러한 사용 사례를 구현할 때 사용자가 오버레이된 섹션으로 빠르게 이동할 수 있도록 add bookmarks를 추가하는 것도 고려해 볼 수 있습니다.


PageSelection 클래스는 어떤 메서드를 제공하나요?

전경과 배경을 다룰 때 IronPDF는 PageSelection 클래스의 메서드를 사용하여 페이지를 지정하는 유연한 방법을 제공합니다. 다음은 선택 사항입니다.

  • firstPage(): PDF의 첫 페이지에 변경 사항을 적용합니다.
  • lastPage(): PDF의 마지막 페이지에 변경 사항을 적용합니다.
  • singlePage(int index): 인덱스(0부터 시작)를 기준으로 특정 페이지를 대상으로 지정합니다.
  • pageRange(int startIndex, int endIndex): startIndex부터 endIndex까지(포함)의 페이지 범위를 대상으로 합니다.
  • pageRange(List<Integer> pageList): Applies changes to a list of specific pages, allowing non-sequential selections

올바른 페이지 선택 방법을 어떻게 선택해야 할까요?

적절한 PageSelection 방법을 선택하는 것은 문서 구조 및 요구 사항에 따라 다릅니다.

  • 표지, 제목 페이지 또는 소개 워터마크에는 firstPage()를 사용하십시오.
  • 결론 페이지, 서명 또는 문서 끝 부분에는 lastPage()를 사용하십시오.
  • 인증서나 양식과 같은 특정 페이지를 대상으로 지정할 때는 singlePage()를 사용하세요.
  • 장이나 부록과 같은 연속된 섹션에는 pageRange(start, end)를 사용하십시오.
  • 짝수 페이지나 특정 선택 영역과 같이 순차적이지 않은 페이지에는 pageRange(List)를 사용하십시오.

일반적인 페이지 선택 패턴은 무엇인가요?

다음은 PageSelection를 효과적으로 사용하는 실용적인 패턴입니다.

// Apply to all even pages
List<Integer> evenPages = new ArrayList<>();
for (int i = 1; i < pdf.getPageCount(); i += 2) {
    evenPages.add(i);
}
pdf.addForegroundPdf(foreground, PageSelection.pageRange(evenPages));

// Apply to first and last page only
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

// Apply to middle section (excluding first and last pages)
if (pdf.getPageCount() > 2) {
    pdf.addForegroundPdf(foreground, PageSelection.pageRange(1, pdf.getPageCount() - 2));
}
// Apply to all even pages
List<Integer> evenPages = new ArrayList<>();
for (int i = 1; i < pdf.getPageCount(); i += 2) {
    evenPages.add(i);
}
pdf.addForegroundPdf(foreground, PageSelection.pageRange(evenPages));

// Apply to first and last page only
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

// Apply to middle section (excluding first and last pages)
if (pdf.getPageCount() > 2) {
    pdf.addForegroundPdf(foreground, PageSelection.pageRange(1, pdf.getPageCount() - 2));
}
JAVA

보다 고급 PDF 조작 기술을 배우려면 추가 렌더링 옵션 및 모범 사례를 다루는 포괄적인 HTML to PDF 튜토리얼을 참조하십시오.

자주 묻는 질문

자바에서 기존 PDF에 배경을 추가하는 방법은 무엇인가요?

IronPDF의 addBackgroundPdf 메서드를 사용하여 기존 PDF에 배경을 추가할 수 있습니다. 먼저 PdfDocument.fromFile()을 사용하여 대상 PDF를 불러온 다음, PdfDocument.renderHtmlAsPdf()를 사용하여 원하는 HTML/CSS 콘텐츠로 배경 PDF를 생성하고, 마지막으로 pdf.addBackgroundPdf(background)를 사용하여 적용합니다.

addBackgroundPdf 메서드와 addForegroundPdf 메서드의 차이점은 무엇인가요?

IronPDF의 addBackgroundPdf 메서드는 기존 PDF 콘텐츠 뒤에 콘텐츠를 배치하여 워터마크나 배경 이미지에 활용할 수 있습니다. addForegroundPdf 메서드는 기존 PDF 콘텐츠 위에 콘텐츠를 겹쳐 표시하여 스탬프, 주석 또는 '초안'이나 '기밀'과 같은 텍스트를 추가하는 데 적합합니다.

HTML과 CSS를 사용하여 PDF에 사용자 지정 배경을 만들 수 있나요?

네, IronPDF의 HTML 렌더링 엔진은 최신 CSS 속성을 지원하므로 HTML/CSS를 사용하여 복잡한 배경을 만들 수 있습니다. PdfDocument.renderHtmlAsPdf() 메서드를 통해 그라데이션 배경, 패턴, 배경 이미지, 사용자 지정 글꼴 및 CSS 스타일을 사용할 수 있습니다.

PDF 파일의 특정 페이지에 워터마크를 추가하려면 어떻게 해야 하나요?

IronPDF는 addBackgroundPdf 또는 addForegroundPdf 메서드의 PageSelection 매개변수를 사용하여 특정 페이지에 워터마크를 추가할 수 있도록 합니다. PDF 문서에 배경이나 전경을 적용할 때 개별 페이지, 페이지 범위 또는 모든 페이지를 대상으로 지정할 수 있습니다.

PDF 배경 및 전경 이미지에 사용할 수 있는 파일 형식은 무엇인가요?

IronPDF를 사용하면 PdfDocument.fromFile() 메서드를 통해 기존 PDF 파일을 불러와 배경/전경으로 활용하거나, PdfDocument.renderHtmlAsPdf() 메서드를 사용하여 HTML 콘텐츠에서 새 PDF 파일을 생성할 수 있습니다. HTML 렌더링 기능은 HTML/CSS 코드에 포함된 PNG, JPEG, GIF 등의 일반적인 이미지 형식을 지원합니다.

PDF에 배경과 전경을 추가하려면 라이선스가 필요한가요?

네, PDF에 배경이나 전경을 추가하기 전에 License.setLicenseKey()를 사용하여 IronPDF에 유효한 라이선스 키를 설정해야 합니다. 이 라이브러리는 실제 사용 환경에서 사용하려면 적절한 라이선스가 필요하며, 테스트 목적으로 평가판 라이선스를 사용할 수 있습니다.

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

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

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

시작할 준비 되셨나요?
버전: 2026.2 방금 출시되었습니다