Rendu de figures LaTeX | Aspose.TeX pour .NET

Parfois, vous souhaiterez peut-être extraire du contenu d’un fichier LaTeX sous la forme d’un élément rendu séparément, ou d’une “figure”, sans aucune connexion avec la mise en page. Il peut s’agir d’une illustration pour votre publication sur Internet par exemple. Vous pouvez le faire avec notre API. Quant aux formats cibles, il existe deux options : PNG et SVG. Comme c’est le cas avec la fonctionnalité de rendu de formules mathématiques LaTeX. Il convient également de noter que le rendu de figures LaTeX est une généralisation du rendu de formule mathématique LaTeX.

Comment rendre une figure LaTeX en PNG

La section de référence de l’API liée à ce sujet est ici. Et comme pour le rendu de formule, nous commencerons par un exemple. C’est ici:

// Create rendering options setting the image resolution to 150 dpi.
PngFigureRendererOptions options = new PngFigureRendererOptions();
options.Resolution = 150;
// Specify the preamble.
options.Preamble = "\\usepackage{pict2e}";
// Specify the scaling factor 300%.
options.Scale = 3000;
// Specify the background color.
options.BackgroundColor = System.Drawing.Color.White;
// Specify the output stream for the log file.
options.LogStream = new System.IO.MemoryStream();
// Specify whether to show the terminal output on the console or not.
options.ShowTerminal = true;

// Create the output stream for the figure image.
using (System.IO.Stream stream = System.IO.File.Open(
    System.IO.Path.Combine(RunExamples.OutputDirectory, "text-and-formula.png"), System.IO.FileMode.Create))
{
    // Run rendering.
    System.Drawing.SizeF size = new PngFigureRenderer().Render(@"\setlength{\unitlength}{0.8cm}
\begin{picture}(6,5)
\thicklines
\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$}
\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}$}
\end{picture}", stream, options);
    
    // Show other results.
    System.Console.Out.WriteLine(options.ErrorReport);
    System.Console.Out.WriteLine();
    System.Console.Out.WriteLine("Size: " + size); // Dimensions of the resulting image.
}

Tout d’abord, nous créons une instance LaTeX figure options. Nous le faisons ici simultanément en spécifiant la résolution de l’image de sortie.

Ensuite, nous précisons le préambule. Il n’y a pas de préambule par défaut pour le rendu des figures LaTeX, donc si vous souhaitez, par exemple, restituer des graphiques tracés à l’aide du package LaTeX pict2e, vous devez le spécifier dans le préambule :

\usepackage{pict2e}

Ensuite, nous demandons au moteur de rendu de mettre à l’échelle la sortie de 300 %.

L’option suivante définit la couleur d’arrière-plan. Contrairement au rendu de formules mathématiques, nous ne spécifions pas de couleur de premier plan puisque nous supposons que les couleurs sont entièrement sous le contrôle du code LaTeX. En fait, la couleur d’arrière-plan l’est également, ce n’est donc qu’une option pratique.

La ligne suivante de l’exemple n’a pas beaucoup de sens. Cela démontre simplement que vous pouvez diriger la sortie du journal vers un flux.

Et la dernière option « ShowTerminal » vous permet d’écrire la sortie du terminal sur la console.

La méthode qui effectue réellement le rendu est FigureRenderer.Render(). Il renvoie la taille de la figure en points.

Le flux dans lequel l’image doit être écrite est accepté par la méthode comme deuxième argument. Nous créons ensuite le flux.

Et enfin, nous appelons la méthode FigureRenderer.Render() elle-même, en passant les options comme troisième argument. Le code LaTeX de la figure est passé en premier argument.

Les dernières lignes de l’exemple impriment deux artefacts de rendu de figure : la taille de la figure et le bref rapport d’erreur (en cas d’erreurs).

Voici le résultat du rendu.

Il s’agit du cas d’utilisation le plus général de la fonctionnalité Rendu de figures LaTeX.

Comment rendre une figure LaTeX en SVG

De la même manière, nous pouvons restituer une figure LaTeX au format SVG.

// Create rendering options.
FigureRendererOptions options = new SvgFigureRendererOptions();
// Specify the preamble.
options.Preamble = "\\usepackage{pict2e}";
// Specify the scaling factor 300%.
options.Scale = 3000;
// Specify the background color.
options.BackgroundColor = System.Drawing.Color.White;
// Specify the output stream for the log file.
options.LogStream = new System.IO.MemoryStream();
// Specify whether to show the terminal output on the console or not.
options.ShowTerminal = true;

// Create the output stream for the figure image.
using (System.IO.Stream stream = System.IO.File.Open(
    System.IO.Path.Combine(RunExamples.OutputDirectory, "text-and-formula.svg"), System.IO.FileMode.Create))
{
    // Run rendering.
    System.Drawing.SizeF size = new SvgFigureRenderer().Render(@"\setlength{\unitlength}{0.8cm}
\begin{picture}(6,5)
\thicklines
\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$}
\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}$}
\end{picture}", stream, options);
    
    // Show other results.
    System.Console.Out.WriteLine(options.ErrorReport);
    System.Console.Out.WriteLine();
    System.Console.Out.WriteLine("Size: " + size); // Dimensions of the resulting image.
}

Les différences sont :

• Nous utilisons la classe SvgFigureRendererOptions au lieu de PngFigureRendererOptions.
• Nous ne précisons pas la résolution.
• Nous utilisons la classe SvgFigureRenderer au lieu de PngFigureRenderer.

Voici le résultat :