Rendern von LaTeX-Matheformeln | .NET

So rendern Sie eine LaTeX-Matheformel in PNG

Der API-Referenzabschnitt zu diesem Thema ist hier. Tatsächlich ist es am einfachsten, die LaTeX-Funktion zum Rendern mathematischer Formeln zu demonstrieren, indem man mit dem Beispiel beginnt. Hier ist es:

// 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(RunExamples.OutputDirectory, "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.
}

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 (falls Fehler vorliegen).

Hier ist das Ergebnis des Renderns.

Dies ist der allgemeinste Anwendungsfall für die Funktion LaTeX-Rendering mathematischer Formeln.

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

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.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(RunExamples.OutputDirectory, "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.
}

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.