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

Introdução

O Aspose.Slides permite exportar 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

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 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 outro aplicativo ou processar adicionalmente.

O exemplo a seguir examina cada caixa de texto em cada slide, encontra todas as porções matemáticas 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();
                    Path latexPath = Paths.get(latexFileName);
                    byte[] latexBytes = latexText.getBytes(StandardCharsets.UTF_8);
                    Files.write(latexPath, latexBytes);
                    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 e imagens comuns.

Os mecanismos LaTeX e os modelos de documento não suportam todos os mesmos comandos, pacotes ou caracteres Unicode. Teste a string retornada com o mecanismo LaTeX usado pela sua aplicação. Se um símbolo ou elemento Office Math não tiver 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 os humanos escrevam facilmente o código para alguns formatos de equação, como LaTeX, eles têm dificuldade em escrever o código para MathML, pois este último deve ser gerado automaticamente por aplicativos. Os 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 muitas áreas.

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 tanto um parágrafo matemático inteiro (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 em vez de texto comum ou uma imagem?

Uma fórmula reside em uma MathPortion e possui um MathParagraph. Imagens e porções de texto regular 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 utilizado em aplicativos e na web.

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

Sim, se esses objetos contiverem porções de texto com um MathParagraph (ou seja, fórmulas genuínas do PowerPoint), elas são exportadas. Se uma fórmula estiver incorporada como imagem, não será.

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

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