Fórmulas de matemática de LaTeX Renderização | .NET

Como renderizar uma fórmula matemática LaTeX para PNG

A seção de referência da API relacionada a este tópico é aqui. De fato, a maneira mais fácil de demonstrar o recurso de renderização de fórmulas matemáticas LaTeX é começar com o exemplo. Aqui está:

            // Render LaTeX math formula to PNG image

            // Create rendering options setting the image resolution to 150 dpi.
            PngMathRendererOptions options = new PngMathRendererOptions();
            options.Resolution = 150;
            
            // Specify the preamble.
            options.Preamble = @"\usepackage{amsmath}
            \usepackage{amsfonts}
            \usepackage{amssymb}
            \usepackage{color}";
            
            // Specify the scaling factor 300%.
            options.Scale = 3000;
            
            // Specify the foreground color.
            options.TextColor = System.Drawing.Color.Black;
            
            // Specify the background color.
            options.BackgroundColor = System.Drawing.Color.White;
            
            // Specify the output stream for the log file.
            options.LogStream = new System.IO.MemoryStream();
            
            // Specify whether to show the terminal output on the console or not.
            options.ShowTerminal = true;

            // Create the output stream for the formula image.
            using (System.IO.Stream stream = System.IO.File.Open(
                System.IO.Path.Combine(OutputDir, "math-formula.png"), System.IO.FileMode.Create))
            {
                // Run rendering.
                System.Drawing.SizeF size = new PngMathRenderer().Render(@"\begin{equation*}
e^x = x^{\color{red}0} + x^{\color{red}1} + \frac{x^{\color{red}2}}{2} + \frac{x^{\color{red}3}}{6} + \cdots = \sum_{n\geq 0} \frac{x^{\color{red}n}}{n!}
\end{equation*}", stream, options);

                // Show other results.
                System.Console.Out.WriteLine(options.ErrorReport);
                System.Console.Out.WriteLine();
                System.Console.Out.WriteLine($"Size: {size}"); // Dimensions of the resulting image.
            }

Vamos até os detalhes. Primeiro de tudo, criamos uma instância de opções de renderização, semelhante à composição TeX/LaTeX. Fazemos isso aqui especificando simultaneamente a resolução da imagem de saída.

Em seguida, especificamos o preâmbulo. O preâmbulo padrão é:

\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}

que fornece suporte a fórmula matemática um pouco mais avançado do que o LaTeX básico. Você pode, por exemplo, adicionar o pacote color se quiser usar seu próprio destaque na fórmula, como mostramos no exemplo do código.

Em seguida, instruímos o renderizador a escalar a saída em 300%.

As próximas duas opções definem as cores de primeiro plano e fundo. As partes da fórmula que não são cobertas (“coloridas”) pelo destaque personalizado serão exibidas na cor ’textColor`.

A próxima linha do exemplo não faz muito sentido. Ele apenas demonstra que você pode direcionar a saída de log para algum fluxo.

E a última opção showterminal permite alternar a gravação da saída do terminal no console.

O método que realmente executa a renderização é MathRenderer.Render(). Ele retorna o tamanho da fórmula em pontos.

O fluxo em que a imagem deve ser escrito é aceito pelo método como o segundo argumento. Criamos o fluxo a seguir.

E, finalmente, chamamos o próprio método MathRenderer.Render(), passando as opções como o terceiro argumento. O código LaTeX da fórmula é passado como o primeiro argumento.

As últimas linhas do exemplo imprimem dois artefatos de renderização de fórmula matemática - o tamanho da fórmula e o breve relatório de erro (caso haja erros).

Aqui está o resultado da renderização.

Este é o caso de uso mais geral para o recurso de fórmula matemática.

Você também pode conferir o aplicativo web gratuito construído com base no recurso implementado em Aspose.TeX para .NET API.

Como renderizar uma fórmula de matemática de LaTeX para SVG

Da mesma maneira, podemos renderizar uma fórmula matemática de LaTeX ao formato SVG.

            // Render LaTeX math formula to SVG image

            // Create rendering options.
            MathRendererOptions options = new SvgMathRendererOptions();
            
            // Specify the preamble.
            options.Preamble = @"\usepackage{amsmath}
            \usepackage{amsfonts}
            \usepackage{amssymb}
            \usepackage{color}";
            
            // Specify the scaling factor 300%.
            options.Scale = 3000;
            
            // Specify the foreground color.
            options.TextColor = System.Drawing.Color.Black;
            
            // Specify the background color.
            options.BackgroundColor = System.Drawing.Color.White;
            
            // Specify the output stream for the log file.
            options.LogStream = new System.IO.MemoryStream();
            
            // Specify whether to show the terminal output on the console or not.
            options.ShowTerminal = true;

            // Create the output stream for the formula image.
            using (System.IO.Stream stream = System.IO.File.Open(
                System.IO.Path.Combine(OutputDir, "math-formula.svg"), System.IO.FileMode.Create))
            {
                // Run rendering.
                System.Drawing.SizeF size = new SvgMathRenderer().Render(@"\begin{equation*}
e^x = x^{\color{red}0} + x^{\color{red}1} + \frac{x^{\color{red}2}}{2} + \frac{x^{\color{red}3}}{6} + \cdots = \sum_{n\geq 0} \frac{x^{\color{red}n}}{n!}
\end{equation*}", stream, options);

                // Show other results.
                System.Console.Out.WriteLine(options.ErrorReport);
                System.Console.Out.WriteLine();
                System.Console.Out.WriteLine($"Size: {size}"); // Dimensions of the resulting image.
            }

As diferenças são:

• Utilizamos a classe SvgMathRendererOptions em vez de PngMathRendererOptions.
• Não especificamos resolução.
• Utilizamos a classe SvgMathRenderer em vez de PngMathRenderer.

Aqui está o resultado:

Criação de um Agente de IA para Renderização de Matemática LaTeX com Aspose.TeX

Para os programadores que pretendem encapsular esta funcionalidade num Agente de IA conversacional ou programático, o principal desafio de engenharia passa da simples execução de código para o reconhecimento de intenções, verificação de estrutura e processamento de loops de erro em tempo de execução.

Abaixo, segue uma sugestão de arquitetura de fluxo de trabalho de produção para um agente de IA que interpreta pedidos do utilizador, constrói sintaxe LaTeX válida e devolve componentes visuais totalmente renderizados.

Como pode ver, o Agente de IA para renderização de matemática deve operar como um ciclo de feedback fechado composto por três microcamadas:

1. Recolha de entrada e sintaxe (LLM Layer) O utilizador digita em linguagem natural ou expressões de sintaxe parcial (por exemplo, “Mostra-me a derivada de uma equação de multiplicação de matrizes”). O agente transforma estes prompts em estruturas matemáticas LaTeX válidas dentro de uma carga útil JSON estruturada, evitando wrappers Markdown como ````latex`.

2. Validação e Higienização da AST (Camada de Validação) Antes de encaminhar as strings diretamente para os pipelines de execução, o agente de software valida os padrões de tokens para evitar injeções de segurança ou quebras na cadeia de execução.

3. Pipeline de Execução da API (Mecanismo Aspose.TeX) O agente passa o token higienizado diretamente para a estrutura de processamento de backend utilizando as regras de execução programáticas.

O agente instancia SvgMathRendererOptions ou PngMathRendererOptions dependendo do contexto do cliente (por exemplo, se o utilizador estiver num dispositivo móvel ou na web, utilize o SVG para obter a melhor nitidez).

4. Se a compilação do Aspose.TeX falhar ou encontrar avisos de sintaxe, direciona os diagnósticos de registo padrão diretamente para um fluxo de erros em tempo de execução. Em vez de falhar silenciosamente ou causar falhas nas interfaces de utilizador, o agente interceta os dados do rastreio de pilha, constrói um loop de contexto e solicita ao LLM que reescreva a carga útil da equação.

Você também pode conferir o [aplicativo web] gratuito (12) construído com base no recurso implementado em Aspose.TeX para .NET API.