اضافه کردن معادلات ریاضی به ارائههای PowerPoint در Python
نمای کلی
PowerPoint معادلات را به عنوان Office Math Markup Language (OMML) ذخیره میکند. با Aspose.Slides برای Python از طریق Java میتوانید همان نوع محتویات ریاضی را بهصورت برنامهنویسی ایجاد کنید: کسرها، رادیکالها، توابع، حدود، عملگرهای N‑ary، ماتریسها، آرایهها و بلوکهای ریاضی قالببندیشده.
در PowerPoint، کاربران معمولاً معادلات را از Insert > Equation اضافه میکنند:

نتیجه، متن ریاضی قابل ویرایش بر روی اسلاید است:

Aspose.Slides این متن ریاضی را از طریق سه شیء اصلی میسازد:
- یک شکل ریاضی، که با addMathShape ساخته میشود، شکلی است که معادله را در خود دارد.
- MathPortion محتویات ریاضی را داخل فریم متنی شکل ذخیره میکند.
- MathParagraph شامل یک یا چند شیء MathBlock است.
اکثر مثالهای زیر از MathematicalText و متدهای fluent موجود در MathElementBase برای کوتاه و خوانا نگه داشتن کد استفاده میکنند.
برای سناریوهای استخراج MathML، به صادر کردن معادلات ریاضی از ارائهها در Python مراجعه کنید.
ایجاد یک معادله
این مثال از addMathShape برای ایجاد یک شکل ریاضی استفاده میکند و قضیهٔ فیثاغورث را اضافه میکند:

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 120)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
a_squared = MathematicalText("a").setSuperscript("2")
b_squared = MathematicalText("b").setSuperscript("2")
equation = MathematicalText("c").setSuperscript("2").join("=").join(a_squared).join("+").join(b_squared)
math_paragraph.add(equation)
presentation.save("pythagorean-theorem.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
Note
addMathShape شکلی را میسازد که از پیش شامل یک پاراگراف ریاضی است. اولین MathPortion را دسترسی پیدا کنید، getMathParagraph را فراخوانی کنید و بلوکها یا عناصر ریاضی را به آن اضافه کنید.افزودن کسرها
از divide برای ایجاد یک کسر استفاده کنید. میتوانید استایل کسر را با MathFractionTypes انتخاب کنید.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathFractionTypes, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
fraction = MathematicalText("1").divide("x", MathFractionTypes.Skewed)
math_block = MathBlock(fraction)
math_paragraph.add(math_block)
presentation.save("fraction.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
برای یک کسر انباشته، از MathFractionTypes.Bar استفاده کنید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathFractionTypes, MathematicalText
stacked_fraction = MathematicalText("x + 1").divide("y - 1", MathFractionTypes.Bar)
افزودن رادیکالها
از radical برای ایجاد ریشهٔ مربع، ریشهٔ مکعب یا ریشههای دیگر استفاده کنید. عنصر جاری به پایه تبدیل میشود و آرگومان به درجه ریشه.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
radical = MathematicalText("x").radical("n")
math_block = MathBlock(radical)
math_paragraph.add(math_block)
presentation.save("radical.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
افزودن توابع و حدود
از asArgumentOfFunction یا function برای توابعی مانند sin(x)، log(x) یا نامهای سفارشی استفاده کنید. برای حدود، lim را در یک MathLimit قرار دهید یا از setLowerLimit استفاده کنید.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
limit = MathematicalText("lim").setLowerLimit("x\u2192\u221E").function("x")
math_block = MathBlock(limit)
math_paragraph.add(math_block)
presentation.save("functions-and-limits.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
برای یک نام تابع سفارشی، نام تابع را عنصر جاری کنید و function را با آرگومان آن فراخوانی کنید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathematicalText
custom_function = MathematicalText("f").function("x + 1")
افزودن عملگرهای N‑ary و انتگرالها
از nary برای جمعها، اتحادیهها، تقاطعها و دیگر عملگرهای بزرگ استفاده کنید. از integral برای انتگرالها استفاده کنید. هر دو متد امکان تنظیم حدود پایین و بالا را میدهند.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathNaryOperatorTypes, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 120)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
a_power = MathematicalText("a").setSuperscript("n-k")
summation_base = MathematicalText("x").setSuperscript("k").join(a_power)
summation = summation_base.nary(MathNaryOperatorTypes.Summation, "k=0", "n")
math_block = MathBlock(summation)
math_paragraph.add(math_block)
presentation.save("nary-operators.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
عملگرهای N‑ary برای عملگرهای بزرگ با حدود اختیاری هستند. عملگرهای ساده مانند +، - و = معمولاً بهعنوان MathematicalText اضافه شده و در عبارت ترکیب میشوند.
برای یک انتگرال، از integral استفاده کنید:
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathIntegralTypes, MathematicalText
differential = MathematicalText("dx").toBox()
integral_base = MathematicalText("x").join(differential)
integral = integral_base.integral(MathIntegralTypes.Simple, "0", "1")
افزودن ماتریسها
از MathMatrix برای ردیفها و ستونها استفاده کنید. ماتریسها به طور پیشفرض کروشه ندارند، بنابراین هنگام نیاز به پرانتز، کروشه یا آکولاد، ماتریس را در آنها بپیچید.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathMatrix, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 120)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
matrix = MathMatrix(2, 3)
cell_0_0 = MathematicalText("1")
matrix.set_Item(0, 0, cell_0_0)
cell_0_1 = MathematicalText("x")
matrix.set_Item(0, 1, cell_0_1)
cell_1_0 = MathematicalText("x")
matrix.set_Item(1, 0, cell_1_0)
cell_1_1 = MathematicalText("2")
matrix.set_Item(1, 1, cell_1_1)
cell_1_2 = MathematicalText("y")
matrix.set_Item(1, 2, cell_1_2)
math_block = MathBlock(matrix)
math_paragraph.add(math_block)
presentation.save("matrix.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
افزودن آرایهٔ معادلات
هنگامی که به معادلات همتراز یا یک پشتهٔ عمودی از عبارات نیاز دارید، از toMathArray استفاده کنید.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 140)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
equation_array = MathematicalText("x").join("y").toMathArray()
math_block = MathBlock(equation_array)
math_paragraph.add(math_block)
presentation.save("equation-array.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
همترازی آرایه با عناصر اطراف
setBaseJustification تراز عمودی آرایه نسبت به عناصر ریاضی مجاور را کنترل میکند. مثال زیر تراز را برای ردیف اول، مرکز آرایه و ردیف آخر مقایسه میکند.
مثال زیر سه آرایهٔ یکسان، هر کدام با سه ردیف و عناصر همسایهٔ A= و =B ایجاد میکند. تمام متنهای ریاضی با Cambria Math با اندازهٔ ۲۴ پوینت استفاده میشود. فقط تراز آرایه تغییر میکند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, MathArray, MathBlock, MathJustification, MathematicalText, MathVerticalAlignment, Presentation, SaveFormat, ShapeType, SlideSizeScaleType, TextAnchorType
from java.awt import Color
def create_text(value):
text = MathematicalText(value)
text.getFormat().setFontHeight(24)
text.getFormat().setLatinFont(FontData("Cambria Math"))
return text
presentation = Presentation()
try:
presentation.getSlideSize().setSize(780, 200, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
alignments = (("Top", MathVerticalAlignment.Top), ("Center", MathVerticalAlignment.Center), ("Bottom", MathVerticalAlignment.Bottom))
for index, (name, alignment) in enumerate(alignments):
x = 20 + index * 260
label = slide.getShapes().addAutoShape(ShapeType.Rectangle, x, 10, 240, 30)
label.getFillFormat().setFillType(FillType.NoFill)
label.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
label.getTextFrame().setText(name)
label_format = label.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat()
label_format.setFontHeight(16)
label_format.getFillFormat().setFillType(FillType.Solid)
label_format.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
math_shape = slide.getShapes().addMathShape(x, 60, 240, 130)
math_shape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Top)
paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0)
math_paragraph = paragraph.getPortions().get_Item(0).getMathParagraph()
math_paragraph.setJustification(MathJustification.LeftJustified)
equation_array = MathArray(create_text("x+y=3"))
equation_array.getArguments().add(create_text("x-y=1"))
equation_array.getArguments().add(create_text("x=2"))
equation_array.setBaseJustification(alignment)
equation = MathBlock(create_text("A=")).join(equation_array).join(create_text("=B"))
math_paragraph.add(equation)
presentation.save("equation-array-alignment.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
مقایسهٔ زیر ارائهٔ ذخیرهشده در PowerPoint را نشان میدهد. موقعیت A= و =B در کنار هر آرایه را ببینید.

پیکربندی فاصلهٔ ردیفها
setRowSpacingRule قانون فاصلهٔ ردیفها را درون آرایه انتخاب میکند. setRowSpacing مقدار عددی برای قانون فاصلهٔ صریح میدهد و توسط قوانین پیشتنظیم نادیده گرفته میشود.
برای فاصلهٔ دقیق، مقدار بر حسب پوینت اندازهگیری میشود. برای فاصلهٔ نسبی، بر حسب نیمخط اندازهگیری میشود: مقدار 3 در مثال برابر با 1.5 خط است. هنگام مشخص کردن مقدار صریح، هر دو ویژگی را تنظیم کنید؛ تغییر تنها مقدار عددی قانون فاصله را انتخاب نمیکند.
مثال زیر پنج ارائه با معادلات، تراز و تنظیمات قلم یکسان ذخیره میکند. سه مورد اول از پیشتنظیمها استفاده میکنند؛ دو مورد آخر مقدارهای صریح را نشان میدهند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FontData, MathArray, MathBlock, MathJustification, MathematicalText, MathRowSpacingRule, MathVerticalAlignment, Presentation, SaveFormat
def create_text(value):
text = MathematicalText(value)
text.getFormat().setFontHeight(24)
text.getFormat().setLatinFont(FontData("Cambria Math"))
return text
settings = (("SingleLineGap", MathRowSpacingRule.SingleLineGap, 0), ("OneAndAHalfLineGap", MathRowSpacingRule.OneAndAHalfLineGap, 0), ("TwoLineGap", MathRowSpacingRule.TwoLineGap, 0), ("Exactly", MathRowSpacingRule.Exactly, 20), ("Multiple", MathRowSpacingRule.Multiple, 3))
for name, rule, spacing in settings:
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 600, 300)
paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0)
paragraph.getParagraphFormat().setSpaceBefore(0)
paragraph.getParagraphFormat().setSpaceAfter(0)
math_paragraph = paragraph.getPortions().get_Item(0).getMathParagraph()
math_paragraph.setJustification(MathJustification.LeftJustified)
equation_array = MathArray(create_text("x+y=3"))
equation_array.getArguments().add(create_text("x-y=1"))
equation_array.getArguments().add(create_text("x=2"))
equation_array.setBaseJustification(MathVerticalAlignment.Center)
equation_array.setRowSpacingRule(rule)
equation_array.setRowSpacing(spacing)
equation = MathBlock(create_text("A=")).join(equation_array).join(create_text("=B"))
math_paragraph.add(equation)
presentation.save(f"equation-array-{name}.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
فاصلهٔ ردیفهای آرایه جدا از فاصلهٔ پاراگراف است. setSpaceBefore و setSpaceAfter فضای اطراف پاراگراف حاوی آرایه را اضافه میکنند، نه بین ردیفهای آرایه. به همان ترتیب، MathParagraph.setJustification پاراگراف ریاضی را بهصورت افقی موقعیت میدهد؛ تنظیم عمودی آرایه را تغییر نمیدهد.
افزودن توابع مثلثاتی
هنگامی که آرگومان عنصر جاری است و نام تابع شناخته شده، از asArgumentOfFunction استفاده کنید.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathFunctionsOfOneArgument, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
cosine = MathematicalText("2x").asArgumentOfFunction(MathFunctionsOfOneArgument.Cos)
math_block = MathBlock(cosine)
math_paragraph.add(math_block)
presentation.save("trigonometric-function.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
افزودن زیرنویس و بالانویس
از کمککنندههای زیرنویس و بالانویس برای شاخصها و توانها استفاده کنید. وقتی شاخصها باید در سمت چپ پایه ظاهر شوند، از setSubSuperscriptOnTheLeft استفاده کنید.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
scripts = MathematicalText("Y").setSubSuperscriptOnTheLeft("1", "n")
math_block = MathBlock(scripts)
math_paragraph.add(math_block)
presentation.save("subscript-superscript.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
افزودن جداکنندهها
از enclose برای قرار دادن یک عبارت داخل جداکنندهها استفاده کنید. میتوانید کاراکتر جداکنندهٔ دیگری برای عبارات شامل چند عنصر تنظیم کنید.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
delimiter = MathematicalText("x").join("y").join("z").enclose('<', '>')
delimiter.setSeparatorCharacter('|')
math_block = MathBlock(delimiter)
math_paragraph.add(math_block)
presentation.save("delimiters.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
اندازه و تراز جداکنندهها
با ارسال True به setGrowToMatchOperandHeight میتوانید پرانتزها را طوری بگذارید که نسبت به یک عملوند بلند رشد کنند، یا با False اندازهٔ معمولی آنها را حفظ کنید. با setDelimiterShape و یکی از دو مقدار MathDelimiterShape استفاده کنید. Centered پرانتزها را روی محور ریاضی، که از وسط علامت مساوی عبور میکند، مرکز میکند. Match آنها را با محتوای داخل مطابقت میدهد. هر دو تنظیم فقط بر جداکنندهها اثر میگذارند؛ عبارت داخل بدون تغییر میماند.
مثال یک کسر را در توان x قرار میدهد تا عبارت بالاتر از خط پایه بیش از پایین آن گسترش یابد. چهار معادله همگی از یک پرانتز و تنظیمات قلم یکسان استفاده میکنند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathDelimiterShape, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
for row, grow in enumerate((True, False)):
for column, shape in enumerate((MathDelimiterShape.Centered, MathDelimiterShape.Match)):
fraction = MathematicalText("a + b").divide("c + d")
power = MathematicalText("x").setSuperscript(fraction)
delimiter = power.enclose("(", ")")
delimiter.setGrowToMatchOperandHeight(grow)
delimiter.setDelimiterShape(shape)
math_shape = slide.getShapes().addMathShape(20 + 330 * column, 20 + 120 * row, 300, 100)
portion = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
portion.getPortionFormat().setFontHeight(32)
equation = MathematicalText("y = ").join(delimiter)
portion.getMathParagraph().add(equation)
presentation.save("delimiter-sizing.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
در PowerPoint، ردیفها را برای مشاهدهٔ اثر رشد مقایسه کنید. در ردیف بالایی، پرانتزها برای پوشش دادن توان رشد میکنند و برای هر دو شکل مشابه هستند. در ردیف پایین، رشد غیرفعال است. پرانتزهای کوچکتر سمت چپ (Centered) با علامت مساوی همراستا هستند، در حالی که آنهای سمت راست (Match) بالاتر به دور عبارت قرار میگیرند.

افزودن جعبهٔ حاشیهای
بر یک کسر toBorderBox را فراخوانی کنید تا تمام عبارت در یک چارچوب قرار گیرد. MathBorderBox بهطور پیشفرض تمام چهار طرف را نشان میدهد. برای حذف طرفهای جداگانه از setHideTop، setHideBottom، setHideLeft و setHideRight استفاده کنید.
مثال شش نسخهٔ یکسان از همان کسر را بر روی یک اسلاید قرار میدهد. برای نمایش لغو، تمام چهار طرف را مخفی کنید و True را به setStrikethroughBottomLeftToTopRight برای یک قطر صعودی (↗) یا به setStrikethroughTopLeftToBottomRight برای یک قطر نزولی (↘) بدهید. همچنین میتوانید از setStrikethroughHorizontal یا setStrikethroughVertical با هر ترکیبی از طرفهای قابل مشاهده استفاده کنید.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat, SlideSizeScaleType
presentation = Presentation()
try:
presentation.getSlideSize().setSize(540, 220, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
def add_fraction(x, y, hide_border):
fraction = MathematicalText("x+1").divide("y+2")
box = fraction.toBorderBox()
box.setHideTop(hide_border)
box.setHideBottom(hide_border)
box.setHideLeft(hide_border)
box.setHideRight(hide_border)
shape = slide.getShapes().addMathShape(x, y, 160, 90)
portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
portion.getPortionFormat().setFontHeight(28)
math_block = MathBlock(box)
portion.getMathParagraph().add(math_block)
return box
add_fraction(10, 10, False)
partial = add_fraction(190, 10, False)
partial.setHideTop(True)
partial.setHideRight(True)
add_fraction(370, 10, True).setStrikethroughBottomLeftToTopRight(True)
add_fraction(10, 120, True).setStrikethroughTopLeftToBottomRight(True)
add_fraction(190, 120, True).setStrikethroughHorizontal(True)
add_fraction(370, 120, False).setStrikethroughVertical(True)
presentation.save("border-box.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

در این کسر، خط افقی بر روی نوار کسر همپوشانی دارد. خط عمودی همراستا با صورت و مخرج است در حالی که حاشیهٔ اطراف دیده میشود. این خطوط تمام عبارت را تزئین میکنند. Strikethrough متنی معمولی فقط بر روی کاراکترهای یک ران متن اعمال میشود. پس از باز کردن مجدد ارائه در PowerPoint، میتوانید صورت و مخرج را بهصورت مستقل ویرایش کنید.
کنترل دیدهشدن و چینش با عناصر وهمی
یک عبارت را داخل MathPhantom بپیچید تا دیدهشدن و فضایی که به معادله اضافه میکند را بهصورت مستقل کنترل کنید. متدهای MathPhantom موارد زیر را تنظیم میکنند:
| Method | Effect |
|---|---|
| setShow | ارسال False برای مخفی کردن عبارت. ابعاد آن همچنان در چینش مشارکت میکند مگر اینکه متدهای زیر True شوند. |
| setZeroWidth | عرض افقی عبارت را صفر در نظر میگیرد و اجازه میدهد عناصر همسایه نزدیکتر شوند. |
| setZeroAsc | صعود (ارتفاع بالاتر از خط پایه) را صفر در نظر میگیرد. این میتواند فضای بالای عناصر همسایه را کاهش دهد. |
| setZeroDesc | نزول (عمق زیر خط پایه) را صفر در نظر میگیرد. این میتواند نوار کسر یا محتوای دیگر زیر عبارت را به همسایگان نزدیکتر کند. |
خط پایه مرجع است که حروف ریاضی معمولی روی آن قرار میگیرند. مخفی کردن محتوا ابعاد آن را حذف نمیکند و در نظر گرفتن یک ابعاد بهعنوان صفر عبارت را حذف نمیکند. عبارت زیرین از طریق getBase در دسترس باقی میماند. برای نمایش دوباره، True را به setShow بدهید؛ تنظیمات ابعاد بدون تغییر میمانند.
مثال زیر پنج گونهٔ کنار هم ایجاد میکند: یک کسر قابل مشاهده، یک کسر مخفی که فضای خود را حفظ میکند و سه کسر مخفی که در هر کدام یک بعد به صفر تبدیل شده است. هر گونه از همان عبارت اطراف و Cambria Math با اندازهٔ ۲۴ پوینت استفاده میکند. تمام اشکال معادله موقعیت بالایی یکسانی دارند که توسط راهنمای خاکستری نشان داده شده است. قرار دادن phantom در صورت یک کسر خارجی تغییرات چینش عمودی را بهراحتی نشان میدهد.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import FillType, FontData, MathBlock, MathFraction, MathematicalText, MathPhantom, Presentation, SaveFormat, ShapeType, SlideSizeScaleType, TextAnchorType
from java.awt import Color
def create_text(value):
text = MathematicalText(value)
text.getFormat().setFontHeight(24)
text.getFormat().setLatinFont(FontData("Cambria Math"))
return text
presentation = Presentation()
try:
presentation.getSlideSize().setSize(1000, 180, SlideSizeScaleType.DoNotScale)
slide = presentation.getSlides().get_Item(0)
labels = ("Visible", "Hidden: reserves space", "Hidden: ZeroWidth", "Hidden: ZeroAsc", "Hidden: ZeroDesc")
guide = slide.getShapes().addAutoShape(ShapeType.Line, 10, 60, 980, 0)
guide.getLineFormat().getFillFormat().setFillType(FillType.Solid)
guide.getLineFormat().getFillFormat().getSolidFillColor().setColor(Color.LIGHT_GRAY)
for index, name in enumerate(labels):
left = 10 + index * 200
label = slide.getShapes().addAutoShape(ShapeType.Rectangle, left, 10, 190, 30)
label.getFillFormat().setFillType(FillType.NoFill)
label.getLineFormat().getFillFormat().setFillType(FillType.NoFill)
label.getTextFrame().setText(name)
label_format = label.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getPortionFormat()
label_format.setFontHeight(14)
label_format.getFillFormat().setFillType(FillType.Solid)
label_format.getFillFormat().getSolidFillColor().setColor(Color.BLACK)
fraction_numerator = create_text("a+b")
fraction_denominator = create_text("c+d")
fraction = MathFraction(fraction_numerator, fraction_denominator)
phantom = MathPhantom(fraction)
phantom.setShow(index == 0)
phantom.setZeroWidth(index == 2)
phantom.setZeroAsc(index == 3)
phantom.setZeroDesc(index == 4)
left_text = create_text("x+")
right_text = create_text("+y")
numerator = MathBlock(left_text).join(phantom).join(right_text)
denominator = create_text("z")
equation = MathFraction(numerator, denominator)
shape = slide.getShapes().addMathShape(left, 60, 190, 100)
shape.getTextFrame().getTextFrameFormat().setAnchoringType(TextAnchorType.Top)
math_portion = shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
math_paragraph = math_portion.getMathParagraph()
math_block = MathBlock(equation)
math_paragraph.add(math_block)
presentation.save("math-phantom.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()

گروهبندی عبارات
از group برای قرار دادن یک کاراکتر گروهبندی بالای یا پایین یک عبارت استفاده کنید. یک حد اضافه کنید تا عبارات گروهبندی شده برچسبگذاری شوند.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathTopBotPositions, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 120)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
grouped = MathematicalText("x + y").group('\u23DF', MathTopBotPositions.Bottom, MathTopBotPositions.Top).setLowerLimit("any text")
math_block = MathBlock(grouped)
math_paragraph.add(math_block)
presentation.save("grouped-terms.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
قالببندی عناصر ریاضی
از کمککنندههای قالببندی تنها در جایی استفاده کنید که فرمول را واضحتر میکند. بهعنوان مثال، overbar یک میله بالای عنصر ریاضی میگذارد.

import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import MathBlock, MathematicalText, Presentation, SaveFormat
presentation = Presentation()
try:
slide = presentation.getSlides().get_Item(0)
math_shape = slide.getShapes().addMathShape(20, 20, 700, 100)
math_paragraph = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0).getMathParagraph()
overbar = MathematicalText("ABC").overbar()
math_block = MathBlock(overbar)
math_paragraph.add(math_block)
presentation.save("overbar.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
قالببندی متن در یک معادلهٔ موجود
برای قالببندی متن در تمام یک معادلهٔ موجود، درخت عناصر هر بلوک ریاضی را پیمایش کنید. MathElementBase.getChildren فقط فرزندان مستقیم را برمیگرداند، بنابراین برای رسیدن به متن داخل کسرها، نمایهها، رادیکالها و سایر ساختارهای تو در تو باید بهصورت بازگشتی فراخوانی شود. عنصر جاری و فرزندان آن را بررسی کنید تا وقتی که عنصر MathematicalText باشد نیز شامل شود.
این مثال فرض میکند input.pptx شامل معادلهای مانند z = xᵢ / ∛y باشد، که یک کسر با زیرنویس در صورت و یک رادیکال در مخرج دارد. پردازش تنها عناصر سطح بالای بلوک متنهای داخل کسر را از دست میدهد. این مثال بخشهای متنی اسلایدها را پیدا میکند، بلوکهایشان را از طریق MathPortion.getMathParagraph دسترسی میگیرد و با استفاده از setFontHeight اندازهٔ قلم را به ۲۸ پوینت برای هر عنصر متنی از طریق متد getFormat تنظیم میکند.
import jpype
import asposeslides
if not jpype.isJVMStarted():
jpype.startJVM()
from asposeslides.api import AutoShape, MathematicalText, MathPortion, Presentation, SaveFormat
def format_math_text(element):
if isinstance(element, MathematicalText):
element.getFormat().setFontHeight(28)
for child in element.getChildren():
format_math_text(child)
presentation = Presentation("input.pptx")
try:
for slide in presentation.getSlides():
for shape in slide.getShapes():
if not isinstance(shape, AutoShape):
continue
if shape.getTextFrame() is None:
continue
for paragraph in shape.getTextFrame().getParagraphs():
for portion in paragraph.getPortions():
if isinstance(portion, MathPortion):
for block in portion.getMathParagraph():
format_math_text(block)
presentation.save("formatted-equations.pptx", SaveFormat.Pptx)
finally:
presentation.dispose()
ارائهٔ ذخیرهشده شامل قالببندی متن بهروزرسانیشده در هر سطح از هر معادلهٔ پردازششده است، در حالی که محتویات متنی و ساختار ریاضی آن حفظ میشود.
راهنمای سریع
| Task | Main API |
|---|---|
| ایجاد متن ریاضی | MathematicalText |
| ترکیب عناصر | MathElementBase.join |
| ایجاد کسرها | MathElementBase.divide |
| افزودن بالانویس یا زیرنویس | setSuperscript, setSubscript |
| افزودن توابع | function, asArgumentOfFunction |
| افزودن رادیکالها | MathElementBase.radical |
| افزودن حدود | setLowerLimit, setUpperLimit |
| افزودن اسکریپتهای سمت چپ | setSubSuperscriptOnTheLeft |
| افزودن جمعها و انتگرالها | nary, integral |
| افزودن ماتریسها | MathMatrix |
| افزودن آرایهٔ معادلات | toMathArray |
| افزودن جداکنندهها | enclose |
| افزودن میلهها و حاشیهها | overbar, toBorderBox |
| گروهبندی عبارات | group |
سوالات متداول
آیا میتوان معادلهٔ موجود در PowerPoint را ویرایش کرد؟
بله. ارائه را باز کنید، شکلی را که شامل یک MathPortion است پیدا کنید، getMathParagraph را فراخوانی کنید و بلوکهای ریاضی در آن پاراگراف را بهروزرسانی کنید.
آیا معادلات به صورت ریاضی قابل ویرایش در PowerPoint ذخیره میشوند؟
بله. هنگام ذخیره به قالب PPTX، Aspose.Slides معادله را به عنوان محتوای ریاضی Office قابل ویرایش مینویسد.
آیا میتوان معادلات را به LaTeX صادر کرد؟
بله. MathParagraph را از MathPortion دریافت کنید و MathParagraph.toLatex را فراخوانی کنید تا مستقیماً صادر شود. برای مثال کامل، به Export Math Equations from Presentations in Python مراجعه کنید.