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

Vue d’ensemble

Dans PowerPoint, il est possible d’écrire une équation ou une formule mathématique et de l’afficher dans la présentation. Pour cela, divers symboles mathématiques sont représentés dans PowerPoint et peuvent être ajoutés au texte ou à l’équation. Le constructeur d’équations mathématiques de PowerPoint sert à créer des formules complexes telles que :

  • Fraction mathématique
  • Racine 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 de nombreux symboles mathématiques pour créer des équations. Cependant, créer des équations complexes dans PowerPoint ne donne pas toujours un résultat élégant et professionnel. Les utilisateurs qui doivent fréquemment créer des présentations mathématiques se tournent souvent vers des solutions tierces pour obtenir de belles formules.

En utilisant Aspose.Slide API, vous pouvez travailler avec les équations mathématiques dans les présentations PowerPoint de façon programmatique en C#. Créez de nouvelles expressions mathématiques ou modifiez celles existantes. L’exportation des structures mathématiques en images est également partiellement prise en charge.

Comment créer une équation mathématique

Les éléments mathématiques sont utilisés pour construire toute construction mathématique avec n’importe quel niveau d’imbrication. Une collection linéaire d’éléments mathématiques forme un bloc mathématique représenté par la classe MathBlock. La classe MathBlock représente essentiellement une expression, une formule ou une équation séparée. MathPortion est une portion mathématique, utilisée pour contenir du texte mathématique (à ne pas confondre avec Portion). MathParagraph permet de manipuler un ensemble de blocs mathématiques. Les classes susmentionnées sont la clé pour travailler avec les équations mathématiques PowerPoint via l’API Aspose.Slides.

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

todo:image_alt_text

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

Presentation pres = new Presentation();
try {
    IAutoShape mathShape = pres.getSlides().get_Item(0).getShapes().addMathShape(0, 0, 720, 150);
} finally {
    if (pres != null) pres.dispose();
}

Après création, la forme contiendra 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 de la MathPortion, référez‑vous à la variable MathParagraph :

IMathParagraph mathParagraph = ((MathPortion)mathShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)).getMathParagraph();

La classe MathParagraph 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 :

IMathFraction fraction = new MathematicalText("x").divide("y");

mathParagraph.add(new MathBlock(fraction));

Chaque élément mathématique est représenté par une classe implémentant l’interface IMathElement. Cette interface fournit de nombreuses méthodes pour créer facilement des expressions mathématiques. Vous pouvez créer une expression assez complexe en une seule ligne de code. Par exemple, le théorème de Pythagore s’écrirait ainsi :

IMathBlock mathBlock = new MathematicalText("c")
        .setSuperscript("2")
        .join("=")
        .join(new MathematicalText("a").setSuperscript("2"))
        .join("+")
        .join(new MathematicalText("b").setSuperscript("2"));

Les opérations de l’interface IMathElement sont implémentées dans tout type d’élément, y compris le MathBlock.

Exemple complet :

Presentation pres = new Presentation();
try {
    IAutoShape mathShape = pres.getSlides().get_Item(0).getShapes().addMathShape(0, 0, 720, 150);

    IMathParagraph mathParagraph = ((MathPortion)mathShape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)).getMathParagraph();
    
    IMathFraction fraction = new MathematicalText("x").divide("y");

    mathParagraph.add(new MathBlock(fraction));

    IMathBlock mathBlock = new MathematicalText("c")
            .setSuperscript("2")
            .join("=")
            .join(new MathematicalText("a").setSuperscript("2"))
            .join("+")
            .join(new MathematicalText("b").setSuperscript("2"));
    mathParagraph.add(mathBlock);

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

Types d’éléments mathématiques

Les expressions mathématiques sont formées à partir de séquences d’éléments mathématiques. La séquence d’éléments est représentée par un bloc mathématique, et les arguments des éléments forment une imbrication en forme d’arbre.

Il existe de nombreux types d’éléments pouvant être utilisés pour construire un bloc mathématique. Chaque élément peut être inclus (agrégé) dans un autre. Autrement dit, les éléments sont en fait des conteneurs pour d’autres, formant une structure arborescente. Le type le plus simple d’élément ne contient pas d’autres éléments du texte mathématique.

Chaque type d’élément implémente l’interface IMathElement, permettant l’utilisation d’un jeu commun d’opérations mathématiques sur différents types d’éléments.

Classe MathematicalText

La classe MathematicalText représente du texte mathématique – l’élément sous‑jacent de toutes les constructions mathématiques. Le texte mathématique peut représenter des opérandes, des opérateurs, des variables, etc.

Exemple : 𝑎=𝑏+𝑐

Classe MathFraction

La classe MathFraction définit un objet fraction, constitué 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. Elle sert également à représenter la fonction « stack », qui place un élément au‑dessus d’un autre sans barre.

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 possède les propriétés : getName – nom de la fonction et getBase – argument de la fonction.

Exemple :

todo:image_alt_text

Classe MathNaryOperator

La classe MathNaryOperator définit un objet mathématique n‑aire, tel que Σ ou ∫. Il comprend un opérateur, une base (ou opérande) et des limites supérieures et inférieures optionnelles. Les opérateurs simples comme + ou – ne sont pas inclus ; ils sont représentés par un seul élément texte – MathematicalText.

Exemple :

todo:image_alt_text

Classe MathLimit

La classe MathLimit crée une limite supérieure ou inférieure. Elle spécifie un objet limite composé d’un texte de base et d’un texte réduit placé immédiatement au-dessus ou en dessous. L’élément n’inclut pas le mot « lim », mais permet de placer le texte en haut ou en bas de l’expression.

Exemple :

todo:image_alt_text

Création :

MathLimit funcName = new MathLimit(new MathematicalText("lim"), new MathematicalText("𝑥→∞"));

MathFunction mathFunc = new MathFunction(funcName, new MathematicalText("𝑥"));

Classes MathSubscriptElement, MathSuperscriptElement, MathRightSubSuperscriptElement, MathLeftSubSuperscriptElement

Ces classes définissent un indice inférieur ou supérieur. Vous pouvez définir simultanément indice et exposant à gauche ou à droite d’un argument, mais un seul indice ou exposant seul n’est possible qu’à droite. [MathSubscriptElement] peut également servir à définir le degré d’un nombre.

Exemple :

todo:image_alt_text

Classe MathMatrix

La classe MathMatrix spécifie un objet matrice, composé d’éléments enfants disposés en lignes et colonnes. Les matrices n’ont pas de délimiteurs intégrés ; pour les placer entre crochets, il faut utiliser l’objet délimiteur – IMathDelimiter. Des arguments nuls permettent de 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 d’autres objets mathématiques.

Exemple :

todo:image_alt_text

Mise en forme des éléments mathématiques

  • Classe MathBorderBox : dessine un rectangle ou toute autre bordure autour de l’IMathElement.

    Exemple : todo:image_alt_text

  • Classe MathBox : spécifie un encadrement logique de l’élément mathématique.

  • Classe MathDelimiter : spécifie l’objet délimiteur, composé de caractères d’ouverture et de fermeture (parenthèses, accolades, crochets, barres verticales) et d’un ou plusieurs éléments mathématiques à l’intérieur.

    Exemple : todo:image_alt_text

  • Classe MathAccent : spécifie la fonction accent, composée d’une base et d’un diacritique combiné.

    Exemple : 𝑎́.

  • Classe MathBar : spécifie la fonction barre, composée d’un argument de base et d’une barre supérieure ou inférieure.

    Exemple : todo:image_alt_text

  • Classe MathGroupingCharacter : spécifie un symbole de regroupement au‑dessus ou au‑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 et chaque expression mathématique (via MathBlock) implémente l’interface IMathElement. Elle permet d’appliquer des opérations sur la structure existante et de former des expressions plus complexes. Toutes les opérations acceptent deux jeux de paramètres : soit un [IMathElement], soit une chaîne. Les instances de la classe MathematicalText sont créées implicitement à partir des chaînes lorsqu’on utilise des arguments de type string. Les opérations mathématiques disponibles dans Aspose.Slides sont listées ci‑dessous.

Méthode Join

Joint un élément mathématique et forme un bloc mathématique. Exemple :

IMathElement element1 = new MathematicalText("x");

IMathElement element2 = new MathematicalText("y");

IMathBlock block = element1.join(element2);

Méthode Divide

Crée une fraction du type indiqué avec ce numérateur et ce dénominateur. Exemple :

IMathElement numerator = new MathematicalText("x");

IMathFraction fraction = numerator.divide("y", MathFractionTypes.Linear);

Méthode Enclose

Encadre l’élément avec les caractères spécifiés, comme des parenthèses.

/**
 * <p>
 * Enclose a math element in parenthesis
 * </p>
 */
public IMathDelimiter enclose();

/**
 * <p>
 * Encloses this element in specified characters such as parenthesis or another characters as framing
 * </p>
 */
public IMathDelimiter enclose(char beginningCharacter, char endingCharacter);

Exemple :

IMathDelimiter delimiter = new MathematicalText("x").enclose('[', ']');

IMathDelimiter delimiter2 = new MathematicalText("elem1").join("elem2").enclose();

Méthode Function

Applique une fonction à un argument en utilisant l’objet actuel comme nom de fonction.

/**
 * <p>
 * Takes a function of an argument using this instance as the function name
 * </p>
 */
public IMathFunction function(IMathElement functionArgument);

/**
 * <p>
 * Takes a function of an argument using this instance as the function name
 * </p>
 */
public IMathFunction function(String functionArgument);

Exemple :

IMathFunction func = new MathematicalText("sin").function("x");

Méthode AsArgumentOfFunction

Utilise la fonction spécifiée en prenant l’instance actuelle comme argument. Vous pouvez :

Exemple :

MathLimit funcName = new MathLimit(new MathematicalText("lim"), new MathematicalText("𝑛→∞"));

IMathFunction func1 = new MathematicalText("2x").asArgumentOfFunction(funcName);

IMathFunction func2 = new MathematicalText("x").asArgumentOfFunction("sin");

IMathFunction func3 = new MathematicalText("x").asArgumentOfFunction(MathFunctionsOfOneArgument.Sin);

IMathFunction func4 = new MathematicalText("x").asArgumentOfFunction(MathFunctionsOfTwoArguments.Log, "3");

Méthodes SetSubscript, SetSuperscript, SetSubSuperscriptOnTheRight, SetSubSuperscriptOnTheLeft

Définit les indices et exposants. Vous pouvez définir les deux simultanément à gauche ou à droite de l’argument, mais un seul indice ou exposant seul n’est pris en charge qu’à droite. L’exposant peut également servir à indiquer le degré d’un nombre.

Exemple :

IMathLeftSubSuperscriptElement script = new MathematicalText("y").setSubSuperscriptOnTheLeft("2x", "3z");

Méthode Radical

Spécifie la racine mathématique du degré indiqué à partir de l’argument donné.

Exemple :

IMathRadical radical = new MathematicalText("x").radical("3");

Méthodes SetUpperLimit et SetLowerLimit

Définit une limite supérieure ou inférieure. La position indique simplement si l’argument est placé au-dessus ou en dessous de la base.

Considérons l’expression :

todo:image_alt_text

Cette expression peut être créée en combinant les classes MathFunction et MathLimit ainsi que les opérations de IMathElement :

IMathFunction mathExpression = new MathematicalText("lim").setLowerLimit("x→∞").function("x");

Méthodes Nary et Integral

Les méthodes nary et integral créent et renvoient un opérateur n‑aire de type IMathNaryOperator. Dans la méthode nary, l’énumération MathNaryOperatorTypes indique le type d’opérateur : somme, union, etc., excluant les intégrales. La méthode Integral utilise l’énumération MathIntegralTypes pour les différents types d’intégrales.

Exemple :

IMathBlock baseArg = new MathematicalText("x").join(new MathematicalText("dx").toBox());

IMathNaryOperator integral = baseArg.integral(MathIntegralTypes.Simple, "0", "1");

Méthode ToMathArray

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

Exemple :

IMathArray arrayFunction = new MathematicalText("x").join("y").toMathArray();

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

  • Méthode accent : ajoute un accent (caractère au‑dessus de l’élément).
  • Méthodes overbar et underbar : ajoutent une barre au‑dessus ou au‑dessous.
  • Méthode group : regroupe à l’aide d’un symbole de groupement tel qu’une accolade inférieure ou autre.
  • Méthode toBorderBox : place dans une bordure.
  • Méthode toBox : place dans une boîte logique non visuelle.

Exemples :

IMathAccent accent = new MathematicalText("x").accent('\u0303');

IMathBar bar = new MathematicalText("x").overbar();

IMathGroupingCharacter groupChr = new MathematicalText("x").join("y").join("z").group('\u23E1', MathTopBotPositions.Bottom, MathTopBotPositions.Top);

IMathBorderBox borderBox = new MathematicalText("x+y+z").toBorderBox();

IMathBox boxedOperator = new MathematicalText(":=").toBox();

FAQ

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

Pour ajouter une équation, créez un objet forme mathématique, qui contient automatiquement une portion mathématique. Ensuite, récupérez le MathParagraph depuis la 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 complexes en imbriquant des MathBlocks. Chaque élément implémente l’interface IMathElement, ce qui vous permet d’appliquer des opérations (Join, Divide, Enclose, etc.) pour les combiner.

Comment mettre à jour ou modifier une équation existante ?

Pour mettre à jour une équation, accédez aux MathBlocks existants via le MathParagraph. Ensuite, à l’aide des méthodes comme Join, Divide, Enclose, etc., modifiez les éléments de l’équation. Après modification, enregistrez la présentation pour appliquer les changements.

Graphiques PowerPoint Formes PowerPoint