Design parameters
Every dial the engine has, with its default and what it does to the letters.
Put these under "design" in the spec. Units are font units (1000 per em).
Anything you leave out comes from the preset, then from the defaults below.
Vertical proportions
| Parameter | Default | Effect |
|---|---|---|
cap |
700 | Capital height. |
xh |
500 | x-height. Larger reads bigger and more modern (520 to 560); smaller is more elegant (460 to 480). |
asc |
740 | Ascender height (b d h k l). Above cap looks classic, equal looks compact. |
desc |
-200 | Descender depth (g j p q y). |
overshoot |
10 | How far round letters pass the baseline and x-height. |
Weight and contrast
| Parameter | Default | Effect |
|---|---|---|
stem |
84 | Vertical stroke of the Regular (400) lowercase. Other weights are derived from it. |
cap_stem |
1.08 | Capitals are this much heavier than lowercase. |
hratio |
0.9 | Horizontal stroke thickness relative to vertical, before contrast. |
contrast |
0.0 | Thick-thin contrast. 0 monoline, 0.15 humanist, 0.5 fashion display. |
stress |
"expansion" | Stroke model. "expansion" (pointed pen) puts thick strokes on the verticals; "translation" (broad nib) gives diagonal stress, like a calligraphic serif. |
stress_angle |
0 | Tilts the stress axis, in degrees. 15 to 30 with "translation" feels written. |
join |
0.75 | Stroke thinning where curves meet stems (n, b, a). Lower is more sculpted. |
Width and shape
| Parameter | Default | Effect |
|---|---|---|
width |
1.0 | Global width. 0.72 condensed, 1.15 extended. |
o_ratio |
1.0 | Width of o relative to x-height. 1.0 is a circle. |
n_ratio |
0.9 | Width of n relative to x-height. |
O_ratio |
1.04 | Width of O relative to cap height. |
H_ratio |
0.76 | Width of H relative to cap height. |
roundness |
0.5523 | Curve tension. 0.5523 true ellipse, 0.62 soft square, 0.74 squarish (DIN-like). |
branch |
0.6 | Height where arches leave the stem. 0.5 geometric, 0.7 grotesque. |
aperture |
0.5 | Opening of c e s a. 0.1 closed and compact, 0.9 open and legible at small sizes. |
cut |
"perp" | Terminal cut: "h" horizontal (neo-grotesque), "v" vertical, "perp" at right angles to the stroke. |
terminal |
"flat" | "round" gives rounded stroke ends everywhere. |
dot |
"round" | "square" for square i-dots and punctuation. |
soften |
0.07 | Rounds the outer corners. 0 is sharp, 0.32 is fully soft (the rounded preset). |
inktrap |
0 | Notches cut into sharp inner corners, in stems. 0.15 is subtle, 0.25 is deep. Helps heavy weights at small sizes. |
serif |
"none" | "slab" adds slab serifs. |
serif_len |
0.95 | Slab length. |
serif_weight |
1.0 | Slab thickness relative to horizontal strokes. |
slant |
0 | Degrees of lean (oblique). |
a |
"double" | Default form of a: "double" or "single" storey. The other form becomes ss01. |
Rhythm
| Parameter | Default | Effect |
|---|---|---|
spacing |
1.0 | Letter-spacing. 0.92 tight headline fit, 1.08 airy text. |
kerning |
1.0 | Kerning strength. 0 turns kerning off. |
weight_comp |
0.9 | How much letters widen as weight grows. Lower keeps Bold narrow. |
Spec fields outside design
{
"family": "Family Name",
"version": "1.000",
"designer": "Name",
"designer_url": "https://...",
"description": "One or two sentences.",
"license": "SIL Open Font License 1.1",
"license_url": "https://openfontlicense.org",
"vendor": "ABCD",
"preset": "grotesque",
"weights": [300, 400, 700],
"glyphs": "my_glyphs.py",
"design": { }
}
weights may use any of 100 to 900 in steps of 100. Masters are created
for the lightest, the heaviest and 400 when it lies between them.
For full control, set "masters" instead: a map from weight to parameter
overrides, for example {"300": {"stem": 50}, "800": {"stem": 160, "aperture": 0.7}}.
Any numeric parameter can differ between masters and will interpolate.