Ajouter des équations mathématiques aux présentations PowerPoint en Python

Vue d’ensemble

Dans PowerPoint, vous pouvez écrire une équation ou une formule mathématique et l’afficher dans votre présentation. Divers symboles mathématiques sont disponibles et peuvent être ajoutés au texte ou aux équations. Le constructeur d’équations mathématiques est utilisé pour créer des formules complexes telles que :

Fraction mathématique
Radical mathématique
Fonction mathématique
Limites et fonctions logarithmiques
Opérations N-aires
Matrice
Opérateurs larges
Fonctions sin, cos

Pour ajouter une équation mathématique dans PowerPoint, le menu Insertion → Équation est utilisé :

$todo:image_alt_text$

Cela crée un texte mathématique en XML qui peut être affiché dans PowerPoint comme suit :

$todo:image_alt_text$

PowerPoint prend en charge un large éventail de symboles mathématiques pour créer des équations. Cependant, la génération d’équations mathématiques complexes dans PowerPoint ne donne souvent pas un résultat soigné et professionnel. Ainsi, les utilisateurs qui créent fréquemment des présentations mathématiques se tournent souvent vers des solutions tierces pour obtenir des formules plus esthétiques.

En utilisant l'Aspose.Slides API, vous pouvez travailler avec les équations mathématiques dans les présentations PowerPoint de manière programmatique en Python. Créez de nouvelles expressions mathématiques ou modifiez celles déjà créées. Un support partiel est disponible pour l’exportation des structures mathématiques sous forme d’images.

Comment créer une équation mathématique

Les éléments mathématiques sont utilisés pour construire toute construction mathématique, quel que soit le niveau d’imbrication. Une collection linéaire de ces éléments forme un bloc mathématique, représenté par la classe MathBlock. La classe MathBlock représente une expression, une formule ou une équation mathématique autonome. MathPortion sert à contenir du texte mathématique (distinct de la classe Portion ordinaire), tandis que MathParagraph vous permet de manipuler un ensemble d’objets MathBlock. Ces classes sont essentielles pour travailler avec les équations mathématiques PowerPoint via l’Aspose.Slides API.

Voyons comment créer l’équation mathématique suivante en utilisant l’Aspose.Slides API :

$todo:image_alt_text$

Pour ajouter une expression mathématique à la diapositive, ajoutez d’abord une forme qui contiendra le texte mathématique :

import aspose.slides as slides
import aspose.slides.mathtext as math

with slides.Presentation() as presentation:
    math_shape = presentation.slides[0].shapes.add_math_shape(0, 0, 720, 150)

Après la création de la forme, celle‑ci contient déjà un paragraphe avec une portion mathématique par défaut. La classe MathPortion représente une portion contenant du texte mathématique. Pour accéder au contenu mathématique à l’intérieur d’une MathPortion, référez‑vous à la variable MathParagraph :

math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph

La classe MathParagraph vous permet de lire, ajouter, modifier et supprimer des blocs mathématiques (MathBlock), qui consistent en une combinaison d’éléments mathématiques. Par exemple, créez une fraction et placez‑la dans la présentation :

fraction = math.MathematicalText("x").divide("y")
math_paragraph.add(math.MathBlock(fraction))

math_block = (
    math.MathematicalText("c").set_superscript("2").
        join("=").
        join(math.MathematicalText("a").set_superscript("2")).
        join("+").
        join(math.MathematicalText("b").set_superscript("2")))

Les opérations de la classe IMathElement sont implémentées dans chaque type d’élément, y compris la classe MathBlock .

Voici le code source complet :

import aspose.slides as slides
import aspose.slides.mathtext as math

with slides.Presentation() as presentation:
    math_shape = presentation.slides[0].shapes.add_math_shape(0, 0, 720, 150)

    math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph

    fraction = math.MathematicalText("x").divide("y")
    math_paragraph.add(math.MathBlock(fraction))

    math_block = (
        math.MathematicalText("c").set_superscript("2").
            join("=").
            join(math.MathematicalText("a").set_superscript("2")).
            join("+").
            join(math.MathematicalText("b").set_superscript("2")))

    math_paragraph.add(math_block)

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

Types d’éléments mathématiques

Les expressions mathématiques sont composées de séquences d’éléments mathématiques. Un bloc mathématique représente une telle séquence, et les arguments de ces éléments forment une structure imbriquée en forme d’arbre.

Il existe de nombreux types d’éléments mathématiques qui peuvent être utilisés pour construire un bloc mathématique. Chacun de ces éléments peut être agrégé au sein d’un autre, formant ainsi une structure arborescente. Le type d’élément le plus simple est celui qui ne contient aucun autre élément de texte mathématique.

Chaque type d’élément mathématique implémente la classe IMathElement, vous permettant d’utiliser un même ensemble d’opérations mathématiques sur différents types d’éléments.

Classe MathematicalText

La classe MathematicalText représente un texte mathématique – l’élément sous‑jacent de toutes les constructions mathématiques. Le texte mathématique peut représenter des opérandes et des opérateurs, des variables ou tout autre texte linéaire.

Exemple : 𝑎=𝑏+𝑐

Classe MathFraction

La classe MathFraction spécifie un objet fraction composé d’un numérateur et d’un dénominateur séparés par une barre de fraction. La barre peut être horizontale ou diagonale, selon les propriétés de la fraction. L’objet fraction est également utilisé pour représenter la fonction pile, qui place un élément au‑dessus d’un autre sans barre de fraction.

Exemple :

$todo:image_alt_text$

Classe MathRadical

La classe MathRadical spécifie la fonction radicale (racine mathématique), composée d’une base et d’un degré optionnel.

Exemple :

$todo:image_alt_text$

Classe MathFunction

La classe MathFunction spécifie une fonction d’un argument. Elle contient des propriétés telles que name, qui représente le nom de la fonction, et base, qui représente l’argument de la fonction.

Exemple :

$todo:image_alt_text$

Classe MathNaryOperator

La classe MathNaryOperator spécifie un objet mathématique N‑aire, tel qu’une sommation ou une intégrale. Elle se compose d’un opérateur, d’une base (ou opérande) et de limites supérieures et inférieures optionnelles. Des exemples d’opérateurs N‑aires sont la sommation, l’union, l’intersection et l’intégrale.

Cette classe n’inclut pas les opérateurs simples tels que l’addition, la soustraction, etc. Ils sont représentés par un seul texte MathematicalText.

Exemple :

$todo:image_alt_text$

Classe MathLimit

La classe MathLimit crée la limite supérieure ou inférieure. Elle spécifie l’objet limite, composé de texte sur la ligne de base et de texte de taille réduite immédiatement au‑dessus ou au‑dessous. Cet élément n’inclut pas le mot « lim », mais permet de placer du texte en haut ou en bas de l’expression. Ainsi, l’expression

$todo:image_alt_text$

est créée à l’aide d’une combinaison d’éléments MathFunction et MathLimit de la manière suivante :

function_name = math.MathLimit(math.MathematicalText("lim"), math.MathematicalText("𝑥→∞"))
math_function = math.MathFunction(function_name, math.MathematicalText("𝑥"))

Classes MathSubscriptElement, MathSuperscriptElement, MathRightSubSuperscriptElement, MathLeftSubSuperscriptElement

Ces classes spécifient un indice inférieur ou supérieur. Vous pouvez définir simultanément l’indice et l’exposant du côté gauche ou droit d’un argument, mais un seul indice ou exposant est pris en charge uniquement du côté droit. Le MathSubscriptElement peut également être utilisé pour définir le degré mathématique d’un nombre.

Exemple :

$todo:image_alt_text$

Classe MathMatrix

La classe MathMatrix spécifie l’objet Matrice, qui se compose d’éléments enfants disposés en une ou plusieurs lignes et colonnes. Il est important de noter que les matrices n’ont pas de délimiteurs intégrés. Pour entourer la matrice de crochets, utilisez l’objet délimiteur MathDelimiter. Des arguments nuls peuvent être utilisés pour créer des espaces dans les matrices.

Exemple :

$todo:image_alt_text$

Classe MathArray

La classe MathArray spécifie un tableau vertical d’équations ou de tout objet mathématique.

Exemple :

$todo:image_alt_text$

Mise en forme des éléments mathématiques

Classe MathBorderBox : Dessine une bordure rectangulaire ou alternative autour de l’IMathElement.

Exemple :

$todo:image_alt_text$

Classe MathBox : Spécifie l’encapsulation logique d’un élément mathématique. Un objet encapsulé peut servir d’émulateur d’opérateur—avec ou sans point d’alignement—fonctionner comme rupture de ligne, ou être groupé pour empêcher les coupures de ligne à l’intérieur. Par exemple, l’opérateur « == » doit être encapsulé pour empêcher les ruptures de ligne.
Classe MathDelimiter : Spécifie l’objet délimiteur, qui se compose de caractères ouvrants et fermants (parenthèses, accolades, crochets ou barres verticales) et d’un ou plusieurs éléments mathématiques à l’intérieur, séparés par un caractère spécifié. Exemples : (𝑥2) ; [𝑥2|𝑦2].

Exemple :

$todo:image_alt_text$

Classe MathAccent : Spécifie la fonction accent, qui comprend une base et un signe diacritique combiné.

Exemple : 𝑎́.

Classe MathBar : Spécifie la fonction barre, qui comprend un argument de base et une barre supérieure ou inférieure.

Exemple :

$todo:image_alt_text$

Classe MathGroupingCharacter : Spécifie un symbole de regroupement placé au-dessus ou en dessous d’une expression, généralement pour mettre en évidence les relations entre les éléments.

Exemple :

$todo:image_alt_text$

Opérations mathématiques

Chaque élément mathématique et chaque expression mathématique (via MathBlock) implémente la classe IMathElement. Cela vous permet d’effectuer des opérations sur la structure existante et de former des expressions plus complexes. Toutes les opérations disposent de deux jeux de paramètres : soit des IMathElement, soit des arguments de chaîne. Les instances de la classe MathematicalText sont créées implicitement à partir des chaînes spécifiées lorsqu’elles sont utilisées comme arguments. Les opérations mathématiques disponibles dans Aspose.Slides sont répertoriées ci‑dessous.

Méthode Join

Ces méthodes joignent un élément mathématique et forment un bloc mathématique. Par exemple :

element1 = math.MathematicalText("x")
element2 = math.MathematicalText("y")
block = element1.join(element2)

Méthode Divide

Ces méthodes créent une fraction du type spécifié avec un numérateur et le dénominateur indiqué. Par exemple :

numerator = math.MathematicalText("x")
fraction = numerator.divide("y", math.MathFractionTypes.LINEAR)

Méthode Enclose

Ces méthodes entourent l’élément avec les caractères spécifiés, comme des parenthèses ou d’autres caractères d’encadrement. Par exemple :

delimiter = math.MathematicalText("x").enclose('[', ']')
delimiter2 = math.MathematicalText("elem1").join("elem2").enclose()

Méthode Function

Ces méthodes prennent une fonction d’un argument en utilisant l’objet actuel comme nom de fonction. Par exemple :

function = math.MathematicalText("sin").function("x")

Méthode AsArgumentOfFunction

Ces méthodes prennent la fonction spécifiée en utilisant l’instance actuelle comme argument. Vous pouvez :

spécifier une chaîne comme nom de fonction, par exemple « cos »;
choisir l’une des valeurs prédéfinies des énumérations MathFunctionsOfOneArgument ou MathFunctionsOfTwoArguments, par exemple MathFunctionsOfOneArgument.ARC_SIN;
sélectionner l’instance de l’IMathElement.

Par exemple :

function_name = math.MathLimit(math.MathematicalText("lim"), math.MathematicalText("𝑛→∞"))
func1 = math.MathematicalText("2x").as_argument_of_function(function_name)
func2 = math.MathematicalText("x").as_argument_of_function("sin")
func3 = math.MathematicalText("x").as_argument_of_function(math.MathFunctionsOfOneArgument.SIN)
func4 = math.MathematicalText("x").as_argument_of_function(math.MathFunctionsOfTwoArguments.LOG, "3")

Méthodes SetSubscript, SetSuperscript, SetSubSuperscriptOnTheRight, SetSubSuperscriptOnTheLeft

Ces méthodes définissent l’indice et l’exposant. Vous pouvez définir les deux simultanément du côté gauche ou droit de l’argument ; toutefois, un indice ou un exposant unique n’est pris en charge que du côté droit. Le Superscript peut également être utilisé pour définir le degré mathématique d’un nombre.

Exemple :

script = math.MathematicalText("y").set_sub_superscript_on_the_left("2x", "3z")

Méthode Radical

Ces méthodes spécifient la racine mathématique du degré donné en fonction de l’argument indiqué.

Exemple :

radical = math.MathematicalText("x").radical("3")

Méthodes SetUpperLimit et SetLowerLimit

Ces méthodes prennent une limite supérieure ou inférieure, où « upper » et « lower » indiquent la position de l’argument par rapport à la base.

Considérons une expression :

$todo:image_alt_text$

De telles expressions peuvent être créées grâce à une combinaison des classes MathFunction et MathLimit, ainsi que des opérations de la classe IMathElement, comme suit :

math_expression = math.MathematicalText("lim").set_lower_limit("x→∞").function("x")

Méthodes Nary et Integral

Les deux méthodes nary et integral créent et renvoient l’opérateur N‑aire représenté par le type MathNaryOperator. Dans la méthode Nary, l’énumération MathNaryOperatorTypes indique le type d’opérateur — tel que sommation ou union — excluant les intégrales. Dans la méthode Integral, une opération spécialisée pour les intégrales est fournie via l’énumération MathIntegralTypes.

Exemple :

base_arg = math.MathematicalText("x").join(math.MathematicalText("dx").to_box())
integral = base_arg.integral(math.MathIntegralTypes.SIMPLE, "0", "1")

Méthode ToMathArray

to_math_array place les éléments dans un tableau vertical. Si cette opération est appelée sur une instance de MathBlock, tous ses éléments enfants seront placés dans le tableau retourné.

Exemple :

array_function = math.MathematicalText("x").join("y").to_math_array()

Opérations de mise en forme : Accent, Overbar, Underbar, Group, ToBorderBox, ToBox

Méthode accent : définit un accent (un caractère au‑dessus de l’élément).
Méthodes overbar et underbar : définissent une barre au‑dessus ou au‑dessous.
Méthode group : place dans un groupe à l’aide d’un caractère de regroupement tel qu’une accolade inférieure ou autre.
Méthode to_border_box : place dans une bordure‑boîte.
Méthode to_box : place dans une boîte non visuelle (groupement logique).

Exemples :

accent = math.MathematicalText("x").accent(chr(0x0303))
bar = math.MathematicalText("x").overbar()
group_chr = math.MathematicalText("x").join("y").join("z").group(chr(0x23E1), 
        math.MathTopBotPositions.BOTTOM, 
        math.MathTopBotPositions.TOP)
border_box = math.MathematicalText("x+y+z").to_border_box()
boxed_operator = math.MathematicalText(":=").to_box()

FAQ

Comment ajouter une équation mathématique à une diapositive PowerPoint ?

Pour ajouter une équation mathématique, vous devez créer un shape mathématique qui contient automatiquement une portion mathématique. Ensuite, récupérez le MathParagraph depuis le MathPortion et ajoutez‑y des objets MathBlock.

Est‑il possible de créer des expressions mathématiques imbriquées complexes ?

Oui, Aspose.Slides permet de créer des expressions mathématiques complexes en imbriquant des MathBlocks. Chaque élément mathématique vous permet d’appliquer des opérations (Join, Divide, Enclose, etc.) pour combiner les éléments en structures plus complexes.

Comment mettre à jour ou modifier une équation mathématique existante ?

Pour mettre à jour une équation, vous devez accéder au MathBlock existant via le MathParagraph. Ensuite, en utilisant des méthodes telles que Join, Divide, Enclose, etc., vous pouvez modifier les éléments individuels de l’équation. Après la modification, enregistrez la présentation pour appliquer les changements.

Créer et personnaliser des graphiques PowerPoint en Python Formes PowerPoint