Управление темами презентаций в PHP
Тема презентации определяет свойства элементов дизайна. При выборе темы презентации вы фактически выбираете конкретный набор визуальных элементов и их свойства.
В PowerPoint тема включает цвета, шрифты, стили фона, и эффекты.
Изменить цвет темы
Тема PowerPoint использует определённый набор цветов для различных элементов на слайде. Если вам не нравятся цвета, вы меняете их, применяя новые цвета к теме. Чтобы позволить выбрать новый цвет темы, Aspose.Slides предоставляет значения в перечислении SchemeColor.
$pres = new Presentation();
try {
$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 (!java_is_null($pres)) {
$pres->dispose();
}
}
Вы можете определить эффективное значение полученного цвета таким способом:
$fillEffective = $shape->getFillFormat()->getEffective();
$effectiveColor = $fillEffective->getSolidFillColor();
echo(sprintf("Color [A=%d, R=%d, G=%d, B=%d]", $effectiveColor->getAlpha(), $effectiveColor->getRed(), $effectiveColor->getGreen(), $effectiveColor->getBlue()));
Чтобы дополнительно продемонстрировать операцию изменения цвета, мы создаём другой элемент и назначаем ему акцентный цвет (из первоначальной операции). Затем меняем цвет в теме:
$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(java("java.awt.Color")->RED);
Новый цвет применяется автоматически к обоим элементам.
Установить цвет темы из дополнительной палитры
Когда вы применяете преобразования яркости к основному цвету темы(1), формируются цвета из дополнительной палитры(2). Затем вы можете установить и получить эти цвета темы.
1 - Основные цвета темы
2 - Цвета из дополнительной палитры.
Этот PHP‑код демонстрирует операцию, при которой цвета дополнительной палитры получаются из основного цвета темы и затем используются в фигурах:
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
# Accent 4
$shape1 = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, 50, 50);
$shape1->getFillFormat()->setFillType(FillType::Solid);
$shape1->getFillFormat()->getSolidFillColor()->setSchemeColor(SchemeColor->Accent4);
# Accent 4, светлее на 80%
$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.2);
$shape2->getFillFormat()->getSolidFillColor()->getColorTransform()->add(ColorTransformOperation->AddLuminance, 0.8);
# Accent 4, светлее на 60%
$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.4);
$shape3->getFillFormat()->getSolidFillColor()->getColorTransform()->add(ColorTransformOperation->AddLuminance, 0.6);
# Accent 4, светлее на 40%
$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.6);
$shape4->getFillFormat()->getSolidFillColor()->getColorTransform()->add(ColorTransformOperation->AddLuminance, 0.4);
# Accent 4, темнее на 25%
$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.75);
# Accent 4, темнее на 50%
$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.5);
$presentation->save($path . "example_accent4.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Отобразить SchemeColor в цвета ColorScheme
Когда вы работаете с SchemeColor, вы можете заметить, что он содержит следующие значения цветов темы: Background1, Background2, Text1 и Text2.
Однако Presentation::getMasterTheme()::getColorScheme() возвращает ColorScheme, который предоставляет соответствующие цвета как: Dark1, Dark2, Light1 и Light2.
Это различие только в названиях. Эти значения относятся к тем же слотам цвета темы, и сопоставление фиксировано:
Text1=Dark1Background1=Light1Text2=Dark2Background2=Light2
Нет динамического преобразования между Text/Background и Dark/Light. Это просто альтернативные названия одних и тех же цветов темы.
Это различие в названиях происходит из терминологии Microsoft Office. В более старых версиях Office использовались Dark 1, Light 1, Dark 2 и Light 2, тогда как в новых пользовательских интерфейсах те же слоты отображаются как Text 1, Background 1, Text 2 и Background 2.
Изменить шрифт темы
Чтобы позволить выбирать шрифты для тем и других целей, Aspose.Slides использует следующие специальные идентификаторы (аналогичные тем, что используются в PowerPoint):
- +mn-lt - Body Font Latin (Minor Latin Font)
- +mj-lt -Heading Font Latin (Major Latin Font)
- +mn-ea - Body Font East Asian (Minor East Asian Font)
- +mj-ea - Body Font East Asian (Major East Asian Font)
Этот PHP‑код показывает, как назначить латинский шрифт элементу темы:
$shape = $pres->getSlides()->get_Item(0)->getShapes()->addAutoShape(ShapeType::Rectangle, 10, 10, 100, 100);
$paragraph = new Paragraph();
$portion = new Portion("Theme text format");
$paragraph->getPortions()->add($portion);
$shape->getTextFrame()->getParagraphs()->add($paragraph);
$portion->getPortionFormat()->setLatinFont(new FontData("+mn-lt"));
Этот PHP‑код показывает, как изменить шрифт темы презентации:
$pres->getMasterTheme()->getFontScheme()->getMinor()->setLatinFont(new FontData("Arial"));
Шрифт во всех текстовых полях будет обновлен.
TIP
Возможно, вам будет интересно посмотреть шрифты PowerPoint.Изменить стиль фона темы
По умолчанию приложение PowerPoint предоставляет 12 предопределённых фонов, но только 3 из этих 12 обычно сохраняются в типичной презентации.
Например, после сохранения презентации в приложении PowerPoint вы можете выполнить этот PHP‑код, чтобы узнать количество предопределённых фонов в презентации:
$pres = new Presentation("pres.pptx");
try {
$numberOfBackgroundFills = $pres->getMasterTheme()->getFormatScheme()->getBackgroundFillStyles()->size();
echo("Number of background fill styles for theme is " . $numberOfBackgroundFills);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Этот PHP‑код показывает, как установить фон для презентации:
$pres->getMasters()->get_Item(0)->getBackground()->setStyleIndex(2);
Руководство по индексам: 0 используется для отсутствия заливки. Индекс начинается с 1.
TIP
Возможно, вам будет интересно посмотреть фон PowerPoint.Изменить эффект темы
Тема PowerPoint обычно содержит 3 значения для каждого массива стилей. Эти массивы объединяются в 3 эффекта: тонкий, умеренный и интенсивный. Например, так выглядит результат, когда эффекты применяются к конкретной фигуре:
Используя 3 свойства (FillStyles, LineStyles, EffectStyles) из класса FormatScheme вы можете менять элементы в теме (даже гибче, чем параметры в PowerPoint).
$pres = new Presentation("Subtle_Moderate_Intense.pptx");
try {
$pres->getMasterTheme()->getFormatScheme()->getLineStyles()->get_Item(0)->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
$pres->getMasterTheme()->getFormatScheme()->getFillStyles()->get_Item(2)->setFillType(FillType::Solid);
$pres->getMasterTheme()->getFormatScheme()->getFillStyles()->get_Item(2)->getSolidFillColor()->setColor(java("java.awt.Color")->GREEN);
$pres->getMasterTheme()->getFormatScheme()->getEffectStyles()->get_Item(2)->getEffectFormat()->getOuterShadowEffect()->setDistance(10.0);
$pres->save("Design_04_Subtle_Moderate_Intense-out.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($pres)) {
$pres->dispose();
}
}
Полученные изменения в цвете заливки, типе заливки, теневом эффекте и т.д.:
FAQ
Могу ли я применить тему к отдельному слайду, не меняя мастер?
Да. Aspose.Slides поддерживает переопределения темы на уровне слайда, поэтому вы можете применить локальную тему только к этому слайду, оставив мастер‑тему нетронутой (через SlideThemeManager).
Какой способ наиболее безопасен для переноса темы из одной презентации в другую?
Клонировать слайды вместе с их мастером в целевую презентацию. Это сохраняет оригинальный мастер, макеты и связанную тему, так что внешний вид остаётся一致ным.
Как увидеть «эффективные» значения после всех наследований и переопределений?
Используйте «эффективные» представления API [/slides/ru/php-java/shape-effective-properties/] для темы/цвета/шрифта/эффекта. Они возвращают окончательные, разрешённые свойства после применения мастера и всех локальных переопределений.