Rendu des formules mathématiques LaTeX | Python via .NET

Rendu d’une formule mathématique LaTeX au format PNG

Si nécessaire, jetez un œil à la section de référence API pour ce sujet. En fait, la meilleure façon de démontrer la fonctionnalité de rendu de la formule mathématique LaTeX est de commencer par un exemple. C’est ici:

Définissez ASPOSE_TEX_OUTPUT_DIR sur votre répertoire de sortie ou utilisez le dossier par défaut output. Le code LaTeX est entièrement inclus dans les exemples ; aucun fichier d’entrée externe n’est nécessaire. Appliquez d’abord une licence. Licences.

# Render a highlighted LaTeX math formula to PNG.
import os
from pathlib import Path
from aspose.pydrawing import Color
from aspose.tex.features import PngMathRenderer, PngMathRendererOptions

# Set an output directory, or use the default output folder.
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

# Create rendering options setting the image resolution to 150 dpi.
options = PngMathRendererOptions()
options.resolution = 150
# Specify the preamble.
options.preamble = r"""\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{color}"""
# Specify the scaling factor 300%.
options.scale = 3000
# Leave space around the rendered fragment.
options.margin = 5
# Specify the foreground color.
options.text_color = Color.black
# Specify the background color.
options.background_color = Color.white
# Specify whether to show the terminal output on the console or not.
options.show_terminal = False

# Create binary streams for the rendering log and formula image.
with (output_dir / "math-formula.png.log").open("wb") as log_stream, \
        (output_dir / "math-formula.png").open("wb") as stream:
    options.log_stream = log_stream
    # Run rendering.
    size = PngMathRenderer().render(r"""\begin{equation*}
e^x = x^{\color{red}0} + x^{\color{red}1} + \frac{x^{\color{red}2}}{2} + \frac{x^{\color{red}3}}{6} + \cdots = \sum_{n\geq 0} \frac{x^{\color{red}n}}{n!}
\end{equation*}""", stream, options)

# Show other results.
print(options.error_report or "No rendering errors.")
print()
print(f"Size: {size.width}x{size.height}")

Passons aux détails. Tout d’abord, nous lançons un objet options de rendu, similaire à la composition TeX/LaTeX, qui inclut la spécification de la résolution de l’image de sortie souhaitée.

Ensuite, nous précisons le préambule. Le préambule par défaut est :

\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}

qui offre une prise en charge améliorée des formules mathématiques par rapport au LaTeX standard. Par exemple, vous pouvez inclure le package « color » pour personnaliser la mise en évidence dans la formule, comme démontré dans l’exemple de code fourni.

Nous définissons scale = 3000 pour une échelle de 300 % et margin = 5 pour laisser de l’espace autour du fragment. L’exemple PNG utilise resolution = 150 DPI.

Les deux options suivantes déterminent les couleurs de premier plan et d’arrière-plan. Toutes les parties de la formule qui ne sont pas affectées par la surbrillance personnalisée seront affichées dans la couleur « text_color ».

L’exemple affecte un flux de fichier binaire à log_stream et enregistre le journal dans math-formula.png.log, à côté de math-formula.png. L’instruction with ferme automatiquement les deux flux.

show_terminal contrôle la sortie du terminal dans la console. Les exemples le définissent sur False ; le journal est toujours écrit dans le fichier.

Le processus de rendu proprement dit est effectué par la méthode MathRenderer.render(), qui renvoie la taille de la formule en points.

Le deuxième argument est le flux de sortie binaire ouvert pour l’image. Le troisième fournit les options de rendu.

Et enfin, la méthode MathRenderer.render() est invoquée, les options étant passées comme troisième argument. Le code LaTeX de la formule est fourni comme premier argument.

Les dernières lignes affichent le rapport d’erreurs, ou No rendering errors. s’il est vide, puis la largeur et la hauteur en points.

Voici le résultat du rendu.

Il s’agit de l’application la plus courante et la plus large de la fonctionnalité de rendu de formule mathématique LaTeX.

Vous pouvez également explorer l’ application Web gratuite, qui utilise la fonctionnalité implémentée de l’ API Aspose.TeX pour .NET.

Rendu d’une formule mathématique LaTeX en SVG

De même, nous pouvons convertir une formule mathématique LaTeX au format SVG en utilisant la même approche.

# Render a highlighted LaTeX math formula to SVG.
import os
from pathlib import Path
from aspose.pydrawing import Color
from aspose.tex.features import SvgMathRenderer, SvgMathRendererOptions

# Set an output directory, or use the default output folder.
output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
output_dir.mkdir(parents=True, exist_ok=True)

# Create rendering options.
options = SvgMathRendererOptions()
# Specify the preamble.
options.preamble = r"""\usepackage{amsmath}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{color}"""
# Specify the scaling factor 300%.
options.scale = 3000
# Leave space around the rendered fragment.
options.margin = 5
# Specify the foreground color.
options.text_color = Color.black
# Specify the background color.
options.background_color = Color.white
# Specify whether to show the terminal output on the console or not.
options.show_terminal = False

# Create binary streams for the rendering log and formula image.
with (output_dir / "math-formula.svg.log").open("wb") as log_stream, \
        (output_dir / "math-formula.svg").open("wb") as stream:
    options.log_stream = log_stream
    # Run rendering.
    size = SvgMathRenderer().render(r"""\begin{equation*}
e^x = x^{\color{red}0} + x^{\color{red}1} + \frac{x^{\color{red}2}}{2} + \frac{x^{\color{red}3}}{6} + \cdots = \sum_{n\geq 0} \frac{x^{\color{red}n}}{n!}
\end{equation*}""", stream, options)

# Show other results.
print(options.error_report or "No rendering errors.")
print()
print(f"Size: {size.width}x{size.height}")

Cet exemple crée math-formula.svg et son journal math-formula.svg.log dans le même répertoire de sortie.

Les différences sont :

• Au lieu d’utiliser la classe PngMathRendererOptions, nous utilisons la classe SvgMathRendererOptions.
• Nous ne précisons pas la résolution.
• Au lieu d’utiliser la classe PngMathRenderer, nous utilisons la classe SvgMathRenderer.

Voici le résultat :

Vous pouvez également explorer l’ application Web gratuite, qui utilise la fonctionnalité implémentée de l’ API Aspose.TeX pour .NET.