LaTeX в изображение | Aspose.TeX для C++

Aspose.TeX for C++ также позволяет нам конвертировать файлы LaTeX в ряд других форматов растровых изображений.

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

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

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

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

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

Далее нам нужно создать экземпляр класса TeXJob. Желая преобразовать файл LaTeX, хранящийся в файловой системе, мы используем эту версию конструктора. Нам нужно указать полный путь к файлу. В противном случае движок будет искать его в текущем каталоге (то есть CurrentDirectory) и, скорее всего, не найдет. Тем не менее, мы можем опустить расширение, если наш файл имеет расширение .tex. Движок добавит его автоматически. Второй аргумент конструктора — это экземпляр класса Device. Поскольку мы конвертируем LaTeX в PNG, это экземпляр класса ImageDevice (который является общим для всех поддерживаемых форматов изображений). В качестве последнего аргумента мы передаем недавно подготовленные варианты конвертации.

Все, что осталось сделать сейчас, это запустить задание.

Независимо от того, был ли запуск успешным или нет, первым результатом, который мы увидим, будет вывод терминала. В случае успеха это выглядит примерно так:

 1This is ObjectTeX, Version 3.1415926-1.0 (Aspose.TeX 21.8)
 2entering extended mode
 3
 4(<input_directory>\hello-world.ltx
 5LaTeX2e <2011/06/27>
 6(article.cls
 7Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
 8(size10.clo))
 9No file hello-world.aux.
10[1]
11(<output_directory>\hello-world.aux) )
12Output written on hello-world.png (1 page).
13Transcript written on hello-world.log.

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

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

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

 1    // Create conversion options for Object LaTeX format on Object TeX engine extension.
 2    System::SharedPtr<TeXOptions> options = TeXOptions::ConsoleAppOptions(TeXConfig::get_ObjectLaTeX());
 3    // Specify the file system working directory for the output.
 4    options->set_OutputWorkingDirectory(System::MakeObject<OutputFileSystemDirectory>(RunExamples::OutputDirectory));
 5    // Initialize the options for saving in PNG format.
 6    options->set_SaveOptions(System::MakeObject<PngSaveOptions>());
 7    // Run LaTeX to PNG conversion.
 8    System::SharedPtr<ImageDevice> device = System::MakeObject<ImageDevice>();
 9    System::MakeObject<TeXJob>(System::IO::Path::Combine(RunExamples::InputDirectory, u"hello-world.ltx"), device, options)->Run();
10    
11    // Save pages file by file.
12    for (int32_t i = 0; i < device->get_Result()->get_Length(); i++)
13    {
14        {
15            System::SharedPtr<System::IO::Stream> fs = System::IO::File::Open(System::IO::Path::Combine(RunExamples::OutputDirectory, System::String(u"page-") + (i + 1) + u".png"), System::IO::FileMode::Create);
16            // Clearing resources under 'using' statement
17            System::Details::DisposeGuard<1> __dispose_guard_0({ fs});
18            // ------------------------------------------
19            
20            try
21            {
22                fs->Write(device->get_Result()[i], 0, device->get_Result()[i]->get_Length());
23            }
24            catch(...)
25            {
26                __dispose_guard_0.SetCurrentException(std::current_exception());
27            }
28        }
29    }

Файл(ы) “page-n.png” будут записаны по любому указанному нами пути. В отличие от Вывод PDF, они будут дублировать выходные файлы PNG, записанные в выходной каталог.

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

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

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

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

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

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

1...
2// Initialize the options for saving in JPEG format.
3options->set_SaveOptions(System::MakeObject<JpegSaveOptions>());

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

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

1...
2// Initialize the options for saving in TIFF format.
3options->set_SaveOptions(System::MakeObject<TiffSaveOptions>());

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

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

1...
2// Initialize the options for saving in BMP format.
3options->set_SaveOptions(System::MakeObject<BmpSaveOptions>());

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

Конверсия LaTeX в PDF