Aggiungi equazioni matematiche alle presentazioni PowerPoint in PHP
Panoramica
PowerPoint memorizza le equazioni come Office Math Markup Language (OMML). Con Aspose.Slides per PHP via Java, è possibile creare lo stesso tipo di contenuto matematico in modo programmatico: frazioni, radici, funzioni, limiti, operatori N‑ari, matrici, array e blocchi matematici formattati.
In PowerPoint, gli utenti normalmente aggiungono le equazioni da Insert > Equation:


Aspose.Slides costruisce quel testo matematico tramite tre oggetti principali:
- Una forma matematica, creata con addMathShape, è la forma che contiene l’equazione.
- MathPortion memorizza il contenuto matematico all’interno del riquadro di testo della forma.
- MathParagraph contiene uno o più oggetti MathBlock.
La maggior parte degli esempi qui sotto utilizza MathematicalText e i metodi fluenti di MathElementBase per mantenere il codice breve e leggibile.
Per scenari di esportazione MathML, vedere Export Math Equations from Presentations in PHP via Java.
Crea un’equazione
Questo esempio utilizza addMathShape per creare una forma matematica e aggiunge il teorema di Pitagora:

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 120);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$equation = (new MathematicalText("c"))
- >setSuperscript("2")
- >join("=")
- >join((new MathematicalText("a"))->setSuperscript("2"))
- >join("+")
- >join((new MathematicalText("b"))->setSuperscript("2"));
$mathParagraph->add($equation);
$presentation->save("pythagorean-theorem.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Note
addMathShape crea una forma che contiene già un paragrafo matematico. Accedi alla prima MathPortion, chiama getMathParagraph e aggiungi blocchi matematici o elementi matematici.Aggiungi frazioni
Usa divide per creare una frazione. Puoi scegliere uno stile di frazione con MathFractionTypes.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 100);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$fraction = (new MathematicalText("1"))
- >divide("x", MathFractionTypes::Skewed);
$mathParagraph->add(new MathBlock($fraction));
$presentation->save("fraction.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Per una frazione impilata, usa MathFractionTypes::Bar:
$stackedFraction = (new MathematicalText("x + 1"))->divide("y - 1", MathFractionTypes::Bar);
Aggiungi radici
Usa radical per creare una radice quadrata, cubica o un’altra radice. L’elemento corrente diventa la base e l’argomento diventa il grado.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 100);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$radical = (new MathematicalText("x"))
- >radical("n");
$mathParagraph->add(new MathBlock($radical));
$presentation->save("radical.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Mostra o nascondi il grado di una radice quadrata
Una radice quadrata può mostrare un 2 esplicito oppure usare la notazione convenzionale √x. Il metodo setHideDegree di MathRadical controlla quale forma appare. Entrambe le forme mantengono il grado 2 e il radicando x nell’equazione modificabile.

L’esempio salva la stessa radice quadrata due volte. In visible-degree.pptx, il 2 è visibile. In hidden-degree.pptx, è nascosto.
use aspose\slides\MathBlock;
use aspose\slides\MathematicalText;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$radical = (new MathematicalText("x"))->radical("2");
$shape = $slide->getShapes()->addMathShape(20, 20, 200, 100);
$portion = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0);
$portion->getMathParagraph()->add(new MathBlock($radical));
$radical->setHideDegree(false);
$presentation->save("visible-degree.pptx", SaveFormat::Pptx);
$radical->setHideDegree(true);
$presentation->save("hidden-degree.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Aggiungi funzioni e limiti
Usa asArgumentOfFunction o function per funzioni come sin(x), log(x) o nomi di funzioni personalizzati. Per i limiti, inserisci lim in un MathLimit o usa setLowerLimit.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 100);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$limit = (new MathematicalText("lim"))
- >setLowerLimit("x\u{2192}\u{221E}")
- >function("x");
$mathParagraph->add(new MathBlock($limit));
$presentation->save("functions-and-limits.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Per un nome di funzione personalizzato, rendi il nome della funzione l’elemento corrente e chiama function con il suo argomento:
$customFunction = (new MathematicalText("f"))->function("x + 1");
Aggiungi operatori N‑ari e integrali
Usa nary per somme, unioni, intersezioni e altri operatori grandi. Usa integral per gli integrali. Entrambi i metodi consentono di impostare i limiti inferiore e superiore.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 120);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$summationBase = (new MathematicalText("x"))
- >setSuperscript("k")
- >join((new MathematicalText("a"))->setSuperscript("n-k"));
$summation = $summationBase->nary(MathNaryOperatorTypes::Summation, "k=0", "n");
$mathParagraph->add(new MathBlock($summation));
$presentation->save("nary-operators.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Gli operatori N‑ari sono per operatori grandi con limiti opzionali. Gli operatori semplici come +, - e = vengono solitamente aggiunti come MathematicalText e concatenati nell’espressione.
Per un integrale, usa integral:
$integralBase = (new MathematicalText("x"))->join((new MathematicalText("dx"))->toBox());
$integral = $integralBase->integral(MathIntegralTypes::Simple, "0", "1");
Aggiungi matrici
Usa MathMatrix per righe e colonne. Le matrici non includono parentesi per impostazione predefinita, quindi racchiudi la matrice quando ti servono parentesi tonde, quadre o graffe.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 120);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$matrix = new MathMatrix(2, 3);
$matrix->set_Item(0, 0, new MathematicalText("1"));
$matrix->set_Item(0, 1, new MathematicalText("x"));
$matrix->set_Item(1, 0, new MathematicalText("x"));
$matrix->set_Item(1, 1, new MathematicalText("2"));
$matrix->set_Item(1, 2, new MathematicalText("y"));
$mathParagraph->add(new MathBlock($matrix));
$presentation->save("matrix.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Aggiungi array di equazioni
Usa toMathArray quando ti servono equazioni allineate o uno stack verticale di espressioni.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 140);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$equationArray = (new MathematicalText("x"))
- >join("y")
- >toMathArray();
$mathParagraph->add(new MathBlock($equationArray));
$presentation->save("equation-array.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Allinea un array con gli elementi circostanti
setBaseJustification controlla l’allineamento verticale di un array rispetto agli elementi matematici a fianco. L’esempio sotto confronta l’allineamento con la prima riga, il centro dell’array e l’ultima riga.
L’esempio seguente crea tre array identici, ognuno con tre righe e gli elementi vicini A= e =B. Tutto il testo matematico usa Cambria Math a 24 punti. Solo l’allineamento dell’array varia.
use aspose\slides\FillType;
use aspose\slides\FontData;
use aspose\slides\MathArray;
use aspose\slides\MathBlock;
use aspose\slides\MathJustification;
use aspose\slides\MathVerticalAlignment;
use aspose\slides\MathematicalText;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\SlideSizeScaleType;
use aspose\slides\TextAnchorType;
$createText = static function (string $value) {
$text = new MathematicalText($value);
$text->getFormat()->setFontHeight(24);
$text->getFormat()->setLatinFont(new FontData("Cambria Math"));
return $text;
};
$alignments = ["Top" => MathVerticalAlignment::Top, "Center" => MathVerticalAlignment::Center, "Bottom" => MathVerticalAlignment::Bottom];
$presentation = new Presentation();
try {
$presentation->getSlideSize()->setSize(780, 200, SlideSizeScaleType::DoNotScale);
$slide = $presentation->getSlides()->get_Item(0);
$x = 20;
foreach ($alignments as $name => $alignment) {
$label = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, $x, 10, 240, 30);
$label->getFillFormat()->setFillType(FillType::NoFill);
$label->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
$label->getTextFrame()->setText($name);
$labelFormat = $label->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$labelFormat->setFontHeight(16);
$labelFormat->getFillFormat()->setFillType(FillType::Solid);
$labelFormat->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
$mathShape = $slide->getShapes()->addMathShape($x, 60, 240, 130);
$mathShape->getTextFrame()->getTextFrameFormat()->setAnchoringType(TextAnchorType::Top);
$paragraph = $mathShape->getTextFrame()->getParagraphs()->get_Item(0);
$mathParagraph = $paragraph->getPortions()->get_Item(0)->getMathParagraph();
$mathParagraph->setJustification(MathJustification::LeftJustified);
$firstRow = $createText("x+y=3");
$equationArray = new MathArray($firstRow);
foreach (["x-y=1", "x=2"] as $value) {
$row = $createText($value);
$equationArray->getArguments()->add($row);
}
$equationArray->setBaseJustification($alignment);
$leftText = $createText("A=");
$rightText = $createText("=B");
$equation = (new MathBlock($leftText))->join($equationArray)->join($rightText);
$mathParagraph->add($equation);
$x += 260;
}
$presentation->save("equation-array-alignment.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
Il confronto seguente mostra la presentazione salvata in PowerPoint. Nota la posizione di A= e =B accanto a ciascun array.

Configura la spaziatura delle righe
setRowSpacingRule seleziona la regola di spaziatura per le righe all’interno dell’array. setRowSpacing fornisce un valore numerico per una regola di spaziatura esplicita ed è ignorato dalle regole predefinite.
Per una spaziatura esatta, il valore è misurato in punti. Per una spaziatura proporzionale, è misurata in mezze linee: il valore 3 nell’esempio specifica 1,5 linee. Imposta entrambe le proprietà quando specifichi un valore esplicito; cambiare solo il valore numerico non seleziona una regola di spaziatura.
L’esempio sotto salva cinque presentazioni con le stesse equazioni, allineamento e impostazioni di font. Le prime tre usano preset; le ultime due mostrano valori espliciti.
use aspose\slides\FontData;
use aspose\slides\MathArray;
use aspose\slides\MathBlock;
use aspose\slides\MathJustification;
use aspose\slides\MathRowSpacingRule;
use aspose\slides\MathVerticalAlignment;
use aspose\slides\MathematicalText;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$createText = static function (string $value) {
$text = new MathematicalText($value);
$text->getFormat()->setFontHeight(24);
$text->getFormat()->setLatinFont(new FontData("Cambria Math"));
return $text;
};
$settings = [
"SingleLineGap" => [MathRowSpacingRule::SingleLineGap, 0],
"OneAndAHalfLineGap" => [MathRowSpacingRule::OneAndAHalfLineGap, 0],
"TwoLineGap" => [MathRowSpacingRule::TwoLineGap, 0],
"Exactly" => [MathRowSpacingRule::Exactly, 20],
"Multiple" => [MathRowSpacingRule::Multiple, 3],
];
foreach ($settings as $name => [$rule, $spacing]) {
$presentation = new Presentation();
try {
$mathShape = $presentation->getSlides()->get_Item(0)->getShapes()->addMathShape(20, 20, 600, 300);
$paragraph = $mathShape->getTextFrame()->getParagraphs()->get_Item(0);
$paragraph->getParagraphFormat()->setSpaceBefore(0);
$paragraph->getParagraphFormat()->setSpaceAfter(0);
$mathParagraph = $paragraph->getPortions()->get_Item(0)->getMathParagraph();
$mathParagraph->setJustification(MathJustification::LeftJustified);
$firstRow = $createText("x+y=3");
$equationArray = new MathArray($firstRow);
foreach (["x-y=1", "x=2"] as $value) {
$row = $createText($value);
$equationArray->getArguments()->add($row);
}
$equationArray->setBaseJustification(MathVerticalAlignment::Center);
$equationArray->setRowSpacingRule($rule);
$equationArray->setRowSpacing($spacing);
$leftText = $createText("A=");
$rightText = $createText("=B");
$equation = (new MathBlock($leftText))->join($equationArray)->join($rightText);
$mathParagraph->add($equation);
$presentation->save("equation-array-$name.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
}
La spaziatura delle righe dell’array è separata dalla spaziatura del paragrafo. setSpaceBefore e setSpaceAfter aggiungono spazio attorno al paragrafo contenitore, non tra le righe dell’array. Allo stesso modo, MathParagraph::setJustification posiziona l’intero paragrafo matematico orizzontalmente; non sostituisce l’impostazione di allineamento verticale dell’array.
Aggiungi funzioni trigonometriche
Usa asArgumentOfFunction quando l’argomento è l’elemento corrente e il nome della funzione è noto.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 100);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$cosine = (new MathematicalText("2x"))
- >asArgumentOfFunction(MathFunctionsOfOneArgument::Cos);
$mathParagraph->add(new MathBlock($cosine));
$presentation->save("trigonometric-function.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Aggiungi pedici e apici
Usa gli assistenti per pedici e apici per indici e potenze. Quando gli indici devono apparire sul lato sinistro della base, usa setSubSuperscriptOnTheLeft.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 100);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$scripts = (new MathematicalText("Y"))
- >setSubSuperscriptOnTheLeft("1", "n");
$mathParagraph->add(new MathBlock($scripts));
$presentation->save("subscript-superscript.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Aggiungi delimitatori
Usa enclose per inserire un’espressione tra delimitatori. Puoi anche impostare un carattere separatore per espressioni delimitate che contengono più elementi.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 100);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$delimiter = (new MathematicalText("x"))
- >join("y")
- >join("z")
- >enclose(new Java("java.lang.Character", "<"), new Java("java.lang.Character", ">"));
$delimiter->setSeparatorCharacter(new Java("java.lang.Character", "|"));
$mathParagraph->add(new MathBlock($delimiter));
$presentation->save("delimiters.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Dimensiona e allinea i delimitatori
Passa true a setGrowToMatchOperandHeight per far crescere le parentesi attorno a un operando alto, oppure false per mantenerle della dimensione normale. Usa setDelimiterShape con uno dei due valori di MathDelimiterShape. Centered centra le parentesi sull’asse matematico, che attraversa il centro del segno di uguale. Match le allinea al contenuto inserito. Entrambe le impostazioni influenzano solo i delimitatori. L’espressione interna rimane invariata.
L’esempio inserisce una frazione nell’esponente di x così l’espressione si estende più sopra la linea di base che sotto. Tutte e quattro le equazioni usano le stesse parentesi e le stesse impostazioni di font.
use aspose\slides\MathDelimiterShape;
use aspose\slides\MathematicalText;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$opening = new Java("java.lang.Character", "(");
$closing = new Java("java.lang.Character", ")");
for ($row = 0; $row < 2; $row++) {
for ($column = 0; $column < 2; $column++) {
$fraction = (new MathematicalText("a + b"))->divide("c + d");
$power = (new MathematicalText("x"))->setSuperscript($fraction);
$delimiter = $power->enclose($opening, $closing);
$delimiter->setGrowToMatchOperandHeight($row === 0);
$delimiter->setDelimiterShape($column === 0 ? MathDelimiterShape::Centered : MathDelimiterShape::Match);
$mathShape = $slide->getShapes()->addMathShape(20 + 330 * $column, 20 + 120 * $row, 300, 100);
$portion = $mathShape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0);
$portion->getPortionFormat()->setFontHeight(32);
$equation = (new MathematicalText("y = "))->join($delimiter);
$portion->getMathParagraph()->add($equation);
}
}
$presentation->save("delimiter-sizing.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
In PowerPoint, confronta le righe per vedere l’effetto della crescita. Nella riga superiore, le parentesi crescono per racchiudere l’esponente e appaiono uguali per entrambe le forme. Nella riga inferiore, la crescita è disattivata. Le parentesi più piccole a sinistra (Centered) si allineano con il segno di uguale, mentre quelle a destra (Match) si trovano più in alto attorno all’espressione.

Aggiungi una cornice
Chiama toBorderBox su una frazione per inquadrare l’intera espressione. Il MathBorderBox restituito mostra tutti e quattro i lati per impostazione predefinita. Usa setHideTop, setHideBottom, setHideLeft e setHideRight per rimuovere lati individuali.
L’esempio posiziona sei copie della stessa frazione su una diapositiva. Per mostrare l’annullamento, nascondi tutti e quattro i lati e passa true a setStrikethroughBottomLeftToTopRight per una diagonale ascendente (↗) o a setStrikethroughTopLeftToBottomRight per una diagonale discendente (↘). Puoi anche usare setStrikethroughHorizontal o setStrikethroughVertical con qualsiasi combinazione di lati visibili.
use aspose\slides\MathBlock;
use aspose\slides\MathematicalText;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\SlideSizeScaleType;
$presentation = new Presentation();
try {
$presentation->getSlideSize()->setSize(540, 220, SlideSizeScaleType::DoNotScale);
$slide = $presentation->getSlides()->get_Item(0);
$addFraction = function ($x, $y, $hideBorder) use ($slide) {
$fraction = (new MathematicalText("x+1"))->divide("y+2");
$box = $fraction->toBorderBox();
$box->setHideTop($hideBorder);
$box->setHideBottom($hideBorder);
$box->setHideLeft($hideBorder);
$box->setHideRight($hideBorder);
$shape = $slide->getShapes()->addMathShape($x, $y, 160, 90);
$portion = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0);
$portion->getPortionFormat()->setFontHeight(28);
$mathBlock = new MathBlock($box);
$portion->getMathParagraph()->add($mathBlock);
return $box;
};
$addFraction(10, 10, false);
$partial = $addFraction(190, 10, false);
$partial->setHideTop(true);
$partial->setHideRight(true);
$addFraction(370, 10, true)->setStrikethroughBottomLeftToTopRight(true);
$addFraction(10, 120, true)->setStrikethroughTopLeftToBottomRight(true);
$addFraction(190, 120, true)->setStrikethroughHorizontal(true);
$addFraction(370, 120, false)->setStrikethroughVertical(true);
$presentation->save("border-box.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}

Su questa frazione, la barra orizzontale si sovrappone alla barra della frazione. La barra verticale attraversa sia il numeratore sia il denominatore mentre la cornice circostante rimane visibile. Queste linee decorano l’intera espressione. La barratura del testo ordinario si applica ai caratteri di un run di testo. Dopo aver riaperto la presentazione in PowerPoint, è ancora possibile modificare separatamente numeratore e denominatore.
Controlla la visibilità e il layout con elementi fantasma
Racchiudi un’espressione in MathPhantom per controllare indipendentemente la sua visibilità e lo spazio che contribuisce a un’equazione. I metodi di MathPhantom controllano quanto segue:
| Method | Effect |
|---|---|
| setShow | Passa false per nascondere l’espressione. Le sue dimensioni contribuiscono ancora al layout a meno che i metodi corrispondenti qui sotto non ricevano true. |
| setZeroWidth | Considera la larghezza orizzontale dell’espressione come zero, permettendo agli elementi vicini di avvicinarsi. |
| setZeroAsc | Considera la sua ascensione, l’altezza sopra la linea di base, come zero. Questo può ridurre lo spazio riservato sopra gli elementi vicini. |
| setZeroDesc | Considera la sua discesa, la profondità sotto la linea di base, come zero. Questo può avvicinare una barra di frazione o altro contenuto sotto l’espressione ai suoi vicini. |
La linea di base è la linea di riferimento su cui si posizionano i normali simboli matematici. Nascondere il contenuto non ne rimuove le dimensioni, e trattare una dimensione come zero non elimina l’espressione. L’espressione sottostante rimane disponibile tramite getBase. Passa true a setShow per visualizzarla nuovamente; le impostazioni di dimensione rimangono inalterate.
L’esempio qui sotto crea cinque varianti affiancate: una frazione visibile, una frazione nascosta che riserva spazio e tre frazioni nascoste con una dimensione trattata come zero. Ogni variante usa la stessa espressione circostante e Cambria Math a 24 punti. Tutte le forme dell’equazione hanno la stessa posizione superiore, indicata dalla guida grigia. Posizionare il fantasma nel numeratore di una frazione esterna rende più evidente il cambiamento di layout verticale.
use aspose\slides\FillType;
use aspose\slides\FontData;
use aspose\slides\MathBlock;
use aspose\slides\MathFraction;
use aspose\slides\MathPhantom;
use aspose\slides\MathematicalText;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\ShapeType;
use aspose\slides\SlideSizeScaleType;
use aspose\slides\TextAnchorType;
$createText = static function (string $value) {
$text = new MathematicalText($value);
$text->getFormat()->setFontHeight(24);
$text->getFormat()->setLatinFont(new FontData("Cambria Math"));
return $text;
};
$presentation = new Presentation();
try {
$presentation->getSlideSize()->setSize(1000, 180, SlideSizeScaleType::DoNotScale);
$slide = $presentation->getSlides()->get_Item(0);
$labels = ["Visible", "Hidden: reserves space", "Hidden: ZeroWidth", "Hidden: ZeroAsc", "Hidden: ZeroDesc"];
$guide = $slide->getShapes()->addAutoShape(ShapeType::Line, 10, 60, 980, 0);
$guide->getLineFormat()->getFillFormat()->setFillType(FillType::Solid);
$guide->getLineFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->LIGHT_GRAY);
foreach ($labels as $i => $labelText) {
$left = 10 + $i * 200;
$label = $slide->getShapes()->addAutoShape(ShapeType::Rectangle, $left, 10, 190, 30);
$label->getFillFormat()->setFillType(FillType::NoFill);
$label->getLineFormat()->getFillFormat()->setFillType(FillType::NoFill);
$label->getTextFrame()->setText($labelText);
$labelFormat = $label->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0)->getPortionFormat();
$labelFormat->setFontHeight(14);
$labelFormat->getFillFormat()->setFillType(FillType::Solid);
$labelFormat->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->BLACK);
$fractionNumerator = $createText("a+b");
$fractionDenominator = $createText("c+d");
$fraction = new MathFraction($fractionNumerator, $fractionDenominator);
$phantom = new MathPhantom($fraction);
$phantom->setShow($i === 0);
$phantom->setZeroWidth($i === 2);
$phantom->setZeroAsc($i === 3);
$phantom->setZeroDesc($i === 4);
$leftText = $createText("x+");
$rightText = $createText("+y");
$numerator = (new MathBlock($leftText))->join($phantom)->join($rightText);
$denominator = $createText("z");
$equation = new MathFraction($numerator, $denominator);
$shape = $slide->getShapes()->addMathShape($left, 60, 190, 100);
$shape->getTextFrame()->getTextFrameFormat()->setAnchoringType(TextAnchorType::Top);
$mathPortion = $shape->getTextFrame()->getParagraphs()->get_Item(0)->getPortions()->get_Item(0);
$mathParagraph = $mathPortion->getMathParagraph();
$mathBlock = new MathBlock($equation);
$mathParagraph->add($mathBlock);
}
$presentation->save("math-phantom.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}

Raggruppa termini
Usa group per posizionare un carattere di raggruppamento sopra o sotto un’espressione. Aggiungi un limite per etichettare i termini raggruppati.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 120);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$grouped = (new MathematicalText("x + y"))
- >group(new Java("java.lang.Character", "\u{23DF}"), MathTopBotPositions::Bottom, MathTopBotPositions::Top)
- >setLowerLimit("any text");
$mathParagraph->add(new MathBlock($grouped));
$presentation->save("grouped-terms.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Formatta gli elementi matematici
Usa gli assistenti di formattazione solo dove chiariscono la formula. Per esempio, overbar posiziona una barra sopra un elemento matematico.

$presentation = new Presentation();
try {
$slide = $presentation->getSlides()->get_Item(0);
$mathShape = $slide->getShapes()->addMathShape(20, 20, 700, 100);
$mathParagraph = $mathShape->getTextFrame()->getParagraphs()
- >get_Item(0)->getPortions()->get_Item(0)->getMathParagraph();
$overbar = (new MathematicalText("ABC"))->overbar();
$mathParagraph->add(new MathBlock($overbar));
$presentation->save("overbar.pptx", SaveFormat::Pptx);
} finally {
if (!java_is_null($presentation)) {
$presentation->dispose();
}
}
Formatta il testo in un’equazione esistente
Per formattare il testo in un’equazione esistente, percorri l’albero degli elementi di ogni blocco matematico. MathElementBase::getChildren restituisce solo i figli immediati, quindi chiamalo ricorsivamente per raggiungere il testo all’interno di frazioni, script, radici e altre strutture nidificate. Controlla sia l’elemento corrente sia i suoi figli per includere l’elemento iniziale quando è MathematicalText.
Questo esempio assume che input.pptx contenga un’equazione come z = xᵢ / ∛y, con una frazione che contiene un pedice nel numeratore e una radice nel denominatore. Elaborare solo gli elementi di livello superiore del blocco ometterebbe il testo all’interno della frazione. L’esempio trova le porzioni matematiche nei riquadri di testo delle diapositive, accede ai loro blocchi tramite MathPortion::getMathParagraph e usa setFontHeight per impostare la dimensione del font a 28 punti attraverso il metodo getFormat di ogni elemento di testo.
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
function formatMathText($element, $mathematicalTextClass) {
if (java_instanceof($element, $mathematicalTextClass)) {
$element->getFormat()->setFontHeight(28);
}
foreach ($element->getChildren() as $child) {
formatMathText($child, $mathematicalTextClass);
}
}
$mathematicalTextClass = new JavaClass("com.aspose.slides.MathematicalText");
$autoShapeClass = new JavaClass("com.aspose.slides.IAutoShape");
$mathPortionClass = new JavaClass("com.aspose.slides.IMathPortion");
$presentation = new Presentation("input.pptx");
try {
for ($slideIndex = 0; $slideIndex < java_values($presentation->getSlides()->size()); $slideIndex++) {
$slide = $presentation->getSlides()->get_Item($slideIndex);
for ($shapeIndex = 0; $shapeIndex < java_values($slide->getShapes()->size()); $shapeIndex++) {
$shape = $slide->getShapes()->get_Item($shapeIndex);
if (!java_instanceof($shape, $autoShapeClass)) {
continue;
}
$textFrame = $shape->getTextFrame();
if (java_is_null($textFrame)) {
continue;
}
for ($paragraphIndex = 0; $paragraphIndex < java_values($textFrame->getParagraphs()->getCount()); $paragraphIndex++) {
$paragraph = $textFrame->getParagraphs()->get_Item($paragraphIndex);
for ($portionIndex = 0; $portionIndex < java_values($paragraph->getPortions()->getCount()); $portionIndex++) {
$portion = $paragraph->getPortions()->get_Item($portionIndex);
if (java_instanceof($portion, $mathPortionClass)) {
for ($blockIndex = 0; $blockIndex < java_values($portion->getMathParagraph()->getCount()); $blockIndex++) {
$block = $portion->getMathParagraph()->get_Item($blockIndex);
formatMathText($block, $mathematicalTextClass);
}
}
}
}
}
}
$presentation->save("formatted-equations.pptx", SaveFormat::Pptx);
} finally {
$presentation->dispose();
}
La presentazione salvata contiene la formattazione del testo aggiornata a tutti i livelli di ogni equazione elaborata, preservando il contenuto testuale e la struttura matematica.
Riferimento rapido
| Task | Main API |
|---|---|
| Crea testo matematico | MathematicalText |
| Combina elementi | join |
| Crea frazioni | divide |
| Aggiungi apice o pedice | setSuperscript, setSubscript |
| Aggiungi funzioni | function, asArgumentOfFunction |
| Aggiungi radici | radical |
| Aggiungi limiti | setLowerLimit, setUpperLimit |
| Aggiungi script a sinistra | setSubSuperscriptOnTheLeft |
| Aggiungi somme e integrali | nary, integral |
| Aggiungi matrici | MathMatrix |
| Aggiungi array di equazioni | toMathArray |
| Aggiungi delimitatori | enclose |
| Aggiungi barre e cornici | overbar, toBorderBox |
| Raggruppa termini | group |
FAQ
Posso modificare un’equazione PowerPoint esistente?
Sì. Apri la presentazione, trova la forma che contiene una MathPortion, chiama getMathParagraph e aggiorna i blocchi matematici in quel paragrafo.
Le equazioni vengono salvate come matematica PowerPoint modificabile?
Sì. Quando salvi in PPTX, Aspose.Slides scrive l’equazione come contenuto Office Math modificabile.
Posso esportare le equazioni in LaTeX?
Sì. Ottieni il MathParagraph dell’equazione dalla sua MathPortion, quindi chiama MathParagraph::toLatex per esportarla direttamente. Per un esempio completo, vedere Esporta equazioni matematiche da presentazioni in PHP via Java.