Java에서 PDF에 사용자 지정 워터마크 적용하는 방법

텍스트 워터마크는 어떻게 생겼나요?

출력 파일 text_watermark.pdf에는 'Confidential'이라는 WORD가 빨간색으로 표시되어 있으며, 각 페이지의 가로 및 세로 중앙에 정렬되어 있습니다. 기본 불투명도 50%는 워터마크 아래에서 문서 내용을 읽을 수 있게 유지합니다. 여러 페이지로 구성된 문서의 경우, 각 페이지는 별도의 페이지 루프 없이 동일한 스탬프를 받습니다.

워터마크에 적용 가능한 HTML 렌더링 기술을 더 깊이 있게 알아보려면 HTML에서 PDF로 변환하는 튜토리얼을 참조하세요.

PDF에 이미지 워터마크를 어떻게 추가할 수 있나요?

이미지 워터마크는 HTML 문자열 내에 <img> 태그를 감싸는 동일한 applyWatermark 방식을 통해 작동합니다. 투명한 배경의 PNG 파일은 로고 워터마크에 적합합니다. 이미지가 PDF 페이지에 합성될 때 투명성이 유지되기 때문입니다. JPEG, GIF, SVG 및 BMP 형식도 지원됩니다.

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/image-watermark.java
import java.io.IOException;
import java.nio.file.Paths;

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

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

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

        // Reference the image file path relative to the runtime working directory
        String watermarkHtml = "<img src='logo.png' style='width:100px;'/>";

        // Apply the image watermark to all pages
        pdf.applyWatermark(watermarkHtml);

        // Save the result
        pdf.saveAs("image_watermark.pdf");
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/image-watermark.java
import java.io.IOException;
import java.nio.file.Paths;

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

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

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

        // Reference the image file path relative to the runtime working directory
        String watermarkHtml = "<img src='logo.png' style='width:100px;'/>";

        // Apply the image watermark to all pages
        pdf.applyWatermark(watermarkHtml);

        // Save the result
        pdf.saveAs("image_watermark.pdf");
    }
}

<img> 태그 내의 CSS 속성은 크기, 위치 및 투명도를 제어합니다:

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/image-watermark-advanced.java
// Apply a 150px logo at 50% opacity, rotated 45 degrees counterclockwise
String advancedWatermarkHtml =
    "<img src='logo.png' style='width:150px; opacity:0.5; transform:rotate(-45deg);'/>";

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/image-watermark-advanced.java
// Apply a 150px logo at 50% opacity, rotated 45 degrees counterclockwise
String advancedWatermarkHtml =
    "<img src='logo.png' style='width:150px; opacity:0.5; transform:rotate(-45deg);'/>";

이미지 경로는 런타임 시 JVM의 작업 디렉터리에서 접근 가능해야 합니다. 서버 배포 시 경로 확인 문제를 방지하려면 절대 경로를 사용하거나 src 속성 내에 Base64 데이터 URI로 이미지를 삽입하십시오.

워터마크의 불투명도와 정렬을 어떻게 제어할 수 있나요?

applyWatermark 메서드는 HTML 문자열 뒤에 불투명도 및 정렬 매개변수를 받아들입니다. 불투명도는 0(완전 투명)에서 100(완전 불투명) 사이의 정수입니다. 20에서 40 사이의 값은 대부분의 문서에 잘 맞으며, 워터마크가 본문 텍스트를 가리지 않으면서도 가시성을 유지합니다. VerticalAlignment 및 HorizontalAlignment 열거형은 워터마크가 페이지의 어느 모서리나 가장자리를 대상으로 할지 제어합니다.

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/watermark-opacity-alignment.java
import java.io.IOException;
import java.nio.file.Paths;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

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

        // Define the watermark HTML
        String watermarkHtml = "<h1 style='color:blue;'>Confidential</h1>";

        // Apply at 30% opacity, anchored to the top-left corner of each page
        pdf.applyWatermark(watermarkHtml, 30, VerticalAlignment.TOP, HorizontalAlignment.LEFT);

        // Save the result
        pdf.saveAs("watermark_opacity_alignment.pdf");
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/watermark-opacity-alignment.java
import java.io.IOException;
import java.nio.file.Paths;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

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

        // Define the watermark HTML
        String watermarkHtml = "<h1 style='color:blue;'>Confidential</h1>";

        // Apply at 30% opacity, anchored to the top-left corner of each page
        pdf.applyWatermark(watermarkHtml, 30, VerticalAlignment.TOP, HorizontalAlignment.LEFT);

        // Save the result
        pdf.saveAs("watermark_opacity_alignment.pdf");
    }
}

세 가지 선택적 매개변수를 결합하면 수직 및 수평 정렬의 교차점마다 하나씩 총 9가지 위치 옵션이 있습니다. 같은 페이지에 여러 위치에 워터마크를 나타내거나 특정 페이지 범위에만 워터마크를 적용해야 하는 경우, 스탬퍼 클래스가 더 세밀한 제어를 제공합니다. 배경 및 전경 가이드를 참조하여 레이어드 조합 기술을 확인하세요.

TextStamper 및 ImageStamper로 고급 워터마크를 어떻게 적용합니까?

applyWatermark 메서드는 대부분의 워터마킹 요구 사항을 처리하지만, 정확한 픽셀 좌표, 페이지 범위 지정 또는 동적 텍스트 생성이 필요한 경우 TextStamper 및 ImageStamper 클래스를 통해 프로그래밍 방식으로 제어할 수 있습니다. 두 클래스 모두 com.ironsoftware.ironpdf.stamp 패키지에 속합니다.

TextStamper는 문자열 값을 받아 글꼴, 글꼴 크기, 글꼴 색상, 수평 및 수직 정렬, 불투명도 등의 속성을 제공합니다. 또한 정수(도)로 회전도 지원합니다. ImageStamper은 이미지에 대한 파일 경로 또는 바이트 배열을 받아들이며, TextStamper과 동일한 정렬 및 불투명도 제어 기능을 제공합니다.

applyWatermark에 비해 스탬퍼 클래스의 주요 장점은 특정 페이지를 대상으로 지정할 수 있다는 점입니다. stamp 메서드에 0부터 시작하는 페이지 번호 목록을 전달하면, 워터마크가 필요한 페이지에만 적용할 수 있습니다. 예를 들어, 보고서의 표지나 계약서의 최종 승인 페이지에만 워터마크를 찍는 경우입니다.

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/text-stamper.java
import java.io.IOException;
import java.nio.file.Paths;
import java.util.Arrays;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.TextStamper;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

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

        // Configure a TextStamper with custom font, rotation, and opacity
        TextStamper stamper = new TextStamper();
        stamper.setText("DRAFT");
        stamper.setFontSize(72);
        stamper.setFontColor("gray");
        stamper.setOpacity(40);
        stamper.setRotation(45);
        stamper.setVerticalAlignment(VerticalAlignment.MIDDLE);
        stamper.setHorizontalAlignment(HorizontalAlignment.CENTER);

        // Apply the stamp only to pages 0 and 1 (zero-indexed)
        pdf.stamp(stamper, Arrays.asList(0, 1));

        // Save the stamped PDF
        pdf.saveAs("text_stamped.pdf");
    }
}

//:path=/static-assets/pdf/content-code-examples/how-to/custom-watermark/text-stamper.java
import java.io.IOException;
import java.nio.file.Paths;
import java.util.Arrays;

import com.ironsoftware.ironpdf.License;
import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.stamp.HorizontalAlignment;
import com.ironsoftware.ironpdf.stamp.TextStamper;
import com.ironsoftware.ironpdf.stamp.VerticalAlignment;

public class Main {
    public static void main(String[] args) throws IOException {
        // Set the license key for IronPDF
        License.setLicenseKey("IRONPDF-MYLICENSE-KEY-1EF01");

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

        // Configure a TextStamper with custom font, rotation, and opacity
        TextStamper stamper = new TextStamper();
        stamper.setText("DRAFT");
        stamper.setFontSize(72);
        stamper.setFontColor("gray");
        stamper.setOpacity(40);
        stamper.setRotation(45);
        stamper.setVerticalAlignment(VerticalAlignment.MIDDLE);
        stamper.setHorizontalAlignment(HorizontalAlignment.CENTER);

        // Apply the stamp only to pages 0 and 1 (zero-indexed)
        pdf.stamp(stamper, Arrays.asList(0, 1));

        // Save the stamped PDF
        pdf.saveAs("text_stamped.pdf");
    }
}

stamp 메서드는 0을 기점으로 한 페이지 번호 배열(List<Integer>)을 받아, 워터마크가 적용될 페이지를 정밀하게 제어할 수 있게 합니다. 페이지 목록이 제공되지 않은 경우, 스탬프는 모든 페이지에 적용됩니다. 따라서 생성된 각 PDF에 고유한 트랜잭션 ID, 사용자 이름 또는 타임스탬프를 삽입하는 등 애플리케이션에서 워터마크를 동적으로 생성해야 할 때 TextStamper이 최적의 선택입니다.

수백 개의 PDF에 고객별 고유 워터마크를 일괄적으로 삽입하는 등의 일괄 처리를 수행하려면, 루프 내에서 각 PdfDocument을 불러와 워터마크를 삽입한 후, 다음 반복 전에 saveAs을 호출하십시오. IronPDF는 각 문서를 독립적으로 처리하므로 메모리 사용이 일정하게 유지됩니다. Java PDF 스탬프 가이드에서는 ImageStamper 및 추가 스탬프 옵션을 상세히 다루고 있으며, IronPDF Java 문서에서는 전체 API 레퍼런스 정보를 제공합니다.

Java에서 PDF 워터마킹을 위한 다음 단계는 무엇입니까?

이 가이드에서는 IronPDF for Java를 사용하여 PDF에 워터마크를 삽입하는 네 가지 방법을 다루었습니다: applyWatermark을 통한 간단한 텍스트 워터마크, HTML <img> 태그를 활용한 이미지 워터마크, 메서드 매개변수를 통한 불투명도 및 정렬 제어, 그리고 고급 사용 사례를 위한 TextStamper 및 ImageStamper을 이용한 프로그래밍 방식의 스탬핑 등 네 가지 방법을 다루었습니다.

무료 체험을 시작하세요 당신의 Java 애플리케이션에서 워터마킹을 테스트하기 위해. 체험에는 평가에 시간 제한이 없는 모든 스탬프 및 워터마킹 기능에 대한 전체 액세스가 포함됩니다. 배포할 준비가 되면, 라이선스 옵션을 확인하여 귀하의 사용에 맞는 등급을 찾으십시오.

당신이 할 수 있는 다른 일들을 알아볼 준비가 되셨나요? 전체 튜토리얼 페이지를 여기서 확인하세요: IronPDF for Java 사용 가이드