Exportar Equações Matemáticas de Apresentações em Python

Introdução

O Aspose.Slides permite exportar equações matemáticas de apresentações. Por exemplo, você pode precisar extrair as equações matemáticas dos slides (de uma apresentação específica) e usá‑las em outro programa ou plataforma.

Exportar Equações Matemáticas para LaTeX

O Aspose.Slides pode converter uma equação matemática do PowerPoint diretamente para LaTeX; não é necessário um arquivo MathML intermediário nem um conversor externo. Uma equação matemática é armazenada em um quadro de texto como um MathPortion. Use MathPortion.getMathParagraph para obter um MathParagraph, e então chame MathParagraph.toLatex. O método retorna uma string que você pode salvar, exibir, enviar para outra aplicação ou processar posteriormente.

O exemplo a seguir examina cada quadro de texto em cada slide, encontra todas as porções matemáticas e grava cada equação em um arquivo .tex separado:

from pathlib import Path

import jpype
import asposeslides

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

from asposeslides.api import MathPortion, Presentation, SlideUtil

presentation = Presentation("equations.pptx")
try:
    slide_count = presentation.getSlides().size()
    for slide_index in range(slide_count):
        slide = presentation.getSlides().get_Item(slide_index)
        slide_number = slide_index + 1
        equation_number = 1
        text_frames = SlideUtil.getAllTextBoxes(slide)

        for text_frame in text_frames:
            for paragraph in text_frame.getParagraphs():
                for portion in paragraph.getPortions():
                    if not isinstance(portion, MathPortion):
                        continue

                    math_paragraph = portion.getMathParagraph()
                    latex_file_name = f"slide_{slide_number}_equation_{equation_number}.tex"
                    latex_text = math_paragraph.toLatex()
                    latex_path = Path(latex_file_name)
                    latex_path.write_text(str(latex_text), encoding="utf-8")
                    equation_number += 1
finally:
    presentation.dispose()

SlideUtil.getAllTextBoxes retorna todos os quadros de texto encontrados em um slide. A verificação de tipo MathPortion separa equações editáveis reais de texto e imagens comuns.

Os motores LaTeX e os modelos de documento não suportam todos os mesmos comandos, pacotes ou caracteres Unicode. Teste a string retornada com o motor LaTeX usado pela sua aplicação. Se um símbolo ou elemento Office Math não tiver uma representação adequada naquele ambiente, substitua‑o na string retornada por um comando específico do projeto ou ignore a equação e registre o problema para revisão.

Salvar Equações Matemáticas como MathML

Embora as pessoas possam escrever código facilmente para alguns formatos de equação, como LaTeX, o MathML é mais difícil de escrever manualmente porque foi projetado para ser gerado automaticamente por aplicações. Programas podem ler e analisar MathML facilmente, pois ele é baseado em XML, e por isso o MathML é comumente usado como formato de saída e impressão em muitos campos.

Este código de exemplo mostra como exportar uma equação matemática de uma apresentação para MathML:

import jpype
import asposeslides

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

from asposeslides.api import MathematicalText, Presentation
from java.io import FileOutputStream

presentation = Presentation()
try:
    math_shape = presentation.getSlides().get_Item(0).getShapes().addMathShape(0, 0, 500, 50)
    math_portion = math_shape.getTextFrame().getParagraphs().get_Item(0).getPortions().get_Item(0)
    math_paragraph = math_portion.getMathParagraph()

    a_squared = MathematicalText("a").setSuperscript("2")
    b_squared = MathematicalText("b").setSuperscript("2")
    c_squared = MathematicalText("c").setSuperscript("2")
    equation = a_squared.join("+").join(b_squared).join("=").join(c_squared)
    math_paragraph.add(equation)

    stream = FileOutputStream("mathml.xml")
    try:
        math_paragraph.writeAsMathMl(stream)
    finally:
        stream.close()
finally:
    presentation.dispose()

FAQ

O que exatamente é exportado para MathML—um parágrafo ou um bloco de fórmula individual?

Você pode exportar tanto um parágrafo matemático completo (MathParagraph) quanto um bloco individual (MathBlock) para MathML. Ambos os tipos fornecem um método para gravar em MathML.

Como posso saber se um objeto em um slide é uma fórmula matemática e não texto ou imagem comum?

Uma fórmula reside em um MathPortion e possui um MathParagraph. Imagens e trechos de texto comuns sem um MathParagraph não são fórmulas exportáveis.

De onde vem o MathML em uma apresentação—é específico do PowerPoint ou um padrão?

A exportação tem como alvo o MathML padrão (XML). A Aspose usa Presentation MathML — o subconjunto de apresentação do padrão — que é amplamente usado em aplicações e na web.

A exportação de fórmulas dentro de tabelas, SmartArt, grupos etc. é suportada?

Sim, se esses objetos contêm trechos de texto com um MathParagraph (ou seja, fórmulas reais do PowerPoint), eles são exportados. Se uma fórmula estiver incorporada como imagem, não será.

A exportação para MathML modifica a apresentação original?

Não. Gravar MathML é uma serialização do conteúdo da fórmula; não modifica o arquivo da apresentação.