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

배경 출력 PDF는 어떻게 보입니까?

PDF 배경을 HTML로 만드는 이유는 무엇입니까?

배경을 추가하면 기존 콘텐츠 뒤에 이미지를 레이어하거나 문서 페이지를 추가할 수 있어 편지지, 색 채우기, 워터마크, 장식 디자인 요소가 가능합니다. 전경을 오버레이하면 주석, 스탬프 및 승인 표시 등에 유용합니다.

HTML 기반 접근 방식은 이미지 가져오기보다 몇 가지 구체적인 장점을 제공합니다:

• 정확한 CSS 제어: 배경 디자인을 정의하기 위해 모든 CSS 색상, 그라데이션, 이미지 또는 레이아웃 사용 가능.
• 페이지 크기 적응성: HTML에서 렌더링된 배경은 대상 PDF 페이지 크기에 자동으로 맞춰 스케일링됨.
• 동적 생성
• 경량 출력: CSS로 정의된 배경은 동등한 시각적 품질에서 래스터 이미지보다 작습니다.

이 기능은 회사 로고가 있는 양식 만들기 또는 맞춤 워터마크 추가에 적합합니다.

특정 페이지에 배경을 어떻게 추가합니까?

addBackgroundPdf 메서드는 지정한 페이지로만 작업을 제한하는 선택적 PageSelection 인수를 받습니다. 특정 페이지 집합을 대상으로 하려면 PageSelection.firstPage(), PageSelection.lastPage(), PageSelection.singlePage(int index) 또는 PageSelection.pageRange(int start, int end)을 사용하십시오. PageSelection에 대한 전체 문서는 IronPDF for Java API 레퍼런스에서 확인할 수 있습니다.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background-specific-page.java
import com.ironsoftware.IronPDF.*;
import com.ironsoftware.IronPDF.edit.PageSelection;
java.nio.file.Paths;를 가져옵니다.

// 대상 PDF를 로드합니다.
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

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

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

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

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-background-specific-page.java
import com.ironsoftware.IronPDF.*;
import com.ironsoftware.IronPDF.edit.PageSelection;
java.nio.file.Paths;를 가져옵니다.

// 대상 PDF를 로드합니다.
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

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

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

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

두 번째 인자(0)는 backgroundPdfPageIndex로, 소스로 사용할 배경 PDF의 페이지를 선택하는 0을 기준으로 한 인덱스입니다. 배경 템플릿에 여러 페이지 디자인이 포함된 경우, 이 매개변수는 대상 문서의 다른 섹션에 다른 디자인을 적용할 수 있게 합니다. 선택적 배경을 PDF 분할 및 병합 예제와 함께 사용하여 다단계 문서 조립 워크플로우를 구축하십시오.

PDF에 전경 오버레이를 어떻게 추가합니까?

addForegroundPdf 메서드는 기존 페이지 콘텐츠 위에 PDF 레이어를 합성합니다. 렌더링된 전경은 각 대상 페이지의 모든 기존 텍스트, 이미지 및 그래픽 위에 나타납니다. 이 메서드는 워터마크, 승인 스탬프 및 기반 콘텐츠에 상관없이 표시되어야 하는 수정 표시기에 대한 표준 접근 방식입니다. 작업 코드 샘플은 백그라운드 및 포그라운드 Java 예제를 참조하세요.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
java.nio.file.Paths;를 가져옵니다.

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// 대상 PDF를 로드합니다.
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a diagonal text stamp as the foreground layer
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to all pages
pdf.addForegroundPdf(전경);

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

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground.java
import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
java.nio.file.Paths;를 가져옵니다.

// Activate the license
License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

// 대상 PDF를 로드합니다.
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

// Render a diagonal text stamp as the foreground layer
PdfDocument foreground = PdfDocument.renderHtmlAsPdf(
    "<h1 style='transform: rotate(-45deg); opacity: 0.5;'>Foreground Example</h1>"
);

// Apply the foreground to all pages
pdf.addForegroundPdf(전경);

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

opacity CSS 속성은 투명도를 제어하여 전경 스탬프가 밑에 있는 콘텐츠를 완전히 가리지 않도록 합니다. transform: rotate() 속성은 대각선 방향을 적용하며, 이는 초안 및 기밀 워터마크의 표준입니다. 라이브러리는 모든 합성을 내부적으로 처리합니다; 수동 PDF 스트림 조작은 필요하지 않습니다.

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

addForegroundPdf 메서드는 PageSelection 인수를 addBackgroundPdf와 동일한 방식으로 받아들입니다. PageSelection.pageRange(int start, int end)을 사용하여 전경 영역을 연속된 범위로 제한하거나, List<Integer>을 전달하여 비연속적인 페이지를 대상으로 지정하십시오.

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground-page-range.java
import com.ironsoftware.IronPDF.*;
import com.ironsoftware.IronPDF.edit.PageSelection;
java.nio.file.Paths;를 가져옵니다.

// 대상 PDF를 로드합니다.
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

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

// Apply the foreground to pages 2 through 8 (zero-based index: 1 to 7)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

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

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/add-foreground-page-range.java
import com.ironsoftware.IronPDF.*;
import com.ironsoftware.IronPDF.edit.PageSelection;
java.nio.file.Paths;를 가져옵니다.

// 대상 PDF를 로드합니다.
PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));

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

// Apply the foreground to pages 2 through 8 (zero-based index: 1 to 7)
pdf.addForegroundPdf(foreground, PageSelection.pageRange(2, 8));

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

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/page-selection-patterns.java
import com.ironsoftware.IronPDF.*;
import com.ironsoftware.IronPDF.edit.PageSelection;
import java.util.ArrayList;
import java.util.List;
java.nio.file.Paths;를 가져옵니다.

PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='opacity: 0.4;'>DRAFT</h1>");
PdfDocument background1 = PdfDocument.fromFile(Paths.get("cover-background.pdf"));
PdfDocument background2 = PdfDocument.fromFile(Paths.get("end-background.pdf"));

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

// Apply different backgrounds to the first and last pages
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

// Apply foreground to all pages except the first and last
if (pdf.getPageCount() > 2) {
    pdf.addForegroundPdf(foreground, PageSelection.pageRange(1, pdf.getPageCount() - 2));
}

pdf.saveAs(Paths.get("selective-overlay.pdf"));

//:path=/static-assets/ironpdf-java/content-code-examples/how-to/background-foreground/page-selection-patterns.java
import com.ironsoftware.IronPDF.*;
import com.ironsoftware.IronPDF.edit.PageSelection;
import java.util.ArrayList;
import java.util.List;
java.nio.file.Paths;를 가져옵니다.

PdfDocument pdf = PdfDocument.fromFile(Paths.get("sample.pdf"));
PdfDocument foreground = PdfDocument.renderHtmlAsPdf("<h1 style='opacity: 0.4;'>DRAFT</h1>");
PdfDocument background1 = PdfDocument.fromFile(Paths.get("cover-background.pdf"));
PdfDocument background2 = PdfDocument.fromFile(Paths.get("end-background.pdf"));

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

// Apply different backgrounds to the first and last pages
pdf.addBackgroundPdf(background1, 0, PageSelection.firstPage());
pdf.addBackgroundPdf(background2, 0, PageSelection.lastPage());

// Apply foreground to all pages except the first and last
if (pdf.getPageCount() > 2) {
    pdf.addForegroundPdf(foreground, PageSelection.pageRange(1, pdf.getPageCount() - 2));
}

pdf.saveAs(Paths.get("selective-overlay.pdf"));

PageSelection 클래스는 어떤 메서드를 제공합니까?

PageSelection 클래스는 어떤 페이지에 배경 레이어나 전경 레이어가 적용될지 제어합니다. 모든 내장 팩토리 메서드는 PageSelection와 addBackgroundPdf, addForegroundPdf 모두에서 허용되는 PageSelection 객체를 반환합니다.

PDF에 백그라운드와 포그라운드를 추가하기 위한 다음 단계는 무엇인가요?

addBackgroundPdf 및 addForegroundPdf 메서드는 단순한 색상 채우기 및 워터마크부터 다중 템플릿 문서 조립 워크플로에 이르기까지 모든 PDF 오버레이 시나리오를 포괄합니다. PageSelection와 결합하여 섹션별로 다른 디자인을 적용하거나, 다른 PdfDocument 메서드와 연동하여 실제 환경에 바로 적용 가능한 문서 파이프라인을 구축할 수 있습니다. 텍스트 및 이미지 스탬프와 같은 추가 오버레이 기법은 텍스트 및 이미지 가이드 스탬프 또는 Java용 주석 예제를 탐색하세요.

프로젝트에서 이 기능들을 사용하려면 IronPDF for Java의 무료 체험을 시작하거나 상용 배포를 위한 라이선싱 옵션 보기를 클릭하세요. IronPDF는 Maven Central을 통해 제공되며, Windows, Linux, macOS에서 Java 8 이상을 지원합니다.

IronPDF로 무엇을 할 수 있는지 준비되셨습니까? 렌더링, 조작 및 내보내기 옵션에 대한 전체 과정을 확인하려면 Java용 HTML to PDF 튜토리얼을 탐색하세요.