Rendern von LaTeX-Matheformeln | Java

So rendern Sie eine LaTeX-Matheformel in PNG

Tatsächlich lässt sich die Renderfunktion für LaTeX-Matheformeln am einfachsten demonstrieren, indem man mit dem Beispiel beginnt. Hier ist es:

// 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();
}

Kommen wir zu den Details. Zunächst erstellen wir eine rendering options-Instanz, ähnlich dem TeX/LaTeX-Schriftsatz. Wir tun dies hier und geben gleichzeitig die Ausgabebildauflösung an.

Als nächstes spezifizieren wir die Präambel. Die Standardpräambel lautet:

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

Dies bietet etwas erweiterte Unterstützung für mathematische Formeln als einfaches LaTeX. Sie können beispielsweise das Paket „color“ hinzufügen, wenn Sie Ihre eigene Hervorhebung in der Formel verwenden möchten, wie wir im Codebeispiel gezeigt haben.

Dann weisen wir den Renderer an, die Ausgabe um 300 % zu skalieren.

Die nächsten beiden Optionen definieren die Vordergrund- und Hintergrundfarben. Die Teile der Formel, die nicht durch die benutzerdefinierte Hervorhebung abgedeckt („eingefärbt“) werden, werden in der Farbe „TextColor“ angezeigt.

Die nächste Zeile des Beispiels ergibt wenig Sinn. Es zeigt lediglich, dass Sie die Protokollausgabe an einen Stream weiterleiten können.

Und mit der letzten Option „ShowTerminal“ können Sie das Schreiben der Terminalausgabe in die Konsole umschalten.

Die Methode, die das Rendern tatsächlich durchführt, ist MathRenderer.render(). Es gibt die Größe der Formel in Punkten zurück.

Der Stream, in den das Bild geschrieben werden soll, wird von der Methode als zweites Argument akzeptiert. Als nächstes erstellen wir den Stream.

Und schließlich rufen wir die Methode „MathRenderer.render()“ selbst auf und übergeben Optionen als drittes Argument. Als erstes Argument wird der LaTeX-Code der Formel übergeben.

Die letzten Zeilen des Beispiels geben zwei Artefakte der mathematischen Formeldarstellung aus – die Größe der Formel und den kurzen Fehlerbericht (für den Fall, dass Fehler aufgetreten sind).

Hier ist das Ergebnis des Renderns.

Dies ist der allgemeinste Anwendungsfall für das Rendern von LaTeX-Matheformeln.

Sie können sich auch die kostenlose Web-App ansehen, die auf der in der Aspose.TeX for .NET-API implementierten Funktion basiert. Hier ist die Java-Versionsseite.

So rendern Sie eine LaTeX-Matheformel in SVG

Auf die gleiche Weise können wir eine LaTeX-Matheformel in das SVG-Format rendern.

// 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();
}

Die Unterschiede sind:

• Wir verwenden die Klasse SvgMathRendererOptions anstelle von PngMathRendererOptions.
• Wir geben keine Auflösung an.
• Wir verwenden die Klasse SvgMathRenderer anstelle von PngMathRenderer.

Hier ist das Ergebnis:

Sie können sich auch die kostenlose Web-App ansehen, die auf der in Aspose.TeX for .NET API implementierten Funktion basiert.