Cómo convertir un PDF en un archivo de imagen

¿Cómo convertir PDF a formato JPEG?

Por defecto, rasterizeToImageFiles convierte documentos según el tipo de archivo especificado en la ruta de destino. La detección automática de formatos permite cambiar fácilmente de un formato de imagen a otro sin necesidad de modificar el código.

Para convertir nuestro PDF de muestra en un archivo JPG, cambie la extensión del archivo en la ruta de destino:

// Convert PDF to JPG (not to PNG)
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

Como alternativa, especifique una opción ImageType. Un valor ImageType anula el tipo de archivo de imagen declarado en la ruta de destino. Esto obliga a rasterizeToImageFiles a ignorar el nombre de archivo al realizar la conversión, proporcionando un control explícito sobre el formato de salida.

El siguiente ejemplo incluye 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,
   dpi: 300  // High quality output
};
PdfDocument.fromFile("./sample-pdf-file.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.png", options);
    return pdf;
});

Este programa crea una imagen JPG. Observa que el nombre del archivo de destino sigue utilizando la extensión PNG. rasterizeToImageFiles ignora la extensión .PNG, siguiendo en su lugar el valor ImageType.JPG. Este enfoque es similar a la forma en que IronPDF gestiona otras operaciones de conversión en las que tiene prioridad la especificación explícita del tipo.

Puede adaptar este ejemplo para convertir PDF a otros tipos de imagen, incluidos los formatos GIF y Bitmap.

Consejo: Este enfoque es útil cuando no es posible cambiar los nombres de archivo a tipos específicos, como cuando se trabaja con sistemas automatizados de nomenclatura de archivos o se mantienen convenciones de nomenclatura coherentes en diferentes formatos de salida.

¿Cómo convierto archivos PDF de varias páginas en imágenes?

Para convertir documentos con varias páginas, utilice el método rasterizeToImageFiles de la misma manera. El método crea cada página como una imagen independiente en el tipo especificado, añadiendo automáticamente números de página a los nombres de archivo. Esta funcionalidad es útil para crear galerías de imágenes o trabajar con documentos de varias páginas.

Documento PDF de dos páginas abierto en el visor que muestra el contenido de muestra antes del proceso de conversión de la imagen Un documento PDF de muestra de dos páginas.

El siguiente bloque de código de muestra genera dos archivos PNG a partir del ejemplo de archivo PDF de dos páginas que se muestra arriba.

import { PdfDocument } from "@ironsoftware/ironpdf";

// Convert PDF with two pages to a set of images.
PdfDocument.fromFile("./multipage-pdf.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-pdf/multipage-pdf-page.png");
});

Dos archivos PNG individuales creados a partir de un PDF de dos páginas, mostrando la numeración automática de páginas en los nombres de archivo 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.

¿Cómo convierto solo páginas específicas?

Utilice un objeto JSON con la propiedad fromPages para rasterizar páginas específicas de un documento multipágina. Esta conversión selectiva es útil cuando se trata de PDF de gran tamaño en los que sólo se necesitan determinadas páginas, de forma similar a como se puede eliminar páginas específicas de un PDF.

El siguiente ejemplo de código solo convierte la primera, cuarta, sexta y novena página de este archivo de muestra grande en bitmaps.

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 desired pages (0-indexed)
    dpi: 150  // Balance quality and file size
};
PdfDocument.fromFile("./sample-pdf-with-images.pdf").then((pdf) => {
    pdf.rasterizeToImageFiles("./images/multipage-selective-pdf/multipage-pdf-page.bmp", options);
}).catch((error) => {
    console.error("Failed to convert pages:", error);
});

Cuatro páginas PDF convertidas con éxito en imágenes que muestran archivos multipágina pdf-página_2, página_4, página_7 y página_9 IronPDF realizó la operación de PDF a Imagen solo en las páginas que especificamos en el argumento options.

La función de conversión selectiva de páginas funciona con todos los formatos de imagen compatibles y mantiene los ajustes de calidad que especifiques. Para manipulaciones de página más complejas, explore la referencia completa de la API que detalla todas las opciones y métodos disponibles.

Empezar con IronPDF

¿Dónde puedo encontrar la documentación de la API?

Lee la documentación API de la clase PdfDocument y sus métodos rasterizeToImageFiles para obtener más información sobre cómo adaptar el método a tus necesidades. La documentación proporciona información detallada sobre todos los parámetros y opciones disponibles.

¿Qué otros ejemplos de código hay disponibles?

• Convertir un PDF en imágenes utilizando IronPDF: Ver rasterizeToImageFiles utilizado de una manera ligeramente diferente con opciones de configuración adicionales.
• Convertir imágenes en archivos PDF con IronPDF: Aprende a convertir una o varias imágenes en un único archivo PDF, esencialmente la operación inversa.
• Conversión de TIFF de varias páginas a PDF: Explore cómo manejar formatos de imagen de varias páginas al convertir a PDF, que comparte conceptos similares con la conversión de PDF de varias páginas a imagen.