Rendern von LaTeX-Matheformeln | Python

Rendern einer LaTeX-Matheformel in PNG

Werfen Sie bei Bedarf einen Blick auf den API-Referenzabschnitt für dieses Thema. Tatsächlich lässt sich die Renderfunktion für LaTeX-Matheformeln am besten demonstrieren, indem man mit einem Beispiel beginnt. Hier ist es:

Setzen Sie ASPOSE_TEX_OUTPUT_DIR auf Ihr Ausgabeverzeichnis oder verwenden Sie den Standardordner output. Der LaTeX-Code ist vollständig in den Beispielen enthalten; externe Eingabedateien sind nicht erforderlich. Wenden Sie zuerst eine Lizenz an. Lizenzierung.

# Render a highlighted LaTeX math formula to PNG.
import os
from pathlib import Path
from aspose.pydrawing import Color
from aspose.tex.features import PngMathRenderer, PngMathRendererOptions

# Set an output directory, or use the default output folder.
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

# Create rendering options setting the image resolution to 150 dpi.
options = PngMathRendererOptions()
options.resolution = 150
# Specify the preamble.
options.preamble = r"""\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{color}"""
# Specify the scaling factor 300%.
options.scale = 3000
# Leave space around the rendered fragment.
options.margin = 5
# Specify the foreground color.
options.text_color = Color.black
# Specify the background color.
options.background_color = Color.white
# Specify whether to show the terminal output on the console or not.
options.show_terminal = False

# Create binary streams for the rendering log and formula image.
with (output_dir / "math-formula.png.log").open("wb") as log_stream, \
        (output_dir / "math-formula.png").open("wb") as stream:
    options.log_stream = log_stream
    # Run rendering.
    size = PngMathRenderer().render(r"""\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.
print(options.error_report or "No rendering errors.")
print()
print(f"Size: {size.width}x{size.height}")

Kommen wir zu den Details. Zuerst initiieren wir ein rendering options-Objekt, ähnlich dem TeX/LaTeX-Schriftsatz, das die Spezifikation für die gewünschte Ausgabebildauflösung enthält.

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

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

das im Vergleich zum Standard-LaTeX eine verbesserte Unterstützung für mathematische Formeln bietet. Sie können beispielsweise das Paket „color“ einschließen, um die Hervorhebung in der Formel anzupassen, wie im bereitgestellten Codebeispiel gezeigt.

Mit scale = 3000 wird die Ausgabe auf 300 % skaliert; margin = 5 lässt Platz um das Fragment. Das PNG-Beispiel verwendet resolution = 150 DPI.

Die nächsten beiden Optionen bestimmen die Vordergrund- und Hintergrundfarben. Alle Teile der Formel, die von der benutzerdefinierten Hervorhebung nicht betroffen sind, werden in der Farbe „text_color“ angezeigt.

Das Beispiel weist log_stream einen binären Dateistream zu und speichert das Protokoll als math-formula.png.log neben math-formula.png. Die with-Anweisung schließt beide Streams automatisch.

show_terminal steuert die Terminalausgabe in der Konsole. Die Beispiele setzen diese Option auf False; das Protokoll wird weiterhin in die Datei geschrieben.

Der eigentliche Rendervorgang wird von der Methode MathRenderer.render() durchgeführt, die die Größe der Formel in Punkten zurückgibt.

Das zweite Argument ist der binäre Ausgabestream für das Bild. Das dritte Argument enthält die Rendering-Optionen.

Und schließlich wird die Methode „MathRenderer.render()“ aufgerufen, wobei die Optionen als drittes Argument übergeben werden. Als erstes Argument wird der LaTeX-Code der Formel bereitgestellt.

Die letzten Zeilen geben den Fehlerbericht oder bei leerem Bericht No rendering errors. aus, gefolgt von Breite und Höhe in Punkten.

Hier ist das Ergebnis des Renderings.

Dies stellt die häufigste und umfassendste Anwendung der LaTeX-Funktion zum Rendern mathematischer Formeln dar.

Sie können auch die kostenlose Web-App erkunden, die die implementierte Funktion der Aspose.TeX für .NET API nutzt.

Rendern einer LaTeX-Matheformel in SVG

Ebenso können wir mit dem gleichen Ansatz eine LaTeX-Matheformel in das SVG-Format konvertieren.

# Render a highlighted LaTeX math formula to SVG.
import os
from pathlib import Path
from aspose.pydrawing import Color
from aspose.tex.features import SvgMathRenderer, SvgMathRendererOptions

# Set an output directory, or use the default output folder.
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

# Create rendering options.
options = SvgMathRendererOptions()
# Specify the preamble.
options.preamble = r"""\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{color}"""
# Specify the scaling factor 300%.
options.scale = 3000
# Leave space around the rendered fragment.
options.margin = 5
# Specify the foreground color.
options.text_color = Color.black
# Specify the background color.
options.background_color = Color.white
# Specify whether to show the terminal output on the console or not.
options.show_terminal = False

# Create binary streams for the rendering log and formula image.
with (output_dir / "math-formula.svg.log").open("wb") as log_stream, \
        (output_dir / "math-formula.svg").open("wb") as stream:
    options.log_stream = log_stream
    # Run rendering.
    size = SvgMathRenderer().render(r"""\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.
print(options.error_report or "No rendering errors.")
print()
print(f"Size: {size.width}x{size.height}")

Dieses Beispiel erstellt math-formula.svg und das Protokoll math-formula.svg.log im selben Ausgabeverzeichnis.

Die Unterschiede sind:

• Anstelle der Klasse PngMathRendererOptions verwenden wir die Klasse SvgMathRendererOptions.
• Wir geben keine Auflösung an.
• Anstelle der Klasse PngMathRenderer verwenden wir die Klasse SvgMathRenderer.

Hier ist das Ergebnis:

Sie können auch die kostenlose Web-App erkunden, die die implementierte Funktion der Aspose.TeX für .NET API nutzt.