La marca de agua es una técnica común utilizada para proteger la autenticidad y la propiedad de los documentos digitales. Este artículo explorará cómo agregar marcas de agua a archivos PDF utilizando IronPDF, una poderosa biblioteca para Java. Con IronPDF, puedes incorporar fácilmente marcas de agua en tus documentos PDF de manera programática, asegurando su seguridad y branding. Profundicemos en el proceso paso a paso de agregar marcas de agua en Java usando IronPDF.

IronPDF - Biblioteca PDF Java

IronPDF for Java Edition es una biblioteca para trabajar con PDFs en Java. Ofrece operaciones rápidas y precisas, lo que lo convierte en una excelente opción para muchas tareas relacionadas con archivos PDF, como extraer texto de PDFs, extraer imágenes de PDFs, fusionar archivos PDF y dividir PDFs. Está construido sobre las capacidades de IronPDF for .NET, asegurando una funcionalidad fiable.

Con la biblioteca IronPDF, puedes convertir documentos HTML, URL y cadenas en documentos PDF usando tipos de documentos estándar abiertos como HTML, CSS, JS, JPG y PNG. La biblioteca genera PDFs con conversión de HTML a PDF con un renderizado preciso de píxel y utiliza la tecnología más reciente.

Requisitos previos

Antes de comenzar, asegúrate de tener los siguientes requisitos previos:

1. Kit de Desarrollo de Java (JDK) instalado en tu máquina.
2. Un IDE de Java (Entorno de Desarrollo Integrado) como Eclipse, NetBeans o IntelliJ IDEA.
3. Biblioteca IronPDF añadida como una dependencia en tu proyecto Java. Puedes incluirlo haciendo referencia al artefacto de Maven apropiado o importando manualmente el archivo JAR. Puede descargarlo desde la página principal de IronPDF e incluirlo en su proyecto.

Configuración del proyecto

1. Crea un nuevo proyecto Java en el IDE elegido e incluye la biblioteca IronPDF como dependencia. Puedes hacerlo añadiendo el artefacto Maven al archivo pom.xml de tu proyecto o importando manualmente el archivo JAR.

2. Añade la biblioteca IronPDF a tu proyecto usando el gestor de dependencias.

   # Install IronPDF through Maven or another package manager

   SHELL

3. Añade las siguientes importaciones necesarias a tu(s) archivo(s) fuente de Java:

   import com.ironsoftware.ironpdf.PdfDocument;
   import com.ironsoftware.ironpdf.stamp.*;
   
   import java.io.IOException;
   import java.nio.file.Paths;

   Java

Carga del documento PDF

Para empezar, carga el documento PDF existente al que deseas añadir la marca de agua, o crea un nuevo archivo PDF utilizando el método [renderHtmlAsPdf](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#renderHtmlAsPdf(java.lang.String). IronPDF proporciona métodos convenientes para abrir y manipular archivos PDF. El siguiente ejemplo de código cargará el archivo example.pdf como un objeto PdfDocument:

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

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

Añadir marca de agua a un archivo PDF

IronPDF te permite agregar varios tipos de marcas de agua a tus documentos PDF, incluyendo marcas de agua de texto y de imagen. Exploremos ambas opciones:

Añadir marca de agua de texto

Para añadir una marca de agua de texto confidencial, utilice el método [applyWatermark](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#applyWatermark(java.lang.String). Puedes personalizar el texto, la fuente, el color y el tamaño, usando una cadena HTML como el primer parámetro, establecer su opacidad y alinear la marca de agua vertical y horizontalmente. A continuación, guárdelo utilizando el método [saveAs](/java/object-reference/api/com/ironsoftware/ironpdf/PdfDocument.html#saveAs(java.lang.String). Aquí hay un ejemplo:

// Apply a text watermark to the PDF
pdf.applyWatermark("<h1 style=\"color:red\">Confidential</h1>", 50, VerticalAlignment.MIDDLE, HorizontalAlignment.CENTER);
// Save the modified PDF document with the applied watermark
pdf.saveAs("textwatermarked.pdf");

// Apply a text watermark to the PDF
pdf.applyWatermark("<h1 style=\"color:red\">Confidential</h1>", 50, VerticalAlignment.MIDDLE, HorizontalAlignment.CENTER);
// Save the modified PDF document with the applied watermark
pdf.saveAs("textwatermarked.pdf");

El documento PDF con marca de agua de texto se verá así:

El archivo PDF con marca de agua

Añadir marca de agua

Para añadir una marca de agua a una imagen, utilice el mismo método applyWatermark. Ahora, utiliza la cadena HTML para configurar la etiqueta img con la imagen original. Especifica la ruta del archivo de imagen y ajusta su posición y opacidad según sea necesario. Aquí hay un ejemplo:

// Apply an image watermark to the PDF
pdf.applyWatermark("<img src='assets/images/iron-pdf-logo.jpg'>", 50, VerticalAlignment.MIDDLE, HorizontalAlignment.CENTER);
// Save the modified PDF document with the applied watermark
pdf.saveAs("imagewatermarked.pdf");

// Apply an image watermark to the PDF
pdf.applyWatermark("<img src='assets/images/iron-pdf-logo.jpg'>", 50, VerticalAlignment.MIDDLE, HorizontalAlignment.CENTER);
// Save the modified PDF document with the applied watermark
pdf.saveAs("imagewatermarked.pdf");

El documento PDF con marca de agua de imagen se verá así:

El archivo PDF con marca de agua

Crear PDF con marca de agua usando la clase Stamper

IronPDF for Java proporciona una clase Stamper, que se puede utilizar para añadir marcas de agua de texto e imagen mediante las clases HtmlStamper, ImageStamper y TextStamper. La clase Stamper ofrece más flexibilidad que el método applyWatermark.

Marca de agua de texto en PDF

En esta sección se utilizará la clase TextStamper para aplicar la marca de agua al PDF. Puedes establecer el ángulo de rotación del texto o imagen de la marca de agua a un documento PDF. También te permite establecer desplazamientos horizontales y verticales junto con el estampado detrás del contenido de la página PDF.

Aquí está el código para agregar una marca de agua de texto a un documento PDF existente:

// Create a text stamper for watermarking
TextStamper stamper = new TextStamper("Confidential");
stamper.setFontColor("#FF0000");
stamper.setFontSize(60);
stamper.setFontFamily("Times New Roman");
stamper.setHorizontalAlignment(HorizontalAlignment.CENTER);
stamper.setVerticalAlignment(VerticalAlignment.MIDDLE);
stamper.setOpacity(30);
stamper.setRotation(45);
// Apply the stamper to the PDF
pdf.applyStamp(stamper);
// Save the modified PDF document with the watermark
pdf.saveAs("textwatermarked2.pdf");

// Create a text stamper for watermarking
TextStamper stamper = new TextStamper("Confidential");
stamper.setFontColor("#FF0000");
stamper.setFontSize(60);
stamper.setFontFamily("Times New Roman");
stamper.setHorizontalAlignment(HorizontalAlignment.CENTER);
stamper.setVerticalAlignment(VerticalAlignment.MIDDLE);
stamper.setOpacity(30);
stamper.setRotation(45);
// Apply the stamper to the PDF
pdf.applyStamp(stamper);
// Save the modified PDF document with the watermark
pdf.saveAs("textwatermarked2.pdf");

En el código anterior, se utiliza la clase TextStamper de la biblioteca IronPDF para crear una marca de agua de texto con el contenido "Confidencial" y aplicarla a un documento PDF. La marca de agua se personaliza con propiedades de fuente específicas, alineación, opacidad y rotación. Finalmente, el documento PDF modificado se guarda como un nuevo archivo con la marca de agua aplicada.

El archivo PDF con marca de agua

Marca de agua de imagen en PDF

En esta sección se va a utilizar la clase ImageStamper para aplicar una marca de agua de imagen de fondo a un documento PDF. El código Java es el siguiente:

// Create an image stamper for watermarking
ImageStamper stamper = new ImageStamper("assets/images/iron-pdf-logo.jpg");
stamper.setHorizontalAlignment(HorizontalAlignment.CENTER);
stamper.setVerticalAlignment(VerticalAlignment.MIDDLE);
stamper.setOpacity(30);
stamper.setStampBehindContent(true);
stamper.setRotation(45);
// Apply the stamper to the PDF
pdf.applyStamp(stamper);
// Save the modified PDF document with the watermark
pdf.saveAs("imagewatermarked.pdf");

// Create an image stamper for watermarking
ImageStamper stamper = new ImageStamper("assets/images/iron-pdf-logo.jpg");
stamper.setHorizontalAlignment(HorizontalAlignment.CENTER);
stamper.setVerticalAlignment(VerticalAlignment.MIDDLE);
stamper.setOpacity(30);
stamper.setStampBehindContent(true);
stamper.setRotation(45);
// Apply the stamper to the PDF
pdf.applyStamp(stamper);
// Save the modified PDF document with the watermark
pdf.saveAs("imagewatermarked.pdf");

En el código completo anterior, se utiliza la clase ImageStamper de la biblioteca IronPDF para crear una marca de agua en forma de imagen y aplicarla a un documento PDF. La imagen de la marca de agua se especifica por su ruta de archivo, y sus propiedades, como alineación, opacidad, posición detrás del contenido y rotación, se configuran. Finalmente, el documento PDF modificado se guarda como un nuevo archivo con la marca de agua aplicada.

El archivo PDF con marca de agua

Conclusión

Este artículo explicó cómo agregar marcas de agua a documentos PDF utilizando IronPDF. Con las APIs intuitivas de IronPDF, puedes incorporar fácilmente marcas de agua de texto o imagen en tus archivos PDF, mejorando su seguridad y branding. Prueba diferentes opciones de personalización utilizando la clase Stamper para conseguir los efectos de marca de agua deseados. Ahora, puedes proteger y personalizar con confianza tus documentos PDF en tus aplicaciones Java.

Para obtener orientación detallada y ejemplos sobre cómo utilizar IronPDF for Java, puedes consultar los ejemplos de código, que proporcionan recursos útiles y demostraciones.

IronPDF es gratuito para fines de desarrollo y ofrece opciones de licenciamiento comercial para uso comercial. Para conocer más detalles sobre el licenciamiento, puedes visitar la Guía de Licencias de IronPDF.

También puedes obtener una licencia de API gratuita en una licencia de prueba gratuita para uso comercial. Para obtener el software IronPDF, puedes descargarlo desde el sitio web oficial de IronPDF for Java.