LaTeX до зображення | Aspose.TeX для .NET

Aspose.TeX для .NET дозволяє нам конвертувати файли LaTeX у декілька форматів растрових зображень.

Як конвертувати LaTeX у PNG

Давайте детально розглянемо код у C#, що забезпечує найпростіший спосіб конвертації LaTeX у формат PNG.

// Create conversion options for Object LaTeX format upon Object TeX engine extension.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectLaTeX);
// Specify a file system working directory for the output.
options.OutputWorkingDirectory = new OutputFileSystemDirectory(RunExamples.OutputDirectory);
// Initialize the options for saving in PNG format.
options.SaveOptions = new PngSaveOptions();
// Run LaTeX to PNG conversion.
new TeXJob(Path.Combine(RunExamples.InputDirectory, "hello-world.ltx"), new ImageDevice(), options).Run();

Отже, перше, що нам потрібно зробити (ну, іноді не перше), це створити екземпляр класу TeXOptions. Єдиним статичним методом, який це робить, є ConsoleAppOptions(), тож давайте не будемо спантеличуватися значенням його назви. Метод використовує екземпляр ObjectLaTeX класу TeXConfig, який точно підходить для перетворення файлу LaTeX. Ця конфігурація повідомляє механізму Object TeX завантажити формат Object LaTeX і бути готовим прийняти файл LaTeX. Формат Object LaTeX насправді є лише форматом LaTeX, за винятком того, що він використовує специфічні примітиви Object TeX для налаштування показників сторінки.

Першим із необхідних параметрів є OutputWorkingDirectory, який визначає простір або область, куди буде записаний вихід TeX. Тут наведено подробиці про концепцію вихідного каталогу в Aspose.TeX для .NET. У цьому прикладі ми використовуємо клас OutputFileSystemDirectory, який дозволяє записувати вихідні дані у вказаний каталог або папку.

Другий варіант — екземпляр класу SaveOptions, який керуватиме перетворенням об’єктної моделі у цільовий формат. Оскільки ми перетворюємо LaTeX у PNG, це екземпляр класу PngSaveOptions, який дозволяє нам вказати роздільну здатність вихідних зображень.

Потім нам потрібно створити екземпляр класу TeXJob. Бажаючи перетворити файл LaTeX, що зберігається у файловій системі, ми використовуємо this версію конструктора. Нам потрібно вказати повний шлях до файлу. Інакше механізм шукатиме його в поточному каталозі (це CurrentDirectory) і, швидше за все, не знайде. Проте розширення .tex можна опустити. Механізм додасть його автоматично. Другим аргументом конструктора є екземпляр класу Device. Оскільки ми перетворюємо LaTeX у PNG, це екземпляр класу ImageDevice, і це є спільним для всіх підтримуваних форматів зображень. В якості останнього аргументу ми передаємо нещодавно підготовлені параметри конвертації.

Все, що залишилося зробити зараз, це запустити роботу.

Незалежно від того, чи був запуск успішним чи ні, першим результатом, який ми побачимо, буде вихід терміналу. Якщо запуск пройшов успішно, це буде виглядати приблизно так:

This is ObjectTeX, Version 3.1415926-1.0 (Aspose.TeX 21.8)
entering extended mode

(<input_directory>\hello-world.ltx
LaTeX2e <2011/06/27>
(article.cls
Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
(size10.clo))
No file hello-world.aux.
[1]
(<output_directory>\hello-world.aux) )
Output written on hello-world.png (1 page).
Transcript written on hello-world.log.

Інші «плоди» праці движка ми знайдемо в папці, яку ми вказали як вихідний каталог. Це буде файл стенограми та, ось він!, основний вихідний(і) файл(и) зображень PNG.

Альтернативний спосіб запису основних вихідних файлів PNG

Існує інший спосіб отримати дані зображення у вигляді масиву масивів байтів, кожен масив у другому вимірі представляє дані зображення для окремої сторінки.

// Create conversion options instance.
...
// Initialize the options for saving in PNG format.
PngSaveOptions pngSaveOptions = new PngSaveOptions();
pngSaveOptions.DeviceWritesImages = false;
options.SaveOptions = pngSaveOptions;
// Create the image device.
ImageDevice device = new ImageDevice();
// Run LaTeX to PNG conversion.
new TeXJob(Path.Combine(RunExamples.InputDirectory, "hello-world.ltx"), device, options).Run();

// Save pages file by file.
for (int i = 0; i < device.Result.Length; i++)
{
    using (Stream fs = File.Open(Path.Combine(RunExamples.OutputDirectory, $"page-{i + 1}.png"), FileMode.Create))
        fs.Write(device.Result[i], 0, device.Result[i].Length);
}

Файл(и) “page-n.png” буде записаний у будь-який шлях, який ми вкажемо. На відміну від PDF output, вони дублюватимуть вихідні файли PNG, записані у вихідний каталог.

Про параметри введення

Якщо наш головний вхідний файл потребує залежностей, наприклад, пакетів, які не входять до базової системи LaTeX і підтримуваних пакетів, ми ПОВИННІ встановити опцію RequiredInputDirectory так само, як ми встановлюємо OutputWorkingDirectory і помістіть залежності в цей каталог. Залежності можуть бути довільно організовані в підкаталоги. Якщо у нас є власні файли для включення в процес верстки, скажімо, зовнішні графічні файли, ми ПОВИННІ також встановити InputWorkingDirectory, використовуючи шлях до розташування, де ці файли зібрано. Ми також можемо розмістити основний вхідний файл десь усередині вхідного каталогу та вказати відносний шлях у методі run() (або не вказати шлях взагалі, якщо головний вхідний файл знаходиться в корені). Тут наведено деталі про концепцію каталогу введення в Aspose.TeX для .NET і надані реалізації.

Інші варіанти завдань TeX обговорюються тут.

Ви також можете ознайомитися з безкоштовною [веб-програмою] для перетворення LaTeX у PNG (26), створеною на основі Aspose.TeX для .NET API.

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

Як конвертувати LaTeX у JPG

// Create conversion options instance.
...
// Initialize the options for saving in JPEG format.
options.SaveOptions = new JpegSaveOptions();

Ви також можете ознайомитися з безкоштовною [веб-програмою] для перетворення LaTeX на JPG (29), створеною на основі Aspose.TeX для .NET API.

Як конвертувати LaTeX у TIFF

// Create conversion options instance.
...
// Initialize the options for saving in TIFF format.
options.SaveOptions = new TiffSaveOptions();

Ви також можете ознайомитися з безкоштовним [веб-програмою] для перетворення LaTeX у TIFF (31), створеним на основі Aspose.TeX для .NET API.

Як конвертувати LaTeX у BMP

// Create conversion options instance.
...
// Initialize the options for saving in BMP format.
options.SaveOptions = new BmpSaveOptions();

Ви також можете ознайомитися з безкоштовною [веб-програмою] для перетворення LaTeX у BMP (33), створеною на основі Aspose.TeX для .NET API.

Як конвертувати LaTeX у SVG

І ще одним підтримуваним цільовим форматом є SVG. Масштабована векторна графіка (SVG) — це формат векторних зображень на основі XML для визначення двовимірної графіки з підтримкою інтерактивності та анімації.

Зображення SVG визначаються у форматі векторної графіки та зберігаються в текстових файлах XML. Таким чином зображення SVG можна масштабувати без втрати якості, а файли SVG можна шукати, індексувати, створювати сценарії та стискати. Текстові XML-файли можна створювати та редагувати за допомогою текстових редакторів або редакторів векторної графіки, і вони відображаються найбільш використовуваними веб-браузерами.

Існує бібліотека Aspose.SVG, яка надає різні функції, пов’язані з SVG. Це включає створення, завантаження, редагування та конвертацію документів SVG.

Перетворення LaTeX у SVG також таке ж просте, як перетворення у формати растрових зображень, за винятком того, що SaveOptions ПОВИНЕН бути встановлений на екземпляр класу SvgSaveOptions, а пристрій ПОВИНЕН бути змінено на екземпляр класу SvgDevice.

// Create conversion options for Object LaTeX format upon Object TeX engine extension.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectLaTeX);
// Specify a file system working directory for the output.
options.OutputWorkingDirectory = new OutputFileSystemDirectory(RunExamples.OutputDirectory);
// Initialize the options for saving in SVG format.
options.SaveOptions = new SvgSaveOptions();
// Run LaTeX to SVG conversion.
new TeXJob(Path.Combine(RunExamples.InputDirectory, "hello-world.ltx"), new PdfDevice(), options).Run();

Ви також можете ознайомитися з безкоштовною [веб-програмою] для перетворення LaTeX у SVG (41), створеною на основі Aspose.TeX для .NET API.