Добавить математические уравнения в презентации PowerPoint на Python
Обзор
PowerPoint сохраняет уравнения в виде Office Math Markup Language (OMML). С помощью Aspose.Slides for Python via Java вы можете программно создавать такой же математический контент: дроби, радикалы, функции, пределы, n-арные операторы, матрицы, массивы и отформатированные блоки математики.
В PowerPoint пользователи обычно добавляют уравнения через Вставка > Формула:

Результатом является редактируемый математический текст на слайде:

Aspose.Slides создает этот математический текст с помощью трех основных объектов:
- Математическая фигура, создаваемая с помощью addMathShape, представляет собой форму, содержащую уравнение.
- MathPortion хранит математическое содержимое внутри текстового фрейма формы.
- MathParagraph содержит один или несколько объектов MathBlock.
Большинство примеров ниже используют MathematicalText и цепочные методы из MathElementBase , чтобы код был коротким и читаемым.
Для сценариев экспорта MathML смотрите Экспорт математических уравнений из презентаций в Python.
Создать уравнение
В этом примере используется addMathShape, чтобы создать математическую форму и добавить теорему Пифагора:

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 120)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
a_squared = MathematicalText("a").setSuperscript("2")
b_squared = MathematicalText("b").setSuperscript("2")
equation = MathematicalText("c").setSuperscript("2").join("=").join(a_squared).join("+").join(b_squared)
math_paragraph.add(equation)
presentation.save("pythagorean-theorem.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Note
addMathShape создает форму, которая уже содержит математический абзац. Доступ к первой MathPortion, вызов getMathParagraph, и добавление математических блоков или элементов в него.Добавить дроби
Используйте divide, чтобы создать дробь. Вы можете выбрать стиль дроби с помощью MathFractionTypes.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathFractionTypes, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
fraction = MathematicalText("1").divide("x", MathFractionTypes.Skewed)
math_block = MathBlock(fraction)
math_paragraph.add(math_block)
presentation.save("fraction.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Для сложенной (вертикальной) дроби используйте MathFractionTypes.Bar:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathFractionTypes, MathematicalText
stacked_fraction = MathematicalText("x + 1").divide("y - 1", MathFractionTypes.Bar)
Добавить радикалы
Используйте radical, чтобы создать квадратный корень, кубический корень или иной корень. Текущий элемент становится основанием, а аргумент — степенью.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
radical = MathematicalText("x").radical("n")
math_block = MathBlock(radical)
math_paragraph.add(math_block)
presentation.save("radical.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Показать или скрыть степень квадратного корня
Квадратный корень может отображать явную цифру 2 или использовать традиционную запись √x. Метод setHideDegree класса MathRadical управляет тем, какая форма отображается. Обе формы сохраняют степень 2 и радиканд x в редактируемом уравнении.

Пример сохраняет один и тот же квадратный корень дважды. В visible-degree.pptx цифра 2 видна. В hidden-degree.pptx она скрыта.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
radical = MathematicalText("x").radical("2")
math_block = MathBlock(radical)
math_shape = slide.getShapes().addMathShape(20, 20, 200, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
math_paragraph.add(math_block)
radical.setHideDegree(False)
presentation.save("visible-degree.pptx", SaveFormat.Pptx)
radical.setHideDegree(True)
presentation.save("hidden-degree.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Добавить функции и пределы
Используйте asArgumentOfFunction или function для функций, таких как sin(x), log(x) или пользовательских названий функций. Для пределов поместите lim в MathLimit или используйте setLowerLimit.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
limit = MathematicalText("lim").setLowerLimit("x\u2192\u221E").function("x")
math_block = MathBlock(limit)
math_paragraph.add(math_block)
presentation.save("functions-and-limits.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Для пользовательского имени функции сделайте имя функции текущим элементом и вызовите function с его аргументом:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathematicalText
custom_function = MathematicalText("f").function("x + 1")
Добавить n-арные операторы и интегралы
Используйте nary, чтобы добавить суммирование, объединения, пересечения и другие крупные операторы. Используйте integral, чтобы добавить интегралы. Оба метода позволяют задавать нижние и верхние пределы.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathNaryOperatorTypes, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 120)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
a_power = MathematicalText("a").setSuperscript("n-k")
summation_base = MathematicalText("x").setSuperscript("k").join(a_power)
summation = summation_base.nary(MathNaryOperatorTypes.Summation, "k=0", "n")
math_block = MathBlock(summation)
math_paragraph.add(math_block)
presentation.save("nary-operators.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
n-арные операторы предназначены для крупных операторов с необязательными пределами. Простые операторы, такие как +, - и =, обычно добавляются как MathematicalText и объединяются в выражение.
Для интеграла используйте integral:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathIntegralTypes, MathematicalText
differential = MathematicalText("dx").toBox()
integral_base = MathematicalText("x").join(differential)
integral = integral_base.integral(MathIntegralTypes.Simple, "0", "1")
Добавить матрицы
Используйте MathMatrix для строк и столбцов. По умолчанию матрицы не содержат скобок, поэтому окружайте матрицу, если нужны круглые скобки, квадратные скобки или фигурные скобки.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathMatrix, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 120)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
matrix = MathMatrix(2, 3)
cell_0_0 = MathematicalText("1")
matrix.set_Item(0, 0, cell_0_0)
cell_0_1 = MathematicalText("x")
matrix.set_Item(0, 1, cell_0_1)
cell_1_0 = MathematicalText("x")
matrix.set_Item(1, 0, cell_1_0)
cell_1_1 = MathematicalText("2")
matrix.set_Item(1, 1, cell_1_1)
cell_1_2 = MathematicalText("y")
matrix.set_Item(1, 2, cell_1_2)
math_block = MathBlock(matrix)
math_paragraph.add(math_block)
presentation.save("matrix.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Добавить массивы уравнений
Используйте toMathArray, когда нужны выровненные уравнения или вертикальная стопка выражений.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 140)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
equation_array = MathematicalText("x").join("y").toMathArray()
math_block = MathBlock(equation_array)
math_paragraph.add(math_block)
presentation.save("equation-array.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Выровнять массив с окружающими элементами
setBaseJustification управляет вертикальным выравниванием массива относительно соседних математических элементов. Пример ниже сравнивает выравнивание с первой строкой, центром массива и последней строкой.
Следующий пример создает три одинаковых массива, каждый из трех строк и соседних элементов A= и =B. Весь математический текст использует Cambria Math размером 24 пункта. Меняется только выравнивание массива.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, MathArray, MathBlock, MathJustification, MathematicalText, MathVerticalAlignment, Presentation, SaveFormat, ShapeType, SlideSizeScaleType, TextAnchorType
from java.awt import Color
def create_text(value):
text = MathematicalText(value)
text.getFormat().setFontHeight(24)
text.getFormat().setLatinFont(FontData("Cambria Math"))
return text
presentation = Presentation()
try:
presentation.getSlideSize().setSize(780, 200, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
alignments = (("Top", MathVerticalAlignment.Top), ("Center", MathVerticalAlignment.Center), ("Bottom", MathVerticalAlignment.Bottom))
for index, (name, alignment) in enumerate(alignments):
x = 20 + index * 260
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)
label_format = label.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat()
label_format.setFontHeight(16)
label_format.getFillFormat().setFillType(FillType.Solid)
label_format.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
math_shape = slide.getShapes().addMathShape(x, 60, 240, 130)
math_shape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Top)
paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0)
math_paragraph = paragraph.getPortions().get_Item(0).getMathParagraph()
math_paragraph.setJustification(MathJustification.LeftJustified)
equation_array = MathArray(create_text("x+y=3"))
equation_array.getArguments().add(create_text("x-y=1"))
equation_array.getArguments().add(create_text("x=2"))
equation_array.setBaseJustification(alignment)
equation = MathBlock(create_text("A=")).join(equation_array).join(create_text("=B"))
math_paragraph.add(equation)
presentation.save("equation-array-alignment.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Следующее сравнение показывает сохраненную презентацию в PowerPoint. Обратите внимание на положение A= и =B рядом с каждым массивом.

Настроить расстояние между строками
setRowSpacingRule выбирает правило отступов для строк внутри массива. setRowSpacing задает числовое значение для явного правила отступа и игнорируется предустановленными правилами.
Для точного отступа значение измеряется в пунктах. Для пропорционального отступа измеряется в полутемах: значение 3 в примере соответствует 1,5 строке. Устанавливайте оба свойства, задавая явное значение; изменение только числового значения не выбирает правило отступа.
В примере ниже сохраняются пять презентаций с одинаковыми уравнениями, выравниванием и настройками шрифта. Первые три используют предустановки; последние два показывают явные значения.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, MathArray, MathBlock, MathJustification, MathematicalText, MathRowSpacingRule, MathVerticalAlignment, Presentation, SaveFormat
def create_text(value):
text = MathematicalText(value)
text.getFormat().setFontHeight(24)
text.getFormat().setLatinFont(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))
for name, rule, spacing in settings:
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 600, 300)
paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getParagraphFormat().setSpaceBefore(0)
paragraph.getParagraphFormat().setSpaceAfter(0)
math_paragraph = paragraph.getPortions().get_Item(0).getMathParagraph()
math_paragraph.setJustification(MathJustification.LeftJustified)
equation_array = MathArray(create_text("x+y=3"))
equation_array.getArguments().add(create_text("x-y=1"))
equation_array.getArguments().add(create_text("x=2"))
equation_array.setBaseJustification(MathVerticalAlignment.Center)
equation_array.setRowSpacingRule(rule)
equation_array.setRowSpacing(spacing)
equation = MathBlock(create_text("A=")).join(equation_array).join(create_text("=B"))
math_paragraph.add(equation)
presentation.save(f"equation-array-{name}.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Отступы строк массива отличаются от отступов абзаца. setSpaceBefore и setSpaceAfter добавляют пространство вокруг содержащего абзаца, а не между строками массива. Аналогично, MathParagraph.setJustification позиционирует весь математический абзац по горизонтали; он не заменяет настройку вертикального выравнивания массива.
Добавить тригонометрические функции
Используйте asArgumentOfFunction, когда аргумент является текущим элементом и имя функции известно.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathFunctionsOfOneArgument, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
cosine = MathematicalText("2x").asArgumentOfFunction(MathFunctionsOfOneArgument.Cos)
math_block = MathBlock(cosine)
math_paragraph.add(math_block)
presentation.save("trigonometric-function.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Добавить нижние и верхние индексы
Используйте вспомогательные функции для нижних и верхних индексов. Когда индексы должны располагаться слева от основания, используйте setSubSuperscriptOnTheLeft.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
scripts = MathematicalText("Y").setSubSuperscriptOnTheLeft("1", "n")
math_block = MathBlock(scripts)
math_paragraph.add(math_block)
presentation.save("subscript-superscript.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Добавить разделители
Используйте enclose, чтобы поместить выражение внутрь разделителей. Вы также можете задать символ‑разделитель для выражений с несколькими элементами.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
delimiter = MathematicalText("x").join("y").join("z").enclose('<', '>')
delimiter.setSeparatorCharacter('|')
math_block = MathBlock(delimiter)
math_paragraph.add(math_block)
presentation.save("delimiters.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Размер и выравнивание разделителей
Передайте True в setGrowToMatchOperandHeight, чтобы скобки увеличивались вокруг высокого аргумента, или передайте False, чтобы оставить их обычного размера. Используйте setDelimiterShape с одним из двух значений MathDelimiterShape. Centered центрирует скобки относительно математической оси, проходящей через середину знака равенства. Match выравнивает их по содержимому. Оба параметра влияют только на скобки. Выражение внутри остаётся прежним.
В примере дробь помещается в степень x, поэтому выражение выходит выше базовой линии, чем ниже её. Все четыре уравнения используют одинаковые скобки и настройки шрифта.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathDelimiterShape, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
for row, grow in enumerate((True, False)):
for column, shape in enumerate((MathDelimiterShape.Centered, MathDelimiterShape.Match)):
fraction = MathematicalText("a + b").divide("c + d")
power = MathematicalText("x").setSuperscript(fraction)
delimiter = power.enclose("(", ")")
delimiter.setGrowToMatchOperandHeight(grow)
delimiter.setDelimiterShape(shape)
math_shape = slide.getShapes().addMathShape(20 + 330 * column, 20 + 120 * row, 300, 100)
portion = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
portion.getPortionFormat().setFontHeight(32)
equation = MathematicalText("y = ").join(delimiter)
portion.getMathParagraph().add(equation)
presentation.save("delimiter-sizing.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
В PowerPoint сравните строки, чтобы увидеть эффект роста. В верхней строке скобки увеличиваются, чтобы охватить степень, и выглядят одинаково для обеих форм. В нижней строке рост выключен. Более небольшие скобки слева (Centered) выравниваются со знаком равенства, а справа (Match) находятся выше вокруг выражения.

Добавить рамку
Вызовите toBorderBox для дроби, чтобы обрамить всё выражение. Возвращаемый объект MathBorderBox по умолчанию показывает все четыре стороны. Используйте setHideTop, setHideBottom, setHideLeft и setHideRight, чтобы убрать отдельные стороны.
В примере размещаются шесть копий одной и той же дроби на одном слайде. Чтобы показать аннулирование, скройте все четыре стороны и передайте True в setStrikethroughBottomLeftToTopRight для наклонной линии слева внизу направо вверх (↗) или в setStrikethroughTopLeftToBottomRight для наклонной линии сверху слева направо вниз (↘). Вы также можете использовать setStrikethroughHorizontal или setStrikethroughVertical с любой комбинацией видимых сторон.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat, SlideSizeScaleType
presentation = Presentation()
try:
presentation.getSlideSize().setSize(540, 220, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
def add_fraction(x, y, hide_border):
fraction = MathematicalText("x+1").divide("y+2")
box = fraction.toBorderBox()
box.setHideTop(hide_border)
box.setHideBottom(hide_border)
box.setHideLeft(hide_border)
box.setHideRight(hide_border)
shape = slide.getShapes().addMathShape(x, y, 160, 90)
portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
portion.getPortionFormat().setFontHeight(28)
math_block = MathBlock(box)
portion.getMathParagraph().add(math_block)
return box
add_fraction(10, 10, False)
partial = add_fraction(190, 10, False)
partial.setHideTop(True)
partial.setHideRight(True)
add_fraction(370, 10, True).setStrikethroughBottomLeftToTopRight(True)
add_fraction(10, 120, True).setStrikethroughTopLeftToBottomRight(True)
add_fraction(190, 120, True).setStrikethroughHorizontal(True)
add_fraction(370, 120, False).setStrikethroughVertical(True)
presentation.save("border-box.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

В этой дроби горизонтальная линия пересекает черту дроби. Вертикальная линия пересекает и числитель, и знаменатель, при этом окружающая рамка остаётся видимой. Эти линии украшают всё выражение. Обычное зачеркивание текста применяется к символам в текстовом блоке. После повторного открытия презентации в PowerPoint можно по‑прежнему редактировать числитель и знаменатель независимо.
Управление видимостью и расположением с помощью phantom‑элементов
Оберните выражение в MathPhantom, чтобы независимо управлять его видимостью и пространством, которое оно занимает в уравнении. Методы MathPhantom управляют следующим:
| Метод | Эффект |
|---|---|
| setShow | Передайте False, чтобы скрыть выражение. Его размеры всё равно учитываются в раскладке, если нижеуказанные методы не получат True. |
| setZeroWidth | Считать горизонтальную ширину выражения нулевой, позволяя соседним элементам приблизиться друг к другу. |
| setZeroAsc | Считать его подъём (высоту над базовой линией) нулевым. Это может уменьшить пространство над соседними элементами. |
| setZeroDesc | Считать его спуск (глубину ниже базовой линии) нулевым. Это может приблизить черту дроби или другое содержимое под выражением к соседям. |
Базовая линия — это опорная линия, на которой находятся обычные математические символы. Скрытие содержимого не удаляет его размеры, а установка размера в ноль не удаляет выражение. Исходное выражение остаётся доступным через getBase. Передайте True в setShow, чтобы снова отобразить его; настройки размеров останутся неизменными.
В примере ниже создаются пять вариантов рядом: видимая дробь, скрытая дробь, сохраняющая пространство, и три скрытые дроби, у которых одна из измерений установлена в ноль. Каждый вариант использует одинаковое окружающее выражение и Cambria Math 24 пункта. Все фигуры уравнений имеют одинаковую верхнюю позицию, обозначенную серой направляющей. Размещение phantom‑элемента в числителе внешней дроби упрощает визуальное восприятие изменений вертикального расположения.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, MathBlock, MathFraction, MathematicalText, MathPhantom, Presentation, SaveFormat, ShapeType, SlideSizeScaleType, TextAnchorType
from java.awt import Color
def create_text(value):
text = MathematicalText(value)
text.getFormat().setFontHeight(24)
text.getFormat().setLatinFont(FontData("Cambria Math"))
return text
presentation = 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(Color.LIGHT_GRAY)
for index, name in enumerate(labels):
left = 10 + index * 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(name)
label_format = label.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat()
label_format.setFontHeight(14)
label_format.getFillFormat().setFillType(FillType.Solid)
label_format.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
fraction_numerator = create_text("a+b")
fraction_denominator = create_text("c+d")
fraction = MathFraction(fraction_numerator, fraction_denominator)
phantom = MathPhantom(fraction)
phantom.setShow(index == 0)
phantom.setZeroWidth(index == 2)
phantom.setZeroAsc(index == 3)
phantom.setZeroDesc(index == 4)
left_text = create_text("x+")
right_text = create_text("+y")
numerator = MathBlock(left_text).join(phantom).join(right_text)
denominator = create_text("z")
equation = MathFraction(numerator, denominator)
shape = slide.getShapes().addMathShape(left, 60, 190, 100)
shape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Top)
math_portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
math_paragraph = math_portion.getMathParagraph()
math_block = MathBlock(equation)
math_paragraph.add(math_block)
presentation.save("math-phantom.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

Группировать члены
Используйте group, чтобы разместить символ группировки над или под выражением. Добавьте предел, чтобы пометить сгруппированные члены.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathTopBotPositions, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 120)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
grouped = MathematicalText("x + y").group('\u23DF', MathTopBotPositions.Bottom, MathTopBotPositions.Top).setLowerLimit("any text")
math_block = MathBlock(grouped)
math_paragraph.add(math_block)
presentation.save("grouped-terms.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Форматировать математические элементы
Используйте вспомогательные функции форматирования только там, где они уточняют формулу. Например, overbar помещает черту над математическим элементом.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
overbar = MathematicalText("ABC").overbar()
math_block = MathBlock(overbar)
math_paragraph.add(math_block)
presentation.save("overbar.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Форматировать текст в существующем уравнении
Чтобы отформатировать текст во всём существующем уравнении, пройдитесь по дереву элементов каждого математического блока. MathElementBase.getChildren возвращает только непосредственных потомков, поэтому вызывайте его рекурсивно, чтобы достать текст внутри дробей, надстрочных/подстрочных индексов, радикалов и других вложенных структур. Проверяйте текущий элемент, а также его потомков, чтобы включить стартовый элемент, если он является MathematicalText.
Этот пример предполагает, что input.pptx содержит уравнение, например z = xᵢ / ∛y, где в дроби числитель имеет подстрочный индекс, а знаменатель содержит радикал. Обработка только элементов верхнего уровня блока пропустит текст внутри дроби. Пример ищет математические части в текстовых фреймах слайдов, получает их блоки через MathPortion.getMathParagraph и использует setFontHeight, чтобы установить размер шрифта 28 пунктов через метод getFormat каждого текстового элемента.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import AutoShape, MathematicalText, MathPortion, Presentation, SaveFormat
def format_math_text(element):
if isinstance(element, MathematicalText):
element.getFormat().setFontHeight(28)
for child in element.getChildren():
format_math_text(child)
presentation = Presentation("input.pptx")
try:
for slide in presentation.getSlides():
for shape in slide.getShapes():
if not isinstance(shape, AutoShape):
continue
if shape.getTextFrame() is None:
continue
for paragraph in shape.getTextFrame().getParagraphs():
for portion in paragraph.getPortions():
if isinstance(portion, MathPortion):
for block in portion.getMathParagraph():
format_math_text(block)
presentation.save("formatted-equations.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Сохранённая презентация содержит обновлённое форматирование текста на каждом уровне каждой обработанной формулы, при этом сохраняется её текстовое содержание и математическая структура.
Быстрая справка
| Задача | Основное API |
|---|---|
| Создать математический текст | MathematicalText |
| Объединить элементы | MathElementBase.join |
| Создать дроби | MathElementBase.divide |
| Добавить надстрочный или подстрочный индекс | setSuperscript, setSubscript |
| Добавить функции | function, asArgumentOfFunction |
| Добавить радикалы | MathElementBase.radical |
| Добавить пределы | setLowerLimit, setUpperLimit |
| Добавить индексы слева | setSubSuperscriptOnTheLeft |
| Добавить суммы и интегралы | nary, integral |
| Добавить матрицы | MathMatrix |
| Добавить массивы уравнений | toMathArray |
| Добавить разделители | enclose |
| Добавить черты и рамки | overbar, toBorderBox |
| Группировать члены | group |
ЧаВо
Можно ли редактировать существующее уравнение PowerPoint?
Да. Откройте презентацию, найдите форму, содержащую MathPortion, вызовите getMathParagraph, и обновите математические блоки в этом абзаце.
Сохраняются ли уравнения как редактируемая математика PowerPoint?
Да. При сохранении в PPTX Aspose.Slides записывает уравнение как редактируемый контент Office Math.
Можно ли экспортировать уравнения в LaTeX?
Да. Получите MathParagraph уравнения из его MathPortion, и вызовите MathParagraph.toLatex, чтобы экспортировать его напрямую. Для полного примера смотрите Экспорт математических уравнений из презентаций в Python.