Java PDF para arquivo de imagem

O que é a conversão de PDF para imagem e por que ela é necessária?

Converter páginas PDF em arquivos de imagem como JPEG, PNG ou TIFF tem muitas aplicações no desenvolvimento de software. Você pode precisar de imagens de páginas específicas de um PDF para usar em outro lugar, mas sua única opção é tirar capturas de tela. O código Java tradicional torna essa conversão praticamente impossível. O IronPDF resolve esse desafio com uma abordagem direta.

A conversão de PDF para imagem é essencial em diversos cenários empresariais: criação de miniaturas para sistemas de gerenciamento de documentos, geração de imagens de pré-visualização para aplicativos web, extração de conteúdo visual para apresentações ou conversão de documentos para exibição em dispositivos que não suportam a renderização de PDF. O IronPDF simplifica essa tarefa complexa ao fornecer uma API robusta que lida internamente com todas as complexidades de renderização.

O que é o IronPDF for Java e como ele pode ajudar?

IronPDF for Java é uma biblioteca que permite criar, preparar e gerenciar arquivos PDF. Os desenvolvedores o utilizam para ler, gerar e modificar arquivos PDF sem o Adobe Acrobat. O IronPDF suporta cabeçalhos/rodapés personalizados, assinaturas, anexos, senhas e mecanismos de segurança. Oferece suporte completo a multithreading e assíncrono para melhor desempenho. O IronPDF funciona com projetos baseados em Maven.

A biblioteca se destaca na conversão de HTML para PDF , permitindo que os desenvolvedores aproveitem seus conhecimentos prévios de HTML/CSS ao criar PDFs. Além da conversão básica, o IronPDF oferece recursos avançados, como adicionar planos de fundo e primeiro plano , criar e preencher formulários e aplicar marcas d'água personalizadas . Para conversão de PDF em imagem, o IronPDF oferece uma API integrada que mantém a qualidade e, ao mesmo tempo, oferece flexibilidade nos formatos de saída.

A seguir, discutiremos como converter páginas PDF em formatos de imagem como JPEG, JPG ou PNG usando Java.

Quais são os pré-requisitos para começar?

Antes de começar, certifique-se de que estes pré-requisitos sejam atendidos:

1. Java instalado com o caminho definido nas variáveis ​​de ambiente. Consulte este guia de instalação do Java .
2. Ambiente de desenvolvimento integrado (IDE) Java instalado (Eclipse ou IntelliJ). Baixe o Eclipse ou o IntelliJ .
3. Maven integrado ao seu IDE. Consulte este tutorial de instalação do Maven .
4. Chaves de licença configuradas para uso comercial.

Como instalo o IronPDF for Java?

Uma vez atendidos todos os pré-requisitos, a instalação do IronPDF é simples. Para obter instruções detalhadas de configuração, consulte a documentação de primeiros passos .

Para usar o IronPDF for Java, você precisa de uma IDE. Este artigo usa o JetBrains IntelliJ IDEA para instalar as dependências e executar os exemplos.

Primeiro, abra o JetBrains IntelliJ IDEA e crie um novo projeto Maven.

Criar um novo projeto Maven

Uma nova janela será aberta. Digite o nome do projeto e clique em Concluir.

Novo nome do projeto

Após clicar em Concluir, o novo projeto é aberto com pom.xml exibido por padrão. Precisamos deste arquivo para adicionar as dependências do Maven para o IronPDF.

Novo projeto

Adicione as seguintes dependências ao seu arquivo pom.xml. Você também pode baixar o arquivo JAR da API na página do repositório Maven do IronPDF. Para implantações em nuvem, consulte nossos guias para AWS, Azure ou Google Cloud.

<dependencies>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2022.11.0</version>
    </dependency>

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

<dependencies>
    <dependency>
        <groupId>com.ironsoftware</groupId>
        <artifactId>ironpdf</artifactId>
        <version>2022.11.0</version>
    </dependency>

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

Depois de adicionar as dependências ao pom.xml, um pequeno ícone aparece no canto superior direito.

Dependências do Maven

Clique neste ícone para instalar as dependências do Maven. A instalação leva alguns minutos, dependendo da sua conexão com a internet. Após a instalação, explore a documentação completa da API para entender todos os recursos disponíveis.

Como faço para converter arquivos PDF em imagens usando o IronPDF?

Usando o IronPDF for Java, converter PDFs para formatos de imagem como JPEG requer apenas algumas linhas de código. Ele converte o documento PDF de entrada em um fluxo de imagens de saída. O método toBufferedImages retorna uma lista de objetos List<BufferedImage> organizados em ordem crescente pelo número da página.

O IronPDF converte documentos PDF em imagens e também pode criar imagens diretamente a partir de URLs e HTML. Essa flexibilidade o torna ideal para diversos casos de uso, desde a criação de pré-visualizações de documentos até a geração de miniaturas para sistemas de gerenciamento de conteúdo.

Como faço para converter um documento PDF existente em imagens?

Este exemplo converte um documento PDF inteiro em imagens. Escreva o seguinte código e execute o programa. Para mais exemplos de conversão de PDF em imagem, visite nossos exemplos de código de rasterização .

import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class Main {
    public static void main(String [] args) throws IOException {
        // Load the PDF document from a file
        PdfDocument instance = PdfDocument.fromFile(Paths.get("business_plan.pdf"));

        // Convert the PDF pages into a list of BufferedImage objects
        List<BufferedImage> extractedImages = instance.toBufferedImages();

        // Set image conversion options
        ToImageOptions rasterOptions = new ToImageOptions();
        rasterOptions.setImageMaxHeight(800);
        rasterOptions.setImageMaxWidth(500);

        // Convert the pages using the specified options
        List<BufferedImage> sizedExtractedImages = instance.toBufferedImages(rasterOptions, PageSelection.allPages());

        int pageIndex = 1;
        // Loop through each image and write to the file system
        for (BufferedImage extractedImage : sizedExtractedImages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(extractedImage, "PNG", new File(fileName));
        }
    }
}

import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.nio.file.Paths;
import java.util.List;

public class Main {
    public static void main(String [] args) throws IOException {
        // Load the PDF document from a file
        PdfDocument instance = PdfDocument.fromFile(Paths.get("business_plan.pdf"));

        // Convert the PDF pages into a list of BufferedImage objects
        List<BufferedImage> extractedImages = instance.toBufferedImages();

        // Set image conversion options
        ToImageOptions rasterOptions = new ToImageOptions();
        rasterOptions.setImageMaxHeight(800);
        rasterOptions.setImageMaxWidth(500);

        // Convert the pages using the specified options
        List<BufferedImage> sizedExtractedImages = instance.toBufferedImages(rasterOptions, PageSelection.allPages());

        int pageIndex = 1;
        // Loop through each image and write to the file system
        for (BufferedImage extractedImage : sizedExtractedImages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(extractedImage, "PNG", new File(fileName));
        }
    }
}

JAVA

O resultado é salvo na pasta de recursos do seu projeto (crie esta pasta antes de executar o programa), com a numeração começando em 1 e incrementando para cada página do PDF. Aplique recursos avançados, como compressão de imagens ou adição de marcas d'água aos arquivos de saída.

Saída de PDF para imagens

Como faço para converter um URL em PDF e depois em imagens?

O IronPDF converte HTML diretamente em PDF e, em seguida, converte cada página do PDF gerado em imagens. Este recurso permite capturar conteúdo da web como imagens, o que é útil para arquivar páginas da web, criar capturas de tela para documentação ou gerar relatórios visuais a partir de painéis de controle baseados na web.

Este exemplo utiliza o site da Amazon. O programa renderiza uma página do Amazon.com em um PDF e, em seguida, gera cada página do PDF como imagens armazenadas em uma pasta de recursos. Para páginas seguras que exigem autenticação, consulte nosso guia sobre logins em sites e sistemas .

import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class Main {
    public static void main(String [] args) throws IOException {
        // Generate a PDF from a URL
        PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://www.amazon.com/?tag=hp2-brobookmark-us-20");

        // Convert the PDF pages into a list of BufferedImage objects
        List<BufferedImage> extractedImages = pdf.toBufferedImages();

        // Set image conversion options
        ToImageOptions rasterOptions = new ToImageOptions();
        rasterOptions.setImageMaxHeight(800);
        rasterOptions.setImageMaxWidth(500);

        // Convert the pages using the specified options
        List<BufferedImage> sizedExtractedImages = pdf.toBufferedImages(rasterOptions, PageSelection.allPages());

        int pageIndex = 1;
        // Loop through each image and write to the file system
        for (BufferedImage extractedImage : sizedExtractedImages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(extractedImage, "PNG", new File(fileName));
        }
    }
}

import com.ironsoftware.ironpdf.PdfDocument;
import com.ironsoftware.ironpdf.edit.PageSelection;
import com.ironsoftware.ironpdf.image.ToImageOptions;
import javax.imageio.ImageIO;
import java.awt.image BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class Main {
    public static void main(String [] args) throws IOException {
        // Generate a PDF from a URL
        PdfDocument pdf = PdfDocument.renderUrlAsPdf("https://www.amazon.com/?tag=hp2-brobookmark-us-20");

        // Convert the PDF pages into a list of BufferedImage objects
        List<BufferedImage> extractedImages = pdf.toBufferedImages();

        // Set image conversion options
        ToImageOptions rasterOptions = new ToImageOptions();
        rasterOptions.setImageMaxHeight(800);
        rasterOptions.setImageMaxWidth(500);

        // Convert the pages using the specified options
        List<BufferedImage> sizedExtractedImages = pdf.toBufferedImages(rasterOptions, PageSelection.allPages());

        int pageIndex = 1;
        // Loop through each image and write to the file system
        for (BufferedImage extractedImage : sizedExtractedImages) {
            String fileName = "assets/images/" + pageIndex++ + ".png";
            ImageIO.write(extractedImage, "PNG", new File(fileName));
        }
    }
}

JAVA

Saída de PDF para imagens

Ajuste a resolução da imagem modificando estas chamadas na instância ToImageOptions:

rasterOptions.setImageMaxHeight(800);
rasterOptions.setImageMaxWidth(500);

rasterOptions.setImageMaxHeight(800);
rasterOptions.setImageMaxWidth(500);

JAVA

Essas linhas ajustam a largura e a altura das imagens geradas quando toBufferedImage é invocado. Para opções e configurações avançadas de renderização, consulte nosso guia sobre configurações de geração de PDF .

// Convert only page 3 to an image
List<BufferedImage> singlePage = instance.toBufferedImages(rasterOptions, PageSelection.singlePage(3));

// Convert pages 2 through 5
List<BufferedImage> pageRange = instance.toBufferedImages(rasterOptions, PageSelection.pageRange(2, 5));

// Convert first and last pages only
PageSelection customPages = new PageSelection();
customPages.add(0); // First page (0-indexed)
customPages.add(instance.getPageCount() - 1); // Last page
List<BufferedImage> selectedPages = instance.toBufferedImages(rasterOptions, customPages);

// Convert only page 3 to an image
List<BufferedImage> singlePage = instance.toBufferedImages(rasterOptions, PageSelection.singlePage(3));

// Convert pages 2 through 5
List<BufferedImage> pageRange = instance.toBufferedImages(rasterOptions, PageSelection.pageRange(2, 5));

// Convert first and last pages only
PageSelection customPages = new PageSelection();
customPages.add(0); // First page (0-indexed)
customPages.add(instance.getPageCount() - 1); // Last page
List<BufferedImage> selectedPages = instance.toBufferedImages(rasterOptions, customPages);

Quais são os principais pontos a serem destacados neste guia?

Este guia demonstra como converter PDFs em imagens usando o IronPDF for Java. As imagens geradas preservam os números de página e os nomes dos documentos do PDF original. O IronPDF suporta vários formatos de imagem, incluindo JPEG, JPG, TIFF e outros.

O IronPDF oferece controle total sobre a resolução da imagem de saída. Para obter mais informações sobre manipulação de PDFs usando Java, consulte a documentação do IronPDF for Java . Para obter mais detalhes sobre a conversão de PDF em imagem, consulte este exemplo de conversão de PDF para imagem com o IronPDF .

O IronPDF for Java é gratuito para desenvolvimento, mas requer uma licença para uso comercial. Saiba mais sobre licenciamento na página de Licenciamento Java do IronPDF .