Como converter um PDF em um arquivo de imagem no Node.js

Como faço para instalar o IronPDF for Node.js?

 npm e @ironsoftware/ironpdf

Instale o pacote Node.js do IronPDF a partir do npm para converter PDFs em PNG, JPG, GIF, BMP e outros formatos de imagem.

Antes de converter PDFs em imagens na produção, configure sua chave de licença. O pacote também exige que o IronPDF Engine seja instalado em seu sistema — este binário lida com todas as operações de renderização de PDF e deve estar presente para que a conversão funcione.

Como faço para converter um PDF em uma imagem?

O método rasterizeToImageFiles lê um documento PDF e escreve um arquivo de imagem por página no caminho de saída que você fornecer. Para PDFs de página única, ele produz exatamente uma imagem. Para PDFs de múltiplas páginas, ele adiciona um sufixo de número de página a cada nome de arquivo automaticamente.

O exemplo abaixo carrega um PDF de exemplo do Learning Container e o converte em um arquivo PNG.

O arquivo PDF de exemplo aberto em um visualizador. Baixe este arquivo e outros PDFs de teste do Learning Container.

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-png.js

PdfDocument.fromFile carrega o PDF e retorna uma Promessa resolvendo-se para um objeto PdfDocument. O callback .then recebe o documento resolvido e chama rasterizeToImageFiles com o caminho de destino. A extensão do arquivo no caminho — .png aqui — informa ao IronPDF qual formato produzir. O bloco .catch lida com quaisquer erros de leitura ou conversão.

O PNG gerado a partir do PDF de exemplo acima. IronPDF converte o documento em três linhas de código.

Para exemplos mais detalhados das opções deste método, veja a página de exemplo de código PDF para Imagens.

Minha biblioteca favorita desse tipo é o IronPDF. Ele permite a manipulação rápida e eficiente de arquivos PDF. Além disso, possui muitos recursos valiosos, como a exportação para o formato PDF/A e a assinatura digital de documentos PDF.

Milan Jovanovic

Microsoft MVP

Veja o estudo de caso

Com o IronOCR, podemos economizar US$ 40.000 por ano em processamento manual, ao mesmo tempo que aumentamos a produtividade e liberamos recursos para tarefas de alto impacto. Eu o recomendo fortemente.

Brent Matzelle

Diretor de Tecnologia, OPYN

Veja o estudo de caso

O IronSuite desempenha um papel crucial nas nossas operações. Estas são ferramentas que aumentam a eficiência no negócio, incluindo a criação de plantas baixas e melhoria na gestão de inventário.

David Jones

Engenheiro(a) de Software Líder, Agorus Build

Veja o estudo de caso

Como converto um PDF no formato JPEG?

A seleção de formato é automática: qualquer extensão que você passar para rasterizeToImageFiles determina o formato de saída. Para produzir um JPEG em vez de um PNG, altere a extensão no caminho de destino:

//:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-extension.js
// Switch to JPEG by changing the file extension in the output path.
pdf.rasterizeToImageFiles("./images/pdf-to-jpeg.jpg");

Quando o nome do arquivo de saída não pode ser controlado — por exemplo, em pipelines automatizados com esquemas de nomenclatura fixos — passe um valor ImageType no objeto de opções para substituir a detecção baseada em extensão:

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-to-jpeg-imagetype.js

A propriedade type no objeto de opções tem precedência sobre a extensão do nome do arquivo. No exemplo acima, rasterizeToImageFiles produz um arquivo JPEG, embora o caminho de destino termine com .png. O mesmo padrão se aplica a saídas GIF e BMP.

Como converto um PDF de várias páginas em imagens?

Para documentos com mais de uma página, rasterizeToImageFiles cria uma imagem por página. IronPDF adiciona um índice de página baseado em zero a cada nome de arquivo de saída, mantendo a saída organizada sem código adicional de sua parte.

Um exemplo de PDF de duas páginas. IronPDF cria um arquivo de imagem por página durante a conversão.

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-multipage.js

Os dois arquivos PNG produzidos a partir do PDF de duas páginas. IronPDF nomeia cada arquivo de saída com seu número de página.

Esse comportamento automático de divisão de página funciona com todos os formatos de imagem suportados. Combine-o com a opção fromPages na próxima seção para converter apenas páginas específicas de documentos grandes. Para trabalhar na direção oposta, o exemplo de imagem para PDF mostra como combinar vários arquivos de imagem em um único documento PDF.

Como converto apenas páginas específicas?

A propriedade fromPages no objeto de opções aceita um array de índices de página baseados em zero. Apenas as páginas especificadas são rasterizadas; todas as outras são ignoradas. Isso é útil quando se trabalha com PDFs grandes onde apenas um subconjunto de páginas é necessário — por exemplo, extraindo páginas de capa e início de seção para visualização de documentos. Quando você precisa trabalhar com páginas individuais antes de convertê-las, a referência de API Node.js para PdfDocument documenta operações adicionais em nível de página.

:path=/static-assets/pdf/content-code-examples/how-to/nodejs-pdf-to-image/convert-selective-pages.js

IronPDF rasterizou apenas as quatro páginas especificadas no array fromPages. As outras páginas não foram processadas.

Os índices de página em fromPages são baseados em zero, então [0, 3, 5, 8] aponta para a primeira, quarta, sexta e nona páginas. O valor de 150 DPI equilibra a qualidade da saída contra o tamanho do arquivo — adequado para casos de uso de arquivo ou visualização. A conversão seletiva é compatível com todos os tipos de imagem suportados.