Відтворення математичних формул LaTeX | Python через .NET

Відтворення математичної формули LaTeX у форматі PNG

За потреби перегляньте довідковий розділ API для цієї теми. Насправді, найкращий спосіб продемонструвати функцію відтворення математичної формули LaTeX — почати з прикладу. Ось воно:

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

 1# Render a highlighted LaTeX math formula to PNG.
 2import os
 3from pathlib import Path
 4from aspose.pydrawing import Color
 5from aspose.tex.features import PngMathRenderer, PngMathRendererOptions
 6
 7# Set an output directory, or use the default output folder.
 8output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
 9output_dir.mkdir(parents=True, exist_ok=True)
10
11# Create rendering options setting the image resolution to 150 dpi.
12options = PngMathRendererOptions()
13options.resolution = 150
14# Specify the preamble.
15options.preamble = r"""\usepackage{amsmath}
16\usepackage{amsfonts}
17\usepackage{amssymb}
18\usepackage{color}"""
19# Specify the scaling factor 300%.
20options.scale = 3000
21# Leave space around the rendered fragment.
22options.margin = 5
23# Specify the foreground color.
24options.text_color = Color.black
25# Specify the background color.
26options.background_color = Color.white
27# Specify whether to show the terminal output on the console or not.
28options.show_terminal = False
29
30# Create binary streams for the rendering log and formula image.
31with (output_dir / "math-formula.png.log").open("wb") as log_stream, \
32        (output_dir / "math-formula.png").open("wb") as stream:
33    options.log_stream = log_stream
34    # Run rendering.
35    size = PngMathRenderer().render(r"""\begin{equation*}
36e^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!}
37\end{equation*}""", stream, options)
38
39# Show other results.
40print(options.error_report or "No rendering errors.")
41print()
42print(f"Size: {size.width}x{size.height}")

Перейдемо до деталей. По-перше, ми ініціюємо об’єкт параметри візуалізації, подібний до набору тексту TeX/LaTeX, який містить специфікацію для бажаної роздільної здатності вихідного зображення.

Далі уточнюємо преамбулу. Типова преамбула:

1\usepackage{amsmath}
2\usepackage{amsfonts}
3\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 у форматі PNG

Це найбільш поширене та широке застосування функції відтворення математичних формул LaTeX.

Ви також можете дослідити безкоштовну веб-програму, яка використовує реалізовану функцію Aspose.TeX для .NET API.

Відтворення математичної формули LaTeX у SVG

Так само ми можемо перетворити математичну формулу LaTeX у формат SVG, використовуючи той самий підхід.

 1# Render a highlighted LaTeX math formula to SVG.
 2import os
 3from pathlib import Path
 4from aspose.pydrawing import Color
 5from aspose.tex.features import SvgMathRenderer, SvgMathRendererOptions
 6
 7# Set an output directory, or use the default output folder.
 8output_dir = Path(os.environ.get("ASPOSE_TEX_OUTPUT_DIR", "output")).resolve()
 9output_dir.mkdir(parents=True, exist_ok=True)
10
11# Create rendering options.
12options = SvgMathRendererOptions()
13# Specify the preamble.
14options.preamble = r"""\usepackage{amsmath}
15\usepackage{amsfonts}
16\usepackage{amssymb}
17\usepackage{color}"""
18# Specify the scaling factor 300%.
19options.scale = 3000
20# Leave space around the rendered fragment.
21options.margin = 5
22# Specify the foreground color.
23options.text_color = Color.black
24# Specify the background color.
25options.background_color = Color.white
26# Specify whether to show the terminal output on the console or not.
27options.show_terminal = False
28
29# Create binary streams for the rendering log and formula image.
30with (output_dir / "math-formula.svg.log").open("wb") as log_stream, \
31        (output_dir / "math-formula.svg").open("wb") as stream:
32    options.log_stream = log_stream
33    # Run rendering.
34    size = SvgMathRenderer().render(r"""\begin{equation*}
35e^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!}
36\end{equation*}""", stream, options)
37
38# Show other results.
39print(options.error_report or "No rendering errors.")
40print()
41print(f"Size: {size.width}x{size.height}")

Цей приклад створює math-formula.svg і журнал math-formula.svg.log у тому самому вихідному каталозі.

Відмінності:

Ось результат:

Відтворення математичної формули LaTeX у SVG

Ви також можете дослідити безкоштовну веб-програму, яка використовує реалізовану функцію Aspose.TeX для .NET API.