Cómo convertir PNG a PDF en Java (Tutorial)

En este artículo se utilizará la biblioteca IronPDF for Java para crear documentos PDF a partir de formatos de archivo de imagen mediante programación.

IronPDF - Una biblioteca Java

Los ingenieros de Iron Software ahora han desarrollado la biblioteca IronPDF para Java, que ayuda a los desarrolladores de Java a crear nuevos documentos, editar, escribir, cambiar el tamaño y manipular documentos PDF. IronPDF permite trabajar con todos los aspectos de un archivo PDF o de su conversión. Proporciona a los desarrolladores una amplia gama de funciones para crear y personalizar PDF en Java. También ayuda a controlar el diseño y la configuración de los PDFs.

IronPDF for Java se basa en las capacidades de .NET Framework, lo que la convierte en una herramienta versátil para trabajar con PDF en comparación con otras bibliotecas de código abierto. Además de crear y manipular PDFs, principalmente ayuda a convertir imágenes y archivos HTML a PDF y otros formatos de archivo también.

Pasos para convertir PNG a PDF en Java

Requisitos previos

Para crear una aplicación de conversión de PNG a PDF, necesitará tener descargados e instalados los siguientes requisitos previos:

1. Kit de Desarrollo de Java (JDK): La última versión del JDK debe estar instalada en su computadora para compilar y ejecutar la aplicación de conversión de PNG a PDF. El JDK se puede descargar desde el sitio web de Oracle.

2. Maven: Maven necesita ser instalado ya que es una herramienta de automatización de compilaciones utilizada principalmente para proyectos Java. Maven se puede descargar desde el sitio web de Apache Maven.

3. Biblioteca Java de IronPDF: Ahora necesitarás la última versión de IronPDF añadida como una dependencia a tu proyecto de conversión de PNG a PDF. Agrega la siguiente dependencia de IronPDF al archivo pom.xml de tu proyecto:

   <dependency>
      <groupId>com.ironsoftware</groupId>
      <artifactId>com.ironsoftware</artifactId>
      <version>2025.4.4</version>
   </dependency>

   XML
4. También necesitarás agregar la dependencia Slf4j en el archivo pom.xml.

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.5</version>
    </dependency>

    <dependency>
        <groupId>org.slf4j</groupId>
        <artifactId>slf4j-simple</artifactId>
        <version>2.0.5</version>
    </dependency>

Una vez descargados e instalados todos los requisitos previos, el proyecto puede utilizarse para convertir imágenes PNG en documentos PDF en aplicaciones Java.

Añadir importaciones al archivo principal de Java

En primer lugar, necesitará las siguientes importaciones para convertir imágenes PNG en archivos PDF utilizando IronPDF en su aplicación Java.

import com.ironsoftware.ironpdf.PdfDocument;
import java.io.IOException;
import java.nio.file.*;
import java.util.ArrayList;
import java.util.List;

import com.ironsoftware.ironpdf.PdfDocument;
import java.io.IOException;
import java.nio.file.*;
import java.util.ArrayList;
import java.util.List;

Una vez añadidas las importaciones, ya puedes empezar con la conversión de imagen a PDF.

Convertir un único archivo PNG a PDF

IronPDF ayuda a los desarrolladores a convertir una sola imagen PNG o JPG en un archivo PDF con unos sencillos pasos. El fragmento de código Java se muestra en el siguiente ejemplo:

// Reference to the image that we want to convert
List<Path> paths = new ArrayList<>();
paths.add(Paths.get("example.png"));

// Save the image into a new PDF document.
PdfDocument.fromImage(paths).saveAs(Paths.get("example.pdf"));

// Reference to the image that we want to convert
List<Path> paths = new ArrayList<>();
paths.add(Paths.get("example.png"));

// Save the image into a new PDF document.
PdfDocument.fromImage(paths).saveAs(Paths.get("example.pdf"));

En primer lugar, debe obtener la ruta del archivo de imagen que desea convertir a PDF. Luego, agrega esa ruta de imagen a una List y llama al método fromImage. Finalmente, llame al método saveAs para guardar el archivo PNG convertido en el sistema de archivos.

Convertir varios PNG en un archivo PDF

IronPDF también permite a los desarrolladores combinar varias imágenes PNG o JPG en un único documento PDF, como se muestra en el siguiente ejemplo de código.

// Reference to the directory containing the images that we desire to convert
Path imageDirectory = Paths.get("assets/images");

// Create an empty List to contain Paths to images from the directory.
List<Path> imageFiles = new ArrayList<>();

// Use a DirectoryStream to populate the List with paths for each image in the directory
try (DirectoryStream<Path> stream = Files.newDirectoryStream(imageDirectory, "*.{png, jpg, gif}")) {
    for (Path entry : stream) {
        imageFiles.add(entry);
    }

    // Render all targeted images as PDF content and save them together in one PDF document.
    PdfDocument.fromImage(imageFiles).saveAs(Paths.get("multiple_images.pdf"));
} catch (IOException exception) {
    throw new RuntimeException(String.format("Error converting images to PDF from directory: %s: %s",
            imageDirectory,
            exception.getMessage()),
            exception);
}

// Reference to the directory containing the images that we desire to convert
Path imageDirectory = Paths.get("assets/images");

// Create an empty List to contain Paths to images from the directory.
List<Path> imageFiles = new ArrayList<>();

// Use a DirectoryStream to populate the List with paths for each image in the directory
try (DirectoryStream<Path> stream = Files.newDirectoryStream(imageDirectory, "*.{png, jpg, gif}")) {
    for (Path entry : stream) {
        imageFiles.add(entry);
    }

    // Render all targeted images as PDF content and save them together in one PDF document.
    PdfDocument.fromImage(imageFiles).saveAs(Paths.get("multiple_images.pdf"));
} catch (IOException exception) {
    throw new RuntimeException(String.format("Error converting images to PDF from directory: %s: %s",
            imageDirectory,
            exception.getMessage()),
            exception);
}

El método fromImage en el código anterior también puede aceptar una lista de objetos de ruta de imagen PNG. Cada objeto path hace referencia a una ruta válida a una imagen almacenada localmente. En este caso, las imágenes provienen del mismo directorio, por lo que se utiliza rápidamente un DirectoryStream que se encuentra en las clases de java.nio.file para construir una lista de todas las imágenes contenidas en el directorio.

Ahora, el método fromImage renderizará cada imagen PNG o JPG presente en la lista en una página separada del documento PDF. Finalmente, utiliza el método saveAs para guardar las imágenes convertidas en el archivo de salida multiple_images.pdf.

Después de ejecutar el proyecto con cualquiera de los ejemplos de código anteriores, la salida se genera en formato de archivo PDF. Aquí, la salida que se muestra es de la "Convertir PNG a PDF" Múltiples imágenes.

Salida de PNG a PDF

Puedes consultar más ejemplos de código en la conversión de imágenes con IronPDF y también descargar IronPDF for Java desde el sitio web oficial de IronPDF.

IronPDF for Java

IronPDF tiene una gran calidad de renderizado de todas las imágenes y textos sin perder ningún formato. Los componentes de formulario en PDFs también son editables en el archivo PDF convertido.

Resumen

Este artículo muestra cómo generar archivos PDF utilizando la función de conversión de imágenes a PDF de IronPDF. En conclusión, IronPDF es una potente biblioteca desarrollada para que los desarrolladores Java puedan trabajar con el formato de archivo PDF. Permite a los desarrolladores crear fácilmente documentos PDF a partir de múltiples imágenes desde cero. También admite documentos XML a PDF junto con archivos HTML y de imagen. IronPDF es una excelente API PDF que ayuda a los ingenieros de software a extraer y escribir contenido de archivos PDF.

IronPDF for Java es gratuito para usar, pero para fines de implementación, tiene una licencia comercial a partir de $liteLicense. También puedes acceder a la prueba gratuita de la versión completa de IronPDF para probar su funcionalidad en modo de producción.