Візуалізація фігур LaTeX | Aspose.TeX для .NET

Іноді вам може знадобитися витягнути деякий вміст із файлу LaTeX як окремо відтворену частину або “фігуру” без будь-якого зв’язку з макетом сторінки. Це може бути ілюстрація до вашої публікації в Інтернеті, наприклад. Ви можете зробити це за допомогою нашого API. Що стосується цільових форматів, то тут є два варіанти - PNG і SVG. Як і у випадку з функцією відтворення математичних формул LaTeX. Варто також зазначити, що Відтворення фігур LaTeX є узагальненням відтворення математичних формул LaTeX.

Як відобразити фігуру LaTeX у форматі PNG

Довідковий розділ API, пов’язаний із цією темою, знаходиться тут. Як і у випадку з відтворенням формул, ми почнемо з прикладу. Ось воно:

// 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.
}

Перш за все, ми створюємо екземпляр LaTeX figure options. Ми робимо це тут, одночасно вказуючи роздільну здатність вихідного зображення.

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

\usepackage{pict2e}

Потім ми наказуємо рендереру масштабувати вихід на 300%.

Наступний параметр визначає колір фону. На відміну від відтворення математичних формул, ми не вказуємо колір переднього плану, оскільки припускаємо, що кольори повністю контролюються кодом LaTeX. Власне, фоновий колір також, тому це лише зручний варіант.

Наступний рядок прикладу не має особливого сенсу. Це просто демонструє, що ви можете спрямувати вихід журналу в якийсь потік.

І остання опція ShowTerminal дозволяє вам перемикати запис виводу терміналу на консоль.

Метод, який фактично виконує візуалізацію, це FigureRenderer.Render(). Він повертає розмір фігури в пунктах.

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

І, нарешті, ми викликаємо сам метод FigureRenderer.Render(), передаючи параметри як третій аргумент. Код LaTeX фігури передається як перший аргумент.

Останні рядки прикладу друкують два артефакти відтворення фігури - розмір фігури та короткий звіт про помилку (якщо помилки є).

Ось результат візуалізації.

Це найзагальніший випадок використання функції LaTeX rendering figure.

Як відобразити фігуру LaTeX у SVG

Приблизно так само ми можемо відобразити фігуру LaTeX у форматі 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.
}

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

• Ми використовуємо клас SvgFigureRendererOptions замість PngFigureRendererOptions.
• Ми не вказуємо роздільну здатність.
• Ми використовуємо клас SvgFigureRenderer замість PngFigureRenderer.

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