Como converter um PDF em um arquivo de imagem

Como faço para converter um PDF para o formato JPEG?

Por padrão, rasterizeToImageFiles converte documentos de acordo com o tipo de arquivo especificado no caminho de destino. Essa detecção automática de formato permite alternar facilmente entre formatos de imagem sem alterações no código.

Para converter nosso PDF de exemplo em um arquivo JPG, altere a extensão do arquivo no caminho de destino:

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

Alternativamente, especifique a opção ImageType. O valor ImageType substitui o tipo de arquivo de imagem declarado no caminho de destino. Isso força o rasterizeToImageFiles a ignorar o nome do arquivo ao realizar a conversão, fornecendo controle explícito sobre o formato de saída.

O próximo exemplo inclui um argumento de opções JSON com nossa chamada para rasterizeToImageFiles que declara um 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 cria uma imagem JPG. Observe que o nome do arquivo de destino ainda usa a extensão PNG. rasterizeToImageFiles ignora a extensão .PNG, seguindo o valor ImageType.JPG em vez disso. Essa abordagem é semelhante à forma como o IronPDF lida com outras operações de conversão, onde a especificação explícita do tipo tem precedência.

Você pode adaptar este exemplo para converter PDFs em outros tipos de imagem, incluindo os formatos GIF e Bitmap.

Dica: Essa abordagem é útil quando alterar os nomes dos arquivos para tipos específicos não é viável, como ao trabalhar com sistemas automatizados de nomenclatura de arquivos ou ao manter convenções de nomenclatura consistentes em diferentes formatos de saída.

Como faço para converter PDFs com várias páginas em imagens?

Para converter documentos com várias páginas, use o método rasterizeToImageFiles da mesma maneira. O método cria cada página como uma imagem separada no tipo especificado, acrescentando automaticamente os números de página aos nomes dos arquivos. Essa funcionalidade é útil ao criar galerias de imagens ou ao trabalhar com documentos de várias páginas .

Um documento PDF de exemplo com duas páginas.

O próximo bloco de código de exemplo gera dois arquivos PNG a partir do arquivo PDF de duas páginas mostrado acima.

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");
});

Resultado da aplicação do método rasterizeToImageFiles em um arquivo PDF de duas páginas. O método cria uma imagem para cada página do arquivo original.

Como faço para converter apenas páginas específicas?

Utilize um objeto JSON com a propriedade fromPages para rasterizar páginas específicas de um documento com várias páginas. Essa conversão seletiva é útil ao lidar com PDFs grandes, nos quais você precisa apenas de determinadas páginas, de forma semelhante a como você removeria páginas específicas de um PDF .

O exemplo de código a seguir converte apenas a primeira, a quarta, a sexta e a nona página deste grande arquivo de amostra em 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);
});

O IronPDF realizou a operação de conversão de PDF para imagem apenas nas páginas que especificamos no argumento options.

O recurso de conversão seletiva de páginas funciona com todos os formatos de imagem suportados e mantém as configurações de qualidade especificadas. Para manipulações de página mais complexas, explore a referência completa da API , que detalha todas as opções e métodos disponíveis.

Onde posso encontrar a documentação da API?

Leia a documentação da API sobre a classe PdfDocument e seus métodos rasterizeToImageFiles para obter mais informações sobre como adaptar o método às suas necessidades. A documentação fornece informações detalhadas sobre todos os parâmetros e opções disponíveis.

Que outros exemplos de código estão disponíveis?

• Converter um PDF em imagens usando o IronPDF : Veja rasterizeToImageFiles usado de uma maneira ligeiramente diferente com opções de configuração adicionais.
• Converter imagens em arquivos PDF usando o IronPDF : Aprenda como converter uma ou mais imagens em um único arquivo PDF, essencialmente a operação inversa.
• Conversão de TIFF com várias páginas para PDF : Explore como lidar com formatos de imagem com várias páginas ao converter para PDF, que compartilha conceitos semelhantes com a conversão de PDF com várias páginas para imagem.