Управление темами презентаций в Java

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

В PowerPoint тема состоит из цветов, шрифты, стили фона, и эффектов.

theme-constituents

Изменить цвет темы

Тема PowerPoint использует определённый набор цветов для различных элементов слайда. Если вам не нравятся цвета, вы меняете их, применяя новые цвета к теме. Чтобы позволить вам выбрать новый цвет темы, Aspose.Slides предоставляет значения в перечислении SchemeColor.

Этот Java‑код показывает, как изменить цвет акцента для темы:

Presentation pres = new Presentation();
try {
    IAutoShape shape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);

    shape.getFillFormat().setFillType(FillType.Solid);

    shape.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
} finally {
    if (pres != null) pres.dispose();
}

Таким образом вы можете определить фактическое значение полученного цвета:

IFillFormatEffectiveData fillEffective = shape.getFillFormat().getEffective();

Color effectiveColor = fillEffective.getSolidFillColor();

System.out.println(String.format("Color [A=%d, R=%d, G=%d, B=%d]", 
        effectiveColor.getAlpha(), effectiveColor.getRed(), effectiveColor.getGreen(), effectiveColor.getBlue()));

Чтобы дополнительно продемонстрировать операцию изменения цвета, мы создаём другой элемент и назначаем ему цвет акцента (из первоначальной операции). Затем меняем цвет в теме:

IAutoShape otherShape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 10, 120, 100, 100);

otherShape.getFillFormat().setFillType(FillType.Solid);

otherShape.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);

pres.getMasterTheme().getColorScheme().getAccent4().setColor(Color.RED);

Новый цвет автоматически применяется к обоим элементам.

Установить цвет темы из дополнительной палитры

При применении трансформаций яркости к основному цвету темы(1) формируются цвета из дополнительной палитры(2). Затем вы можете задавать и получать эти цвета темы.

additional-palette-colors

1 - Основные цвета темы
2 - Цвета из дополнительной палитры.

Этот Java‑код демонстрирует операцию, при которой цвета дополнительной палитры получаются из основного цвета темы и затем используются в формах:

Presentation presentation = new Presentation();
try {
    ISlide slide = presentation.getSlides().get_Item(0);

    // Акцент 4
    IShape shape1 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 50, 50);

    shape1.getFillFormat().setFillType(FillType.Solid);
    shape1.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);

    // Акцент 4, светлее 80%
    IShape shape2 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 70, 50, 50);

    shape2.getFillFormat().setFillType(FillType.Solid);
    shape2.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape2.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.2f);
    shape2.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.AddLuminance, 0.8f);

    // Акцент 4, светлее 60%
    IShape shape3 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 130, 50, 50);

    shape3.getFillFormat().setFillType(FillType.Solid);
    shape3.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape3.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.4f);
    shape3.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.AddLuminance, 0.6f);

    // Акцент 4, светлее 40%
    IShape shape4 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 190, 50, 50);

    shape4.getFillFormat().setFillType(FillType.Solid);
    shape4.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape4.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.6f);
    shape4.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.AddLuminance, 0.4f);

    // Акцент 4, темнее 25%
    IShape shape5 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 250, 50, 50);

    shape5.getFillFormat().setFillType(FillType.Solid);
    shape5.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape5.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.75f);

    // Акцент 4, темнее 50%
    IShape shape6 = slide.getShapes().addAutoShape(ShapeType.Rectangle, 10, 310, 50, 50);

    shape6.getFillFormat().setFillType(FillType.Solid);
    shape6.getFillFormat().getSolidFillColor().setSchemeColor(SchemeColor.Accent4);
    shape6.getFillFormat().getSolidFillColor().getColorTransform().add(ColorTransformOperation.MultiplyLuminance, 0.5f);

    presentation.save(path + "example_accent4.pptx", SaveFormat.Pptx);
} finally {
    if (presentation != null) presentation.dispose();
}

Отображение `SchemeColor` на цвета `IColorScheme`

Работая с SchemeColor, вы можете заметить, что он содержит следующие значения цветов темы: Background1, Background2, Text1 и Text2.

Однако Presentation.getMasterTheme().getColorScheme() возвращает IColorScheme, который предоставляет соответствующие цвета как: Dark1, Dark2, Light1 и Light2.

Это различие только в названии. Эти значения относятся к тем же слотам цветов темы, и сопоставление фиксировано:

Text1 = Dark1
Background1 = Light1
Text2 = Dark2
Background2 = Light2

Динамического преобразования между Text/Background и Dark/Light нет. Это просто альтернативные названия одних и тех же цветов темы.

Это различие в названиях происходит из терминологии Microsoft Office. В более старых версиях Office использовались Dark 1, Light 1, Dark 2 и Light 2, тогда как в новых версиях UI те же слоты отображаются как Text 1, Background 1, Text 2 и Background 2.

Изменить шрифт темы

Чтобы позволить вам выбирать шрифты для тем и других целей, Aspose.Slides использует следующие специальные идентификаторы (аналогичные тем, что используются в PowerPoint):

+mn-lt – Основной шрифт латиницы (Minor Latin Font)
+mj-lt – Шрифт заголовка латиницы (Major Latin Font)
+mn-ea – Основной шрифт восточноазиатский (Minor East Asian Font)
+mj-ea – Шрифт заголовка восточноазиатский (Major East Asian Font)

Этот Java‑код показывает, как назначить латинский шрифт элементу темы:

IAutoShape shape = pres.getSlides().get_Item(0).getShapes().addAutoShape(ShapeType.Rectangle, 10, 10, 100, 100);

Paragraph paragraph = new Paragraph();

Portion portion = new Portion("Theme text format");

paragraph.getPortions().add(portion);

shape.getTextFrame().getParagraphs().add(paragraph);

portion.getPortionFormat().setLatinFont(new FontData("+mn-lt"));

Этот Java‑код показывает, как изменить шрифт темы презентации:

pres.getMasterTheme().getFontScheme().getMinor().setLatinFont(new FontData("Arial"));

Шрифт во всех текстовых полях будет обновлен.

TIP

Возможно, вы захотите посмотреть шрифты PowerPoint.

Изменить стиль фона темы

По умолчанию приложение PowerPoint предоставляет 12 предопределённых фонов, но в типичной презентации сохраняются только 3 из этих 12 фонов.

todo:image_alt_text

Например, после сохранения презентации в приложении PowerPoint вы можете выполнить следующий Java‑код, чтобы узнать количество предопределённых фонов в презентации:

Presentation pres = new Presentation("pres.pptx");
try {
    int numberOfBackgroundFills = pres.getMasterTheme().getFormatScheme().getBackgroundFillStyles().size();

    System.out.println("Number of background fill styles for theme is " + numberOfBackgroundFills);
} finally {
    if (pres != null) pres.dispose();
}

Используя свойство BackgroundFillStyles класса FormatScheme, вы можете добавить или получить доступ к стилю фона в теме PowerPoint.

Этот Java‑код показывает, как задать фон для презентации:

pres.getMasters().get_Item(0).getBackground().setStyleIndex(2);

Справочник индексов: 0 используется для отсутствия заливки. Индекс начинается с 1.

TIP

Возможно, вы захотите посмотреть фон PowerPoint.

Изменить эффект темы

Тема PowerPoint обычно содержит 3 значения для каждого массива стилей. Эти массивы объединяются в 3 эффекта: тонкий, умеренный и интенсивный. Например, это результат применения эффектов к конкретной фигуре:

todo:image_alt_text

Используя 3 свойства (FillStyles, LineStyles, EffectStyles) класса FormatScheme вы можете изменить элементы темы (даже гибче, чем параметры в PowerPoint).

Этот Java‑код показывает, как изменить эффект темы, изменяя части элементов:

Presentation pres = new Presentation("Subtle_Moderate_Intense.pptx");
try {
    pres.getMasterTheme().getFormatScheme().getLineStyles().get_Item(0).getFillFormat().getSolidFillColor().setColor(Color.RED);

    pres.getMasterTheme().getFormatScheme().getFillStyles().get_Item(2).setFillType(FillType.Solid);

    pres.getMasterTheme().getFormatScheme().getFillStyles().get_Item(2).getSolidFillColor().setColor(Color.GREEN);

    pres.getMasterTheme().getFormatScheme().getEffectStyles().get_Item(2).getEffectFormat().getOuterShadowEffect().setDistance(10f);

    pres.save("Design_04_Subtle_Moderate_Intense-out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Полученные изменения в цвете заливки, типе заливки, эффекте тени и т.д.:

todo:image_alt_text

Часто задаваемые вопросы

Могу ли я применить тему к отдельному слайду без изменения мастера?
Да. Aspose.Slides поддерживает переопределения темы на уровне слайда, поэтому вы можете применить локальную тему только к этому слайду, сохранив при этом неизменной тему мастера (через SlideThemeManager).

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

Как я могу увидеть «фактические» значения после всей наследования и переопределений?
Используйте «эффективные» представления API /slides/ru/java/shape-effective-properties/ для темы/цвета/шрифта/эффекта. Они возвращают вычисленные конечные свойства после применения мастера и всех локальных переопределений.

Управление фонами презентаций в Java

Управление темами презентаций в Java

Изменить цвет темы

Установить цвет темы из дополнительной палитры

Отображение SchemeColor на цвета IColorScheme

Изменить шрифт темы

TIP

Изменить стиль фона темы

TIP

Изменить эффект темы

Часто задаваемые вопросы

Отображение `SchemeColor` на цвета `IColorScheme`