Работа с изображениями

Aspose.Words позволяет пользователям работать с изображениями очень гибким способом. В этой статье вы можете рассмотреть лишь некоторые возможности работы с изображениями.

Вставка изображения

DocumentBuilder содержит несколько дополнений к методу insert_image, который позволяет вставлять встроенное или плавающее изображение. Если изображение представляет собой метафайл EMF или WMF, оно будет вставлено в документ в формате метафайла. Все остальные изображения будут сохранены в формате PNG. В методе insert_image можно использовать изображения из разных источников:

Из файла или URL путем передачи строкового параметра
Из потока путем передачи параметра Stream
Из массива байтов путем передачи параметра массива байтов

Для каждого из методов insert_image существуют дополнительные перегрузки, которые позволяют вставлять изображение со следующими параметрами:

Встроенный или плавающий в определенном положении, например, insert_image
Процентная шкала или пользовательский размер; кроме того, метод DocumentBuilder.insert_image возвращает объект Shape, который был только что создан и вставлен, чтобы вы могли дополнительно изменять свойства объекта Shape

Вставка встроенного изображения

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

В следующем примере кода показано, как вставить встроенное изображение в положение курсора в документе:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_image(docs_base.images_dir + "Logo.jpg")

doc.save(docs_base.artifacts_dir+"WorkingWithImages.document_builder_insert_inline_image.doc")

Вставка плавающего (абсолютно расположенного) Изображение

В следующем примере кода показано, как вставить плавающее изображение из файла или URL в указанное положение и размер:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_image(docs_base.images_dir + "Logo.jpg",
    aw.drawing.RelativeHorizontalPosition.MARGIN,
    100,
    aw.drawing.RelativeVerticalPosition.MARGIN,
    100,
    200,
    100,
    aw.drawing.WrapType.SQUARE)

doc.save(docs_base.artifacts_dir+"WorkingWithImages.document_builder_insert_floating_image.doc")

Как извлечь изображения из документа

Все изображения хранятся внутри Shape узлов в Document. Чтобы извлечь из документа все изображения или картинки определенного типа, выполните следующие действия:

Используйте метод Document.get_child_nodes, чтобы выбрать все узлы Shape.
Выполните итерацию по результирующим наборам узлов.
Проверьте логическое свойство Shape.has_image.
Извлеките данные изображения, используя свойство Shape.image_data.
Сохраните данные изображения в файл.

В следующем примере кода показано, как извлекать изображения из документа и сохранять их в виде файлов:

Вы можете скачать файл шаблона для этого примера с сайта здесь.

Вы можете скачать примерный файл этого примера с сайта Aspose.Words GitHub.

Как вставить штрих-код на каждую страницу документа

В этом примере показано, как можно добавлять одинаковые или разные штрих-коды на все или определенные страницы документа Word. Прямого способа добавить штрих-коды на все страницы документа не существует, но вы можете использовать методы move_to_section, move_to_header_footer и insert_image, чтобы перейти к любому разделу или верхним/нижним колонтитулам и вставить изображения штрих-кодов, как вы можете видеть в следующем коде.

В следующем примере кода изображение штрих-кода вставляется на каждую страницу документа.

Фиксируйте соотношение сторон изображения

Соотношение сторон геометрической фигуры - это соотношение ее размеров в разных измерениях. Вы можете настроить соотношение сторон изображения, используя aspect_ratio_locked. Значение соотношения сторон фигуры по умолчанию зависит от ShapeType. Это True для ShapeType.IMAGE и False для других типов фигур.

В следующем примере кода показано, как работать с соотношением сторон:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_image(docs_base.images_dir + "Logo.jpg")
shape.aspect_ratio_locked = False

doc.save(docs_base.artifacts_dir+"WorkingWithImages.set_aspect_ratio_locked.doc")

Как получить фактические границы формы в точках

Если вы хотите, чтобы фактическая ограничивающая рамка фигуры отображалась на странице, вы можете добиться этого с помощью свойства bounds_in_points.

В следующем примере кода показано, как использовать это свойство:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_image(docs_base.images_dir + "Logo.jpg")
shape.aspect_ratio_locked = False

print("\nGets the actual bounds of the shape in points.")
rect = shape.get_shape_renderer().bounds_in_points
print(f"{rect.x}, {rect.y}, {rect.width}, {rect.height}")

Обрезка изображений

Обрезка изображения обычно означает удаление нежелательных внешних частей изображения, чтобы улучшить качество кадрирования. Она также используется для удаления некоторых частей изображения, чтобы увеличить фокусировку на определенной области.

В следующем примере кода показано, как этого добиться, используя Aspose.Words API:

# The path to the documents directory.
inputPath = docs_base.images_dir + "Logo.jpg"
outputPath = docs_base.artifacts_dir + "cropped_logo.jpg"

self.crop_image(inputPath,outputPath, 100, 90, 200, 200)

@staticmethod
def crop_image(inPath : str, outPath : str, left : int, top : int, width : int, height : int) :
    
    doc = aw.Document();
    builder = aw.DocumentBuilder(doc)
    
    croppedImage = builder.insert_image(inPath)
    
    src_width_points = croppedImage.width
    src_height_points = croppedImage.height
    
    croppedImage.width = aw.ConvertUtil.pixel_to_point(width)
    croppedImage.height = aw.ConvertUtil.pixel_to_point(height)
    
    widthRatio = croppedImage.width / src_width_points
    heightRatio = croppedImage.height / src_height_points
    
    if (widthRatio< 1) :
        croppedImage.image_data.crop_right = 1 - widthRatio
    
    if (heightRatio< 1) :
        croppedImage.image_data.crop_bottom = 1 - heightRatio
    
    leftToWidth = aw.ConvertUtil.pixel_to_point(left) / src_width_points
    topToHeight = aw.ConvertUtil.pixel_to_point(top) / src_height_points
    
    croppedImage.image_data.crop_left = leftToWidth
    croppedImage.image_data.crop_right = croppedImage.image_data.crop_right - leftToWidth
    
    croppedImage.image_data.crop_top = topToHeight
    croppedImage.image_data.crop_bottom = croppedImage.image_data.crop_bottom - topToHeight
    
    croppedImage.get_shape_renderer().save(outPath, aw.saving.ImageSaveOptions(aw.SaveFormat.JPEG))

Сохранение изображений как WMF

Aspose.Words предоставляет функциональные возможности для сохранения всех доступных изображений в документе в WMF форматируйте при преобразовании DOCX в RTF.

В следующем примере кода показано, как сохранять изображения как WMF с параметрами сохранения RTF:

Как добавить Group Shape в файл Word Работа с графиками в Python