LaTeX-Figurenrendering | Aspose.TeX für Java

Es kann vorkommen, dass Sie Inhalte (eine Zeichnung, eine Schrift, einen Plot usw.) aus einer LaTeX-Datei als separat gerendertes Stück oder als „Figur“ extrahieren möchten, unabhängig von ihrer Position auf einer Ausgabedokumentseite . Eine Illustration für Ihre Veröffentlichung im Internet ist beispielsweise der Fall. Unsere API kann Ihnen bei dieser Aufgabe helfen. Es stehen zwei Zielformate zur Verfügung: PNG und SVG. Genau wie beim Rendern mathematischer Formeln in LaTeX. Wir müssen auch beachten, dass LaTeX-Figuren-Rendering eine Verallgemeinerung von LaTeX-Mathe-Formel-Rendering ist.

So rendern Sie eine LaTeX-Figur in PNG

Und wie bei der Formeldarstellung beginnen wir mit einem Beispiel. Hier ist es:

// Create rendering options setting the image resolution to 150 dpi.
PngFigureRendererOptions options = new PngFigureRendererOptions();
options.setResolution(150);
// Specify the preamble.
options.setPreamble("\\usepackage{pict2e}");
// Specify the scaling factor 300%.
options.setScale(3000);
// 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 figure image.
final OutputStream stream = new FileOutputStream(Utils.getOutputDirectory() + "text-and-formula.png");
try {
    // Run rendering.
    com.aspose.tex.Size2D size = new PngFigureRenderer().render("\\setlength{\\unitlength}{0.8cm}\r\n" +
    "\\begin{picture}(6,5)\r\n" +
    "\\thicklines\r\n" +
    "\\put(1,0.5){\\line(2,1){3}} \\put(4,2){\\line(-2,1){2}} \\put(2,3){\\line(-2,-5){1}} \\put(0.7,0.3){$A$} \\put(4.05,1.9){$B$} \\put(1.7,2.95){$C$}\r\n" +
    "\\put(3.1,2.5){$a$} \\put(1.3,1.7){$b$} \\put(2.5,1.05){$c$} \\put(0.3,4){$F=\\sqrt{s(s-a)(s-b)(s-c)}$} \\put(3.5,0.4){$\\displaystyle s:=\\frac{a+b+c}{2}$}\r\n" +
    "\\end{picture}", 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();
}

Zunächst erstellen wir eine rendering options-Instanz. Wir tun dies hier zusammen mit der Angabe der Ausgabebildauflösung.

Als nächstes spezifizieren wir die Präambel. Es gibt keine Standard-Präambel für die Darstellung von LaTeX-Figuren. Wenn Sie also beispielsweise einige Grafiken rendern möchten, die mit dem LaTeX-Paket „pict2e“ geplottet wurden, müssen Sie dies in der Präambel angeben:

\usepackage{pict2e}

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

Die nächste Option definiert die Hintergrundfarbe. Anders als beim Rendern mathematischer Formeln geben wir keine Vordergrundfarbe an, da wir davon ausgehen, dass die Farben vollständig vom LaTeX-Code gesteuert werden. Tatsächlich gilt dies auch für die Hintergrundfarbe, es handelt sich also lediglich um eine praktische Option.

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 FigureRenderer.render(). Es gibt die Größe der Figur 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 „FigureRenderer.render()“ selbst auf und übergeben Optionen als drittes Argument. Als erstes Argument wird der LaTeX-Code der Abbildung übergeben.

Die letzten Zeilen des Beispiels geben zwei Artefakte der Figurendarstellung aus – die Größe der Figur und den kurzen Fehlerbericht (falls Fehler vorliegen).

Hier ist das Ergebnis des Renderns.

Dies ist der allgemeinste Anwendungsfall für die Funktion LaTeX-Figurenrendering.

So rendern Sie eine LaTeX-Figur in SVG

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

// Create rendering options.
SvgFigureRendererOptions options = new SvgFigureRendererOptions();
// Specify the preamble.
options.setPreamble("\\usepackage{pict2e}");
// Specify the scaling factor 300%.
options.setScale(3000);
// 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 figure image.
final OutputStream stream = new FileOutputStream(Utils.getOutputDirectory() + "text-and-formula.svg");
try {
    // Run rendering.
    com.aspose.tex.Size2D size = new SvgFigureRenderer().render("\\setlength{\\unitlength}{0.8cm}\r\n" +
    "\\begin{picture}(6,5)\r\n" +
    "\\thicklines\r\n" +
    "\\put(1,0.5){\\line(2,1){3}} \\put(4,2){\\line(-2,1){2}} \\put(2,3){\\line(-2,-5){1}} \\put(0.7,0.3){$A$} \\put(4.05,1.9){$B$} \\put(1.7,2.95){$C$}\r\n" +
    "\\put(3.1,2.5){$a$} \\put(1.3,1.7){$b$} \\put(2.5,1.05){$c$} \\put(0.3,4){$F=\\sqrt{s(s-a)(s-b)(s-c)}$} \\put(3.5,0.4){$\\displaystyle s:=\\frac{a+b+c}{2}$}\r\n" +
    "\\end{picture}", 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();
}

Die Unterschiede sind:

• Wir verwenden die Klasse SvgFigureRendererOptions anstelle von PngFigureRendererOptions.
• Wir geben keine Auflösung an.
• Wir verwenden die Klasse SvgFigureRenderer anstelle von PngFigureRenderer.

Hier ist das Ergebnis: