Rendern von LaTeX-Matheformeln | Aspose.TeX für 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:

Setzen Sie outputFile auf einen java.nio.file.Path in einem vorhandenen Ordner, beispielsweise Paths.get(outputDirectory, "math-formula.png") für PNG oder Paths.get(outputDirectory, "math-formula.svg") für SVG. Importieren Sie die verwendeten Aspose.TeX-Renderer-, Options- und Size2D-Klassen sowie java.awt.Color, java.io.ByteArrayOutputStream, java.io.OutputStream, java.nio.file.Files, java.nio.file.Path, java.nio.file.Paths. Die aufrufende Methode muss Ausnahmen behandeln oder deklarieren. Wenden Sie gemäß der Lizenzierungsanleitung eine Lizenz an, um Evaluierungseinschränkungen zu vermeiden.

// Render a highlighted LaTeX math formula to PNG.
// outputFile is a java.nio.file.Path in an existing output folder.
PngMathRendererOptions options = new PngMathRendererOptions();
options.setResolution(150);
options.setPreamble("\\usepackage{amsmath}\n\\usepackage{amsfonts}\n"
        + "\\usepackage{amssymb}\n\\usepackage{color}");
options.setScale(3000); // 300%.
options.setTextColor(Color.BLACK);
options.setBackgroundColor(Color.WHITE);
options.showTerminal(false);

Size2D size;
try (ByteArrayOutputStream log = new ByteArrayOutputStream();
        OutputStream stream = Files.newOutputStream(outputFile)) {
    options.setLogStream(log);
    size = new PngMathRenderer().render("\\begin{equation*}\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!}\n"
            + "\\end{equation*}", stream, options);
    System.out.println(options.getErrorReport());
    System.out.println("Size: " + size.getWidth() + "x" + size.getHeight());
}

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 beiden Optionen definieren Vordergrund- und Hintergrundfarben. Ohne benutzerdefinierte Hervorhebung verwendet die Formel die mit setTextColor() festgelegte Farbe.

Das Beispiel leitet Rendering-Protokolle mit setLogStream() an einen ByteArrayOutputStream weiter. Protokoll- und Bildausgabestream werden nach dem Rendern automatisch geschlossen.

showTerminal() steuert die Terminalausgabe in der Konsole. Die Beispiele verwenden false; setzen Sie true, um die Ausgabe anzuzeigen.

MathRenderer.render() wird auf einer PngMathRenderer- oder SvgMathRenderer-Instanz aufgerufen und gibt die Formelgröße in Punkten als Size2D zurück.

Die Methode akzeptiert den Bildausgabestream als zweites Argument. Das Beispiel öffnet ihn in einem try-with-resources-Block, der ihn nach dem Rendern schließt.

Schließlich rufen wir render() auf der Renderer-Instanz auf: Die LaTeX-Formel ist das erste Argument, der Bildausgabestream das zweite und die Rendering-Optionen das dritte.

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.

// Render a highlighted LaTeX math formula to SVG.
// outputFile is a java.nio.file.Path in an existing output folder.
SvgMathRendererOptions options = new SvgMathRendererOptions();
options.setPreamble("\\usepackage{amsmath}\n\\usepackage{amsfonts}\n"
        + "\\usepackage{amssymb}\n\\usepackage{color}");
options.setScale(3000); // 300%.
options.setTextColor(Color.BLACK);
options.setBackgroundColor(Color.WHITE);
options.showTerminal(false);

Size2D size;
try (ByteArrayOutputStream log = new ByteArrayOutputStream();
        OutputStream stream = Files.newOutputStream(outputFile)) {
    options.setLogStream(log);
    size = new SvgMathRenderer().render("\\begin{equation*}\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!}\n"
            + "\\end{equation*}", stream, options);
    System.out.println(options.getErrorReport());
    System.out.println("Size: " + size.getWidth() + "x" + size.getHeight());
}

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.