Добавление изображения в PDF с помощью Java

Aspose.PDF for Java поддерживает как размещение изображений на высоком уровне, так и рисование с использованием низкоуровневых операторов.

Добавление изображения с координатами страницы

Используйте этот пример, когда необходимо разместить изображение в фиксированном положении на странице PDF.

  1. Создайте новый PDF Document и добавьте страницу.
  2. Вызовите page.addImage() с путем к исходному изображению и целевым прямоугольником.
  3. Сохраните сгенерированный PDF‑файл.
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());
    }
}

Добавление изображения с помощью операторов страницы

Используйте этот пример, когда вам нужен низкоуровневый контроль над размещением изображения и масштабированием с помощью операторов страницы.

  1. Создайте новый PDF Документ и откройте поток исходного изображения.
  2. Добавьте изображение в ресурсы страницы и вычислите целевой прямоугольник.
  3. Запишите необходимые графические операторы и сохраните документ.
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());
    }
}

Добавление изображения и задание альтернативного текста

Используйте этот пример, когда изображение должно включать метаданные доступности для программ чтения с экрана.

  1. Создайте новый PDF Документ и добавьте изображение на страницу.
  2. Получите вставленное изображение XImage из ресурсов страницы.
  3. Установите альтернативный текст и сохраните 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());
    }
}

Добавление изображения со сжатием Flate

Используйте этот пример, когда хотите встроить данные изображения, используя сжатие Flate.

  1. Создайте новый PDF Документ и откройте поток изображения.
  2. Добавьте изображение в ресурсы страницы с ImageFilterType.Flate.
  3. Отрисуйте изображение с помощью операторов страницы и сохраните результат.
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());
    }
}