LaTeX zum Bild | Python

Aspose.TeX für Python bietet uns die Möglichkeit, LaTeX-Dateien in verschiedene Rasterbildformate zu konvertieren.

Konvertieren von LaTeX in PNG

Schauen wir uns nun den Python-Code an, der den einfachsten Ansatz zur Konvertierung von LaTeX in das PNG-Format bietet.

Setzen Sie ASPOSE_TEX_INPUT_FILE auf Ihre LaTeX-Datei und ASPOSE_TEX_OUTPUT_DIR auf das Ausgabeverzeichnis, oder ändern Sie die Pfade im Beispiel. Die Standardwerte sind hello-world.ltx und output. Wenden Sie vorher eine Lizenz an. Zusätzliche Eingabedateien werden neben dem Hauptdokument gesucht; die Verarbeitung erfolgt ohne interaktive Eingaben. Lizenzierung

# Convert LaTeX to PNG.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, PngSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
options.save_options = PngSaveOptions()
device = ImageDevice(True)
job_result = TeXJob(str(input_file), device, options).run()

Zunächst müssen wir mit der Methode console_app_options() eine Instanz der Klasse TeXOptions erstellen. Machen Sie sich keine Sorgen um den Namen, es ist nur die statische Methode, die die Instanz erstellt. Diese Methode verwendet die Instanz object_latex der Klasse TeXConfig, die sich perfekt zum Konvertieren einer LaTeX-Datei eignet. Diese Konfiguration richtet die Object TeX-Engine so ein, dass sie das Object LaTeX-Format lädt und für die Verarbeitung der LaTeX-Datei bereit ist. Das Object-LaTeX-Format ist im Wesentlichen dasselbe wie das LaTeX-Format, verwendet jedoch Object-TeX-spezifische Grundelemente, um die Seitenmetriken zu definieren.

Die erste der notwendigen Optionen ist output_working_directory, die den Speicherort angibt, an dem die TeX-Ausgabe gespeichert wird. Bei Interesse können Sie weitere Informationen zum Konzept des Ausgabeverzeichnisses in Aspose.TeX für Python erfahren. In diesem speziellen Beispiel verwenden wir die Klasse OutputFileSystemDirectory, um die Ausgabe in ein bestimmtes Verzeichnis oder einen bestimmten Ordner zu schreiben.

Die zweite Option ist eine Instanz der Klasse SaveOptions, die für die Verwaltung der Konvertierung vom Objektmodell in das gewünschte Format verantwortlich ist. Da wir in diesem Fall LaTeX in PNG konvertieren, verwenden wir die Klasseninstanz PngSaveOptions, mit der wir die Auflösung der Ausgabebilder angeben können.

Als nächstes erstellen wir eine Instanz der Klasse TeXJob. Da wir in diesem Fall eine im Dateisystem gespeicherte LaTeX-Datei konvertieren möchten, verwenden wir diese Version des Konstruktors . Wir müssen den vollständigen Pfad zur Datei angeben, andernfalls sucht die Engine im aktuellen Verzeichnis (dem Arbeitsverzeichnis des Skripts) danach und findet sie möglicherweise nicht. Die Erweiterung „.tex“ kann jedoch weggelassen werden, da die Engine sie automatisch anhängt. Das zweite Argument des Konstruktors ist eine Instanz der Klasse Device. Da wir LaTeX in PNG konvertieren, handelt es sich um eine ImageDevice-Klasseninstanz, die allen unterstützten Bildformaten gemeinsam ist. Abschließend übergeben wir als letztes Argument die vorbereiteten Konvertierungsoptionen.

Jetzt müssen Sie nur noch den Job ausführen.

Das Beispiel erfasst die Terminalausgabe in OutputMemoryTerminal. Im Ausgabeverzeichnis liegt außerdem ein .log-Protokoll. Bei erfolgreicher Konvertierung sieht es etwa so aus; Versionsangaben können abweichen:

This is ObjectTeX, Version 3.1415926-1.0 (Aspose.TeX 21.8)
entering extended mode

(<input_directory>\hello-world.ltx
LaTeX2e <2011/06/27>
(article.cls
Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
(size10.clo))
No file hello-world.aux.
[1]
(<output_directory>\hello-world.aux) )
Output written on hello-world.png (1 page).
Transcript written on hello-world.log.

Die Ergebnisse der Arbeit der Engine finden Sie im von uns angegebenen Ausgabeverzeichnis. Dazu gehören die Transkriptdatei und vor allem die PNG-Bilddatei(en) für die Hauptausgabe.

Eine alternative Möglichkeit, die Hauptausgabe-PNG-Datei(en) zu schreiben.

Es gibt eine alternative Methode, um Bilddaten als Array von Byte-Arrays zu erhalten, wobei jedes Array in der zweiten Dimension die Bilddaten für eine separate Seite darstellt.

# Convert LaTeX to PNG and save each page from the returned byte arrays.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, PngSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
save_options = PngSaveOptions()
save_options.device_writes_images = False
options.save_options = save_options
device = ImageDevice(True)
job_result = TeXJob(str(input_file), device, options).run()

# Write the returned PNG page bytes yourself.
for index, page_bytes in enumerate(device.result, start=1):
    (output_dir / f"page-{index}.png").write_bytes(page_bytes)

Das Beispiel setzt device_writes_images = False auf PngSaveOptions, bevor es die Optionen options.save_options zuweist. Die zurückgegebenen Seitenbytes werden als page-1.png, page-2.png usw. gespeichert. Das Gerät erzeugt daher keine doppelten PNG-Dateien.

Zu den Eingabemöglichkeiten

Wenn unsere Haupteingabedatei Abhängigkeiten erfordert, wie etwa Pakete, die nicht im grundlegenden LaTeX-System enthalten sind, oder unterstützte Pakete, müssen wir die Option required_input_directory auf ähnliche Weise festlegen, wie wir die Option output_working_directory festlegen Platzieren Sie die Abhängigkeiten in diesem Verzeichnis. Die Abhängigkeiten können je nach Bedarf in Unterverzeichnissen organisiert werden. Wenn wir unsere Dateien in den Satzprozess einbeziehen möchten, beispielsweise externe Grafikdateien, müssen wir auch das input_working_directory auf den Speicherort dieser Dateien festlegen. Wir können die Haupteingabedatei auch im Eingabeverzeichnis platzieren und den relativen Pfad an den Konstruktor TeXJob angeben oder überhaupt keinen Pfad angeben, wenn sich die Haupteingabedatei im Stammverzeichnis befindet. Es gibt auch weitere Details zum Eingabeverzeichniskonzept in Aspose.TeX und den bereitgestellten Implementierungen, die beschrieben werden.

Erfahren Sie auch die anderen TeX-Joboptionen hier.

Sie können auch die kostenlose Web-App für die Konvertierung von LaTeX in PNG erkunden, die mit der Aspose.TeX für .NET API entwickelt wurde.

Im Folgenden erklären wir kurz die Konvertierung von LaTeX in andere unterstützte Rasterbildformate, ohne zu sehr ins Detail zu gehen, da es keine wesentlichen Unterschiede gibt. Die einzige Variation liegt im Typ der Eigenschaft save_options in den Konvertierungsoptionen.

Konvertieren von LaTeX in JPG

# Convert LaTeX to JPEG.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, JpegSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
options.save_options = JpegSaveOptions()
device = ImageDevice(True)
job_result = TeXJob(str(input_file), device, options).run()

Sie können auch die kostenlose Web-App für die Konvertierung von LaTeX in JPG erkunden, die mit der Aspose.TeX für .NET API entwickelt wurde.

Konvertieren von LaTeX in TIFF

# Convert LaTeX to TIFF.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, TiffSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
options.save_options = TiffSaveOptions()
device = ImageDevice(True)
job_result = TeXJob(str(input_file), device, options).run()

Sie können auch die kostenlose Web-App für die Konvertierung von LaTeX in TIFF erkunden, die mit der Aspose.TeX für .NET API entwickelt wurde.

Konvertieren von LaTeX in BMP

# Convert LaTeX to BMP.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.image import ImageDevice, BmpSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
options.save_options = BmpSaveOptions()
device = ImageDevice(True)
job_result = TeXJob(str(input_file), device, options).run()

Sie können auch die kostenlose Web-App für die Konvertierung von LaTeX in BMP erkunden, die mit der Aspose.TeX für .NET API entwickelt wurde.

Konvertieren von LaTeX in SVG

Ein weiteres unterstütztes Zielformat ist SVG. Skalierbare Vektorgrafiken (SVG) ist ein XML-basiertes Vektorbildformat, das zur Definition zweidimensionaler Grafiken verwendet wird. Es unterstützt Interaktivität und Animation.

SVG-Bilder werden in XML-Textdateien gespeichert und in einem Vektorgrafikformat definiert. Dies bedeutet, dass SVG-Bilder ohne Qualitätsverlust in der Größe skaliert werden können und SVG-Dateien selbst durchsucht, indiziert, mit Skripts versehen und komprimiert werden können. Die XML-Textdateien können mit Texteditoren oder Vektorgrafik-Editoren erstellt und bearbeitet werden und können von den am häufigsten verwendeten Webbrowsern gerendert werden.

Die Aspose.SVG API bietet eine Reihe von Funktionen für die Arbeit mit SVG, wie zum Beispiel das Erstellen, Laden, Bearbeiten und Konvertieren von SVG-Dokumenten.

Das Konvertieren von LaTeX in SVG ist genauso einfach wie das Konvertieren in Rasterbildformate, mit dem einzigen Unterschied, dass save_options auf eine Instanz der Klasse SvgSaveOptions gesetzt werden muss und die Das Gerät muss in eine Instanz der Klasse SvgDevice geändert werden.

# Convert LaTeX to SVG.
import os
from pathlib import Path
from aspose.tex import Interaction, TeXConfig, TeXJob, TeXOptions
from aspose.tex.io import InputFileSystemDirectory, OutputFileSystemDirectory, OutputMemoryTerminal
from aspose.tex.presentation.svg import SvgDevice, SvgSaveOptions

# Set these paths to your LaTeX document and output directory.
input_file = Path(os.environ.get("ASPOSE_TEX_INPUT_FILE", "hello-world.ltx")).resolve()
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
if not input_file.is_file():
    raise FileNotFoundError(input_file)
output_dir.mkdir(parents=True, exist_ok=True)

# Use the Object LaTeX format and resolve additional inputs beside the main file.
options = TeXOptions.console_app_options(TeXConfig.object_latex)
options.input_working_directory = InputFileSystemDirectory(str(input_file.parent))
options.output_working_directory = OutputFileSystemDirectory(str(output_dir))
options.interaction = Interaction.NONSTOP_MODE
options.terminal_out = OutputMemoryTerminal()
options.save_options = SvgSaveOptions()
device = SvgDevice()
job_result = TeXJob(str(input_file), device, options).run()

Sie können auch die kostenlose Web-App für die Konvertierung von LaTeX in SVG erkunden, die mit der Aspose.TeX für .NET API entwickelt wurde.