This interesting topic provides demonstration on how to render LaTeX to PNG using C++. We also call the LaTeX files as .tex files and one may easily render LaTeX to PNG in C++ with simple API properties and methods. One good thing about using this example is that API calls are not dependent on any other application software or third party tools for their execution.
Steps to Render LaTeX to PNG using C++
- Install Aspose.Tex.Cpp using NuGet package Manager tool
- Include reference to Aspose::TeX, Aspose::TeX::IO and Aspose::TeX::Presentation::Image namespaces
- Instantiate TeXOptions Class object for setting configurations
- Instantiate PngSaveOptions Class object for saving LaTeX to PNG image
- Initialize the ImageDevice for rendering
- Use TexJob for rendering LaTeX to PNG image
LaTeX documents are meant for scientific and research purpose that can be used by technical users and contain information in plain text form. In order to export LaTeX to PNG image in C++, we will first create an instance of TeXOptions class for setting configurations involving input directory, output directory and console options. In subsequent steps, we will set PngSaveOptions properties like image resolution. Finally, we will initialize ImageDevice and by using TexJob render LaTeX to PNG image using C++.
Code to Convert LaTeX to PNG in C++
| #pragma once | |
| #include <system/text/encoding.h> | |
| #include <system/io/text_writer.h> | |
| #include <system/io/memory_stream.h> | |
| #include <system/array.h> | |
| #include <Aspose.TeX.Cpp/TeXOptions.h> | |
| #include <Aspose.TeX.Cpp/TeXConfig.h> | |
| #include <Aspose.TeX.Cpp/TeXJob.h> | |
| #include <Aspose.TeX.Cpp/Presentation/SaveOptions.h> | |
| #include <Aspose.TeX.Cpp/Presentation/Image/PngSaveOptions.h> | |
| #include <Aspose.TeX.Cpp/Presentation/Image/ImageDevice.h> | |
| #include <Aspose.TeX.Cpp/IO/OutputFileSystemDirectory.h> | |
| #include <Aspose.TeX.Cpp/IO/OutputConsoleTerminal.h> | |
| #include <Aspose.TeX.Cpp/IO/IOutputWorkingDirectory.h> | |
| #include <Aspose.TeX.Cpp/IO/IOutputTerminal.h> | |
| #include <Aspose.TeX.Cpp/IO/InputFileSystemDirectory.h> | |
| #include <Aspose.TeX.Cpp/IO/InputConsoleTerminal.h> | |
| #include <Aspose.TeX.Cpp/IO/IInputTerminal.h> | |
| #include <cstdint> | |
| #include <Aspose.TeX.Cpp/License.h> | |
| using namespace Aspose::TeX; | |
| using namespace Aspose::TeX::IO; | |
| using namespace Aspose::TeX::Presentation::Image; | |
| class TexToPngConverter{ | |
| public: | |
| static void TexToPNGRendering() | |
| { | |
| // Initialize license object | |
| System::SharedPtr<License> TexLicense = System::MakeObject<License>(); | |
| // Applying license for rendering PNG | |
| TexLicense->SetLicense(u"Aspose.Total.NET.lic"); | |
| // Instantiate TeXOptions object for configuring settings | |
| System::SharedPtr<TeXOptions> RenderingOptions = TeXOptions::ConsoleAppOptions(TeXConfig::ObjectTeX()); | |
| // Specify the job name. | |
| RenderingOptions->set_JobName(u"stream-image-out"); | |
| // Specify the input file working directory. | |
| RenderingOptions->set_InputWorkingDirectory(System::MakeObject<InputFileSystemDirectory>(u"")); | |
| // Specify the output file working directory. | |
| RenderingOptions->set_OutputWorkingDirectory(System::MakeObject<OutputFileSystemDirectory>(u"")); | |
| // Setting the console input terminal | |
| RenderingOptions->set_TerminalIn(System::MakeObject<InputConsoleTerminal>()); | |
| // Setting the console output terminal | |
| RenderingOptions->set_TerminalOut(System::MakeObject<OutputConsoleTerminal>()); | |
| // Creating and specifying PngSaveOptions | |
| System::SharedPtr<PngSaveOptions> ImageOptions = System::MakeObject<PngSaveOptions>(); | |
| ImageOptions->set_Resolution(300); | |
| RenderingOptions->set_SaveOptions(ImageOptions); | |
| // Instantiating ImageDevice for rendering | |
| System::SharedPtr<ImageDevice> ImageDevise = System::MakeObject<ImageDevice>(); | |
| // Running TexJob for rendering to PNG | |
| TeXJob::TeXJob(System::MakeObject<System::IO::MemoryStream>(System::Text::Encoding::get_ASCII()-> | |
| GetBytes(u"\\hrule height 10pt width 95pt\\vskip10pt\\hrule height 5pt")), | |
| ImageDevise, RenderingOptions); | |
| // During executoion, when the console prompts the input, | |
| // Step 1: Type "ABC", press Enter | |
| // Step 2: Type "\end" and press Enter again | |
| // In order to view the ouptut and to look write. | |
| RenderingOptions->get_TerminalOut()->get_Writer()->WriteLine(); | |
| // Alternatively, you can also get the images in form of array of byte arrays | |
| // The 0th index belong to first page. | |
| System::ArrayPtr<System::ArrayPtr<uint8_t>> result = ImageDevise->get_Result(); | |
| } | |
| }; |
In this topic, we have learnt how C++ create PNG image from LaTeX using simple API calls. If you are interested in learning other features like rendering MPP files then refer to the article on how to convert MPP to XPS using C++.
