Rendu des formules mathématiques LaTeX | Java

Comment restituer une formule mathématique LaTeX au format PNG

En fait, le moyen le plus simple de démontrer la fonctionnalité de rendu de la formule mathématique LaTeX est de commencer par l’exemple. C’est ici:

// Create rendering options setting the image resolution 150 dpi.
PngMathRendererOptions options = new PngMathRendererOptions();
options.setResolution(150);
// Specify the preamble.
options.setPreamble("\\usepackage{amsmath}\r\n\\usepackage{amsfonts}\r\n\\usepackage{amssymb}\r\n\\usepackage{color}");
// Specify the scaling factor 300%.
options.setScale(3000);
// Specify the foreground color.
options.setTextColor(Color.BLACK);
// Specify the background color.
options.setBackgroundColor(Color.WHITE);
// Specify the output stream for the log file.
options.setLogStream(new ByteArrayOutputStream());
// Specify whether to show the terminal output on the console or not.
options.showTerminal(true);

// Create the output stream for the formula image.
final OutputStream stream = new FileOutputStream(Utils.getOutputDirectory() + "math-formula.png");
try {
    // Run rendering.
    com.aspose.tex.Size2D size = MathRenderer.render("\\begin{equation*}\r\n" +
       "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!}\r\n" +
       "\\end{equation*}", stream, options);

    // Show other results.
    System.out.println(options.getErrorReport());
    System.out.println();
    System.out.println("Size: " + size.getWidth() + "x" + size.getHeight()); // Dimensions of the resulting image.
} finally {
    if (stream != null)
        stream.close();
}

Passons aux détails. Tout d’abord, nous créons une instance options de rendu, similaire à la composition TeX/LaTeX. Nous le faisons ici simultanément en spécifiant la résolution de l’image de sortie.

Ensuite, nous précisons le préambule. Le préambule par défaut est :

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

qui fournit une prise en charge des formules mathématiques légèrement plus avancée que LaTeX de base. Vous pouvez, par exemple, ajouter le package color si vous souhaitez utiliser votre propre surlignage dans la formule, comme nous l’avons montré dans l’exemple de code.

Ensuite, nous demandons au moteur de rendu de mettre à l’échelle la sortie de 300 %.

Les deux options suivantes définissent les couleurs de premier plan et d’arrière-plan. Les parties de la formule qui ne sont pas couvertes (« colorées ») par la surbrillance personnalisée seront affichées dans la couleur « TextColor ».

La ligne suivante de l’exemple n’a pas beaucoup de sens. Cela démontre simplement que vous pouvez diriger la sortie du journal vers un flux.

Et la dernière option « ShowTerminal » vous permet d’écrire la sortie du terminal sur la console.

La méthode qui effectue réellement le rendu est MathRenderer.render(). Il renvoie la taille de la formule en points.

Le flux dans lequel l’image doit être écrite est accepté par la méthode comme deuxième argument. Nous créons ensuite le flux.

Et enfin, nous appelons la méthode MathRenderer.render() elle-même, en passant les options comme troisième argument. Le code LaTeX de la formule est passé en premier argument.

Les dernières lignes de l’exemple impriment deux artefacts de rendu de formule mathématique : la taille de la formule et le bref rapport d’erreur (au cas où il y aurait des erreurs).

Voici le résultat du rendu.

Il s’agit du cas d’utilisation le plus général du rendu de formule mathématique LaTeX.

Vous pouvez également consulter l’ application Web gratuite construite sur la base de la fonctionnalité implémentée dans l’API Aspose.TeX for .NET. Ici est la page de la version Java.

Comment rendre une formule mathématique LaTeX en SVG

De la même manière, nous pouvons restituer une formule mathématique LaTeX au format SVG.

// Create rendering options.
MathRendererOptions options = new SvgMathRendererOptions();
// Specify the preamble.
options.setPreamble("\\usepackage{amsmath}\r\n\\usepackage{amsfonts}\r\n\\usepackage{amssymb}\r\n\\usepackage{color}");
// Specify the scaling factor 300%.
options.setScale(3000);
// Specify the foreground color.
options.setTextColor(Color.BLACK);
// Specify the background color.
options.setBackgroundColor(Color.WHITE);
// Specify the output stream for the log file.
options.setLogStream(new ByteArrayOutputStream());
// Specify whether to show the terminal output on the console or not.
options.showTerminal(true);

// Create the output stream for the formula image.
final OutputStream stream = new FileOutputStream(Utils.getOutputDirectory() + "math-formula.svg");
try {
    // Run rendering.
    com.aspose.tex.Size2D size = new SvgMathRenderer().render("\\begin{equation*}\r\n" +
        "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!}\r\n" +
        "\\end{equation*}", stream, options, size);
    
    // Show other results.
    System.out.println(options.getErrorReport());
    System.out.println();
    System.out.println("Size: " + size.getWidth() + "x" + size.getHeight()); // Dimensions of the resulting image.
} finally {
    if (stream != null)
        stream.close();
}

Les différences sont :

• Nous utilisons la classe SvgMathRendererOptions au lieu de PngMathRendererOptions.
• Nous ne précisons pas la résolution.
• Nous utilisons la classe SvgMathRenderer au lieu de PngMathRenderer.

Voici le résultat :

Vous pouvez également consulter l’ application Web gratuite construite sur la base de la fonctionnalité implémentée dans Aspose.TeX pour l’API .NET.