BLFontDesignMetrics Struct Reference [¶]

Design metrics of a font.

Design metrics is information that BLFontFace collected directly from the font data. It means that all fields are measured in font design units.

When a new BLFont instance is created a scaled metrics BLFontMetrics is automatically calculated from BLFontDesignMetrics including other members like transformation, etc...

Public Members

int units_per_em

int lowest_ppem

int line_gap

int x_height

int cap_height

union {

struct {

int ascent

int v_ascent

int descent

int v_descent

int h_min_lsb

int v_min_lsb

int h_min_tsb

int v_min_tsb

int h_max_advance

int v_max_advance

}

struct {

int ascent_by_orientation[2]

int descent_by_orientation[2]

int min_lsb_by_orientation[2]

int min_tsb_by_orientation[2]

int max_advance_by_orientation[2]

}

};

BLBoxI glyph_bounding_box

int underline_position

int underline_thickness

int strikethrough_position

int strikethrough_thickness

Member Functions

void reset() noexcept

int BLFontDesignMetrics::units_per_em[¶]

Units per EM square.

int BLFontDesignMetrics::lowest_ppem[¶]

Lowest readable size in pixels.

int BLFontDesignMetrics::line_gap[¶]

Line gap.

int BLFontDesignMetrics::x_height[¶]

Distance between the baseline and the mean line of lower-case letters.

int BLFontDesignMetrics::cap_height[¶]

Maximum height of a capital letter above the baseline.

int BLFontDesignMetrics::ascent[¶]

Ascent (horizontal layout).

int BLFontDesignMetrics::v_ascent[¶]

Ascent (vertical layout).

int BLFontDesignMetrics::descent[¶]

Descent (horizontal layout).

int BLFontDesignMetrics::v_descent[¶]

Descent (vertical layout).

int BLFontDesignMetrics::h_min_lsb[¶]

Minimum leading-side bearing (horizontal layout).

int BLFontDesignMetrics::v_min_lsb[¶]

Minimum leading-side bearing (vertical layout).

int BLFontDesignMetrics::h_min_tsb[¶]

Minimum trailing-side bearing (horizontal layout).

int BLFontDesignMetrics::v_min_tsb[¶]

Minimum trailing-side bearing (vertical layout).

int BLFontDesignMetrics::h_max_advance[¶]

Maximum advance (horizontal layout).

int BLFontDesignMetrics::v_max_advance[¶]

Maximum advance (vertical layout).

int BLFontDesignMetrics::ascent_by_orientation[2][¶]

Horizontal & vertical ascents.

int BLFontDesignMetrics::descent_by_orientation[2][¶]

Horizontal & vertical descents.

int BLFontDesignMetrics::min_lsb_by_orientation[2][¶]

Minimum leading-side bearing (horizontal and vertical).

int BLFontDesignMetrics::min_tsb_by_orientation[2][¶]

Minimum trailing-side bearing (horizontal and vertical)..

int BLFontDesignMetrics::max_advance_by_orientation[2][¶]

Maximum advance width (horizontal) and height (vertical).

BLBoxI BLFontDesignMetrics::glyph_bounding_box[¶]

Aggregated bounding box of all glyphs in the font.

Note

This value is reported by the font data so it's not granted to be true.

int BLFontDesignMetrics::underline_position[¶]

Text underline position.

int BLFontDesignMetrics::underline_thickness[¶]

Text underline thickness.

int BLFontDesignMetrics::strikethrough_position[¶]

Text strikethrough position.

int BLFontDesignMetrics::strikethrough_thickness[¶]

Text strikethrough thickness.