Gérer les thèmes de présentation PowerPoint en Python

Vue d’ensemble

Un thème de présentation définit les propriétés de ses éléments de conception. Lorsque vous choisissez un thème, vous choisissez un ensemble coordonné d’éléments visuels et leurs propriétés.

Dans PowerPoint, un thème comprend des couleurs, polices, styles d’arrière-plan, et des effets.

theme-constituents

Modifier la couleur du thème

Un thème PowerPoint utilise un ensemble spécifique de couleurs pour différents éléments d’une diapositive. Si vous n’aimez pas les valeurs par défaut, vous pouvez les modifier en appliquant de nouvelles couleurs de thème. Pour vous permettre de sélectionner une nouvelle couleur de thème, Aspose.Slides fournit des valeurs dans l’énumération SchemeColor.

Ce code Python montre comment changer la couleur d’accent d’un thème :

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

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

    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4

Vous pouvez déterminer la valeur effective de la couleur résultante comme suit :

fill_effective = shape.fill_format.get_effective()
print("{0} ({1})".format(fill_effective.solid_fill_color.name, fill_effective.solid_fill_color))

# Exemple de sortie :
#
# ff8080 (Couleur [A=255, R=128, G=100, B=162])

Pour illustrer davantage le changement de couleur, nous créons un autre élément, lui attribuons la couleur d’accent obtenue à l’étape initiale, puis mettons à jour la couleur du thème.

other_shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 120, 100, 100)
other_shape.fill_format.fill_type = slides.FillType.SOLID
other_shape.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4

presentation.master_theme.color_scheme.accent4.color = draw.Color.red

La nouvelle couleur est appliquée automatiquement aux deux éléments.

Définir une couleur de thème à partir de la palette supplémentaire

Lorsque vous appliquez des transformations de luminance à la couleur principale du thème (1), des couleurs provenant de la palette supplémentaire (2) sont générées. Vous pouvez alors définir et récupérer ces couleurs de thème.

additional-palette-colors

1 — Couleurs principales du thème

2 — Couleurs de la palette supplémentaire

Ce code Python montre comment les couleurs de la palette supplémentaire sont dérivées de la couleur principale du thème puis utilisées dans les formes :

import aspose.slides as slides

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

    # Accent 4
    shape1 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 50, 50)

    shape1.fill_format.fill_type = slides.FillType.SOLID
    shape1.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4

    # Accent 4, plus clair 80%
    shape2 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 70, 50, 50)

    shape2.fill_format.fill_type = slides.FillType.SOLID
    shape2.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape2.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.2)
    shape2.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.8)

    # Accent 4, plus clair 60%
    shape3 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 130, 50, 50)

    shape3.fill_format.fill_type = slides.FillType.SOLID
    shape3.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape3.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.4)
    shape3.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.6)

    # Accent 4, plus clair 40%
    shape4 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 190, 50, 50)

    shape4.fill_format.fill_type = slides.FillType.SOLID
    shape4.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape4.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.6)
    shape4.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.ADD_LUMINANCE, 0.4)

    # Accent 4, plus sombre 25%
    shape5 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 250, 50, 50)

    shape5.fill_format.fill_type = slides.FillType.SOLID
    shape5.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape5.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.75)

    # Accent 4, plus sombre 50%
    shape6 = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 310, 50, 50)

    shape6.fill_format.fill_type = slides.FillType.SOLID
    shape6.fill_format.solid_fill_color.scheme_color = slides.SchemeColor.ACCENT4
    shape6.fill_format.solid_fill_color.color_transform.add(slides.ColorTransformOperation.MULTIPLY_LUMINANCE, 0.5)

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

Faire correspondre `SchemeColor` aux couleurs `ColorScheme`

Lorsque vous travaillez avec SchemeColor, vous pouvez remarquer qu’il contient les valeurs de couleur de thème suivantes :

BACKGROUND1, BACKGROUND2, TEXT1 et TEXT2.

Cependant, Presentation.master_theme.color_scheme renvoie un ColorScheme, qui expose les couleurs correspondantes sous les noms :

dark1, dark2, light1 et light2.

Cette différence ne concerne que la dénomination. Ces valeurs font référence aux mêmes emplacements de couleur de thème et le mappage est fixe :

TEXT1 = dark1
BACKGROUND1 = light1
TEXT2 = dark2
BACKGROUND2 = light2

Il n’existe aucune conversion dynamique entre TEXT/BACKGROUND et dark/light. Ce ne sont que des noms alternatifs pour les mêmes couleurs de thème.

Cette différence de nommage provient de la terminologie de Microsoft Office. Les versions anciennes d’Office utilisaient Dark 1, Light 1, Dark 2 et Light 2, tandis que les nouvelles versions de l’interface affichent les mêmes emplacements sous les libellés Text 1, Background 1, Text 2 et Background 2.

Modifier la police du thème

Pour vous permettre de sélectionner des polices pour les thèmes et d’autres usages, Aspose.Slides utilise ces identifiants spéciaux (similaires à ceux de PowerPoint) :

+mn-lt — Police du corps Latin (Minor Latin Font)
+mj-lt — Police des titres Latin (Major Latin Font)
+mn-ea — Police du corps Asiatique de l’Est (Minor East Asian Font)
+mj-ea — Police des titres Asiatique de l’Est (Major East Asian Font)

Ce code Python montre comment affecter la police Latin à un élément du thème :

portion = slides.Portion("Theme text format")
portion.portion_format.latin_font = slides.FontData("+mn-lt")

paragraph = slides.Paragraph()
paragraph.portions.add(portion)

shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 10, 10, 100, 100)
shape.text_frame.paragraphs.add(paragraph)

Cet exemple Python montre comment changer la police du thème de la présentation :

presentation.master_theme.font_scheme.minor.latin_font = slides.FontData("Arial")

Toutes les zones de texte seront mises à jour avec la nouvelle police.

TIP

Pour plus d’informations, consultez Polices maîtres PowerPoint avec Python.

Modifier le style d’arrière-plan du thème

Par défaut, PowerPoint propose 12 arrière-plans prédéfinis, mais une présentation typique n’en stocke que 3.

todo:image_alt_text

Par exemple, après avoir enregistré une présentation dans PowerPoint, vous pouvez exécuter le code Python suivant pour déterminer combien d’arrière-plans prédéfinis elle contient :

with slides.Presentation() as presentation:
    number_of_background_fills = len(presentation.master_theme.format_scheme.background_fill_styles)
    print(f"Number of theme background fill styles: {number_of_background_fills}")

En utilisant la propriété background_fill_styles de la classe FormatScheme, vous pouvez ajouter ou accéder aux styles d’arrière-plan dans un thème PowerPoint.

Cet exemple Python montre comment définir l’arrière-plan de la présentation :

presentation.masters[0].background.style_index = 2  # 0 indique aucun remplissage ; l'indexation commence à 1.

TIP

Pour plus d’informations, consultez Gérer les arrière-plans de présentation en Python.

Modifier les effets du thème

Un thème PowerPoint comprend généralement trois valeurs dans chaque tableau de styles. Ces tableaux se combinent en trois niveaux d’effets : subtil, modéré et intense. Par exemple, voici le résultat lorsque ces effets sont appliqués à une forme spécifique :

todo:image_alt_text

En utilisant les trois propriétés—FillStyles, LineStyles et EffectStyles—de la classe FormatScheme, vous pouvez modifier les éléments du thème (de façon encore plus souple qu’avec PowerPoint).

Ce code Python montre comment changer un effet de thème en modifiant des parties de ces éléments :

with slides.Presentation("sample.pptx") as presentation:
    presentation.master_theme.format_scheme.line_styles[0].fill_format.solid_fill_color.color = draw.Color.red
    presentation.master_theme.format_scheme.fill_styles[2].fill_type = slides.FillType.SOLID
    presentation.master_theme.format_scheme.fill_styles[2].solid_fill_color.color = draw.Color.forest_green
    presentation.master_theme.format_scheme.effect_styles[2].effect_format.outer_shadow_effect.distance = 10

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

Les changements résultants incluent des mises à jour de la couleur de remplissage, du type de remplissage, de l’effet d’ombre et d’autres propriétés :

todo:image_alt_text

FAQ

Puis-je appliquer un thème à une seule diapositive sans modifier la maîtresse ?

Oui. Aspose.Slides prend en charge les substitutions de thème au niveau de la diapositive, vous permettant d’appliquer un thème local uniquement à cette diapositive tout en conservant le thème maître intact (via le SlideThemeManager).

Quelle est la manière la plus sûre de transférer un thème d’une présentation à une autre ?

Cloner les diapositives avec leur maître dans la présentation cible. Cela préserve le maître original, les mises en page et le thème associé afin que l’apparence reste cohérente.

Comment puis‑je voir les valeurs « effectives » après toutes les héritages et remplacements ?

Utilisez les vues « effective » de l’API [/slides/fr/python-net/shape-effective-properties/] pour thème/couleur/police/effet. Elles renvoient les propriétés résolues et finales après l’application du maître et de tout remplacement local.

Gérer les arrière-plans de présentation en Python

Gérer les thèmes de présentation PowerPoint en Python

Vue d’ensemble

Modifier la couleur du thème

Définir une couleur de thème à partir de la palette supplémentaire

Faire correspondre SchemeColor aux couleurs ColorScheme

Modifier la police du thème

TIP

Modifier le style d’arrière-plan du thème

TIP

Modifier les effets du thème

FAQ

Faire correspondre `SchemeColor` aux couleurs `ColorScheme`