Configure rendering output

Configure how MathType Integration Services render formulas and how formulas are stored in your content. Rendering output determines the format generated by MathType Integration Services (such as SVG or PNG), while the save mode determines whether formulas are stored as images or as MathML.

After completing this guide, MathType Integration Services will render formulas using the output format that best fits your deployment.

Before you begin

Requirements

Make sure you have:

• A working MathType Integration Services deployment.
• Access to the configuration.ini file.
• Permission to restart the application if required.

Applies to

Self-hosted MathType Integration Services

Steps

Configure the rendering format

MathType Integration Services support multiple rendering formats. The recommended format is SVG, which provides:

• Resolution-independent rendering.
• Better accessibility.
• High-quality rendering on high-DPI displays.
• Smaller file sizes in most scenarios.

Use PNG only when SVG cannot be used because of application compatibility requirements. 

Open configuration.ini and locate the rendering configuration:

wirisimageformat = svg

Set the desired format. For example:

wirisimageformat = svg

or

wirisimageformat = png

Save the configuration.

Configure the save mode

MathType can store formulas either as rendered images or as MathML. Choose the save mode that best fits your application requirements.

Configure the appropriate save mode in configuration.ini.

Apply the configuration

Depending on your deployment, configuration changes may require restarting the service.

Verify the configuration

Verify that the configuration endpoint returns the expected configuration.

Verify it worked

Insert a formula using your frontend integration. After saving the content:

• Verify that the formula is rendered correctly.
• Verify that the generated output matches the configured format.
• Verify that existing formulas can be reopened for editing.

You can also verify rendering using the Render Engine demo included in the Docker deployment examples.

Options and variations

Choose the rendering format

MathType can generate formulas in different output formats depending on your deployment requirements.

• SVG (recommended): scalable vector graphics suitable for modern browsers.
• PNG: raster images compatible with legacy environments.
• PDF: portable document format.
• EPS: encapsulated PostScript.
• SWF: Adobe Flash output retained for legacy compatibility only.

Choose the rendering mode

MathType supports two rendering approaches.

• Full MathML mode (recommended): formulas are stored as MathML and rendered by WIRISplugins.js.
• Image mode: formulas are stored as images for legacy compatibility.

Common issues

Formulas are not rendered correctly

Verify that:

• wirisimageformat contains a supported value.
• MathType Integration Services have been restarted after changing the configuration.
• The frontend can reach the MathType Integration Services.

Formulas are stored in an unexpected format

Verify that:

• The configured save mode matches your deployment requirements.
• The deployment is using the updated configuration.
• Cached configuration has been refreshed after restarting the application.

Related articles

• Configure MathType Integration Services.
• Configure formula storage and cache.
• Supported rendering formats.
• MathType Integration Services parameters.