Agregar imagen al PDF usando Java

Aspose.PDF for Java admite tanto la colocación de imágenes a alto nivel como el dibujo basado en operadores de bajo nivel.

Agregar una imagen con coordenadas de página

Utilice este ejemplo cuando necesite colocar una imagen en una posición fija en una página PDF.

  1. Cree un nuevo PDF Document y agregue una página.
  2. Llame page.addImage() con la ruta de la imagen de origen y el rectángulo de destino.
  3. Guarde el archivo PDF generado.
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());
    }
}

Agregar una imagen con operadores de página

Utilice este ejemplo cuando necesite un control de bajo nivel sobre la colocación y el escalado de la imagen mediante operadores de página.

  1. Cree un nuevo PDF Document y abra el flujo de imagen de origen.
  2. Agregue la imagen a los recursos de la página y calcule el rectángulo de destino.
  3. Escriba los operadores gráficos requeridos y guarde el 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());
    }
}

Agregar una imagen y establecer texto alternativo

Utilice este ejemplo cuando la imagen deba incluir metadatos de accesibilidad para lectores de pantalla.

  1. Cree un nuevo PDF Document y agregue la imagen a la página.
  2. Obtenga lo insertado XImage de los recursos de la página.
  3. Establezca el texto alternativo y guarde el 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());
    }
}

Agregar una imagen con compresión Flate

Use this example when you want to embed image data by using Flate compression.

  1. Cree un nuevo PDF Document y abra el flujo de imagen.
  2. Agregue la imagen a los recursos de la página con ImageFilterType.Flate.
  3. Dibuje la imagen mediante los operadores de página y guarde el 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());
    }
}