Добавьте рамки изображений в презентации с помощью Python

Обзор

Рамки изображений в Aspose.Slides for Python позволяют размещать и управлять растровыми и векторными изображениями как нативными фигурами слайдов. Вы можете вставлять картинки из файлов или потоков, позиционировать и изменять их размер с точными координатами, применять вращение, задавать прозрачность и управлять порядком наложения вместе с другими фигурами. API также поддерживает обрезку, сохранение пропорций, настройку границ и эффектов, а также замену исходного изображения без перестройки макета. Поскольку рамки изображений ведут себя как обычные фигуры, вы можете добавлять анимацию, гиперссылки и альтернативный текст, что упрощает создание визуально насыщенных, доступных презентаций.

Создание рамок изображений

В этом разделе показано, как вставить изображение в слайд, создав PictureFrame с помощью Aspose.Slides for Python. Вы узнаете, как загрузить изображение, точно разместить его на слайде и управлять его размером и форматированием.

Создайте экземпляр класса Presentation.
Получите слайд по его индексу.
Создайте PPImage путем добавления изображения в ImageCollection презентации. Это изображение будет использоваться для заполнения фигуры.
Укажите ширину и высоту рамки.
Создайте PictureFrame нужного размера с помощью метода add_picture_frame.
Сохраните презентацию в файл PPTX.

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

import aspose.slides as slides

# Создайте объект класса Presentation для представления файла PPTX.
with slides.Presentation() as presentation:
    # Получите первый слайд.
    slide = presentation.slides[0]

    # Добавьте изображение в презентацию.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Добавьте рамку изображения размером с изображение.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

        # Сохраните презентацию в формате PPTX.
        presentation.save("picture_frame.pptx", slides.export.SaveFormat.PPTX)

Рамки изображений позволяют быстро создавать слайды презентаций из картинок. При сочетании рамок изображений с вариантами сохранения Aspose.Slides вы можете управлять операциями ввода‑вывода для конвертации изображений из одного формата в другой. Возможно, вам будут полезны эти страницы: конвертация image to JPG; конвертация JPG to image; конвертация JPG to PNG; конвертация PNG to JPG; конвертация PNG to SVG; конвертация SVG to PNG.

Создание рамок изображений с относительным масштабированием

В этом разделе демонстрируется размещение изображения фиксированного размера, а затем применение процентного масштабирования независимо к его ширине и высоте. Поскольку проценты могут различаться, соотношение сторон может измениться. Масштабирование производится относительно исходных размеров изображения.

Создайте экземпляр класса Presentation.
Получите слайд по его индексу.
Создайте PPImage путем добавления изображения в ImageCollection презентации.
Добавьте PictureFrame на слайд.
Установите относительные ширину и высоту рамки изображения.
Сохраните презентацию в файл PPTX.

Следующий код Python показывает, как создать рамку изображения с относительным масштабированием:

import aspose.slides as slides

# Создайте экземпляр класса Presentation для представления файла PPTX.
with slides.Presentation() as presentation:
    # Получите первый слайд.
    slide = presentation.slides[0]

    # Добавьте изображение в коллекцию изображений презентации.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Добавьте рамку изображения на слайд.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, 100, 100, image)

        # Установите относительные масштаб ширины и высоты.
        picture_frame.relative_scale_height = 0.8
        picture_frame.relative_scale_width = 1.35

        # Сохраните презентацию.
        presentation.save("relative_scaling.pptx", slides.export.SaveFormat.PPTX)

Извлечение растровых изображений из рамок изображений

Вы можете извлекать растровые изображения из объектов PictureFrame и сохранять их в PNG, JPG и других форматах. Пример кода ниже демонстрирует, как извлечь изображение из документа «sample.pptx» и сохранить его в формате PNG.

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    first_slide = presentation.slides[0]
    first_shape = first_slide.shapes[0]

    if isinstance(first_shape, slides.PictureFrame):
        image = first_shape.picture_format.picture.image.image
        image.save("slide_1_shape_1.png", slides.ImageFormat.PNG)

Извлечение SVG‑изображений из рамок изображений

Когда презентация содержит SVG‑графику, размещённую внутри фигур PictureFrame, Aspose.Slides for Python via .NET позволяет получить оригинальные векторные изображения с полной точностью. Путём обхода коллекции фигур слайда вы можете идентифицировать каждую PictureFrame, проверить, содержит ли связанный PPImage SVG‑контент, и затем сохранить это изображение на диск или в поток в его нативном SVG‑формате.

Следующий пример кода демонстрирует, как извлечь SVG‑изображение из рамки:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes[0]

    if isinstance(shape, slides.PictureFrame):
        svg_image = shape.picture_format.picture.image.svg_image

        if svg_image is not None:
            with open("output.svg", "w", encoding="utf-8") as svg_stream:
                svg_stream.write(svg_image.svg_content)

Получение прозрачности изображения

Aspose.Slides позволяет получить эффект прозрачности, применённый к изображению. Этот код Python демонстрирует операцию:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    picture_frame = presentation.slides[0].shapes[0]
    image_transform = picture_frame.picture_format.picture.image_transform
    for effect in image_transform:
        if isinstance(effect, slides.effects.AlphaModulateFixed):
            transparency_value = 100 - effect.amount
            print("Picture transparency: " + str(transparency_value))

Все эффекты, применяемые к изображениям, можно найти в aspose.slides.effects.

Форматирование рамки изображения

Aspose.Slides предоставляет множество параметров форматирования, которые можно применить к рамке изображения. С их помощью вы можете настроить рамку в соответствии с конкретными требованиями.

Создайте экземпляр класса Presentation.
Получите слайд по его индексу.
Создайте PPImage путем добавления изображения в ImageCollection презентации. Это изображение будет использоваться для заполнения фигуры.
Укажите ширину и высоту рамки.
Создайте PictureFrame нужного размера с помощью метода add_picture_frame слайда.
Установите цвет линии рамки изображения.
Установите толщину линии рамки изображения.
Поверните рамку изображения, задав положительное (по часовой стрелке) или отрицательное (против часовой стрелки) значение.
Сохраните изменённую презентацию в файл PPTX.

Следующий код Python демонстрирует процесс форматирования рамки изображения:

import aspose.slides as slides
import aspose.pydrawing as draw

# Создайте экземпляр класса Presentation, представляющий файл PPTX.
with slides.Presentation() as presentation:
    # Получите первый слайд.
    slide = presentation.slides[0]

    # Добавьте изображение в коллекцию изображений презентации.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

        # Добавьте рамку изображения размером с изображение.
        picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

        # Примените форматирование к рамке изображения.
        picture_frame.line_format.fill_format.fill_type = slides.FillType.SOLID
        picture_frame.line_format.fill_format.solid_fill_color.color = draw.Color.blue
        picture_frame.line_format.width = 20
        picture_frame.rotation = 45

    # Сохраните презентацию в формате PPTX.
    presentation.save("picture_formatting.pptx", slides.export.SaveFormat.PPTX)

Tip

Aspose разработала бесплатный Collage Maker. Если вам нужно объединить JPG/JPEG или PNG‑изображения, либо создать фотоколлажи, вы можете воспользоваться этим сервисом.

Добавление изображений в виде ссылок

Чтобы уменьшить размер файлов презентаций, вы можете добавлять изображения или видео через ссылки вместо встраивания файлов непосредственно в презентацию. Следующий код Python показывает, как вставить изображение и видео в заполнитель:

import aspose.slides as slides

with slides.Presentation("input.pptx") as presentation:
    slide = presentation.slides[0]

    shapes_to_remove = []

    for shape in slide.shapes:
        if shape.placeholder is None:
            continue

        if shape.placeholder.type == slides.PlaceholderType.PICTURE:
            picture_frame = slide.shapes.add_picture_frame(
                slides.ShapeType.RECTANGLE, shape.x, shape.y, shape.width, shape.height, None)

            picture_frame.picture_format.picture.link_path_long = \
                "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg"

            shapes_to_remove.append(shape)

        elif shape.placeholder.type == slides.PlaceholderType.MEDIA:
            video_frame = slide.shapes.add_video_frame(shape.X, shape.Y, shape.width, shape.height, "")

            video_frame.picture_format.picture.link_path_long = \
                "https://upload.wikimedia.org/wikipedia/commons/3/3a/I.M_at_Old_School_Public_Broadcasting_in_October_2016_02.jpg"

            video_frame.link_path_long = "https://youtu.be/t_1LYZ102RA"
            shapes_to_remove.append(shape)

    for shape in shapes_to_remove:
        slide.shapes.remove(shape)

    presentation.save("output.pptx", slides.export.SaveFormat.PPTX)

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

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

Следующий код Python показывает, как обрезать изображение на слайде:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # Добавьте изображение в коллекцию изображений презентации.
    with slides.Images.from_file("image.png") as source_image:
        image = presentation.images.add_image(source_image)

    # Добавьте рамку изображения на слайд.
    picture_frame = slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 100, 100, 420, 250, image)

    # Обрежьте изображение (значения в процентах).
    picture_frame.picture_format.crop_left = 23.6
    picture_frame.picture_format.crop_right = 21.5
    picture_frame.picture_format.crop_top = 3
    picture_frame.picture_format.crop_bottom = 31

    # Сохраните результат.
    presentation.save("cropped_image.pptx", slides.export.SaveFormat.PPTX)

Удаление обрезанных областей изображений

Если необходимо удалить обрезанные области изображения в рамке, используйте метод delete_picture_cropped_areas. Этот метод возвращает обрезанное изображение или оригинальное изображение, если обрезка не требуется.

Следующий код Python демонстрирует операцию:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    slide = presentation.slides[0]

    # Получить PictureFrame с первого слайда.
    picture_frame = slides.shape[0]

    # Получить PictureFrame с первого слайда.
    cropped_image = picture_frame.picture_format.delete_picture_cropped_areas()

    # Сохранить результат.
    presentation.save("deleted_cropped_areas.pptx", slides.export.SaveFormat.PPTX)

NOTE

Метод delete_picture_cropped_areas добавляет обрезанное изображение в коллекцию изображений презентации. Если изображение используется только в обработанном PictureFrame, это может уменьшить размер презентации; в противном случае количество изображений в полученной презентации может возрасти.

Во время обрезки этот метод преобразует метафайлы WMF/EMF в растровое PNG‑изображение.

Блокировка соотношения сторон

Если необходимо, чтобы фигура, содержащая изображение, сохраняла соотношение сторон после изменения размеров изображения, задайте свойство aspect_ratio_locked значение True.

Следующий код Python показывает, как заблокировать соотношение сторон фигуры:

import aspose.slides as slides

with slides.Presentation("sample.pptx") as presentation:
    layout = presentation.layout_slides.get_by_type(slides.SlideLayoutType.CUSTOM)
    empty_slide = presentation.slides.add_empty_slide(layout)

    with slides.Images.from_file("image.png") as source_image:
        image = presentation.images.add_image(source_image)

    picture_frame = empty_slide.shapes.add_picture_frame(slides.ShapeType.RECTANGLE, 50, 50, image.width, image.height, image)

    # Блокировать соотношение сторон при изменении размеров.
    picture_frame.picture_frame_lock.aspect_ratio_locked = True

    presentation.save("aspect_ratio_locked.pptx", slides.export.SaveFormat.PPTX)

NOTE

Эта настройка Lock Aspect Ratio сохраняет только соотношение сторон фигуры, а не соотношение сторон изображения внутри неё.

Использование свойств смещения растягивания

С помощью свойств stretch_offset_left, stretch_offset_top, stretch_offset_right и stretch_offset_bottom класса PictureFillFormat вы можете определить прямоугольник заполнения.

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

Создайте экземпляр класса Presentation.
Получите ссылку на слайд по его индексу.
Добавьте прямоугольный AutoShape.
Установите тип заливки фигуры.
Установите режим заливки изображения фигуры.
Загрузите изображение.
Привяжите изображение к заливке фигуры.
Задайте смещения изображения от соответствующих граней ограничивающего прямоугольника фигуры.
Сохраните презентацию в файл PPTX.

Следующий код Python демонстрирует, как использовать свойства смещения растягивания:

import aspose.slides as slides

# Создайте экземпляр класса Presentation, представляющего файл PPTX.
with slides.Presentation() as presentation:
    # Получите первый слайд.
    slide = presentation.slides[0]

    # Добавьте прямоугольный AutoShape.
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20, 20, 300, 300)

    # Установите тип заливки фигуры.
    shape.fill_format.fill_type = slides.FillType.PICTURE

    # Установите режим заливки изображения фигуры.
    shape.fill_format.picture_fill_format.picture_fill_mode = slides.PictureFillMode.STRETCH

    # Загрузите изображение и добавьте его в презентацию.
    with open("image.jpeg", "rb") as image_stream:
        image = presentation.images.add_image(image_stream)

    # Присвойте изображение для заливки фигуры.
    shape.fill_format.picture_fill_format.picture.image = image

    # Укажите смещения изображения от соответствующих граней ограничивающего прямоугольника фигуры.
    shape.fill_format.picture_fill_format.stretch_offset_left = 25
    shape.fill_format.picture_fill_format.stretch_offset_right = 25
    shape.fill_format.picture_fill_format.stretch_offset_top = -20
    shape.fill_format.picture_fill_format.stretch_offset_bottom = -10

    # Сохраните файл PPTX на диск.
    presentation.save("stretch_offset.pptx", slides.export.SaveFormat.PPTX)

Tip

Aspose предоставляет бесплатные конвертеры — JPEG to PowerPoint и PNG to PowerPoint — которые позволяют быстро создавать презентации из изображений.

FAQ

Как узнать, какие форматы изображений поддерживаются для PictureFrame?

Aspose.Slides поддерживает как растровые изображения (PNG, JPEG, BMP, GIF и т.д.), так и векторные (например, SVG) через объект изображения, присваиваемый PictureFrame. Список поддерживаемых форматов в целом совпадает с возможностями движка конвертации слайдов и изображений.

Как добавление десятков больших изображений повлияет на размер и производительность PPTX?

Встраивание больших изображений увеличивает размер файла и потребление памяти; связывание изображений помогает снизить размер презентации, но требует доступности внешних файлов. Aspose.Slides предоставляет возможность добавлять изображения по ссылке для уменьшения размера файла.

Как заблокировать объект изображения от случайного перемещения/изменения размера?

Используйте shape locks для PictureFrame (например, отключите перемещение или изменение размера). Механизм блокировки описан для фигур в отдельной статье о защите и поддерживается для различных типов фигур, включая PictureFrame.

Сохраняется ли векторная точность SVG при экспорте презентации в PDF/изображения?

Aspose.Slides позволяет извлечь SVG из PictureFrame как оригинальный вектор. При экспорте в PDF или растровые форматы результат может быть растровым в зависимости от настроек экспорта; факт того, что исходный SVG хранится как вектор, подтверждается поведением извлечения.