JavaでPDFに背景とオーバーレイ前景を追加する方法

バックグラウンド出力PDFはどのように見えますか？

なぜHTMLを使用してPDFのバックグラウンドを作成するのですか？

バックグラウンドを追加すると、既存のコンテンツの背後に画像や文書ページがレイヤ化され、レターヘッド、カラーフィル、ウォーターマーク、および装飾デザイン要素が可能になります。 フォアグラウンドをオーバーレイすると、コンテンツが上に配置され、注釈、スタンプ、および承認インジケータに役立ちます。

HTMLベースのアプローチは、画像インポートより具体的な利点を提供します。

• 正確なCSS制御：CSSカラ、グラデーション、画像、またはレイアウトを使用してバックグラウンドデザインを定義できます。
• ページサイズ適応：HTMLからレンダリングされたバックグラウンドは、ターゲットPDFページの寸法に自動的にスケールします。
• 動的生成：データ、ユーザープリファレンス、またはテンプレートロジックからプログラム的にバックグラウンドを構築できます。
• 軽量な出力：CSSで定義されたバックグラウンドは、同等のビジュアルクオリティでラスター画像よりも小さいです。

会社のレターヘッドを使用してフォームを作成するか、法的および財務書類にカスタムウォーターマークを追加するためにこの機能が適しています。

特定のページにバックグラウンドを追加するにはどうすればよいですか？

addBackgroundPdf メソッドは、指定したページに操作を限定するオプションの PageSelection 引数を受け付けます。 特定のページ群を対象とする場合は、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
インポート com.ironsoftware.ironPdf.*；
インポート 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
インポート com.ironsoftware.ironPdf.*；
インポート 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"));

2番目の引数 (0) は backgroundPdfPageIndex であり、これは背景のPDFのどのページをソースとして使用するかを指定する0から始まるインデックスです。 バックグラウンドテンプレートに複数のページデザインが含まれている場合、このパラメータを使用してターゲットドキュメントのさまざまなセクションに異なるデザインを適用できます。 PDF分割およびマージの例と選択的なバックグラウンドを組み合わせて、マルチステージの文書組み立てワークフローを構築します。

どのようにしてPDFにフォアグラウンドオーバーレイを追加しますか？

addForegroundPdf メソッドは、既存のページコンテンツの上に PDF レイヤーを合成します。 レンダリングされたフォアグラウンドは、各ターゲットページのすべての既存のテキスト、画像、およびグラフィックの上に表示されます。 このメソッドは、基礎の内容に関係なく表示され続ける必要があるウォーターマーク、承認スタンプ、および改訂インジケータの標準的なアプローチです。 動作するコードサンプルについては、背景とフォールグラウンド for 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(foreground)；

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(foreground)；

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

opacity CSSプロパティは透明度を制御するため、前景色で描画されたスタンプが下にあるコンテンツを完全に隠してしまうことはありません。 transform: rotate() プロパティは斜め方向の配置を適用します。これは、ドラフトや機密の透かしにおける標準的な設定です。 このライブラリはすべての合成を内部的に処理します； 手動でのPDFストリーム操作は必要ありません。

特定のページにフォアグラウンドを追加するにはどうすればよいですか？

addForegroundPdf メソッドは、addBackgroundPdf と同様に PageSelection 引数を受け取ります。 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
インポート com.ironsoftware.ironPdf.*；
インポート 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
インポート com.ironsoftware.ironPdf.*；
インポート 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
インポート com.ironsoftware.ironPdf.*；
インポート 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
インポート com.ironsoftware.ironPdf.*；
インポート 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 クラスは、どのページに背景レイヤーまたは前景レイヤーを適用するかを制御します。 すべての組み込みファクトリメソッドは、addForegroundPdfオブジェクトを返します。

PDFへの背景と前景の追加の次のステップは何ですか?

addBackgroundPdf および addForegroundPdf メソッドは、単純な色塗りや透かしから、複数のテンプレートを用いたドキュメント作成ワークフローに至るまで、PDF オーバーレイのあらゆるシナリオを網羅しています。 これらを PageSelection と組み合わせてセクションごとに異なるデザインを適用したり、他の PdfDocument メソッドと連鎖させて、本番環境向けのドキュメントパイプラインを構築したりできます。 テキストや画像スタンプなどの追加のオーバーレイ技術については、テキストと画像のスタンプガイドまたはJava用注釈例を探索してください。

プロジェクトでこれらの機能を使用するには、IronPDF for Javaの無料トライアルを開始するか、商業展開のライセンスオプションを表示してください。 IronPDFはMaven Central経由で入手可能で、Java 8以降をWindows、Linux、macOSでサポートします。

IronPDFの他の機能をご覧になりたいですか？ Java用の完全なHTMLからPDFへのチュートリアルを参照して、レンダリング、操作、エクスポートオプションの全体のウォークスルーを行ってください。