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

Как преобразовать математическую формулу LaTeX в PNG

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

// Create rendering options setting the image resolution 150 dpi.
PngMathRendererOptions options = new PngMathRendererOptions();
options.setResolution(150);
// Specify the preamble.
options.setPreamble("\\usepackage{amsmath}\r\n\\usepackage{amsfonts}\r\n\\usepackage{amssymb}\r\n\\usepackage{color}");
// Specify the scaling factor 300%.
options.setScale(3000);
// Specify the foreground color.
options.setTextColor(Color.BLACK);
// 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 formula image.
final OutputStream stream = new FileOutputStream(Utils.getOutputDirectory() + "math-formula.png");
try {
    // Run rendering.
    com.aspose.tex.Size2D size = MathRenderer.render("\\begin{equation*}\r\n" +
       "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!}\r\n" +
       "\\end{equation*}", 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();
}

Давайте перейдем к деталям. Прежде всего, мы создаем экземпляр параметры рендеринга, аналогичный набору текста TeX/LaTeX. Мы делаем это здесь, одновременно указывая разрешение выходного изображения.

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

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

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

Затем мы указываем рендереру масштабировать результат на 300%.

Следующие два параметра определяют цвета переднего плана и фона. Те части формулы, которые не покрыты («окрашены») пользовательской подсветкой, будут отображаться цветом TextColor.

Следующая строка примера не имеет особого смысла. Это просто демонстрирует, что вы можете направить вывод журнала в какой-то поток.

И последняя опция «ShowTerminal» позволяет вам переключать запись вывода терминала на консоль.

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

Поток, в который должно быть записано изображение, принимается методом в качестве второго аргумента. Далее мы создаем поток.

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

В последних строках примера выводятся два артефакта отрисовки математической формулы — размер формулы и краткий отчет об ошибке (на случай, если были ошибки).

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

Это наиболее общий вариант использования рендеринга математической формулы LaTeX.

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

Как преобразовать математическую формулу LaTeX в SVG

Практически таким же образом мы можем преобразовать математическую формулу LaTeX в формат SVG.

// Create rendering options.
MathRendererOptions options = new SvgMathRendererOptions();
// Specify the preamble.
options.setPreamble("\\usepackage{amsmath}\r\n\\usepackage{amsfonts}\r\n\\usepackage{amssymb}\r\n\\usepackage{color}");
// Specify the scaling factor 300%.
options.setScale(3000);
// Specify the foreground color.
options.setTextColor(Color.BLACK);
// 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 formula image.
final OutputStream stream = new FileOutputStream(Utils.getOutputDirectory() + "math-formula.svg");
try {
    // Run rendering.
    com.aspose.tex.Size2D size = new SvgMathRenderer().render("\\begin{equation*}\r\n" +
        "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!}\r\n" +
        "\\end{equation*}", stream, options, size);
    
    // 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();
}

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

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

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

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