Exportar Equações Matemáticas de Apresentações no Android

Introdução

Aspose.Slides for Android via Java permite que você exporte equações matemáticas de apresentações. Por exemplo, pode ser necessário 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

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

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

Presentation presentation = new Presentation("equations.pptx");
try {
    int slideCount = presentation.getSlides().size();
    for (int slideIndex = 0; slideIndex < slideCount; slideIndex++) {
        ISlide slide = presentation.getSlides().get_Item(slideIndex);
        int slideNumber = slideIndex + 1;
        int equationNumber = 1;
        ITextFrame[] textFrames = SlideUtil.getAllTextBoxes(slide);

        for (ITextFrame textFrame : textFrames) {
            for (IParagraph paragraph : textFrame.getParagraphs()) {
                for (IPortion portion : paragraph.getPortions()) {
                    if (!(portion instanceof IMathPortion))
                        continue;

                    IMathPortion mathPortion = (IMathPortion) portion;
                    IMathParagraph mathParagraph = mathPortion.getMathParagraph();
                    String latexFileName = "slide_" + slideNumber + "_equation_" + equationNumber + ".tex";

                    String latexText = mathParagraph.toLatex();
                    File latexFile = new File(latexFileName);
                    byte[] latexBytes = latexText.getBytes(StandardCharsets.UTF_8);
                    FileOutputStream outputStream = new FileOutputStream(latexFile);
                    try {
                        outputStream.write(latexBytes);
                    } finally {
                        outputStream.close();
                    }
                    equationNumber++;
                }
            }
        }
    }
} finally {
    presentation.dispose();
}

SlideUtil.getAllTextBoxes retorna todas as caixas de texto encontradas em um slide. A verificação de tipo IMathPortion separa equações editáveis genuínas de texto comum e imagens.

Os motores LaTeX e os modelos de documento nem sempre suportam 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 representação adequada nesse ambiente, substitua‑a 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 os humanos escrevam facilmente o código para alguns formatos de equação, como LaTeX, tenham dificuldade ao escrever o código para MathML, pois este último deve ser gerado automaticamente por aplicativos. Programas leem e analisam MathML facilmente porque seu código está em XML, de modo que 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:

Presentation pres = new Presentation();
try {
    IAutoShape autoShape = pres.getSlides().get_Item(0).getShapes().addMathShape(0, 0, 500, 50);
    IMathParagraph mathParagraph = ((MathPortion)autoShape.getTextFrame().getParagraphs().get_Item(0).
            getPortions().get_Item(0)).getMathParagraph();

    mathParagraph.add(new MathematicalText("a").
            setSuperscript("2").
            join("+").
            join(new MathematicalText("b").setSuperscript("2")).
            join("=").
            join(new MathematicalText("c").setSuperscript("2")));

    FileOutputStream stream = new FileOutputStream("mathml.xml");
    mathParagraph.writeAsMathMl(stream);
} catch (IOException e) {
} finally {
    if (pres != null) pres.dispose();
}

Perguntas Frequentes

O que exatamente é exportado para MathML—um parágrafo ou um bloco de fórmula individual?
Você pode exportar um parágrafo de matemática completo (MathParagraph) ou 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 em vez de texto comum ou uma imagem?
Uma fórmula reside em um MathPortion e possui um MathParagraph. Imagens e trechos de texto regulares 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). O Aspose usa Presentation MathML—o subconjunto de apresentação do padrão—amplamente utilizado em aplicativos e na web.

A exportação de fórmulas dentro de tabelas, SmartArt, grupos, etc., é suportada?
Sim, se esses objetos contiverem trechos de texto com um MathParagraph (ou seja, fórmulas genuínas do PowerPoint), eles são exportados. Se a fórmula estiver inserida como imagem, não será exportada.

Exportar para MathML altera a apresentação original?
Não. A gravação de MathML é uma serialização do conteúdo da fórmula; não modifica o arquivo da apresentação.