LaTeX all'immagine | Python tramite .NET

Aspose.TeX per Python ci fornisce la capacità di convertire i file in LaTeX in vari formati di immagini raster.

Convertire il LaTeX in PNG

Ora, esaminiamo il codice Python che offre l’approccio più semplice alla conversione del formato di LaTeX in PNG in profondità.

Impostare ASPOSE_TEX_INPUT_FILE sul file LaTeX e ASPOSE_TEX_OUTPUT_DIR sulla directory di output, oppure modificare i percorsi nell’esempio. I valori predefiniti sono hello-world.ltx e output. Applicare prima una licenza. I file di input aggiuntivi vengono cercati accanto al documento principale; l’elaborazione non è interattiva. Licenze

# 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()

Per cominciare, dobbiamo creare un’istanza della classe texoptions usando il metodo Console_app_options() . Non preoccuparti del nome, è solo il metodo statico che crea l’istanza. Questo metodo prende l’istanza Object_Latex della classe TexConfig, che è perfetta per convertire un file latex. Questa configurazione imposta il motore Object Tex per caricare il formato Object Latex ed essere pronto a elaborare il file Latex. Il formato di LaTeX oggetto è essenzialmente lo stesso del formato latex, ma utilizza oggetto tex primitive specifiche per definire le metriche di pagina.

La prima delle opzioni necessarie è output_working_directory, che specifica la posizione in cui verrà salvato l’output Tex. Se interessato, puoi conoscere ulteriori informazioni sul concetto di directory di output in Aspose.TeX per python. In questo esempio particolare, utilizziamo la classe OutputFilesystemDirectory per scrivere l’output su una directory o una cartella specifica.

La seconda opzione è un’istanza della classe SaveOptions, che è responsabile della gestione della conversione dal modello a oggetti al formato desiderato. In questo caso, dal momento che stiamo convertendo il LaTeX in PNG, utilizziamo l’istanza di classe PNGSaveOptions, che ci consente di specificare la risoluzione delle immagini di output.

Successivamente, creiamo un’istanza della classe Texjob. In questo caso, dal momento che vogliamo convertire un file LaTeX memorizzato nel file system, utilizziamo questa versione del costruttore . Dobbiamo fornire l’intero percorso al file, altrimenti il ​​motore lo cercherà nella directory corrente (che è la directory di lavoro dello script) e potrebbe non trovarlo. Tuttavia, l’estensione .tex può essere omessa poiché il motore lo aggiungerà automaticamente. Il secondo argomento del costruttore è un’istanza della classe dispositivo. Dal momento che stiamo convertendo il LaTeX in PNG, è un’istanza di classe imagevice, che è comune a tutti i formati di immagine supportati. Infine, passiamo le opzioni di conversione preparate come ultimo argomento.

Ora, tutto ciò che rimane è correre il lavoro.

L’esempio acquisisce l’output del terminale in OutputMemoryTerminal. La directory di output contiene anche un registro .log. Una conversione riuscita produce un registro simile al seguente; le informazioni sulla versione possono variare:

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.

I risultati del lavoro del motore sono disponibili nella directory di output che abbiamo specificato. Ciò includerà il file di trascrizione e, soprattutto, i principali file di immagine PNG di output.

Un modo alternativo per scrivere i file PNG di output principale

Esiste un metodo alternativo per ottenere i dati dell’immagine come array di array di byte, in cui ciascun array nella seconda dimensione rappresenta i dati dell’immagine per una pagina separata.

# 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)

L’esempio imposta device_writes_images = False su PngSaveOptions prima di assegnarlo a options.save_options. Salva i byte delle pagine restituite come page-1.png, page-2.png e così via. Il dispositivo non crea quindi file PNG duplicati.

Per quanto riguarda le opzioni di input

Se il nostro file di input principale richiede dipendenze, come pacchetti che non sono inclusi nel sistema di base in LaTeX o pacchetti supportati, è necessario impostare l’opzione Recome_input_directory in modo simile a come impostiamo l’opzione * output_working_directory * e posizionare le dipendenze in quella directory. Le dipendenze possono essere organizzate nelle sottodirectory se necessario. Se abbiamo i nostri file da includere nel processo di composizione, come i file grafici esterni, dobbiamo anche impostare input_working_directory nella posizione in cui tali file sono archiviati. Possiamo anche posizionare il file di input principale all’interno della directory di input e specificare il percorso relativo al costruttore TeXJob o specificare alcun percorso se il file di input principale è nella directory di root. Ci sono anche maggiori dettagli sul concetto di directory di input in aspose.tex e le implementazioni fornite descritte.

Impara anche le altre opzioni di lavoro di Tex qui.

Puoi anche esplorare la conversione gratuita Web App per la conversione da lattoce a PNG, che viene sviluppata utilizzando Aspose.TeX per API .NET.

Di seguito, spiegheremo brevemente la conversione del LaTeX ad altri formati di immagini raster supportati, senza immergersi in troppi dettagli in quanto non vi sono differenze significative. L’unica variazione risiede nel tipo di proprietà Save_options nelle opzioni di conversione.

Convertire il 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()

Puoi anche esplorare la conversione gratuita app Web per LaTeX a jpg, che viene sviluppata utilizzando Aspose.TeX per .NET API.

Convertire il 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()

Puoi anche esplorare la conversione gratuita app Web per LaTeX-tiff, che viene sviluppata utilizzando Aspose.TeX per .NET API.

Convertire il 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()

Puoi anche esplorare la conversione gratuita app Web per LaTeX-a-BMP, che viene sviluppata utilizzando Aspose.TeX per .NET API.

Convertire il LaTeX in SVG

Un altro formato target supportato è svg. Scalable Vector Graphics (SVG) è un formato di immagine vettoriale basato su XML che viene utilizzato per definire la grafica bidimensionale. Supporta l’interattività e l’animazione.

Le immagini SVG sono archiviate in file di testo XML e definite in un formato grafico vettoriale. Ciò significa che le immagini svg possono essere ridimensionate senza perdere la qualità e i file svg stessi possono essere cercati, indicizzati, scritti e compressi. I file di testo XML possono essere creati e modificati utilizzando editor di testo o redattori di grafica vettoriale e possono essere resi dai browser Web più comunemente usati.

L’API Aspose.svg offre una gamma di funzionalità per lavorare con svg, come la creazione, il caricamento, la modifica e la conversione di documenti svg.

La conversione del LaTeX in SVG è semplice quanto la conversione in formati di immagini raster, con l’unica differenza è che i Save_options devono essere impostati su un’istanza della classe SVGSaveOptions e il dispositivo deve essere modificato in un’istanza della classe SvgDevice.

# 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()

Puoi anche esplorare la conversione gratuita app Web per la latex-a-SVG, che viene sviluppata utilizzando Aspose.TeX per .NET API.