Добавить математические уравнения в презентации PowerPoint на Python

Обзор

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

В PowerPoint пользователи обычно добавляют уравнения через Insert > Equation:

PowerPoint Insert tab with the Equation command selected

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

A PowerPoint slide containing an editable math equation

Aspose.Slides создает этот математический текст с помощью трех основных объектов:

  • Математическая фигура, создаваемая с помощью add_math_shape, является фигурой, содержащей уравнение.
  • MathPortion хранит математическое содержимое внутри текстового кадра фигуры.
  • MathParagraph содержит один или несколько объектов MathBlock.

Большинство приведенных ниже примеров используют MathematicalText и цепочечные методы из MathElementBase , чтобы код был коротким и удобочитаемым.

Для сценариев экспорта MathML см. Export Math Equations from Presentations in Python via .NET.

Создать уравнение

В этом примере используется add_math_shape , чтобы создать математическую фигуру и добавить теорему Пифагора:

The equation c squared equals a squared plus b squared

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)

Объединить математические блоки

Когда части уравнения создаются независимо как объекты 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.

A skewed math fraction showing one divided by x

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 , чтобы создать квадратный корень, кубический корень или другой корень. Текущий элемент становится основанием, а аргумент — степенью.

An n-th root radical expression with x under the radical sign

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 в редактируемом уравнении.

The square root of x with the degree 2 visible on the left and hidden on the right

В примере один и тот же квадратный корень сохраняется дважды. 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 .

The limit of x as x approaches infinity

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 для интегралов. Оба метода позволяют задать нижние и верхние пределы.

A summation with lower and upper limits

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 для строк и столбцов. По умолчанию матрицы не включают скобки, поэтому при необходимости обрамляйте их круглыми, квадратными или фигурными скобками.

A two-row math matrix with one empty cell

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 , чтобы сохранить применимые коэффициенты.

Original two-row coefficient matrix with entries 1, x, and an empty cell in the first row and x, 2, and y in the second

Индексы строк и столбцов начинаются с нуля и относятся к текущему состоянию матрицы при каждом вызове. Вставка строки перед индексом 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 теперь находятся в первом и третьем столбцах.

Updated three-row matrix showing the rows 1, 0, x, 0; 12, 1, 0, 0; and 0, 0, 10, 1

Добавить массивы уравнений

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

A vertical math array with x above y

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 рядом с каждым массивом.

Equation arrays in PowerPoint with Top, Center, and Bottom alignment and identical neighboring elements

Настроить интервал строк

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 , когда аргумент является текущим элементом и имя функции известно.

The trigonometric function cos applied to 2x

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 .

A capital Y with left-side subscript 1 and superscript n

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)

Two editable expressions in PowerPoint with align_scripts set to False on the left and True on the right

Слева нижний индекс начинается левее верхнего, следуя контуру основания. Справа оба индекса выровнены горизонтально друг относительно друга.

Добавить разделители

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

A delimiter expression containing x, y, and z separated by vertical bars

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) располагаются выше вокруг выражения.

Four equations in PowerPoint with delimiter growth enabled above and disabled below, and Centered on the left and Match on the right

Добавить рамку

Вызовите 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)

Six editable fractions in PowerPoint. Top row: full border, bottom and left sides, rising diagonal. Bottom row: falling diagonal, horizontal strike, vertical strike with a full border.

На этой дроби горизонтальная черта перекрывает черту дроби. Вертикальная черта проходит через числитель и знаменатель, пока окружающая рамка остаётся видимой. Эти линии оформляют всё выражение. Обычное зачеркивание текста применяется к символам в текстовом фрагменте. После повторного открытия презентации в 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)

Five equations in PowerPoint comparing a visible fraction, a hidden fraction that reserves space, and hidden fractions with ZeroWidth, ZeroAsc, or ZeroDesc enabled

Группировать термы

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

The expression x plus y grouped with the label any text below it

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 помещает черту над математическим элементом.

A math expression ABC with an 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.