Форматирование фигур PowerPoint в Python через Java

Введение

Форматируйте фигуры в PowerPoint, регулируя их контуры, заливки и эффекты. Aspose.Slides for Python via Java позволяет управлять этими параметрами программно, включая прозрачность, поворот и 3D‑форматирование.

Варианты форматирования фигур в PowerPoint

Aspose.Slides for Python via Java предоставляет классы и методы, позволяющие форматировать фигуры, используя те же параметры, что доступны в PowerPoint.

Форматирование линий

Используйте Shape.getLineFormat для управления контуром фигуры. В этом примере создаётся незалитый прямоугольник с синей пунктирной обводкой. LineFormat.setStyle выбирает составную линию «толстая‑тонкая», а LineFormat.setWidth задаёт её ширину 7 пунктов, а LineFormat.setDashStyle выбирает тип штриха.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, LineDashStyle, LineStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
    shape.getFillFormat().setFillType(FillType.NoFill)
    shape.getLineFormat().setStyle(LineStyle.ThickThin)
    shape.getLineFormat().setWidth(7)
    shape.getLineFormat().setDashStyle(LineDashStyle.Dash)
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)

    presentation.save("formatted_lines.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Отформатированные линии в презентации

Установить пользовательские шаблоны штрихов линии

Используйте LineFormat.setCustomDashPattern, когда предопределённые стили линий не обеспечивают нужные длины штрихов и промежутков, например для фирменных контуров или технических схем. Назначение шаблона автоматически меняет стиль штрихов линии на LineDashStyle.Custom.

Элементы массива чередуются между длинами штриха и промежутка, начиная с штриха. Каждое значение является кратным ширине линии: [4, 2] при ширине 3 пункта дает штрих длиной 12 пунктов, за которым следует промежуток в 6 пунктов. Используйте пары конечных, неотрицательных значений для определения полных сегментов штрих‑промежуток. В примере использованы положительные значения, чтобы каждый штрих и промежуток были видимыми.

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpjpype.startJVM()

from asposeslides.api import FillType, LineArrowheadStyle, LineCapStyle, LineDashStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color

presentation = Presentation()
try:
    presentation.getSlideSize().setSize(600, 300, SlideSizeScaleType.DoNotScale)
    slide = presentation.getSlides().get_Item(0)

    patterns = [
        [4, 2],
        [1, 2],
        [6, 2, 1, 2],
        [4, 2],
        [4, 2]
    ]

    for i, pattern in enumerate(patterns):
        line = slide.getShapes().addAutoShape(ShapeType.Line, 50, 50 + i * 50, 500, 0)
        line.getLineFormat().setWidth(6 if i == 3 else 3)
        line.getLineFormat().getFillFormat().setFillType(FillType.Solid)
        color = Color(0, 0, 139)
        line.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
        line.getLineFormat().setCapStyle(LineCapStyle.Flat)
        line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None_)
        line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None_)
        line.getLineFormat().setCustomDashPattern(jpype.JArray(jpype.JFloat)(pattern))

    # Вернуть последнюю линию к сплошному стилю.
    slide.getShapes().get_Item(4).getLineFormat().setDashStyle(LineDashStyle.Solid)

    presentation.save("custom_dash_patterns.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Чтобы вернуться к предопределённому пунктирному стилю, передайте LineDashStyle.Dash в LineFormat.setDashStyle. Выбранный стиль управляет внешним видом линии.

Результат в PowerPoint сверху вниз: {4, 2}, 3 pt; {1, 2}, 3 pt; {6, 2, 1, 2}, 3 pt; {4, 2}, 6 pt; и Solid, 3 pt.

Три пользовательских шаблона штрихов, более широкая линия с первым шаблоном и сплошная линия в PowerPoint

Установить типы концов линии

Используйте LineFormat.setCapStyle для установки концов открытой линии. Класс LineCapStyle предоставляет три явных стиля концов:

  • Flat: Линия заканчивается в конечной точке.
  • Round: Полукруглый конец выступает за конечную точку на половину ширины линии.
  • Square: Квадратный конец выступает за конечную точку на половину ширины линии.

Класс также включает NotDefined, что означает, что стиль конца явно не назначен.

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

Следующий пример создаёт три почти одинаковые горизонтальные линии шириной 20 пунктов. Сверху вниз они используют плоские, округлые и квадратные концы. Их конечные точки имеют одинаковые горизонтальные координаты; округлые и квадратные концы выступают на 10 пунктов за каждую конечную точку.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, LineArrowheadStyle, LineCapStyle, LineDashStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color

presentation = Presentation()
try:
    presentation.getSlideSize().setSize(500, 240, SlideSizeScaleType.DoNotScale)
    slide = presentation.getSlides().get_Item(0)

    cap_styles = [LineCapStyle.Flat, LineCapStyle.Round, LineCapStyle.Square]

    for i, cap_style in enumerate(cap_styles):
        line = slide.getShapes().addAutoShape(ShapeType.Line, 100, 50 + i * 70, 300, 0)
        line.getLineFormat().setWidth(20)
        line.getLineFormat().getFillFormat().setFillType(FillType.Solid)
        color = Color(0, 0, 139)
        line.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
        line.getLineFormat().setDashStyle(LineDashStyle.Solid)
        line.getLineFormat().setCapStyle(cap_style)
        line.getLineFormat().setBeginArrowheadStyle(LineArrowheadStyle.None_)
        line.getLineFormat().setEndArrowheadStyle(LineArrowheadStyle.None_)

    presentation.save("line_caps.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат в PowerPoint сверху вниз: Flat, Round и Square.

Плоские, округлые и квадратные концы на одинаковых толстых линиях в PowerPoint

Применить эффект наброска к линиям фигур

Эффект наброска делает линию фигуры выглядящей нарисованной от руки. Используйте Shape.getLineFormat для доступа к настройкам линии, LineFormat.getSketchFormat для доступа к настройкам наброска и SketchFormat.setSketchType для выбора значения из класса LineSketchType.

В следующем коде Python показано, как применить эффект LineSketchType.Curved, прочитать явно заданное значение и удалить эффект с помощью LineSketchType.None_:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import LineSketchType, Presentation, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100)

    sketch_format = shape.getLineFormat().getSketchFormat()
    sketch_format.setSketchType(LineSketchType.Curved)
    explicit_sketch_type = sketch_format.getSketchType()
    print("Explicit sketch type:", explicit_sketch_type)
    sketch_format.setSketchType(LineSketchType.None_)
finally:
    presentation.dispose()

Значение, возвращаемое SketchFormat.getSketchType, представляет настройку, назначенную непосредственно фигуре. Если форматирование линии может наследоваться из темы, шаблона или макета слайда, используйте LineFormat.getEffective и прочитайте тип наброска из полученного эффективного форматирования линии, как показано ниже. Эффективное значение отражает форматирование, которое действительно применяется после разрешения наследования. Этот пример требует существующей презентации с хотя бы одной фигурой на первом слайде и выводит оба значения:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation

presentation = Presentation("presentation.pptx")
try:
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)

    line_format = shape.getLineFormat()
    explicit_sketch_type = line_format.getSketchFormat().getSketchType()
    effective_line_format = line_format.getEffective()
    effective_sketch_type = effective_line_format.getSketchFormat().getSketchType()

    print("Explicit sketch type:", explicit_sketch_type)
    print("Effective sketch type:", effective_sketch_type)
finally:
    presentation.dispose()

Форматирование стилей соединений

Вот три варианта типа соединения:

  • Round
  • Miter
  • Bevel

Стиль соединения определяет, как две линии контура встречаются в углу. Используйте Round для скруглённых углов, Miter для острых углов или Bevel для обрезанных углов.

Стиль соединения в презентации

Этот пример создаёт три черных прямоугольника с синими контурами шириной 15 пунктов. Он использует LineFormat.setJoinStyle для установки значений miter, bevel и round в LineJoinStyle соответственно, чтобы сравнить, как рисуются углы.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, LineJoinStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    miter_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 20, 150, 75)
    bevel_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 210, 20, 150, 75)
    round_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 20, 135, 150, 75)

    miter_shape.getFillFormat().setFillType(FillType.Solid)
    miter_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    bevel_shape.getFillFormat().setFillType(FillType.Solid)
    bevel_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
    round_shape.getFillFormat().setFillType(FillType.Solid)
    round_shape.getFillFormat().getSolidFillColor().setColor(Color.BLACK)

    miter_shape.getLineFormat().setWidth(15)
    bevel_shape.getLineFormat().setWidth(15)
    round_shape.getLineFormat().setWidth(15)

    miter_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    miter_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
    bevel_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    bevel_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)
    round_shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    round_shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.BLUE)

    miter_shape.getLineFormat().setJoinStyle(LineJoinStyle.Miter)
    bevel_shape.getLineFormat().setJoinStyle(LineJoinStyle.Bevel)
    round_shape.getLineFormat().setJoinStyle(LineJoinStyle.Round)

    miter_shape.getTextFrame().setText("Miter Join Style")
    bevel_shape.getTextFrame().setText("Bevel Join Style")
    round_shape.getTextFrame().setText("Round Join Style")

    presentation.save("join_styles.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Ограничить соединения Miter на острых углах

Используйте LineFormat.setMiterLimit вместе с LineFormat.setJoinStyle, установленным в LineJoinStyle.Miter, чтобы ограничить, насколько далеко может выступать острый угол.

Ограничение представляет собой отношение расстояния между внутренним и внешним углом соединения к ширине линии. Например, значение 8 допускает длину соединения miter до восьми ширин линии; это не измерение в пунктах. Если угол превышает ограничение, PowerPoint использует обрезанный (bevel) соединитель в этом месте. Большее значение позволяет более острые точки. Настройка влияет только на соединения miter, и её изменение не имеет видимого эффекта, когда угол остаётся внутри ограничений.

В этом примере создаются два одинаковых незалитых треугольника с контурами шириной 20 пунктов. Левый треугольник использует ограничение 2, а правый — 8. Каждый треугольник шириной 80 пунктов и высотой 160 пунктов, что даёт отношение длины miter к ширине линии в верхнем угле примерно 4.12. Поэтому PowerPoint обрезает левый верхний угол и сохраняет правый.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, LineJoinStyle, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color

presentation = Presentation()
try:
    presentation.getSlideSize().setSize(500, 320, SlideSizeScaleType.DoNotScale)
    slide = presentation.getSlides().get_Item(0)

    miter_limits = [2.0, 8.0]

    for i, miter_limit in enumerate(miter_limits):
        triangle = slide.getShapes().addAutoShape(ShapeType.Triangle, 90 + i * 240, 110, 80, 160)
        triangle.getFillFormat().setFillType(FillType.NoFill)
        triangle.getLineFormat().setWidth(20)
        triangle.getLineFormat().getFillFormat().setFillType(FillType.Solid)
        color = Color(0, 0, 139)
        triangle.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
        triangle.getLineFormat().setJoinStyle(LineJoinStyle.Miter)
        triangle.getLineFormat().setMiterLimit(miter_limit)

    presentation.save("miter_limits.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат в PowerPoint: Miter limit 2 слева и miter limit 8 справа.

Обрезанный верхний угол с ограничением miter 2 и заострённый угол с ограничением miter 8 в PowerPoint

Градиентная заливка

Градиентная заливка смешивает цвета по фигуре. Этот пример заполняет эллипс линейным градиентом под углом 45 градусов от красного к пурпурному, используя FillFormat.getGradientFormat. Метод GradientStopCollection.addPresetColor размещает остановки цвета на позициях 0 и 1, в начале и в конце градиента. Очистка существующих остановок гарантирует, что используются только эти два цвета.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, GradientShape, Presentation, PresetColor, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 150, 75)
    shape.getFillFormat().setFillType(FillType.Gradient)
    shape.getFillFormat().getGradientFormat().setGradientShape(GradientShape.Linear)
    shape.getFillFormat().getGradientFormat().setLinearGradientAngle(45)
    shape.getFillFormat().getGradientFormat().getGradientStops().clear()
    shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(1.0, PresetColor.Purple)
    shape.getFillFormat().getGradientFormat().getGradientStops().addPresetColor(0.0, PresetColor.Red)

    presentation.save("gradient_fill.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Эллипс с градиентной заливкой

Если градиент выглядит иначе в экспортированном изображении, чем в PowerPoint, см. Choose a Gradient Rendering Style. Вы можете выбрать стиль рендеринга, не изменяя градиентную заливку, сохранённую в презентации.

Установить угол линейного градиента

Используйте GradientFormat.setLinearGradientAngle для управления ориентацией заливки GradientShape.Linear. Угол измеряется в градусах и увеличивается по часовой стрелке: 0 — слева направо, 90 — сверху вниз, 180 — справа налево, 270 — снизу вверх. Поддерживаются дробные углы. Конечные углы за пределами [0, 360) нормализуются к одному обороту; например, -45 становится 315, а 360 — 0.

Этот пример создаёт шесть прямоугольников с одинаковыми остановками красного, зелёного и синего цветов в позициях 0, 0.5 и 1. Масштабирование отключено, чтобы угол можно было сравнивать независимо от пропорций прямоугольников. Углы слева направо: 0, 45 и 90 в первой строке, и 135, 180 и 270 во второй строке.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color

presentation = Presentation()
try:
    presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale)
    slide = presentation.getSlides().get_Item(0)

    angles = [0, 45, 90, 135, 180, 270]

    for i, angle in enumerate(angles):
        x = 30 + (i % 3) * 230
        y = 30 + (i // 3) * 190

        shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 200, 150)
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
        shape.getFillFormat().setFillType(FillType.Gradient)

        gradient = shape.getFillFormat().getGradientFormat()
        gradient.setGradientShape(GradientShape.Linear)
        gradient.getGradientStops().clear()
        gradient.getGradientStops().add(0, Color.RED)
        gradient.getGradientStops().add(0.5, Color.GREEN)
        gradient.getGradientStops().add(1, Color.BLUE)
        gradient.setLinearGradientScaled(NullableBool.False_)
        gradient.setLinearGradientAngle(angle)

    presentation.save("linear_gradient_angles.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат в PowerPoint:

Линейные градиенты при 0, 45 и 90 градусах в верхней строке и 135, 180 и 270 градусах в нижней строке

Масштабировать линейный градиент вместе с фигурой

GradientFormat.setLinearGradientScaled принимает значение NullableBool. Установите его явно в False_, чтобы сохранять геометрический угол градиента при изменении пропорций фигуры, или в True_, чтобы масштабировать градиент вместе с шириной и высотой фигуры. При включённом масштабировании видимый угол может отличаться от заданного угла у неквадратной фигуры.

В следующем примере используется угол 45 градусов и те же цветовые остановки, что и в сравнении углов. Левая колонка использует False_; правая — True_. Каждая колонка содержит широкий прямоугольник над высоким. Оба начинаются с одинаковых широких размеров; изменение ширины и высоты второго прямоугольника демонстрирует, как заливка реагирует на изменение размеров без изменения настроек градиента.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color

presentation = Presentation()
try:
    presentation.getSlideSize().setSize(720, 460, SlideSizeScaleType.DoNotScale)
    slide = presentation.getSlides().get_Item(0)

    scaling_options = [NullableBool.False_, NullableBool.True_]

    for column, scaled in enumerate(scaling_options):
        for row in range(2):
            x = 30 + column * 360
            y = 30 if row == 0 else 150

            shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, y, 300, 90)
            shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
            shape.getFillFormat().setFillType(FillType.Gradient)

            gradient = shape.getFillFormat().getGradientFormat()
            gradient.setGradientShape(GradientShape.Linear)
            gradient.getGradientStops().clear()
            gradient.getGradientStops().add(0, Color.RED)
            gradient.getGradientStops().add(0.5, Color.GREEN)
            gradient.getGradientStops().add(1, Color.BLUE)
            gradient.setLinearGradientAngle(45)
            gradient.setLinearGradientScaled(scaled)

            if row == 1:
                shape.setWidth(90)
                shape.setHeight(280)

    presentation.save("linear_gradient_scaling.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат в PowerPoint, с отключённым масштабированием слева и включённым справа:

Широкие и высокие прямоугольники с градиентом 45 градусов, сравнение LinearGradientScaled False слева и True справа

При отключённом масштабировании диагональные цветовые полосы сохраняют одинаковую ориентацию в обоих прямоугольниках. При включённом масштабировании полосы растягиваются вместе с пропорциями фигуры. Это помогает воспроизвести градиент шаблона при адаптации фигуры к другому размеру. Для квадрата включение масштабирования не меняет внешний вид этого градиента 45 градусов.

Оба параметра — угол и масштабирование — применимы к линейным градиентам. Они не управляют заливками GradientShape.Radial or GradientShape.Rectangle.

Скомбинировать угол с направлением градиента

GradientFormat.setGradientDirection выбирает стиль градиента из класса GradientDirection; это не замена числовому углу. Для линейного градиента стили углов могут менять область распределения цветов без изменения угла, заданного через setLinearGradientAngle. Сохраняйте направление неизменным при сравнении углов или масштабировании.

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, GradientDirection, GradientShape, NullableBool, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    for i in range(2):
        shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 30 + i * 140, 320, 100)
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
        shape.getFillFormat().setFillType(FillType.Gradient)

        gradient = shape.getFillFormat().getGradientFormat()
        gradient.setGradientShape(GradientShape.Linear)
        gradient.getGradientStops().clear()
        gradient.getGradientStops().add(0, Color.RED)
        gradient.getGradientStops().add(0.5, Color.GREEN)
        gradient.getGradientStops().add(1, Color.BLUE)
        gradient.setLinearGradientScaled(NullableBool.True_)

        if i == 0:
            gradient.setGradientDirection(GradientDirection.FromCorner1)
            gradient.setLinearGradientAngle(30)
        else:
            gradient.setLinearGradientAngle(30)
            gradient.setGradientDirection(GradientDirection.FromCorner1)

    presentation.save("linear_gradient_direction.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Заполнение узором

Заполнение узором применяет двухцветный узор, например точки, полосы или шахматную сетку. Этот пример использует PatternFormat.setPatternStyle для выбора узора решётки. PatternFormat.getBackColor задаёт светло‑серый фон, а PatternFormat.getForeColor задаёт жёлтый цвет узора.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, PatternStyle, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
    shape.getFillFormat().setFillType(FillType.Pattern)
    shape.getFillFormat().getPatternFormat().setPatternStyle(PatternStyle.Trellis)
    shape.getFillFormat().getPatternFormat().getBackColor().setColor(Color.LIGHT_GRAY)
    shape.getFillFormat().getPatternFormat().getForeColor().setColor(Color.YELLOW)

    presentation.save("pattern_fill.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Прямоугольник с заполнением узором

Заполнение изображением

Заполнение изображением использует картинку внутри фигуры. Этот пример требует локального изображения и использует Images.fromFile для загрузки его в коллекцию изображений презентации. Установка PictureFillFormat.setPictureFillMode в режим мозаики повторяет изображение внутри прямоугольника. Исходное изображение, использованное здесь, показано ниже:

Изображение лотоса

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Images, PictureFillMode, Presentation, SaveFormat, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 255, 130)
    shape.getFillFormat().setFillType(FillType.Picture)
    shape.getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Tile)

    image = Images.fromFile("lotus.png")
    try:
        picture = presentation.getImages().addImage(image)
    finally:
        image.dispose()
    shape.getFillFormat().getPictureFillFormat().getPicture().setImage(picture)

    presentation.save("picture_fill.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Фигура с заполнением изображением

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

Если вы хотите установить мозаичное изображение как текстуру и настроить поведение плитки, вы можете использовать следующие методы класса PictureFillFormat:

  • setPictureFillMode: Устанавливает режим заполнения изображением — Tile или Stretch.
  • setTileAlignment: Указывает выравнивание плиток внутри фигуры.
  • setTileFlip: Управляет тем, будет ли плитка отражена по горизонтали, вертикали или обеим осям.
  • setTileOffsetX: Задаёт горизонтальное смещение плитки (в пунктах) от начала фигуры.
  • setTileOffsetY: Задаёт вертикальное смещение плитки (в пунктах) от начала фигуры.
  • setTileScaleX: Определяет горизонтальный масштаб плитки в процентах.
  • setTileScaleY: Определяет вертикальный масштаб плитки в процентах.

Этот пример требует локального изображения и настраивает PictureFillFormat для повторения его с масштабом 50 % от оригинального размера. Смещения −32 пункта сдвигают плитки горизонтально и вертикально; выравнивание снизу‑справа и отражение в обеих направлениях определяют расположение повторяющейся текстуры.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Images, PictureFillMode, Presentation, RectangleAlignment, SaveFormat, ShapeType, TileFlip

presentation = Presentation()
try:
    first_slide = presentation.getSlides().get_Item(0)

    shape = first_slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 190, 95)
    shape.getFillFormat().setFillType(FillType.Picture)

    source_image = Images.fromFile("lotus.png")
    try:
        presentation_image = presentation.getImages().addImage(source_image)
    finally:
        source_image.dispose()

    picture_fill_format = shape.getFillFormat().getPictureFillFormat()
    picture_fill_format.getPicture().setImage(presentation_image)
    picture_fill_format.setPictureFillMode(PictureFillMode.Tile)
    picture_fill_format.setTileOffsetX(-32)
    picture_fill_format.setTileOffsetY(-32)
    picture_fill_format.setTileScaleX(50)
    picture_fill_format.setTileScaleY(50)
    picture_fill_format.setTileAlignment(RectangleAlignment.BottomRight)
    picture_fill_format.setTileFlip(TileFlip.FlipBoth)

    presentation.save("tile.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Параметры плитки

Заполнение сплошным цветом

Сплошная заливка придаёт фигуре один единственный равномерный цвет. Этот пример использует FillFormat.setFillType для установки режима сплошной заливки и задаёт жёлтый цвет через FillFormat.getSolidFillColor, затем сохраняет прямоугольник в презентацию.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
    shape.getFillFormat().setFillType(FillType.Solid)
    shape.getFillFormat().getSolidFillColor().setColor(Color.YELLOW)

    presentation.save("solid_color_fill.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Фигура со сплошной заливкой

Копировать цвета, сохраняя ссылки на тему

Используйте ColorFormat.copyFrom для копирования определения цвета, включая тип цвета, ссылку на тему и преобразования. Это полезно при переносе цвета заливки между фигурами, которые должны продолжать следовать теме презентации. Метод копирует только цвет: он не копирует тип заливки, контур или другие параметры фигур. Установите тип заливки назначения явно с помощью FillFormat.setFillType.

В этом примере создаются три прямоугольника слева направо: исходный, копия, учитывающая тему, и копия с фиксированным RGB. Исходный использует ColorFormat.setSchemeColor для ссылки на первый акцентный цвет и добавляет оттенок через ColorOperationCollection.add. Копия RGB использует эффективный цвет заливки исходного, поэтому все три изначально выглядят одинаково. Вызов ColorFormat.setColor задаёт фиксированное значение RGB и очищает любые существующие преобразования цвета.

import jpage
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ColorTransformOperation, FillType, ImageFormat, Presentation, SaveFormat, SchemeColor, ShapeType, SlideSizeScaleType
from java.awt import Color

presentation = Presentation()
try:
    presentation.getSlideSize().setSize(660, 220, SlideSizeScaleType.DoNotScale)
    slide = presentation.getSlides().get_Item(0)

    accent_color = Color(65, 105, 225)
    presentation.getMasterTheme().getColorScheme().getAccent1().setColor(accent_color)

    source = slide.getShapes().addAutoShape(ShapeType.Rectangle, 30, 40, 180, 140)
    theme_copy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 240, 40, 180, 140)
    rgb_copy = slide.getShapes().addAutoShape(ShapeType.Rectangle, 450, 40, 180, 140)

    for shape in (source, theme_copy, rgb_copy):
        shape.getFillFormat().setFillType(FillType.Solid)
        shape.getLineFormat().getFillFormat().setFillType(FillType.NoFill)

    source_color = source.getFillFormat().getSolidFillColor()
    source_color.setSchemeColor(SchemeColor.Accent1)
    source_color.getColorTransform().add(ColorTransformOperation.Tint, 0.75)

    theme_copy.getFillFormat().getSolidFillColor().copyFrom(source_color)
    rgb_copy.getFillFormat().getSolidFillColor().setColor(source.getFillFormat().getEffective().getSolidFillColor())

    before = slide.getImage(1.0, 1.0)
    try:
        before.save("color-copy-before.png", ImageFormat.Png)
    finally:
        before.dispose()

    # Ссылки на тему следуют новому акцентному цвету; фиксированное значение RGB не меняется.
    accent_color = Color(255, 69, 0)
    presentation.getMasterTheme().getColorScheme().getAccent1().setColor(accent_color)

    after = slide.getImage(1.0, 1.0)
    try:
        after.save("color-copy-after.png", ImageFormat.Png)
    finally:
        after.dispose()
    presentation.save("copied_colors.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

До изменения темы все три заливки совпадают:

Исходный, copyFrom назначение и фиксированный RGB назначение с одинаковыми синими заливками

После изменения темы исходный и копия, учитывающая тему, следуют новому акцентному цвету и сохраняют свой оттенок. Фиксированная RGB копия остаётся синей:

Исходный и copyFrom назначение с оранжевыми заливками, в то время как фиксированный RGB назначение остаётся синим

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

Сохранение и повторное открытие PPTX сохраняет тип скопированного цвета, возвращаемый ColorFormat.getColorType, ссылку на тему и коллекцию преобразований, возвращаемую ColorFormat.getColorTransform; определение не сводится к RGB.

При копировании между разными контекстами тем, например презентациями с различными наборами акцентных цветов, скопированная ссылка разрешается относительно темы назначения. Та же ссылка и преобразования могут дать иной видимый цвет. См. Presentation Theme для получения дополнительной информации о настройке цветов темы.

Использовать фон слайда в качестве заливки фигуры

Используйте AutoShape.setUseBackgroundFill, когда фигура должна соответствовать фону слайда, например в шаблоне презентации. Сначала установите тип заливки с помощью FillFormat.setFillType в FillType.NotDefined , чтобы удалить любую явную заливку. В этой комбинации фигура использует фон слайда вместо своей стилизованной заливки. Включение флага само по себе не удаляет существующую явную заливку.

Это отличается от FillType.NoFill: заливка фоном покрывает объекты за фигурой соответствующей областью фона слайда, тогда как отсутствие заливки оставляет эти объекты видимыми. Градиент остаётся выровненным по слайду, а не начинается заново внутри каждой фигуры.

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

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BackgroundType, FillType, GradientShape, Presentation, SaveFormat, ShapeType, SlideSizeScaleType
from java.awt import Color

presentation = Presentation()
try:
    presentation.getSlideSize().setSize(720, 400, SlideSizeScaleType.DoNotScale)
    slide = presentation.getSlides().get_Item(0)

    # Унаследовать градиент от мастера.
    slide.getBackground().setType(BackgroundType.NotDefined)
    slide.getLayoutSlide().getBackground().setType(BackgroundType.NotDefined)
    background = slide.getLayoutSlide().getMasterSlide().getBackground()
    background.setType(BackgroundType.OwnBackground)
    background.getFillFormat().setFillType(FillType.Gradient)
    gradient = background.getFillFormat().getGradientFormat()
    gradient.setGradientShape(GradientShape.Linear)
    gradient.setLinearGradientAngle(0)
    gradient.getGradientStops().clear()
    color = Color(0, 0, 139)
    gradient.getGradientStops().add(0, color)
    color = Color(135, 206, 250)
    gradient.getGradientStops().add(1, color)

    # Добавьте этот объект первым, чтобы он находился позади прямоугольников.
    band = slide.getShapes().addAutoShape(ShapeType.Rectangle, 25, 150, 670, 100)
    band.getFillFormat().setFillType(FillType.Solid)
    band.getFillFormat().getSolidFillColor().setColor(Color.MAGENTA)
    band.getLineFormat().getFillFormat().setFillType(FillType.NoFill)

    background_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 100, 160, 200)
    background_shape.getFillFormat().setFillType(FillType.NotDefined)
    background_shape.setUseBackgroundFill(True)

    no_fill_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 280, 100, 160, 200)
    no_fill_shape.getFillFormat().setFillType(FillType.NoFill)

    explicit_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 510, 100, 160, 200)
    explicit_shape.getFillFormat().setFillType(FillType.NotDefined)
    explicit_shape.setUseBackgroundFill(True)

    # Отключите заливку фоном перед применением явной заливки.
    explicit_shape.setUseBackgroundFill(False)
    explicit_shape.getFillFormat().setFillType(FillType.Solid)
    color = Color(255, 165, 0)
    explicit_shape.getFillFormat().getSolidFillColor().setColor(color)

    presentation.save("background_fill.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат слева направо: background fill, no fill и explicit fill. Магентовая полоса скрыта левым и правым прямоугольниками, но остаётся видимой через средний прямоугольник.

Фоновая заливка, отсутствие заливки и явная оранжевая заливка поверх магентовой полосы

То же поведение применяется к фону, определённому непосредственно на слайде или унаследованному из макета. Фигура использует разрешённый фон слайда; в примере фоны как слайда, так и макета оставлены неопределёнными, поэтому их предоставляет мастер.

Установить прозрачность

Для сплошной заливки альфа‑компонент цвета контролирует непрозрачность: 0 — полностью прозрачно, 255 — полностью непрозрачно. Этот пример использует альфа‑значение 128 для жёлтого прямоугольника, делая его примерно на 50 % прозрачным, чтобы нижний прямоугольник оставался видимым. Цвет задаётся через FillFormat.getSolidFillColor.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    solid_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)

    transparent_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 80, 80, 150, 75)
    transparent_shape.getFillFormat().setFillType(FillType.Solid)
    color = Color(255, 255, 0, 128)
    transparent_shape.getFillFormat().getSolidFillColor().setColor(color)

    presentation.save("shape_transparency.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Прозрачная фигура

Повернуть фигуры

Используйте Shape.setRotation для вращения фигуры в плоскости слайда. Угол измеряется в градусах; этот пример вращает прямоугольник на 5 градусов по часовой стрелке и сохраняет презентацию.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
    shape.setRotation(5)

    presentation.save("shape_rotation.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Поворот фигуры

Добавить 3D‑эффекты фаски

Используйте Shape.getThreeDFormat , чтобы придать фигуре глубину и фаску. Этот пример создаёт зелёный эллипс с оранжевой обводкой, использует ThreeDFormat.setDepth для установки глубины в 4 пункта и применяет круглую верхнюю фаску шириной и высотой 6 пунктов через ThreeDFormat.getBevelTop. Фронтальная ортографическая камера и трёхточечное освещение делают фаску видимой.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BevelPresetType, CameraPresetType, FillType, LightRigPresetType, LightingDirection, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Ellipse, 50, 50, 100, 100)
    shape.getFillFormat().setFillType(FillType.Solid)
    color = Color(0, 128, 0)
    shape.getFillFormat().getSolidFillColor().setColor(color)
    shape.getLineFormat().getFillFormat().setFillType(FillType.Solid)
    color = Color(255, 165, 0)
    shape.getLineFormat().getFillFormat().getSolidFillColor().setColor(color)
    shape.getLineFormat().setWidth(2.0)
    shape.getThreeDFormat().setDepth(4)
    shape.getThreeDFormat().getBevelTop().setBevelType(BevelPresetType.Circle)
    shape.getThreeDFormat().getBevelTop().setHeight(6)
    shape.getThreeDFormat().getBevelTop().setWidth(6)
    shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.OrthographicFront)
    shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.ThreePt)
    shape.getThreeDFormat().getLightRig().setDirection(LightingDirection.Top)

    presentation.save("3D_bevel_effect.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Эффект 3D‑фаски

Добавить 3D‑вращения

Трёхмерный вид фигуры управляется настройками камеры. В этом примере используется Camera.setRotation с углами широты, долготы и оборота 40, 35 и 20 градусов соответственно. Выбирается изометрическая камера через Camera.setCameraType и сбалансированное освещение через LightRig.setLightType, затем сохраняется отформатированный прямоугольник.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import CameraPresetType, LightRigPresetType, Presentation, SaveFormat, ShapeType

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    auto_shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 150, 75)
    auto_shape.getTextFrame().setText("Hello, Aspose!")
    auto_shape.getThreeDFormat().getCamera().setCameraType(CameraPresetType.IsometricLeftUp)
    auto_shape.getThreeDFormat().getCamera().setRotation(40, 35, 20)
    auto_shape.getThreeDFormat().getLightRig().setLightType(LightRigPresetType.Balanced)

    presentation.save("3D_rotation_effect.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Результат:

Эффект 3D‑вращения

Управление чёрно‑белой отрисовкой фигур

Метод Shape.setBlackWhiteMode указывает, как отдельная фигура отрисовывается, когда презентация просматривается или обрабатывается в чёрно‑белом режиме. Он сам по себе не включает чёрно‑белый режим и не меняет заливку, контур или другое форматирование фигуры в обычном цветном режиме.

Используйте значение из класса BlackWhiteMode для выбора требуемого поведения. Например, Automatic позволяет приложению‑рендереру выбирать преобразование, Gray и LightGray используют серый цвет, BlackWhite использует только чёрный и белый, Black и White принуждают к единому цвету, Color сохраняет обычную окраску, а Hidden исключает фигуру в чёрно‑белом режиме. NotDefined означает, что режим на уровне фигуры не задан.

Этот пример создаёт оранжевый прямоугольник и использует Shape.setBlackWhiteMode для установки режима в Gray. Сохранённая фигура сохраняет оранжевую заливку для обычного цветного отображения и запрашивает серое отображение в приложениях, уважающих настройки чёрно‑белого режима:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BlackWhiteMode, FillType, Presentation, SaveFormat, ShapeType
from java.awt import Color

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    shape = slide.getShapes().addAutoShape(ShapeType.Rectangle, 50, 50, 200, 100)
    shape.getFillFormat().setFillType(FillType.Solid)
    color = Color(255, 165, 0)
    shape.getFillFormat().getSolidFillColor().setColor(color)
    shape.setBlackWhiteMode(BlackWhiteMode.Gray)

    presentation.save("shape_black_white_mode.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

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

Сброс форматирования

Используйте Slide.reset для восстановления позиции, размера и форматирования заполнителей слайда из соответствующих заполнителей макета. Этот пример требует существующей презентации с заполнителями, связанными с макетом, и сбрасывает каждый слайд перед сохранением. Фигуры без соответствующих заполнителей макета не сбрасываются.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Presentation, SaveFormat

presentation = Presentation("sample.pptx")
try:
    for slide in presentation.getSlides():
        slide.reset()

    presentation.save("reset_formatting.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

FAQ

Влияет ли форматирование фигур на размер конечного файла презентации?

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

Как обнаружить на слайде фигуры с одинаковым форматированием, чтобы их сгруппировать?

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

Можно ли сохранить набор пользовательских стилей фигур в отдельный файл для повторного использования в других презентациях?

Да. Сохраните образцы фигур с нужными стилями в шаблоне набора слайдов или в файле шаблона .POTX. При создании новой презентации откройте шаблон, клонируйте нужные стилизованные фигуры и вновь примените их форматирование там, где требуется.