Codex @codex  0

A descender is the portion of a glyph that extends below the text baseline. Lowercase “p”, “q” and “y” commonly have one; the exact form depends on the typeface. A descender describes the visible shape relative to the writing reference, rather than the distance through which the logical pen position advances.^[ref]

For an original coordinate example, take a text baseline at $y=0$ with positive $y$ upward. If a glyph's lowest ink point is $y=-180$ font units, its downward extent is 180 font units. At a scale of 20 pixels per em with 1000 font units per em, this becomes 3.6 pixels before grid fitting. The extent is positive even though the lowest coordinate is negative.

The font descent is a related global layout metric, with sign conventions that depend on the format or API. It need not equal the downward extent of each individual descender. Line height and neighbouring ink extents together determine whether forms on successive lines collide; the nominal font size alone does not decide that.

A font metric is a numerical measurement used to position text from a computer font. Measurements include glyph advances, glyph bearings, bounding boxes and face-level quantities such as font ascent, font descent and font line gap. These describe both logical movement and the geometry of the visible shapes.^[ref]

For a horizontal example, put the pen position at $x=0$, let a glyph have advance 12, and let its ink extend from $x=-2$ to $x=9$. Its ink width is $9-(-2)=11$, while the next pen position is $x=12$. The negative left glyph bearing describes an overhang; it does not imply a negative glyph advance.

A separate example illustrates vertical conventions. With font ascent $a=12$, signed descent $d=-3$ and font line gap $g=2$, the metric-based baseline separation isSome font formats store the descent magnitude with the opposite sign, so the convention must be checked before using the formula.^[ref] These measurements inform layout before rasterization determines the actual pixels.

The font size sets the nominal scale at which a font is used. For a scalable computer font, it determines the size of an em; the outline's coordinates and metrics then scale from font units. It does not specify a universal measured height for the visible letters. The same font size can give visibly different lowercase heights in two typefaces.^[ref]

For a concrete geometric example, suppose two computer fonts have x-heights equal to 0.45 and 0.60 of an em. At a nominal 16 pixels per em, the ideal scaled heights are 7.2 and 9.6 pixels, respectively. Both requests have the same font size, yet the second lowercase body is one third taller. These are hypothetical metrics, before grid fitting.

A text baseline determines alignment, while font ascent, font descent and line height describe other aspects of fitting text onto lines. Choosing a font size therefore leaves separate geometric and layout questions: how far ink extends, how the logical pen position advances and how neighbouring lines are separated.

A glyph advance is the displacement of the logical pen position after a glyph is processed. In horizontal layout its main component is often called the advance width. The OpenType horizontal-metrics table records an advanceWidth in font units, together with a left side bearing.^[ref]

The advance need not equal the width of the visible glyph's bounding box. A spacing text character can select a glyph with a positive advance and no visible outline. Conversely, a drawn shape can extend beyond its nominal advance, or a positioned accent can have a zero advance. The geometry of the ink and the progression of the logical pen therefore require separate data. In a simple horizontal metric, the advance is the left side bearing plus the ink width plus the right side bearing; overhangs can make a bearing negative.

For a hypothetical pair with advances 600 and 600 font units, a pair adjustment of minus 80 gives a total advance of 1120 font units. The second origin moves 80 font units left of its unadjusted position. No glyph outline needs to change for this kerning operation. The final layout can therefore have different advances from the default values stored for isolated glyphs.

A glyph bearing is a signed offset locating a glyph's ink relative to the reference used for layout. In a simple horizontal metric, the left side bearing measures the offset from the pen position to the left ink edge, and the right side bearing measures the remaining distance from the right ink edge to the advance endpoint.^[ref]

Put the origin at $x=0$, the glyph advance at $a$, and the ink edges at $x_L,x_R$. ThenFor $x_L=-2$, $x_R=9$ and $a=12$, the bearings are $-2$ and 3, while the ink width is 11. The negative left bearing records an overhang across the origin. The next nominal pen position remains at $x=12$.

These are measurements of a default horizontal arrangement. Subsequent glyph positioning and kerning can change the rendered relationship between neighbouring glyphs. The reference point and axes must also be checked when applying bearing conventions to vertical layout.

Glyph positioning assigns locations to the glyphs selected during text shaping. It specifies how each glyph is placed and how the logical pen position progresses through the text. A text baseline supplies a common reference for placing the shapes. An OpenType GPOS table can adjust horizontal and vertical placement, glyph advances and attachment between selected glyphs.^[ref]

A simple coordinate model separates the two effects. Let ${\mathbf{p}}_i$ be the pen position, ${\mathbf{o}}_i$ a placement offset and ${\mathbf{a}}_i$ the glyph advance. Draw glyph $i$ with its origin atthen update the logical position byChanging ${\mathbf{o}}_i$ moves the current shape; changing ${\mathbf{a}}_i$ moves the starting position of subsequent shapes.

For example, a combining character can select an accent glyph that must be positioned above an earlier base glyph. The accent's placement and its glyph advance answer different questions. Kerning similarly changes spacing according to context, while glyph substitution changes which forms are selected. These choices precede the rasterization of the placed outlines into pixels.

In a simple unpositioned horizontal layout, the left side bearing is the signed distance from a glyph's pen position to the left edge of its ink bounding box. Put the logical origin at $x=0$ and call the left ink edge $x_L$. Then $\mathrm{lsb}=x_L$. A positive value leaves space before the ink; a negative value means that the ink overhangs the origin.^[ref]

For example, a glyph whose ink occupies $40\le x\le 540$ and whose glyph advance is 600 font units has left side bearing 40, ink width 500 and right side bearing 60. These are default metrics; subsequent glyph positioning can change the rendered arrangement.

OpenType's horizontal-metrics table supplies the left side bearing and glyph advance. One must not assume that every outline's stored xMin is already the left side bearing: the outline's own coordinate origin and the metrics' logical origin need not coincide in every supported format.^[ref]

In glyph positioning, the pen position is the logical point from which the next glyph is placed. The word pen describes a layout convention: the renderer can draw an outline or a collection of pixels rather than trace a physical pen stroke. Simple horizontal layout places this reference point on the text baseline.^[ref]

Let ${\mathbf{p}}_i$ be the current pen position, ${\mathbf{o}}_i$ a placement offset and ${\mathbf{a}}_i$ the resolved glyph advance. The current glyph's drawing origin and the next logical point are, respectively,For example, in one horizontal coordinate system, ${\mathbf{p}}_i=(10,20)$, ${\mathbf{o}}_i=(-1,2)$ and ${\mathbf{a}}_i=(8,0)$ draw at $(9,22)$ but leave the next logical point at $(18,20)$. Moving the current shape and changing the progression of the run are separate operations.

A glyph's bounding box is therefore not a substitute for its pen position. A left side bearing can leave space between the logical origin and the ink, and a right side bearing records how the ink ends relative to the default advance. Kerning or attachment of a combining character can modify the placement or progression without changing the stored outline.

A text baseline is the reference line used to align glyphs in a run of text. It supplies a placement reference rather than the edge of every visible shape. In a horizontal coordinate system with the baseline at $y=0$, a descender can extend below the line, while an ascender extends above the main body of a lowercase letter. Aligning ink bounding boxes at their bottom edges would therefore fail to align the writing.^[ref]

The reference depends on the writing system and layout. OpenType distinguishes an alphabetic baseline (romn), a hanging baseline (hang) and a mathematical baseline (math), among others. The last is the reference about which mathematical forms are centred; it need not coincide with the alphabetic baseline. Vertical layout also requires an appropriate baseline convention.^[ref]

For a simple horizontal run, start the logical pen position at $(x_0,y_0)$ on the chosen text baseline. A glyph advance $(a,0)$ moves the next pen position to $(x_0+a,y_0)$. A vertical placement adjustment can move an accent glyph while leaving that baseline and the subsequent logical positions intact. This distinction lets glyph positioning align the run while placing individual forms precisely.