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

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

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

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 120)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
equation = (
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(equation)
presentation.save("pythagorean-theorem.pptx", slides.export.SaveFormat.PPTX)
Note
add_math_shape создает фигуру, которая уже содержит математический абзац. Получите первый MathPortion , возьмите его math_paragraph , и добавьте к нему блоки или элементы математики.Объединить математические блоки
Когда части уравнения создаются независимо как объекты MathBlock , используйте join_block , чтобы объединить их. В примере в левом блоке формируется c² =, а в правом — a² + b². set_superscript создает редактируемые математические надстрочные индексы для всех трех степеней.
import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
shape = slide.shapes.add_math_shape(20, 20, 600, 100)
math_paragraph = shape.text_frame.paragraphs[0].portions[0].math_paragraph
left_block = math.MathBlock()
left_block.add(math.MathematicalText("c").set_superscript("2"))
left_block.add(math.MathematicalText("="))
right_block = math.MathBlock()
right_block.add(math.MathematicalText("a").set_superscript("2"))
right_block.add(math.MathematicalText("+"))
right_block.add(math.MathematicalText("b").set_superscript("2"))
combined_block = left_block.join_block(right_block)
math_paragraph.add(combined_block)
presentation.save("equation.pptx", slides.export.SaveFormat.PPTX)
join_block возвращает сам left_block, теперь содержащий обе части в порядке, и оставляет right_block пустым. Добавьте объединённый блок в MathParagraph только один раз. После повторного открытия equation.pptx абзац содержит один блок, представляющий c² = a² + b², при этом все три степени сохраняются как надстрочные индексы.
Вызов add как left_block.add(right_block) пытается вложить один блок непосредственно в другой и вызывает RuntimeError, оборачивающий .NET InvalidOperationException.
Добавить дроби
Используйте divide , чтобы создать дробь. Вы можете выбрать стиль дроби с помощью MathFractionTypes.

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 100)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
fraction = math.MathematicalText("1").divide("x", math.MathFractionTypes.SKEWED)
math_paragraph.add(math.MathBlock(fraction))
presentation.save("fraction.pptx", slides.export.SaveFormat.PPTX)
Для сложенной дроби используйте MathFractionTypes.BAR :
import aspose.slides.mathtext as math
stacked_fraction = math.MathematicalText("x + 1").divide("y - 1", math.MathFractionTypes.BAR)
Добавить радикалы
Используйте radical , чтобы создать квадратный корень, кубический корень или другой корень. Текущий элемент становится основанием, а аргумент — степенью.

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 100)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
radical = math.MathematicalText("x").radical("n")
math_paragraph.add(math.MathBlock(radical))
presentation.save("radical.pptx", slides.export.SaveFormat.PPTX)
Показать или скрыть степень квадратного корня
Квадратный корень может отображать явную 2 или использовать традиционную запись √x. Свойство hide_degree класса MathRadical определяет, какая форма будет показана. Обе формы сохраняют степень 2 и подкоренное x в редактируемом уравнении.

В примере один и тот же квадратный корень сохраняется дважды. 2 видна в visible-degree.pptx и скрыта в hidden-degree.pptx.
import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
radical = math.MathematicalText("x").radical("2")
shape = slide.shapes.add_math_shape(20, 20, 200, 100)
portion = shape.text_frame.paragraphs[0].portions[0]
portion.math_paragraph.add(math.MathBlock(radical))
radical.hide_degree = False
presentation.save("visible-degree.pptx", slides.export.SaveFormat.PPTX)
radical.hide_degree = True
presentation.save("hidden-degree.pptx", slides.export.SaveFormat.PPTX)
Добавить функции и пределы
Используйте as_argument_of_function или function для функций, таких как sin(x), log(x) или пользовательских имён функций. Для пределов поместите lim в MathLimit или используйте set_lower_limit .

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 100)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
limit = (
math.MathematicalText("lim")
.set_lower_limit("x\u2192\u221E")
.function("x")
)
math_paragraph.add(math.MathBlock(limit))
presentation.save("functions-and-limits.pptx", slides.export.SaveFormat.PPTX)
Для пользовательского имени функции сделайте имя функции текущим элементом и вызовите function с её аргументом:
import aspose.slides.mathtext as math
custom_function = math.MathematicalText("f").function("x + 1")
Добавить n-арные операторы и интегралы
Используйте nary для суммирования, объединения, пересечения и других больших операторов. Используйте integral для интегралов. Оба метода позволяют задать нижние и верхние пределы.

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 120)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
summation_base = (
math.MathematicalText("x")
.set_superscript("k")
.join(math.MathematicalText("a").set_superscript("n-k"))
)
summation = summation_base.nary(math.MathNaryOperatorTypes.SUMMATION, "k=0", "n")
math_paragraph.add(math.MathBlock(summation))
presentation.save("nary-operators.pptx", slides.export.SaveFormat.PPTX)
n-арные операторы предназначены для больших операторов с необязательными пределами. Простые операторы, такие как +, - и = обычно добавляются как MathematicalText и соединяются в выражение.
Для интеграла используйте integral :
import aspose.slides.mathtext as math
integral_base = math.MathematicalText("x").join(math.MathematicalText("dx").to_box())
integral = integral_base.integral(math.MathIntegralTypes.SIMPLE, "0", "1")
Добавить матрицы
Используйте MathMatrix для строк и столбцов. По умолчанию матрицы не включают скобки, поэтому при необходимости обрамляйте их круглыми, квадратными или фигурными скобками.

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 120)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
matrix = math.MathMatrix(2, 3)
matrix[0, 0] = math.MathematicalText("1")
matrix[0, 1] = math.MathematicalText("x")
matrix[1, 0] = math.MathematicalText("x")
matrix[1, 1] = math.MathematicalText("2")
matrix[1, 2] = math.MathematicalText("y")
math_paragraph.add(math.MathBlock(matrix))
presentation.save("matrix.pptx", slides.export.SaveFormat.PPTX)
Редактировать существующую матрицу
Предположим, урок линейной алгебры начинается с коэффициентной матрицы в matrix.pptx, сохранённой предыдущим примером. Для следующего упражнения сохраняем первое уравнение, заменяем второе двумя новыми и меняем набор переменных. Доступ к существующей матрице осуществляется через MathMatrix , чтобы сохранить применимые коэффициенты.

Индексы строк и столбцов начинаются с нуля и относятся к текущему состоянию матрицы при каждом вызове. Вставка строки перед индексом 1 смещает оригинальную вторую строку к индексу 2. Вставка после индекса 2 затем добавляет строку. Удаление строки 2 удаляет оригинальное второе уравнение и поднимает добавленную строку на одну позицию. Столбцы смещаются аналогично.
import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation("matrix.pptx") as presentation:
shape = presentation.slides[0].shapes[0]
portion = shape.text_frame.paragraphs[0].portions[0]
matrix = portion.math_paragraph[0][0]
matrix.insert_row_before(1)
matrix.insert_row_after(2)
matrix.delete_row(2)
matrix.insert_column_before(1)
matrix.insert_column_after(3)
matrix.delete_column(3)
matrix[1, 0] = math.MathematicalText("12")
matrix[1, 1] = math.MathematicalText("1")
matrix[2, 2] = math.MathematicalText("10")
matrix[2, 3] = math.MathematicalText("1")
for row in range(matrix.row_count):
for column in range(matrix.column_count):
if matrix[row, column] is None:
matrix[row, column] = math.MathematicalText("0")
matrix.set_column_alignment(0, math.MathHorizontalAlignment.LEFT)
matrix.set_columns_alignment(1, 3, math.MathHorizontalAlignment.RIGHT)
presentation.save("updated-matrix.pptx", slides.export.SaveFormat.PPTX)
set_column_alignment выравнивает первый столбец по левому краю. set_columns_alignment выравнивает три последовательных столбца по правому краю, начиная с индекса 1. В updated-matrix.pptx матрица содержит три уравнения и четыре переменные. Первоначальные коэффициенты первой строки 1 и x теперь находятся в первом и третьем столбцах.

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

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 140)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
equation_array = (
math.MathematicalText("x")
.join("y")
.to_math_array()
)
math_paragraph.add(math.MathBlock(equation_array))
presentation.save("equation-array.pptx", slides.export.SaveFormat.PPTX)
Выравнивание массива с соседними элементами
MathArray.base_justification контролирует вертикальное выравнивание массива относительно соседних математических элементов. Пример ниже сравнивает выравнивание по первой строке, по центру массива и по последней строке.
Следующий пример создаёт три идентичных массива, каждый с тремя строками и соседними элементами A= и =B. Весь математический текст использует Cambria Math размером 24 pt. Меняется только выравнивание массива.
import aspose.slides as slides
import aspose.slides.mathtext as math
def create_text(value):
text = math.MathematicalText(value)
text.format.font_height = 24
text.format.latin_font = slides.FontData("Cambria Math")
return text
with slides.Presentation() as presentation:
presentation.slide_size.set_size(780, 200, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
alignments = [math.MathVerticalAlignment.TOP, math.MathVerticalAlignment.CENTER, math.MathVerticalAlignment.BOTTOM]
labels = ["Top", "Center", "Bottom"]
for i, alignment in enumerate(alignments):
label = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 20 + i * 260, 10, 240, 30)
label.fill_format.fill_type = slides.FillType.NO_FILL
label.line_format.fill_format.fill_type = slides.FillType.NO_FILL
label.text_frame.text = labels[i]
label_format = label.text_frame.paragraphs[0].portions[0].portion_format
label_format.font_height = 16
label_format.fill_format.fill_type = slides.FillType.SOLID
label_format.fill_format.solid_fill_color.color = slides.Color.black
math_shape = slide.shapes.add_math_shape(20 + i * 260, 60, 240, 130)
math_shape.text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.TOP
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
math_paragraph.justification = math.MathJustification.LEFT_JUSTIFIED
rows = [create_text("x+y=3"), create_text("x-y=1"), create_text("x=2")]
equation_array = math.MathArray(rows)
equation_array.base_justification = alignment
left_text = create_text("A=")
right_text = create_text("=B")
equation = math.MathBlock(left_text).join(equation_array).join(right_text)
math_paragraph.add(equation)
presentation.save("equation-array-alignment.pptx", slides.export.SaveFormat.PPTX)
Сравнение ниже показывает сохранённую презентацию в PowerPoint. Обратите внимание на позицию A= и =B рядом с каждым массивом.

Настроить интервал строк
row_spacing_rule выбирает правило интервала для строк внутри массива. row_spacing задаёт числовое значение для явного правила и игнорируется предустановленными правилами.
Для точного интервала значение измеряется в пунктах. Для пропорционального интервала оно измеряется в полу‑линиях: значение 3 в примере соответствует 1,5 линии. Устанавливайте оба свойства, когда задаёте явное значение; изменение только числового значения не выбирает правило интервала.
Ниже пример сохраняет пять презентаций с одинаковыми уравнениями, выравниванием и параметрами шрифта. Первые три используют предустановки; последние два показывают явные значения.
import aspose.slides as slides
import aspose.slides.mathtext as math
def create_text(value):
text = math.MathematicalText(value)
text.format.font_height = 24
text.format.latin_font = slides.FontData("Cambria Math")
return text
settings = [
(math.MathRowSpacingRule.SINGLE_LINE_GAP, 0),
(math.MathRowSpacingRule.ONE_AND_A_HALF_LINE_GAP, 0),
(math.MathRowSpacingRule.TWO_LINE_GAP, 0),
(math.MathRowSpacingRule.EXACTLY, 20),
(math.MathRowSpacingRule.MULTIPLE, 3)
]
for rule, spacing in settings:
file_name = f"equation-array-{rule.name}.pptx"
with slides.Presentation() as presentation:
math_shape = presentation.slides[0].shapes.add_math_shape(20, 20, 600, 300)
paragraph = math_shape.text_frame.paragraphs[0]
paragraph.paragraph_format.space_before = 0
paragraph.paragraph_format.space_after = 0
math_paragraph = paragraph.portions[0].math_paragraph
math_paragraph.justification = math.MathJustification.LEFT_JUSTIFIED
rows = [create_text("x+y=3"), create_text("x-y=1"), create_text("x=2")]
equation_array = math.MathArray(rows)
equation_array.base_justification = math.MathVerticalAlignment.CENTER
equation_array.row_spacing_rule = rule
equation_array.row_spacing = spacing
left_text = create_text("A=")
right_text = create_text("=B")
equation = math.MathBlock(left_text).join(equation_array).join(right_text)
math_paragraph.add(equation)
presentation.save(file_name, slides.export.SaveFormat.PPTX)
Интервал строк массива отделён от интервала абзаца. space_before и space_after добавляют пространство вокруг содержащего абзаца, а не между строками массива. Аналогично, MathParagraph.justification позиционирует весь математический абзац горизонтально; он не заменяет вертикальную настройку выравнивания массива.
Добавить тригонометрические функции
Используйте as_argument_of_function , когда аргумент является текущим элементом и имя функции известно.

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 100)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
cosine = math.MathematicalText("2x").as_argument_of_function(
math.MathFunctionsOfOneArgument.COS
)
math_paragraph.add(math.MathBlock(cosine))
presentation.save("trigonometric-function.pptx", slides.export.SaveFormat.PPTX)
Добавить нижние и верхние индексы
Используйте вспомогательные функции для нижних и верхних индексов при работе с индексами и степенями. Когда индексы должны располагаться слева от основания, используйте set_sub_superscript_on_the_left .

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 100)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
scripts = math.MathematicalText("Y").set_sub_superscript_on_the_left("1", "n")
math_paragraph.add(math.MathBlock(scripts))
presentation.save("subscript-superscript.pptx", slides.export.SaveFormat.PPTX)
Выравнивание правых нижних и верхних индексов
Когда оба индекса относятся к одному основанию, используйте MathRightSubSuperscriptElement . Его свойство align_scripts управляет их горизонтальными позициями: False (значение по умолчанию) позволяет им следовать контуру основания, а True выравнивает индексы горизонтально друг относительно друга.
В этом примере две копии одного и того же редактируемого выражения расположены рядом. Оба используют математический курсив f (U+1D453), нижний индекс 1, верхний индекс 2 и Cambria Math размером 72 pt. Наклонное основание делает различие видимым в PowerPoint. Установите Cambria Math перед запуском примера.
import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
presentation.slide_size.set_size(900, 250, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
text_format = slides.PortionFormat()
text_format.font_height = 72
text_format.latin_font = slides.FontData("Cambria Math")
for i in range(2):
left = 40 + i * 440
shape = slide.shapes.add_math_shape(left, 75, 380, 150)
base_text = math.MathematicalText("\U0001D453", text_format)
subscript = math.MathematicalText("1", text_format)
superscript = math.MathematicalText("2", text_format)
scripts = math.MathRightSubSuperscriptElement(base_text, subscript, superscript)
scripts.align_scripts = i == 1
portion = shape.text_frame.paragraphs[0].portions[0]
portion.portion_format.font_height = text_format.font_height
portion.portion_format.latin_font = text_format.latin_font
portion.math_paragraph.add(math.MathBlock(scripts))
presentation.save("aligned-scripts.pptx", slides.export.SaveFormat.PPTX)

Слева нижний индекс начинается левее верхнего, следуя контуру основания. Справа оба индекса выровнены горизонтально друг относительно друга.
Добавить разделители
Используйте enclose , чтобы поместить выражение в разделители. Вы также можете задать символ‑разделитель для выражений, содержащих несколько элементов.

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 100)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
delimiter = (
math.MathematicalText("x")
.join("y")
.join("z")
.enclose("<", ">")
)
delimiter.separator_character = "|"
math_paragraph.add(math.MathBlock(delimiter))
presentation.save("delimiters.pptx", slides.export.SaveFormat.PPTX)
Размер и выравнивание разделителей
Установите grow_to_match_operand_height в True, чтобы скобки увеличивались вокруг высокого операнда, или в False, чтобы оставить их обычного размера. delimiter_shape принимает одно из двух значений MathDelimiterShape : CENTERED центрирует скобки относительно математической оси, проходящей через середину знака «=», а MATCH выравнивает их по содержимому. Оба параметра влияют только на скобки; внутреннее выражение остаётся неизменным.
Пример помещает дробь в показатель степени x, поэтому выражение выходит выше базовой линии, чем ниже. Все четыре уравнения используют одинаковые скобки и настройки шрифта.
import aspose.slides as slides
import aspose.slides.mathtext as math
def add_expression(slide, left, top, grow, shape):
fraction = math.MathematicalText("a + b").divide("c + d")
power = math.MathematicalText("x").set_superscript(fraction)
delimiter = power.enclose("(", ")")
delimiter.grow_to_match_operand_height = grow
delimiter.delimiter_shape = shape
math_shape = slide.shapes.add_math_shape(left, top, 300, 100)
portion = math_shape.text_frame.paragraphs[0].portions[0]
portion.portion_format.font_height = 32
equation = math.MathematicalText("y = ").join(delimiter)
portion.math_paragraph.add(equation)
with slides.Presentation() as presentation:
slide = presentation.slides[0]
add_expression(slide, 20, 20, True, math.MathDelimiterShape.CENTERED)
add_expression(slide, 350, 20, True, math.MathDelimiterShape.MATCH)
add_expression(slide, 20, 140, False, math.MathDelimiterShape.CENTERED)
add_expression(slide, 350, 140, False, math.MathDelimiterShape.MATCH)
presentation.save("delimiter-sizing.pptx", slides.export.SaveFormat.PPTX)
В PowerPoint сравните строки, чтобы увидеть эффект роста. В верхней строке скобки растут, охватывая показатель, и выглядят одинаково для обеих форм. В нижней строке рост отключён. Меньшие скобки слева (CENTERED) выравниваются с знаком «=», а правые (MATCH) располагаются выше вокруг выражения.

Добавить рамку
Вызовите to_border_box для дроби, чтобы обрамить всё выражение. Возвращаемый MathBorderBox по умолчанию показывает все четыре стороны. Используйте hide_top, hide_bottom, hide_left и hide_right , чтобы убрать отдельные стороны.
Пример размещает шесть одинаковых дробей на одном слайде. Чтобы отобразить отмену, скрывают все четыре стороны и задают strikethrough_bottom_left_to_top_right для восходящей диагонали (↗) или strikethrough_top_left_to_bottom_right для нисходящей (↘). Можно также использовать strikethrough_horizontal или strikethrough_vertical в любой комбинации видимых сторон.
import aspose.slides as slides
import aspose.slides.mathtext as math
def add_fraction(slide, x, y, hide_border=False):
fraction = math.MathematicalText("x+1").divide("y+2")
box = fraction.to_border_box()
box.hide_top = box.hide_bottom = box.hide_left = box.hide_right = hide_border
shape = slide.shapes.add_math_shape(x, y, 160, 90)
portion = shape.text_frame.paragraphs[0].portions[0]
portion.portion_format.font_height = 28
portion.math_paragraph.add(math.MathBlock(box))
return box
with slides.Presentation() as presentation:
presentation.slide_size.set_size(540, 220, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
add_fraction(slide, 10, 10)
partial = add_fraction(slide, 190, 10)
partial.hide_top = True
partial.hide_right = True
add_fraction(slide, 370, 10, hide_border=True).strikethrough_bottom_left_to_top_right = True
add_fraction(slide, 10, 120, hide_border=True).strikethrough_top_left_to_bottom_right = True
add_fraction(slide, 190, 120, hide_border=True).strikethrough_horizontal = True
add_fraction(slide, 370, 120).strikethrough_vertical = True
presentation.save("border-box.pptx", slides.export.SaveFormat.PPTX)

На этой дроби горизонтальная черта перекрывает черту дроби. Вертикальная черта проходит через числитель и знаменатель, пока окружающая рамка остаётся видимой. Эти линии оформляют всё выражение. Обычное зачеркивание текста применяется к символам в текстовом фрагменте. После повторного открытия презентации в PowerPoint вы всё ещё можете редактировать числитель и знаменатель независимо.
Управление видимостью и размещением с помощью Phantom‑элементов
Обрамите выражение в MathPhantom , чтобы независимо контролировать его видимость и пространство, которое оно занимает в уравнении. Его свойства управляют следующим:
| Property | Effect |
|---|---|
| show | Установить в False чтобы скрыть выражение. Его размеры по‑прежнему влияют на размещение, если соответствующие свойства ниже не True. |
| zero_width | Считать горизонтальную ширину выражения равной нулю, позволяя соседним элементам приближаться друг к другу. |
| zero_asc | Считать его подём (высоту над базовой линией) равным нулю. Это может уменьшить пространство над соседними элементами. |
| zero_desc | Считать его спуск (глубину под базовой линией) равным нулю. Это может переместить полосу дроби или другой контент ниже выражения ближе к соседям. |
Базовая линия — это опорная линия, на которой располагаются обычные математические буквы. Скрытие содержимого не удаляет его размеры, а трактовка размера как нуля не удаляет выражение. Основное выражение остаётся доступным через base . Установите show обратно в True, чтобы снова отобразить его; настройки размеров остаются без изменений.
В примере ниже создаются пять вариантов рядом: видимая дробь, скрытая дробь, которая сохраняет пространство, и три скрытых дроби, у которых одна из размеров считается нулевой. Каждый вариант использует одинаковое окружающее выражение и Cambria Math размером 24 pt. Все формы уравнений имеют одинаковую верхнюю позицию, отмеченную серой направляющей. Размещение phantom‑элемента в числителе внешней дроби упрощает наблюдение за изменениями вертикального расположения.
import aspose.slides as slides
import aspose.slides.mathtext as math
def create_text(value):
text = math.MathematicalText(value)
text.format.font_height = 24
text.format.latin_font = slides.FontData("Cambria Math")
return text
with slides.Presentation() as presentation:
presentation.slide_size.set_size(1000, 180, slides.SlideSizeScaleType.DO_NOT_SCALE)
slide = presentation.slides[0]
labels = ["Visible", "Hidden: reserves space", "Hidden: ZeroWidth", "Hidden: ZeroAsc", "Hidden: ZeroDesc"]
guide = slide.shapes.add_auto_shape(slides.ShapeType.LINE, 10, 60, 980, 0)
guide.line_format.fill_format.fill_type = slides.FillType.SOLID
guide.line_format.fill_format.solid_fill_color.color = slides.Color.light_gray
for i, label_text in enumerate(labels):
left = 10 + i * 200
label = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, left, 10, 190, 30)
label.fill_format.fill_type = slides.FillType.NO_FILL
label.line_format.fill_format.fill_type = slides.FillType.NO_FILL
label.text_frame.text = label_text
label_format = label.text_frame.paragraphs[0].portions[0].portion_format
label_format.font_height = 14
label_format.fill_format.fill_type = slides.FillType.SOLID
label_format.fill_format.solid_fill_color.color = slides.Color.black
fraction_numerator = create_text("a+b")
fraction_denominator = create_text("c+d")
fraction = math.MathFraction(fraction_numerator, fraction_denominator)
phantom = math.MathPhantom(fraction)
phantom.show = i == 0
phantom.zero_width = i == 2
phantom.zero_asc = i == 3
phantom.zero_desc = i == 4
left_text = create_text("x+")
right_text = create_text("+y")
numerator = math.MathBlock(left_text).join(phantom).join(right_text)
denominator = create_text("z")
equation = math.MathFraction(numerator, denominator)
shape = slide.shapes.add_math_shape(left, 60, 190, 100)
shape.text_frame.text_frame_format.anchoring_type = slides.TextAnchorType.TOP
math_paragraph = shape.text_frame.paragraphs[0].portions[0].math_paragraph
math_paragraph.add(math.MathBlock(equation))
presentation.save("math-phantom.pptx", slides.export.SaveFormat.PPTX)

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

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 120)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
grouped = (
math.MathematicalText("x + y")
.group(chr(0x23DF), math.MathTopBotPositions.BOTTOM, math.MathTopBotPositions.TOP)
.set_lower_limit("any text")
)
math_paragraph.add(math.MathBlock(grouped))
presentation.save("grouped-terms.pptx", slides.export.SaveFormat.PPTX)
Форматировать математические элементы
Используйте вспомогательные функции форматирования только там, где они проясняют формулу. Например, overbar помещает черту над математическим элементом.

import aspose.slides as slides
import aspose.slides.mathtext as math
with slides.Presentation() as presentation:
slide = presentation.slides[0]
math_shape = slide.shapes.add_math_shape(20, 20, 700, 100)
math_paragraph = math_shape.text_frame.paragraphs[0].portions[0].math_paragraph
overbar = math.MathematicalText("ABC").overbar()
math_paragraph.add(math.MathBlock(overbar))
presentation.save("overbar.pptx", slides.export.SaveFormat.PPTX)
Форматировать текст в существующем уравнении
Чтобы отформатировать текст во всем существующем уравнении, пройдите дерево элементов каждого математического блока. MathElementBase.get_children возвращает только непосредственных детей, поэтому вызывайте его рекурсивно, чтобы добраться до текста внутри дробей, индексов, радикалов и других вложенных структур. Проверяйте как текущий элемент, так и его детей, чтобы включить начальный элемент, когда он является MathematicalText .
В этом примере предполагается, что input.pptx содержит уравнение вида z = xᵢ / ∛y, где дробь содержит нижний индекс в числителе, а радикал — в знаменателе. Обработка только верхних элементов блока пропустила бы текст внутри дроби. Пример ищет математические части в текстовых кадрах слайдов, получает их блоки через MathPortion.math_paragraph и устанавливает font_height в 28 pt для каждого текстового элемента через его свойство format .
import aspose.slides as slides
import aspose.slides.mathtext as math
def format_math_text(element):
if isinstance(element, math.MathematicalText):
element.format.font_height = 28
for child in element.get_children():
format_math_text(child)
with slides.Presentation("input.pptx") as presentation:
for slide in presentation.slides:
for shape in slide.shapes:
if not isinstance(shape, slides.AutoShape) or shape.text_frame is None:
continue
for paragraph in shape.text_frame.paragraphs:
for portion in paragraph.portions:
if isinstance(portion, math.MathPortion):
for block in portion.math_paragraph:
format_math_text(block)
presentation.save("formatted-equations.pptx", slides.export.SaveFormat.PPTX)
Сохранённая презентация содержит обновлённое форматирование текста на каждом уровне каждого обработанного уравнения, одновременно сохраняя его содержание и математическую структуру.
Быстрая справка
| Задача | Основной API |
|---|---|
| Создать математический текст | MathematicalText |
| Объединить элементы | MathElementBase.join |
| Создать дроби | MathElementBase.divide |
| Добавить надстрочный или нижний индекс | set_superscript, set_subscript |
| Добавить функции | function, as_argument_of_function |
| Добавить радикалы | radical |
| Добавить пределы | set_lower_limit, set_upper_limit |
| Добавить индексы слева | set_sub_superscript_on_the_left |
| Добавить суммы и интегралы | nary, integral |
| Добавить матрицы | MathMatrix |
| Добавить массивы уравнений | to_math_array |
| Добавить разделители | enclose |
| Добавить штрихи и рамки | overbar, to_border_box |
| Группировать термы | group |
Часто задаваемые вопросы
Могу ли я редактировать существующее уравнение PowerPoint?
Да. Откройте презентацию, найдите фигуру, содержащую MathPortion , получите её math_paragraph и обновите математические блоки в этом абзаце.
Сохраняются ли уравнения как редактируемая математика PowerPoint?
Да. При сохранении в PPTX Aspose.Slides записывает уравнение как редактируемое Office‑math содержимое.
Могу ли я экспортировать уравнения в LaTeX?
Да. Получите MathParagraph из его MathPortion и вызовите MathParagraph.to_latex , чтобы напрямую экспортировать его. Полный пример смотрите в Export Math Equations from Presentations in Python via .NET.