LaTeX all'immagine | Java

Aspose.TeX for Java provides features for converting LaTeX files to a number of raster image formats.

Come convertire il LaTeX in PNG

Diamo un’occhiata più da vicino al codice Java che fornisce il modo più semplice per convertire il LaTeX in formato PNG.

// Create conversion options for Object LaTeX format upon Object TeX engine extension.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
// Specify a file system working directory for the output.
options.setOutputWorkingDirectory(new OutputFileSystemDirectory(Utils.getOutputDirectory()));
// Initialize the options for saving in PNG format.
options.setSaveOptions(new PngSaveOptions());
// Run LaTeX to PNG conversion.
new TeXJob(Utils.getInputDirectory() + "hello-world.ltx", new ImageDevice(), options).run();

Quindi, la prima cosa che dobbiamo fare (a volte non la prima, come scopriremo più avanti) è creare un’istanza della classe Texoptions. L’unico metodo statico che fa questo è ConsoleAppoptions(), quindi non ci preoccupiamo del significato del suo nome. Il metodo prende l’istanza ObjectLatex() della classe TexConfig, che è esattamente adatto per la conversione di un file latex. Questa configurazione indica al motore Object Tex di caricare il formato Object Latex e di essere pronto ad accettare il file LaTeX. Il formato di LaTeX oggetto è in realtà solo il formato LaTeX, tranne per il fatto che utilizza le primitive specifiche Object Tex per impostare le metriche di pagina.

La prima delle opzioni richieste è OutputWorkingDirectory che definisce lo spazio o l’area, in cui verrà scritto l’output di Tex. Qui sono i dettagli sul concetto di directory di output in Aspose.TeX per java. In questo esempio, utilizziamo la classe OutputFilesystemDirectory, che ci consente di scrivere l’output nella directory o nella cartella specificata.

La seconda opzione è un’istanza di classe SaveOptions che controllerà la trasformazione del modello a oggetto al formato target. Dal momento che stiamo convertendo il LaTeX in PNG, è l’istanza di classe PNGSaveOptions, che ci consente di specificare la risoluzione delle immagini di output.

Successivamente, dobbiamo creare un’istanza della classe Texjob. Volendo convertire un file LaTeX archiviato nel file system, utilizziamo questa versione del costruttore. Dovremmo specificare l’intero percorso del file. Altrimenti, il motore lo cercherà nella directory corrente (che è definita qui) e molto probabilmente non lo troverà. Tuttavia, possiamo omettere l’estensione se il nostro file ha quello .tex. Il motore lo aggiungerà automaticamente. Il secondo argomento del costruttore è un’istanza di classe dispositivo. Dal momento che stiamo convertendo il LaTeX in PNG, è una classe imagevice (che è comune a tutti i formati di immagini supportati). Come ultimo argomento, passiamo le opzioni di conversione recentemente preparate.

Tutto quello che dobbiamo fare ora è correre il lavoro.

Indipendentemente dal fatto che la corsa abbia avuto successo o meno, il primo risultato che vedremo sarà l’output del terminale. In caso di successo, assomiglia a questo:

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.

Troveremo altri prodotti dell’esecuzione del motore nella cartella che abbiamo specificato come directory di output. Quelli saranno il file trascrizione (.log) e, voilà!, il principale file di immagine PNG di output.

Un modo alternativo per scrivere i file PNG di output principale

Esiste un altro modo per ottenere i dati dell’immagine come un matrice di array di byte, ogni array nella seconda dimensione rappresenta i dati di immagine per una pagina separata.

// Create conversion options instance.
...
// Initialize the options for saving in PNG format.
PngSaveOptions saveOptions = new PngSaveOptions();
// Set this property to instruct the device not to output images as you will access them alternatively.
saveOptions.deviceWritesImages(false);
options.setSaveOptions(saveOptions);
// Create the image device.
ImageDevice device = new ImageDevice();
// Run LaTeX to PNG conversion.
new TeXJob(Utils.getInputDirectory() + "hello-world.ltx", device, options).run();

// Save pages file by file.
for (int i = 0; i < device.getResult().length; i++)
{
  final OutputStream fs = new FileOutputStream(Utils.getOutputDirectory() + MessageFormat.format("page-{0}.png", (i + 1)));
  try {
    fs.write(device.getResult()[i], 0, device.getResult()[i].length);
  } finally {
    if (fs != null)
      fs.close();
  }
}

I file “Page-n.png” saranno scritti su qualsiasi percorso che specificiamo. A differenza di Output PDF, duplicheranno i file PNG di output scritti nella directory di output.

Sulle opzioni di input

Nel caso in cui il nostro file di input principale richieda dipendenze, ad esempio pacchetti, che non sono inclusi nel sistema di LaTeX di base e nei pacchetti supportati, dobbiamo impostare l’opzione RecomeinputDirectory nel modo simile che impostiamo l’opzione OutputWorkingDirectory e mettere le dipendenze in quella directory. Le dipendenze possono essere organizzate arbitrariamente nelle sottodirectory. Nel caso in cui abbiamo i nostri file da includere lungo il processo di composizione, ad esempio file di grafica esterna, dobbiamo anche impostare InputWorkingDirectory utilizzando il percorso per la posizione in cui tali file vengono raccolti. Potremmo anche posizionare il file di input principale da qualche parte all’interno della directory di input e specificare il percorso relativo nel metodo run() (o specificare alcun percorso se il file di input principale è nella radice). Qui sono i dettagli sul concetto di directory di input in Aspose.TeX per java e hanno fornito implementazioni.

Altre opzioni di lavoro di Tex sono discusse qui.

È inoltre possibile controllare la conversione gratuita di lattici a PNG app Web basata in base all’API Aspose.TeX per .NET. Qui è la pagina della versione Java.

Di seguito, discutiamo della conversione in LaTeX ad altri formati di immagine raster supportati. Non entreremo nei dettagli solo perché in realtà non ci sono dettagli. L’unica differenza è nel tipo di proprietà SaveOptions nelle opzioni di conversione.

Come convertire il LaTeX in jpg

// Create conversion options instance.
...
// Initialize the options for saving in JPEG format.
options.SaveOptions = new JpegSaveOptions();

È inoltre possibile controllare la conversione da lattoce a jpg gratuita app Web basata in base all’API Aspose.TeX per .NET. Qui è la pagina della versione Java.

Come convertire il LaTeX in tiff

// Create conversion options instance.
...
// Initialize the options for saving in TIFF format.
options.SaveOptions = new TiffSaveOptions();

È inoltre possibile controllare la conversione da LaTeX a tiff gratuita app Web basata sulla base dell’API Aspose.TeX per .NET. Qui è la pagina della versione Java.

Come convertire il LaTeX in BMP

// Create conversion options instance.
...
// Initialize the options for saving in BMP format.
options.SaveOptions = new BmpSaveOptions();

È inoltre possibile controllare la conversione da lattoce a BMP gratuita app Web basata sulla base dell’API Aspose.TeX per .NET. Qui è la pagina della versione Java.

Come convertire il LaTeX in SVG

E ancora un altro formato target supportato è svg. Scalable Vector Graphics (SVG) è un formato di immagine vettoriale basato su XML per definire la grafica bidimensionale, con supporto per l’interattività e l’animazione.

Le immagini SVG sono definite in un formato grafico vettoriale e memorizzate in file di testo XML. Ciò significa che le immagini svg possono essere ridimensionate senza perdita di qualità e i file svg possono essere cercati, indicizzati, script e compressi. I file di testo XML possono essere creati e modificati con editor di testo o redattori grafici vettoriali. Thay sono resi dai browser Web più usati.

Inoltre, esiste la libreria Aspose.svg che ha varie funzionalità basate sul formato svg. Questi includono la creazione, il caricamento, la modifica e la conversione di documenti SVG.

La conversione in SVG è semplice quanto la conversione in formati di immagini raster, tranne che oltre alle SaveOptions, dobbiamo cambiare il dispositivo in un’istanza della classe SVGDEVICE.

// Create conversion options for Object LaTeX format upon Object TeX engine extension.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
// Specify a file system working directory for the output.
options.setOutputWorkingDirectory(new OutputFileSystemDirectory(Utils.getOutputDirectory()));
// Initialize the options for saving in SVG format.
options.setSaveOptions(new SvgSaveOptions());
// Run LaTeX to SVG conversion.
new TeXJob(Utils.getInputDirectory() +  "hello-world.ltx", new SvgDevice(), options).run();

È inoltre possibile controllare la conversione da lattici a SVG gratuita app Web basata in base a Aspose.TeX per .NET. Qui è la pagina della versione Java.