Cómo convertir un PDF en un archivo de imagen
Para convertir archivos PDF a imágenes, use el método rasterizeToImageFiles proporcionado por el módulo de NodeJS de IronPDF. Puede configurar este método para que admita diversas operaciones de conversión de PDF a imagen. Convierte PDF a JPG, PNG y otros formatos de imagen. Convierta cada página PDF en una imagen JPEG o PNG, o convierta sólo unas pocas páginas. IronPDF te da el control total._
Continúa leyendo para aprender cómo realizar tareas de PDF a imagen con IronPDF para Node.js.
Instalar IronPDF con NPM
npm i @ironsoftware/ironpdf
Instala el módulo de Nodejs de IronPDF desde NPM para convertir PDFs a PNG, JPG (o JPEG), GIF y otros tipos de imágenes.
Convertir PDF a formato de imagen
Supongamos que estamos trabajando con un documento PDF de muestra de una página que contiene texto de relleno.
Una imagen que muestra nuestro archivo PDF de muestra abierto en una aplicación de visor de PDF. Descargue este archivo PDF y otros para fines de prueba desde Learning Container.
El siguiente código fuente convierte el archivo PDF en un archivo PNG.
import { PdfDocument } from "@ironsoftware/ironpdf";
// Convert PDF File to a PNG File
await PdfDocument.fromFile("./sample-pdf-file.pdf").then((resolve) => {
resolve.rasterizeToImageFiles("./images/sample-pdf-file.png");
return resolve;
});Usamos el método PdfDocument.fromFile para cargar nuestro documento de muestra en la biblioteca de Node. Esta función ofrece una PdfDocument class en IronPDF que representa nuestro archivo de muestra. Dado que el objeto que necesitamos está contenido en una Promise, adjuntamos una función de retorno de llamada para ejecutar cuando la promise resuelve el PdfDocument.
Dentro del callback, llamamos a la rasterizeToImageFiles function in IronPDF en el objeto resuelto para convertir el documento de una sola página en una imagen. Como se mostró anteriormente, especificamos la ruta de destino (que incluye el nombre del archivo y la extensión del archivo) para nuestra nueva imagen como argumento.
**La imagen se generó a partir del código fuente anterior. ¡IronPDF convirtió nuestro PDF de muestra en un archivo PNG con tan solo tres líneas de código!
Learning Container proporciona archivos PDF de muestra que puedes usar en tus proyectos con fines de prueba. Puedes descargar el archivo PDF de muestra utilizado en este ejemplo de forma gratuita (junto con archivos de muestra similares) desde el sitio web. Siéntete libre de probar el ejemplo anterior en otros PDFs con diferentes tamaños y complejidad.
En la siguiente sección se ofrecen detalles adicionales sobre la conversión de PDF a imagen que merece la pena tener en cuenta.
Opciones avanzadas de conversión de imágenes
Convertir PDF a JPEG
De forma predeterminada, rasterizeToImageFiles convierte documentos según el tipo de archivo especificado en la ruta de destino.
Por lo tanto, para convertir nuestro PDF de muestra utilizado en el ejemplo anterior en un archivo JPG (en lugar de convertir PDF a PNG), simplemente podemos cambiar la extensión del nombre del archivo utilizada en la ruta del archivo de destino:
// Convert PDF to JPG (not to PNG)
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");Otra forma de hacer lo mismo es especificar una opción ImageType en IronPDF. Un valor de ImageType reemplaza el tipo de archivo de imagen declarado en la ruta de destino. Esto obliga a rasterizeToImageFiles a no considerar el nombre de archivo al realizar tareas de imagen a PDF.
Puede verlo en acción en el siguiente ejemplo. Aquí, incluimos un argumento de opciones JSON con nuestra llamada a rasterizeToImageFiles que declara un ImageType.
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";
// Convert PDF to JPEG Format using ImageType.JPG
const options = {
type: ImageType.JPG
};
await PdfDocument.fromFile("./sample-pdf-file.pdf").then((resolve) => {
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.png", options);
return resolve;
});Ejecutando el programa anterior también se crea una imagen JPG como en nuestro ejemplo anterior. Observe, sin embargo, que el nombre del archivo de destino sigue utilizando la extensión PNG. rasterizeToImageFiles ignoró la extensión de archivo .PNG utilizada en la ruta, siguiendo en su lugar el valor de tipo ImageType.JPG.
Puede adaptar este ejemplo para convertir PDF en otros tipos de imagen, incluidos los formatos GIF y Bitmap.
Consejo: Usar este enfoque puede ser particularmente útil en situaciones en las que cambiar nombres de archivos a tipos específicos no es factible o no se desea.
Convertir archivos PDF con varias páginas
Para convertir documentos que contienen más de una página en un tipo de imagen deseado (PNG, JPG, Bitmap, etc.), también podemos usar el método rasterizeToImageFiles de la misma manera que antes. Cuando se invoca, el método mostrará cada página como una imagen independiente del tipo especificado.
Un documento PDF de muestra de dos páginas.
El siguiente bloque de código de ejemplo genera dos archivos PNG a partir del ejemplo de archivo PDF de dos páginas mostrado arriba.
import { PdfDocument } from "@ironsoftware/ironpdf";
// Convert PDF with two pages to a set of images.
await PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});
El resultado de usar el método rasterizeToImageFiles en un archivo PDF de dos páginas. El método crea una imagen para cada página del archivo original.
Convertir páginas PDF específicas en imágenes
Declarar un objeto JSON con la propiedad fromPages establecida nos permite rasterizar una o más páginas de un documento de varias páginas (en lugar de todas las páginas).
El siguiente ejemplo de código solo convierte la primera, cuarta, sexta y novena página de este archivo de muestra grande en mapas de bits.
import { PdfDocument, ImageType } from "@ironsoftware/ironpdf";
// Convert PDF containing many pages to BMP images.
const options = {
type: ImageType.BMP,
fromPages: [0, 3, 5, 8] // Select only the pages with an image on it.
};
await PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => {
pdf.rasterizeToImageFiles("./images/multipage-selective-pdf/multipage-pdf-page.bmp", options);
});
IronPDF realizó la operación de PDF a imagen solo en las páginas que especificamos en el argumento options.
Comience con IronPDF
Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.
Lecturas complementarias
Referencia API
Lea la documentación de la API sobre la clase PdfDocument y sus métodos rasterizeToImageFiles para obtener más información sobre cómo adaptar el método a sus necesidades.
Ejemplos de código
- Convierta un PDF a imágenes usando IronPDF: Vea
rasterizeToImageFilesusado de una manera ligeramente diferente. - Convertir imágenes a archivos PDF usando IronPDF: Aprende cómo convertir una o más imágenes en un solo archivo PDF.
Darrius Serrant tiene una licenciatura en Informática de la Universidad de Miami y trabaja como Ingeniero de Marketing WebOps Full Stack en Iron Software. Atraído por la programación desde una edad temprana, veía la computación como algo misterioso y accesible, lo que la convertía en el medio perfecto para la creatividad y la resolución de problemas.
En Iron Software, Darrius disfruta creando cosas nuevas y simplificando conceptos complejos para hacerlos más comprensibles. Como uno de nuestros desarrolladores residentes, también se ha ofrecido como voluntario para enseñar a los estudiantes, compartiendo su experiencia con la próxima generación.
Para Darrius, su trabajo es gratificante porque es valorado y tiene un impacto real.
