LaTeX в изображение | Java

Как конвертировать LaTeX в PNG

Давайте подробнее рассмотрим код Java, обеспечивающий самый простой способ преобразования LaTeX в формат PNG.

Задайте в inputFile полный путь к файлу LaTeX, например hello-world.ltx, а в outputDirectory — существующую папку вывода. Импортируйте используемые в примере классы из com.aspose.tex и com.aspose.tex.rendering. Вызывающий метод должен обрабатывать или объявлять исключения. Примените лицензию согласно руководству по лицензированию, чтобы избежать ограничений ознакомительной версии. Пример использует неинтерактивный режим и закрывает ресурсы вывода. В PNG-примере задано разрешение 300 DPI. Для одностраничного файла hello-world.ltx автоматически создаётся hello-world.png, hello-world.jpg, hello-world.tif, hello-world.bmp или hello-world.svg в зависимости от выбранного формата.

// Convert LaTeX to PNG.
// inputFile is the full input path; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setOutputWorkingDirectory(output);
PngSaveOptions saveOptions = new PngSaveOptions();
saveOptions.setResolution(300);
options.setSaveOptions(saveOptions);
options.setInteraction(Interaction.NonstopMode);

ImageDevice device = new ImageDevice();
TeXJobResult result;
try {
    result = new TeXJob(inputFile, device, options).run();
} finally {
    device.dispose();
    output.close();
}

Итак, первое, что нам нужно сделать (иногда не самое первое, как мы узнаем позже) — это создать экземпляр класса TeXOptions. Единственный статический метод, который это делает, — consoleAppOptions(), поэтому не будем заморачиваться над значением его имени. Метод принимает экземпляр objectLaTeX() класса TeXConfig, который точно подходит для преобразования файла LaTeX. Эта конфигурация предписывает механизму Object TeX загрузить формат Object LaTeX и быть готовым принять файл LaTeX. Формат Object LaTeX на самом деле представляет собой формат LaTeX, за исключением того, что он использует специальные примитивы Object TeX для настройки показателей страницы.

Первая из обязательных опций — OutputWorkingDirectory, которая определяет пространство или область, куда будет записываться вывод TeX. Здесь приведены подробные сведения о концепции выходного каталога в Aspose.TeX для Java. В этом примере мы используем класс OutputFileSystemDirectory, который позволяет нам записывать выходные данные в указанный каталог или папку.

Второй вариант — это экземпляр класса SaveOptions, который будет управлять преобразованием объектной модели в целевой формат. Поскольку мы конвертируем LaTeX в PNG, именно экземпляр класса PngSaveOptions позволяет нам указать разрешение выходных изображений.

Далее нам нужно создать экземпляр класса TeXJob. Желая преобразовать файл LaTeX, хранящийся в файловой системе, мы используем эту версию конструктора. Нам следует указать полный путь к файлу. В противном случае движок будет искать его в текущем каталоге (который определен здесь) и, скорее всего, не найдет. Тем не менее, мы можем опустить расширение, если наш файл имеет расширение .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.

Остальные продукты запуска движка мы найдем в папке, которую мы указали в качестве выходного каталога. Это будет файл стенограммы (.log) и, Вуаля!, основные выходные файлы изображений PNG.

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

Есть еще один способ получить данные изображения в виде массива байтовых массивов: каждый массив во втором измерении представляет данные изображения для отдельной страницы.

// Convert LaTeX to PNG and save each page from the returned byte arrays.
// inputFile is the full input path; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setOutputWorkingDirectory(output);
PngSaveOptions saveOptions = new PngSaveOptions();
saveOptions.deviceWritesImages(false);
options.setSaveOptions(saveOptions);
options.setInteraction(Interaction.NonstopMode);

ImageDevice device = new ImageDevice();
TeXJobResult result;
try {
    result = new TeXJob(inputFile, device, options).run();
    byte[][] pages = device.getResult();
    for (int i = 0; i < pages.length; i++) {
        Files.write(Paths.get(outputDirectory, "page-" + (i + 1) + ".png"), pages[i]);
    }
} finally {
    device.dispose();
    output.close();
}

Пример ручного сохранения также требует java.nio.file.Files и java.nio.file.Paths. Он сохраняет данные страниц из ImageDevice.getResult() как page-1.png, page-2.png и так далее. Поскольку задано deviceWritesImages(false), автоматическая запись PNG отключена и вручную сохранённые страницы не дублируются в выходном каталоге. Это отличается от записи PDF в поток, где поток задаёт путь вывода одного PDF-документа.

О параметрах ввода

Если наш основной входной файл требует зависимостей, например, пакетов, которые не включены в базовую систему LaTeX и поддерживаемых пакетов, мы ДОЛЖНЫ установить параметр RequiredInputDirectory аналогично тому, как мы устанавливаем параметр OutputWorkingDirectory. и поместите зависимости в этот каталог. Зависимости могут быть произвольно организованы в подкаталогах. Если у нас есть собственные файлы, которые нужно включить в процесс верстки, скажем, внешние графические файлы, мы ДОЛЖНЫ также установить InputWorkingDirectory, используя путь к месту, где собраны эти файлы. Мы также можем поместить основной входной файл где-нибудь внутри входного каталога и передать относительный путь в конструктор TeXJob (или вообще не указывать путь, если основной входной файл находится в корне). Здесь приведены подробные сведения о концепции входного каталога в Aspose.TeX для Java и предоставленных реализациях.

Другие варианты работы в TeX обсуждаются здесь.

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

Ниже мы обсудим преобразование LaTeX в другие поддерживаемые форматы растровых изображений. Мы не будем вдаваться в подробности только потому, что на самом деле никаких подробностей нет. Единственная разница заключается в типе свойства SaveOptions в параметрах преобразования.

Как конвертировать LaTeX в JPG

// Convert LaTeX to JPEG.
// inputFile is the full input path; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setOutputWorkingDirectory(output);
options.setSaveOptions(new JpegSaveOptions());
options.setInteraction(Interaction.NonstopMode);

ImageDevice device = new ImageDevice();
TeXJobResult result;
try {
    result = new TeXJob(inputFile, device, options).run();
} finally {
    device.dispose();
    output.close();
}

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

Как конвертировать LaTeX в TIFF

// Convert LaTeX to TIFF.
// inputFile is the full input path; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setOutputWorkingDirectory(output);
options.setSaveOptions(new TiffSaveOptions());
options.setInteraction(Interaction.NonstopMode);

ImageDevice device = new ImageDevice();
TeXJobResult result;
try {
    result = new TeXJob(inputFile, device, options).run();
} finally {
    device.dispose();
    output.close();
}

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

Как конвертировать LaTeX в BMP

// Convert LaTeX to BMP.
// inputFile is the full input path; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setOutputWorkingDirectory(output);
options.setSaveOptions(new BmpSaveOptions());
options.setInteraction(Interaction.NonstopMode);

ImageDevice device = new ImageDevice();
TeXJobResult result;
try {
    result = new TeXJob(inputFile, device, options).run();
} finally {
    device.dispose();
    output.close();
}

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

Как конвертировать LaTeX в SVG

И еще один поддерживаемый целевой формат — SVG. Масштабируемая векторная графика (SVG) — это формат векторных изображений на основе XML для определения двумерной графики с поддержкой интерактивности и анимации.

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

Кроме того, существует библиотека Aspose.SVG, которая имеет различные функции, основанные на формате SVG. К ним относятся создание, загрузка, редактирование и преобразование документов SVG.

Преобразование в SVG так же просто, как и преобразование в форматы растровых изображений, за исключением того, что в дополнение к SaveOptions нам нужно изменить устройство на экземпляр SvgDevice.

// Convert LaTeX to SVG.
// inputFile is the full input path; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setOutputWorkingDirectory(output);
options.setSaveOptions(new SvgSaveOptions());
options.setInteraction(Interaction.NonstopMode);

SvgDevice device = new SvgDevice();
TeXJobResult result;
try {
    result = new TeXJob(inputFile, device, options).run();
} finally {
    device.dispose();
    output.close();
}

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