Rendering di figura in LaTeX | Java

Può succedere che tu voglia estrarre alcuni contenuti (un disegno, una scrittura, una trama, ecc.) Da un file LaTeX come pezzo reso separatamente o una *figura * *, indipendentemente dal suo posto su una pagina del documento di output. È così un illustrazione per la tua pubblicazione su Internet, ad esempio. La nostra API può aiutarti con l’attività. Esistono due formati target disponibili: PNG e SVG. Proprio come nel rendering della formula matematica in LaTeX. Dobbiamo anche notare che il rendering di figura in LaTeX è una generalizzazione del rendering di formula matematica in LaTeX.

Come rendere una figura in LaTeX a png

E come per il rendering della formula, inizieremo con un esempio. Ecco qui:

// 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();
}

Prima di tutto, creiamo un’istanza di rendering options. Lo facciamo qui insieme a specificare la risoluzione dell’immagine di output.

Successivamente, specifichiamo il preambolo. Non esiste un preambolo predefinito per il rendering delle figure in LaTeX, quindi se si desidera, ad esempio, per rendere una grafica tracciata utilizzando il pacchetto Pict2e Latex, è necessario specificarlo nel preambolo:

\usepackage{pict2e}

Quindi istruiamo il rendering di ridimensionare l’output del 300%.

L’opzione successiva definisce il colore di sfondo. A differenza del rendering della formula matematica, non specifichiamo un colore in primo piano poiché supponiamo che i colori siano interamente sotto il controllo del codice LaTeX. In effetti, così è il colore di sfondo, quindi questa è solo un’opzione di convenienza.

La riga successiva dell’esempio non ha molto senso. Dimostra solo che è possibile indirizzare l’output del registro su un flusso.

E l’ultima opzione showterminal consente di attivare la scrittura dell’output del terminale sulla console.

Il metodo che esegue effettivamente il rendering è FigureRender.Render(). Restituisce le dimensioni della figura in punti.

Il flusso in cui l’immagine deve essere scritta è accettato dal metodo come secondo argomento. Creiamo il flusso dopo.

E infine, chiamiamo il metodo figurerender.render(), passando le opzioni come terzo argomento. Il codice in LaTeX della figura viene approvato come primo argomento.

Le ultime righe dell’esempio stampano due artefatti del rendering della figura: la dimensione della figura e il breve rapporto di errore (nel caso in cui vi siano errori).

Ecco il risultato del rendering.

Questo è il caso d’uso più generale per la funzione Latex Figure.

Come rendere una figura in LaTeX a SVG

Allo stesso modo, possiamo rendere una figura in LaTeX al formato SVG.

// 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();
}

Le differenze sono:

• Usiamo la classe SVGFigureRenderEroptions anziché PNGFURESTERERIPTIONS.
• Non specifichiamo la risoluzione.
• Usiamo la classe svgfigurerender anziché pngfigurerender.

Ecco il risultato: