Other managing TeX options | Java

Each snippet creates LaTeX TeXOptions and configures one option. Pass these options to a TeXJob, supply suitable LaTeX input, and set an output working directory before running the job. Import com.aspose.tex.TeXOptions, TeXConfig and the classes used in the selected snippet: Interaction, com.aspose.tex.rendering.XpsSaveOptions or PdfSaveOptions, and java.util.Calendar/GregorianCalendar for the date example. Handle or declare exceptions in the calling method. The rasterization and font-subsetting snippets use PdfSaveOptions; render with a compatible PdfDevice. Apply a license as described in the licensing guide.

How to set the interaction mode

As we mentioned here, Aspose.TeX for Java allows us to set the initial interaction mode in which the engine starts. Here’s how we do it:

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new XpsSaveOptions());
options.setInteraction(Interaction.NonstopMode);

How to set the job name

When we pass the main input file as a file name, we get output files with the same name, although with other extensions. The TeX engine calls the input file’s name the job name and uses it for output files, except in cases when auxiliary files with explicitly specified other names are written. When we pass the main input file as a stream, the TeX engine uses the default job name, which is texput. In both cases, we can override the job name by assigning the appropriate conversion option.

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new XpsSaveOptions());
options.setJobName("my-job-name");

How to “stop time”

LaTeX has a feature to automatically generate a title from some definitions in the preamble. This title normally contains the current date. We may wish to freeze the date in some desired value. Here’s how it can be done:

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new XpsSaveOptions());
options.setDateTime(new GregorianCalendar(2022, Calendar.DECEMBER, 18).getTime());

How to ignore missing packages

A LaTeX file may reference packages that are unavailable in the Aspose.TeX for Java library. The engine normally stops with an error when trying to load such a package. Use ignoreMissingPackages(true) to skip unavailable packages. This does not provide the commands those packages would define; the input must not depend on those commands.

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new XpsSaveOptions());
options.ignoreMissingPackages(true);

How to avoid building ligatures

Normally, the TeX engine builds ligatures for certain pairs of characters if the font provides the data required to do so. We can instruct the engine to skip ligature building with the following code:

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new XpsSaveOptions());
options.noLigatures(true);

How to repeat the job

As we have mentioned above regarding labels and references, there are cases when we may want to run the same job twice. Here is how it can be done:

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new XpsSaveOptions());
options.repeat(true);

How to turn math formulas to raster images

Sometimes we may need to have math formulas as raster images rather than typed in fonts. The following option can serve for this purpose:

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new PdfSaveOptions());
options.getSaveOptions().rasterizeFormulas(true);

How to turn graphics to raster images

The ObjectTeX engine allows us to include graphic files in raster formats (PNG and JPG) as well as PS(EPS) and XPS(OXPS) formats. The last two formats usually contain vector elements and texts. To have them rasterized and included as solid images, we can use the following option:

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new PdfSaveOptions());
options.getSaveOptions().rasterizeIncludedGraphics(true);

How to subset fonts

Font subsetting limits embedded fonts to the glyphs used in the document. Its effect on output size depends on the font and how the output device embeds it. Assign saving options before enabling subsetFonts(true), as shown below:

// Configure options, then pass them to a TeXJob with suitable LaTeX input and output.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectLaTeX());
options.setSaveOptions(new PdfSaveOptions());
options.getSaveOptions().subsetFonts(true);