Quoin
Guide
Laravel
Math
Reference
Examples
Gallery
Changelog
GitHub
Guide
Laravel
Math
Reference
Examples
Gallery
Changelog
GitHub
  • quoin/math

    • Math
    • Recipes
    • Input
    • Output
    • Custom backends

Output

MathML, TeX, OMML and plain text are written from the formula tree. SVG and PNG are drawn from a layout.

Layout

$box = Math::layout($formula, size: 12.0, display: true);
ArgumentDefaultMeaning
size12.0Font size in points. In a browser, SVG points are CSS pixels.
displaytrueDisplay style, for a formula on its own line: large operators carry their limits above and below, fractions are full size. false is text style, for a formula inside a line.
fontSTIX Two MathA TrueTypeFont; see Custom backends.
scriptAlternatestrueUse the font's script-size glyph forms. Turn it off when your output can only draw glyphs reachable from a character.
fallbackAdvancenullA Closure(string $char, float $size): ?float that gives the width of a character the font lacks, for a backend that draws such characters in another font.

The result is a Box with width, ascent (height above the baseline) and descent (depth below it), in points.

SVG

use Quoin\Math\Render\SvgRenderer;

$svg = new SvgRenderer(Math::stixTwoMath(), color: '#1a1a1a', opacity: 1.0);
echo $svg->render($box, pad: 2.0);

The SVG is width + 2 × pad wide and ascent + descent + 2 × pad high. SvgRenderer::baselineOffset($box, $pad) is the distance from its top edge to the baseline. Each glyph is one <path> whose outline is stored in font units and placed with a transform="matrix(…)"; fraction bars and radical rules are <rect>s. Pass the same font you laid out with.

PNG

use Quoin\Math\Render\PngRenderer;

if (PngRenderer::available()) {
    $png = (new PngRenderer(Math::stixTwoMath()))->render($box, pad: 1.0, scale: 2.0);
}

PngRenderer draws with the Imagick extension. scale is pixels per point; the image is (width + 2 × pad) × scale pixels wide, with a transparent background. It is drawn at four times that size and scaled down, which keeps strokes as fine as a browser's. PngRenderer::baselineOffset($box, $pad, $scale) gives the baseline in pixels. Without Imagick, render() throws Quoin\Math\Exception\MissingExtension. A large image is drawn at a smaller multiple to stay under PngRenderer::MAX_PIXELS (8 million); one over it even at its own size throws InvalidArgumentException.

The color is an ImageMagick color: #rrggbb, rgb(…) or a name. currentColor means nothing outside a browser, so it works only for SVG.

To rasterize the SVG yourself, use rsvg-convert. ImageMagick's SVG reader draws glyphs noticeably bolder.

MathML

use Quoin\Math\Render\MathmlWriter;

echo MathmlWriter::write($formula, display: false);   // <math xmlns="…" display="inline">…</math>

The output is MathML Core, which current browsers render natively.

TeX

use Quoin\Math\Render\TexWriter;

echo TexWriter::write($formula);   // x = \frac{- b \pm \sqrt{b^2 - 4 a c}}{2 a}

Standard TeX with no package-specific commands, so KaTeX and MathJax accept it, and Math::tex() reads it back as the same formula.

Word (OMML)

use Quoin\Math\Render\OmmlWriter;
use Quoin\Math\Render\RunFormat;

OmmlWriter::oMath($formula);                                               // inline
OmmlWriter::oMathPara($formula, 'center');                                 // a paragraph of its own: left, center or right
OmmlWriter::oMath($formula, new RunFormat(colorHex: 'C00000', sizeHalfPoints: 24));

Letters are written plain and Word italicizes them; Math::text() becomes ordinary text. Word always uses Cambria Math. It does not stretch = over labels, so \xlongequal keeps its normal width. See In Word for where the XML goes.

Plain text

use Quoin\Math\Render\TextWriter;

echo TextWriter::write($formula);   // x = (−b ± √(b² − 4ac))/(2a)

Linear Unicode with plain letters. Scripts become superscript and subscript characters where Unicode has them, and ^(…) or _(…) where it doesn't. Use it for alt text, search indexes, slugs and plain-text email.

Edit this page on GitHub
Last Updated: 11/17/26, 2:47 PM
Prev
Input
Next
Custom backends