Using the API in Your Program

Follow the general steps below to use the Document Composer in your program.

Setting the License

Before a document can be processed, a valid MathFlow SDK license for the Document Composer must be supplied to the DocumentComposer class (note that this is available in 32- and 64-bit versions for Windows). This is accomplished by using the SetLicense method and passing in either the path and file name of a FlexNet license or the license string for a Design Science key.

Specifying the Input

To pass the input document to be processed into the Document Composer, use the SetInputDoc method, which sets the path to the source document.

Defining the Output

The methods that define where the output document and equation images will generated and what tags and attributes will be generated are:

SetOutputDoc
SetOutputType
SetAltText (Windows only)
SetFontMetrics
SetImageName
SetImageType
SetImageFolder

Setting Rendering Options

The methods that determine how the equations will be rendered are:

SetPointSize
SetDPI
SetForeground
SetBackground
SetBreakWidth (Java only)
SetPadding (Java only)

Using Fonts

Java

Use this method to select which font mapping file is used (see Java Rendering Engine for more information):

SetFontMapping

Windows

Use these methods to select which fonts are used (see Windows Font Configuration for more information):

SetFontConfig
SetFontInfo
SetBaseFont

When the DocumentComposer DLL (note that this is available in 32- and 64-bit versions for Windows) is first loaded, it looks for the font configuration file and the font info file. If either file is present, it is used in the same way as the analogous configuration file passed via the -fontinfo or -fontconfig parameter by the command line component.

Saving Your Options

At any point in your program, you can save the options you have defined using SaveOptions. To load options previously saved, you would use ReadOptions.

Processing a Document

Once the parameters have been set, a document can be processed with the ProcessDocument method.

Getting Additional Information

Use the GetLastMessage method to obtain the latest message string and ClearLastMessage to reset it.

The SetVerbosity method specifies the amount of information that will appear in processing messages. These will be displayed to the console unless they are redirected to a log file with the SetLogFile method.