Рендеринг математических формул LaTeX | Python через .NET

Преобразование математической формулы LaTeX в PNG

При необходимости ознакомьтесь с разделом ссылок на API для этой темы. Фактически, лучший способ продемонстрировать функцию рендеринга математической формулы LaTeX — начать с примера. Вот:

Укажите выходной каталог в ASPOSE_TEX_OUTPUT_DIR либо используйте папку output по умолчанию. Весь код LaTeX включён в примеры; внешние входные файлы не требуются. Предварительно примените лицензию. Лицензирование.

# 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}")

Давайте перейдем к деталям. Во-первых, мы инициируем объект параметры рендеринга, аналогичный набору текста TeX/LaTeX, который включает в себя спецификацию желаемого разрешения выходного изображения.

Далее уточняем преамбулу. Преамбула по умолчанию:

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

который предлагает расширенную поддержку математических формул по сравнению со стандартным LaTeX. Например, вы можете включить пакет «color», чтобы настроить выделение в формуле, как показано в приведенном примере кода.

Задаём scale = 3000 для масштаба 300% и margin = 5, чтобы оставить поля вокруг фрагмента. Пример PNG использует resolution = 150 DPI.

Следующие два параметра определяют цвета переднего плана и фона. Любые части формулы, на которые не влияет пользовательское выделение, будут отображаться цветом text_color.

Пример присваивает двоичный файловый поток свойству log_stream и сохраняет журнал в math-formula.png.log рядом с math-formula.png. Конструкция with автоматически закрывает оба потока.

Параметр show_terminal управляет выводом терминала в консоль. В примерах он равен False; журнал при этом записывается в файл.

Сам процесс рендеринга осуществляется методом MathRenderer.render(), который возвращает размер формулы в пунктах.

Второй аргумент — двоичный выходной поток, открытый для изображения. Третий аргумент содержит параметры рендеринга.

И, наконец, вызывается метод MathRenderer.render(), параметры которого передаются в качестве третьего аргумента. Код формулы LaTeX предоставляется в качестве первого аргумента.

Последние строки выводят отчёт об ошибках либо No rendering errors., если отчёт пуст, а затем ширину и высоту в пунктах.

Вот результат рендеринга.

Это наиболее распространенное и широкое применение функции рендеринга математических формул LaTeX.

Вы также можете изучить бесплатное веб-приложение, в котором используется реализованная функция Aspose.TeX for .NET API.

Преобразование математической формулы LaTeX в SVG

Точно так же мы можем преобразовать математическую формулу LaTeX в формат SVG, используя тот же подход.

# 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}")

Этот пример создаёт math-formula.svg и журнал math-formula.svg.log в том же выходном каталоге.

Отличия заключаются в следующем:

• Вместо использования класса PngMathRendererOptions мы используем класс SvgMathRendererOptions.
• Мы не указываем разрешение.
• Вместо использования класса PngMathRenderer мы используем класс SvgMathRenderer.

Вот результат:

Вы также можете изучить бесплатное веб-приложение, в котором используется реализованная функция Aspose.TeX for .NET API.