Representación de figuras LaTeX | Aspose.TeX para Java

Puede suceder que desee extraer algún contenido (un dibujo, un escrito, una trama, etc.) de un archivo LaTeX como una pieza renderizada por separado, o una “figura”, independientemente de su lugar en la página del documento de salida. . Este es el caso, por ejemplo, de una ilustración para su publicación en Internet. Nuestra API puede ayudarle con la tarea. Hay dos formatos de destino disponibles: PNG y SVG. Al igual que en la representación de fórmulas matemáticas de LaTeX. También debemos tener en cuenta que la representación de figuras LaTeX es una generalización de la representación de fórmulas matemáticas LaTeX.

Cómo renderizar una figura de LaTeX a PNG

Y al igual que con la representación de fórmulas, comenzaremos con un ejemplo. Aquí lo tienes:

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

En primer lugar, creamos una instancia de opciones de renderizado. Lo hacemos aquí junto con la especificación de la resolución de la imagen de salida.

A continuación, especificamos el preámbulo. No hay un preámbulo predeterminado para la representación de figuras en LaTeX, por lo que si desea, por ejemplo, representar algunos gráficos trazados usando el paquete LaTeX pict2e, debe especificarlo en el preámbulo:

\usepackage{pict2e}

Luego le indicamos al renderizador que escale la salida en un 300%.

La siguiente opción define el color de fondo. A diferencia de la representación de fórmulas matemáticas, no especificamos un color de primer plano ya que asumimos que los colores están completamente bajo el control del código LaTeX. De hecho, también lo es el color de fondo, por lo que esta es solo una opción conveniente.

La siguiente línea del ejemplo no tiene mucho sentido. Simplemente demuestra que puede dirigir la salida del registro a alguna secuencia.

Y la última opción ShowTerminal le permite alternar la escritura de la salida del terminal en la consola.

El método que realmente realiza el renderizado es FigureRenderer.render(). Devuelve el tamaño de la figura en puntos.

El método acepta la secuencia donde se escribirá la imagen como segundo argumento. Creamos la secuencia a continuación.

Y finalmente, llamamos al método FigureRenderer.render(), pasando opciones como tercer argumento. El código LaTeX de la figura se pasa como primer argumento.

Las últimas líneas del ejemplo imprimen dos artefactos de la representación de la figura: el tamaño de la figura y el breve informe de errores (en caso de que haya errores).

Aquí está el resultado del renderizado.

Este es el caso de uso más general para la función Representación de figuras LaTeX.

Cómo renderizar una figura de LaTeX a SVG

De la misma manera, podemos renderizar una figura de 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();
}

Las diferencias son:

• Usamos la clase SvgFigureRendererOptions en lugar de PngFigureRendererOptions.
• No especificamos la resolución.
• Usamos la clase SvgFigureRenderer en lugar de PngFigureRenderer.

Aquí está el resultado: