Adicionar imagem ao PDF usando Java

Aspose.PDF for Java suporta tanto a colocação de imagem em alto nível quanto o desenho baseado em operadores de baixo nível.

Adicionar uma imagem com coordenadas da página

Use este exemplo quando precisar colocar uma imagem em uma posição fixa em uma página PDF.

  1. Crie um novo documento PDF Document e adicione uma página.
  2. Chame page.addImage() com o caminho da imagem de origem e o retângulo de destino.
  3. Salve o arquivo PDF gerado.
public static void addImage(Path imageFile, Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        page.addImage(imageFile.toString(), new Rectangle(20, 730, 120, 830, true));
        document.save(outputFile.toString());
    }
}

Adicionar uma imagem com operadores de página

Use este exemplo quando precisar de controle de baixo nível sobre a colocação e dimensionamento de imagens através de operadores de página.

  1. Crie um novo documento PDF Document e abra o fluxo da imagem de origem.
  2. Adicione a imagem aos recursos da página e calcule o retângulo de destino.
  3. Escreva os operadores gráficos necessários e salve o documento.
public static void addImageUsingOperators(Path imageFile, Path outputFile) throws Exception {
    try (Document document = new Document();
         InputStream imageStream = Files.newInputStream(imageFile)) {
        Page page = document.getPages().add();
        page.setPageSize(842, 595);

        XImageCollection resourcesImages = page.getResources().getImages();
        String imageId = resourcesImages.add(imageStream);
        XImage xImage = resourcesImages.get_Item(resourcesImages.size());

        Rectangle rectangle = new Rectangle(
                0,
                0,
                page.getMediaBox().getWidth(),
                (page.getMediaBox().getWidth() * xImage.getHeight()) / xImage.getWidth(),
                true);

        page.getContents().add(new GSave());

        Matrix matrix = new Matrix(
                rectangle.getURX() - rectangle.getLLX(),
                0,
                0,
                rectangle.getURY() - rectangle.getLLY(),
                rectangle.getLLX(),
                rectangle.getLLX() + (page.getMediaBox().getHeight() - rectangle.getHeight()) / 2);
        page.getContents().add(new ConcatenateMatrix(matrix));
        page.getContents().add(new Do(imageId));
        page.getContents().add(new GRestore());

        document.save(outputFile.toString());
    }
}

Adicionar uma imagem e definir texto alternativo

Use este exemplo quando a imagem precisar incluir metadados de acessibilidade para leitores de tela.

  1. Crie um novo documento PDF Document e adicione a imagem à página.
  2. Obtenha o inserido XImage dos recursos da página.
  3. Defina o texto alternativo e salve o PDF.
public static void addImageSetAlternativeTextForImage(Path imageFile, Path outputFile) {
    try (Document document = new Document()) {
        Page page = document.getPages().add();
        page.setPageSize(842, 595);

        page.addImage(imageFile.toString(), new Rectangle(0, 0, 842, 595, true));

        XImage xImage = page.getResources().getImages().get_Item(1);
        boolean result = xImage.trySetAlternativeText("Alternative text for image", page);
        if (result) {
            System.out.println("Text has been added successfuly");
        }
        document.save(outputFile.toString());
    }
}

Adicionar uma imagem com compressão Flate

Use este exemplo quando quiser incorporar dados de imagem usando compressão Flate.

  1. Crie um novo documento PDF Document e abra o fluxo de imagem.
  2. Adicione a imagem aos recursos da página com ImageFilterType.Flate.
  3. Desenhe a imagem por meio dos operadores da página e salve o resultado.
public static void addImageToPdfWithFlateCompression(Path imageFile, Path outputFile) throws Exception {
    try (Document document = new Document();
         InputStream imageStream = Files.newInputStream(imageFile)) {
        Page page = document.getPages().add();
        XImageCollection resourcesImages = page.getResources().getImages();
        String imageId = resourcesImages.add(imageStream, ImageFilterType.Flate);

        page.getContents().add(new GSave());

        Rectangle rectangle = new Rectangle(0, 0, 600, 600, true);
        Matrix matrix = new Matrix(
                rectangle.getURX() - rectangle.getLLX(),
                0,
                0,
                rectangle.getURY() - rectangle.getLLY(),
                rectangle.getLLX(),
                rectangle.getLLY());

        page.getContents().add(new ConcatenateMatrix(matrix));
        page.getContents().add(new Do(imageId));
        page.getContents().add(new GRestore());

        document.save(outputFile.toString());
    }
}