Matematikai egyenletek hozzáadása PowerPoint prezentációkhoz Pythonban

Áttekintés

A PowerPoint egyenleteket Office Math Markup Language (OMML) formátumban tárol. Az Aspose.Slides for Python via Java segítségével programozottan hozhat létre ugyanolyan típusú matematikai tartalmakat: törtöket, gyököket, függvényeket, határokat, N-áris operátorokat, mátrixokat, tömböket és formázott matematikai blokkokat.

PowerPointben a felhasználók általában az Insert > Equation menüpontból adnak hozzá egyenleteket:

PowerPoint Insert lap az Equation parancs kiválasztva

Az eredmény szerkeszthető matematikai szöveg a dián:

PowerPoint dia szerkeszthető matematikai egyenlettel

Az Aspose.Slides a matematikai szöveget három fő objektumon keresztül építi fel:

  • A matematikai alakzat, amelyet az addMathShape hoz létre, az az alakzat, amely tartalmazza az egyenletet.
  • MathPortion tárolja a matematikai tartalmat az alakzat szövegkeretében.
  • MathParagraph egy vagy több MathBlock objektumot tartalmaz.

Az alábbi legtöbb példában a MathematicalText és a MathElementBase folyékony metódusait használjuk a kód rövid és olvasható tartásához.

MathML export esetekhez tekintse meg a Export Math Equations from Presentations in Python oldalt.

Egyenlet létrehozása

Ez a példa a addMathShape használatával hoz létre egy matematikai alakzatot, és hozzáadja a Pitagorasz‑tételt:

Az egyenlet c² = a² + b²

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()

Matematikai blokkok összekapcsolása

Ha az egyenlet részei önállóan MathBlock objektumként épülnek, a joinBlock segítségével kombinálhatók. A példa a bal blokkban a c² =-t, a jobb blokkban az a² + b²-t építi. A setSuperscript szerkeszthető matematikai felsőindexeket hoz létre a három hatványhoz.

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)

    shape = slide.getShapes().addMathShape(20, 20, 600, 100)
    math_portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
    math_paragraph = math_portion.getMathParagraph()

    left_block = MathBlock()
    left_block.add(MathematicalText("c").setSuperscript("2"))
    left_block.add(MathematicalText("="))

    right_block = MathBlock()
    right_block.add(MathematicalText("a").setSuperscript("2"))
    right_block.add(MathematicalText("+"))
    right_block.add(MathematicalText("b").setSuperscript("2"))

    combined_block = left_block.joinBlock(right_block)
    math_paragraph.add(combined_block)

    presentation.save("equation.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

joinBlock visszaadja a left_block-ot magát, amely most már tartalmazza a két részt sorrendben, és a right_block-ot üresen hagyja. Adja hozzá az összekapcsolt blokkot a MathParagraph csak egyszer. A equation.pptx újranyitása után a bekezdés egy blokkot tartalmaz, amely a c² = a² + b²-t ábrázolja, a három hatvány matematikai felsőindexeként megőrizve.

A add left_block.add(right_block) hívása helyette megpróbál egy blokkot közvetlenül egy másikba ágyazni, és InvalidOperationException-t vált ki.

Törtök hozzáadása

Használja a divide függvényt tört létrehozásához. A tört stílusát a MathFractionTypes segítségével választhatja ki.

Döntött matematikai tört, amelyben 1 osztva x-szel

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()

Halmozott tört esetén használja a MathFractionTypes.Bar-t:

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)

Gyökök hozzáadása

Használja a radical függvényt négyzetgyök, köbgyök vagy egyéb gyök létrehozásához. Az aktuális elem lesz az alap, és a paraméter a gyök fokát jelöli.

n-dik gyök kifejezés, ahol az x a gyökjel alatt

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()

A négyzetgyök fokának megjelenítése vagy elrejtése

A négyzetgyök megjeleníthet egy kifejezett 2-t, vagy a hagyományos √x jelölést használhatja. A MathRadical setHideDegree metódusa szabályozza, hogy melyik forma jelenik meg. Mindkét forma megőrzi a 2 fokát és az x radikandját a szerkeszthető egyenletben.

Ugyanaz a négyzetgyök, bal oldalon a fok látható, jobb oldalon rejtett

A példa ugyanazt a négyzetgyököt kétszer menti. A visible-degree.pptx fájlban a 2 látható. A hidden-degree.pptx fájlban rejtett.

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()

Függvények és határok hozzáadása

Használja az asArgumentOfFunction vagy a function metódusokat olyan függvényekhez, mint a sin(x), log(x), vagy egyedi függvénynevek. Határok esetén helyezze a lim-et egy MathLimit objektumba, vagy használja a setLowerLimit.

x határértéke, amikor x a végtelen felé tart

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()

Egy egyedi függvényneknél tegye a függvénynevet az aktuális elemmé, és hívja meg a function-t a paraméterével:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import MathematicalText

custom_function = MathematicalText("f").function("x + 1")

N-áris operátorok és integrálok hozzáadása

Használja a nary függvényt összegeknél, unióknál, metszetnél és egyéb nagy operátoroknál. A integral használható integrálokhoz. Mindkét módszer lehetővé teszi a alsó és felső határ megadását.

Összeg alsó és felső határokkal

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()

Az N-áris operátorok nagy operátorok opcionális határokkal. Az egyszerű operátorok, mint a +, - és = általában MathematicalText használatával kerülnek a kifejezésbe.

Integrálhoz használja a integral-t:

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")

Mátrixok hozzáadása

Használja a MathMatrix sorok és oszlopok kezeléséhez. A mátrixok alapértelmezés szerint nem tartalmaznak zárójeleket, ezért szükség esetén zárja be a mátrixot zárójelbe, szögletes vagy kapcsos zárójelekbe.

Két soros matematikai mátrix egy üres cellával

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()

Létező mátrix szerkesztése

Tegyük fel, hogy egy lineáris algebra óra a matrix.pptx fájlban található koefficiens mátrixszal kezdődik, amelyet az előző példa mentett. A következő feladathoz tartsa meg az első egyenletet, cserélje le a másodikat két új egyenletre, és módosítsa a változók halmazát. Nyissa meg a meglévő mátrixot a MathMatrix segítségével, hogy megtartsa a még alkalmazható koefficiens értékeket.

Eredeti két soros koefficiens mátrix: első sorban 1, x, és egy üres cella; második sorban x, 2, és y

A sor- és oszlopindexek nullától indulnak, és a hívás pillanatában létező mátrixra vonatkoznak. Sor beszúrása az 1-es index előtt áthelyezi az eredeti második sort a 2-es indexre. Beszúrás az 2-es index után egy új sorral bővíti a mátrixot. A 2-es sor törlése eltávolítja az eredeti második egyenletet, és felfelé mozgatja a hozzáadott sort. Az oszlopok ugyanezen szabály szerint tolódnak.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import MathHorizontalAlignment, MathematicalText, Presentation, SaveFormat

presentation = Presentation("matrix.pptx")
try:
    shape = presentation.getSlides().get_Item(0).getShapes().get_Item(0)
    portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
    matrix = portion.getMathParagraph().get_Item(0).get_Item(0)

    matrix.insertRowBefore(1)
    matrix.insertRowAfter(2)
    matrix.deleteRow(2)

    matrix.insertColumnBefore(1)
    matrix.insertColumnAfter(3)
    matrix.deleteColumn(3)

    # Az új cellák kezdetben üresek. Először állítsa be a nem nulla együtthatókat.
    matrix.set_Item(1, 0, MathematicalText("12"))
    matrix.set_Item(1, 1, MathematicalText("1"))
    matrix.set_Item(2, 2, MathematicalText("10"))
    matrix.set_Item(2, 3, MathematicalText("1"))
    for row in range(matrix.getRowCount()):
        for column in range(matrix.getColumnCount()):
            if matrix.get_Item(row, column) is None:
                matrix.set_Item(row, column, MathematicalText("0"))

    matrix.setColumnAlignment(0, MathHorizontalAlignment.Left)
    matrix.setColumnsAlignment(1, 3, MathHorizontalAlignment.Right)
    
    presentation.save("updated-matrix.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

setColumnAlignment az első oszlopot balra igazítja. setColumnsAlignment a maradék három oszlopot jobbra igazítja, az 1-es indextől kezdve. Az updated-matrix.pptx fájlban a mátrix három egyenletet és négy változót tartalmaz. Az eredeti első sor koefficiensei 1 és x most az első és a harmadik oszlopban jelennek meg.

Frissített három soros mátrix, sorok: 1, 0, x, 0; 12, 1, 0, 0; és 0, 0, 10, 1

Egyenlet tömbök hozzáadása

Használja a toMathArray függvényt, ha összehangolt egyenletekre vagy függőleges kifejezésstackre van szükség.

Függőleges matematikai tömb, x felül y alatt

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()

Tömb igazítása a környező elemekhez

setBaseJustification szabályozza egy tömb függőleges igazítását a mellette elhelyezkedő matematikai elemekhez képest. Az alábbi példa a felső, középső és alsó sorok igazítását hasonlítja össze.

Az alábbi példa három azonos tömböt hoz létre, mindegyik három soros, a szomszédos elemek A= és =B. Minden matematikai szöveg Cambria Math betűtípust használ 24 pontos mérettel. Csak a tömb igazítása változik.

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()

Az alábbi összehasonlítás mutatja a mentett bemutatót PowerPointban. Figyelje meg a A= és =B elemek helyzetét minden tömb mellett.

Egyenlet tömbök PowerPointban felső, középső és alsó igazítással és azonos szomszédos elemekkel

Sorok távolságának beállítása

setRowSpacingRule kiválasztja a sorok közti távolság szabályát a tömbön belül. setRowSpacing numerikus értéket ad meg egy explicit szabályhoz, a beépített szabályok ezt figyelmen kívül hagyják.

Az exakt távolságnál az értéket pontban mérik. Arányos távolságnál fél sorban: a példában a 3 érték 1,5 sort jelent. Mindkét tulajdonságot állítsa be, ha explicit értéket ad meg; csak a numerikus érték módosítása nem választ szabályt.

Az alábbi példa öt bemutatót ment ugyanazokkal az egyenletekkel, igazítással és betűtípus-beállításokkal. Az első három előre definiált beállítást használ, az utolsó kettő explicit értékeket mutat.

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()

A tömb sorok távolsága különbözik a bekezdés távolságtól. A setSpaceBefore és setSpaceAfter a környező bekezdés körül adnak helyet, nem a tömb sorok között. Hasonlóan, a MathParagraph.setJustification a teljes matematikai bekezdést igazítja vízszintesen; nem helyettesíti a tömb függőleges igazítási beállítását.

Trigonometrikus függvények hozzáadása

Használja az asArgumentOfFunction metódust, ha az argumentum az aktuális elem és a függvény neve ismert.

Trigonometrikus függvény cos alkalmazva 2x-re

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()

Alsó- és felsőindexek hozzáadása

Használja az alsó- és felsőindex segédfüggvényeit indexek és hatványok kezelésére. Ha az indexeknek a bázis bal oldalán kell megjelenniük, használja a setSubSuperscriptOnTheLeft‑t.

Nagy Y baloldali alsóindex 1 és felsőindex n

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()

Határolójelek hozzáadása

Használja a enclose függvényt egy kifejezés határolójelek közé helyezéséhez. Több elemet tartalmazó határolójelekhez beállíthat elválasztó karaktert is.

Határolójel kifejezés x, y és z függőleges vonalakkal elválasztva

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()

Határolójelek mérete és igazítása

A setGrowToMatchOperandHeight True értéke esetén a zárójelek nőnek egy magas operandus körül, False esetén normál méretűek maradnak. Használja a setDelimiterShape‑t a két MathDelimiterShape érték egyikével. A Centered a zárójeleket a matematikai tengely közepére helyezi, amely áthalad az egyenlőség jel közepén. A Match a tartalomhoz igazítja őket. Mindkét beállítás csak a határolójelekre hat, a kifejezés inna marad.

A példa a x kitevőjébe egy törtet helyez, így a kifejezés a kiinduló vonal fölött magasabb, mint alatta. Mind a négy egyenlet ugyanazt a zárójelet és betűtípust használja.

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()

PowerPointban hasonlítsa össze a sorokat, hogy lássa a növekedés hatását. A felső sorban a zárójelek nőnek, hogy befoglalják a kitevőt, és mindkét forma egyforma. Az alsó sorban a növekedés ki van kapcsolva. A baloldali kisebb zárójel (Centered) az egyenlőség jelhez igazodik, míg a jobb oldali (Match) magasabban helyezkedik el a kifejezés körül.

Négy egyenlet PowerPointban, ahol a határolójelek növekedése felül engedélyezett, alul letiltott, bal oldalon Centered, jobb oldalon Match

Határdoboz hozzáadása

Hívja meg a toBorderBox‑t egy törtön, hogy a teljes kifejezést keretbe foglalja. A visszaadott MathBorderBox alapértelmezés szerint a négy oldalt is megjeleníti. A setHideTop, setHideBottom, setHideLeft és setHideRight egyes oldalak eltávolítására szolgálnak.

A példa hat példányban helyezi el ugyanazt a törtet egy diára. A törlés megmutatásához rejtse el a négy oldalt, és adja át a True értéket a setStrikethroughBottomLeftToTopRight‑nek egy emelkedő átló (↗) vagy a setStrikethroughTopLeftToBottomRight‑nek egy csökkenő átló (↘) esetén. Használhatja a setStrikethroughHorizontal vagy a setStrikethroughVertical függvényeket is, tetszőleges látható oldal kombinációval.

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()

Hat szerkeszthető tört PowerPointban. Felső sor: teljes keret, alsó és bal oldali szél, emelkedő átló. Alsó sor: csökkenő átló, vízszintes áthúzás, függőleges áthúzás teljes kerettel.

Ezen tört esetében a vízszintes áthúzás átfedi a törtvonalat. A függőleges áthúzás áthalad a számláló és a nevező felett, miközben a környező keret látható marad. Ezek a vonalak a teljes kifejezést díszítik. A szokásos szöveg áthúzás karakterekre vonatkozik. A bemutató újbóli megnyitása után a számláló és a nevező továbbra is szerkeszthető marad.

Láthatóság és elrendezés vezérlése fantom elemekkel

Csomagolja be a kifejezést egy MathPhantom‑be, hogy függetlenül szabályozza láthatóságát és az egyenlethez járuló helyet. A MathPhantom metódusai a következőt irányítják:

Metódus Hatás
setShow A False átadása elrejti a kifejezést. Méretei továbbra is hozzájárulnak az elrendezéshez, hacsak az alábbi megfelelő metódusok nem kapnak True értéket.
setZeroWidth A kifejezés vízszintes szélességét nullának tekinti, így a szomszédos elemek közelebb kerülhetnek egymáshoz.
setZeroAsc A felmenet (a baseline fölötti magasság) nullának tekinti. Ez csökkentheti a szomszédos elemek fölött fenntartott helyet.
setZeroDesc A lemenet (a baseline alatti mélység) nullának tekinti. Ez a törtvonalat vagy más tartalmat a kifejezés alatti részen közelebb hozhat a szomszédokhoz.

A baseline az a referenciavonal, amelyen a szokásos matematikai betűk állnak. A tartalom elrejtése nem távolítja el a méreteket, és egy dimenzió nullának tekintése sem törli a kifejezést. Az alapkifejezés továbbra is elérhető a getBase‑on keresztül. A setShow‑nek True átadása újra megjeleníti; a dimenzió beállítások változatlanok maradnak.

Az alábbi példa öt egymás melletti változatot hoz létre: egy látható tört, egy rejtett tört, amely helyet foglal, valamint három rejtett tört, ahol egy dimenzió nullaként van kezelve. Minden változat ugyanazt a környező kifejezést és a Cambria Math 24 pontos betűtípust használja. Az összes egyenlet alakzat ugyanabban a felső pozícióban van, amelyet a szürke segédvonal jelöl. A fantom elhelyezése egy külső tört számlálójába megkönnyíti a függőleges elrendezési változások láthatóságát.

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()

Öt egyenlet PowerPointban, összehasonlítva látható törtet, helyet foglaló rejtett törtet, valamint ZeroWidth, ZeroAsc vagy ZeroDesc engedélyezett rejtett törteket

Kifejezések csoportosítása

Használja a group függvényt, hogy egy csoportosító karaktert helyezzen a kifejezés fölé vagy alá. Adjon meg egy határt a csoportosított elemek megnevezéséhez.

A kifejezés x + y csoportosítva az alatta lévő címkével

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()

Matematikai elemek formázása

Használjon formázó segédfüggvényeket csak ott, ahol a képletet egyértelművé teszik. Például a overbar egy vonalat helyez az elem fölé.

Matematikai kifejezés ABC felül vonallal

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()

Szöveg formázása meglévő egyenletben

A meglévő egyenlet szövegének formázásához járjon végig minden matematikai blokk elemes fáján. A MathElementBase.getChildren csak a közvetlen gyerekeket adja vissza, ezért rekurzívan kell hívni a szöveg eléréséhez a törtekben, indexekben, gyökökben és más beágyazott struktúrákban. Ellenőrizze az aktuális elemet és annak gyerekeit is, hogy a kiinduló elem is bekerüljön, ha az MathematicalText típusú.

Ez a példa feltételezi, hogy a input.pptx tartalmaz egy olyan egyenletet, mint z = xᵢ / ∛y, egy törtet, amelynek számlálójában alsóindex, nevezőjében gyök van. Ha csak a blokk felső szintű elemeit dolgozza fel, a törtben lévő szöveget kihagyja. A példa megtalálja a matematikai részeket a diák szövegkereteiben, a MathPortion.getMathParagraph segítségével eléri a blokkokat, és a setFontHeight‑et használja a betűméret 28 pontra állításához minden szövegelem getFormat metódusán keresztül.

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()

A mentett bemutató minden szintjén frissített szövegformázást tartalmaz az egyes feldolgozott egyenletekben, miközben megőrzi a szövegtartalmat és a matematikai struktúrát.

Gyorsreferencia

Feladat Fő API
Matematikai szöveg létrehozása MathematicalText
Elemek összekapcsolása MathElementBase.join
Törtök létrehozása MathElementBase.divide
Felső- vagy alsóindex hozzáadása setSuperscript, setSubscript
Függvények hozzáadása function, asArgumentOfFunction
Gyökök hozzáadása MathElementBase.radical
Határok hozzáadása setLowerLimit, setUpperLimit
Baloldali indexek hozzáadása setSubSuperscriptOnTheLeft
Összegeket és integrálokat hozzáadása nary, integral
Mátrixok hozzáadása MathMatrix
Egyenlet tömbök hozzáadása toMathArray
Határolójelek hozzáadása enclose
Vonalak és keretek hozzáadása overbar, toBorderBox
Kifejezések csoportosítása group

FAQ

Szerkeszthetek egy létező PowerPoint egyenletet?

Igen. Nyissa meg a bemutatót, keresse meg azt az alakzatot, amelyik MathPortion‑t tartalmaz, hívja meg a getMathParagraph-t, és frissítse a bekezdésben lévő matematikai blokkokat.

Az egyenletek szerkeszthető PowerPoint matematikaként vannak mentve?

Igen. PPTX formátumba mentéskor az Aspose.Slides az egyenletet szerkeszthető Office math tartalomként írja.

Exportálhatok egyenleteket LaTeX‑be?

Igen. Szerezze meg az egyenlet MathParagraph‑ját a MathPortion‑ból, majd hívja meg a MathParagraph.toLatex‑t a közvetlen exportáláshoz. Teljes példáért tekintse meg a Export Math Equations from Presentations in Python oldalt.