Table of Contents

Struct FontMetrics1

Namespace
SharpDX.DirectWrite
Assembly
SharpDX.Direct2D1.dll

The FontMetrics1 structure specifies the metrics that are applicable to all glyphs within the font face.

public struct FontMetrics1
Inherited Members

Remarks

FontMetrics1 inherits from FontMetrics:

struct  : public 
                                                                                                                                                                             {
                                                                                                                                                                             ...
                                                                                                                                                                             };

Fields

Ascent

The ascent value of the font face in font design units. Ascent is the distance from the top of font character alignment box to the English baseline.

public short Ascent

Field Value

short

CapHeight

The cap height value of the font face in font design units. Cap height is the distance from the English baseline to the top of a typical English capital. Capital "H" is often used as a reference character for the purpose of calculating the cap height value.

public short CapHeight

Field Value

short

Descent

The descent value of the font face in font design units. Descent is the distance from the bottom of font character alignment box to the English baseline.

public short Descent

Field Value

short

DesignUnitsPerEm

The number of font design units per em unit. Font files use their own coordinate system of font design units. A font design unit is the smallest measurable unit in the em square, an imaginary square that is used to size and align glyphs. The concept of em square is used as a reference scale factor when defining font size and device transformation semantics. The size of one em square is also commonly used to compute the paragraph identation value.

public short DesignUnitsPerEm

Field Value

short

GlyphBoxBottom

Bottom edge of accumulated bounding blackbox of all glyphs in the font.

public short GlyphBoxBottom

Field Value

short

GlyphBoxLeft

Left edge of accumulated bounding blackbox of all glyphs in the font.

public short GlyphBoxLeft

Field Value

short

GlyphBoxRight

Right edge of accumulated bounding blackbox of all glyphs in the font.

public short GlyphBoxRight

Field Value

short

GlyphBoxTop

Top edge of accumulated bounding blackbox of all glyphs in the font.

public short GlyphBoxTop

Field Value

short

HasTypographicMetrics

A Boolean value that indicates that the ascent, descent, and lineGap are based on newer 'typographic' values in the font, rather than legacy values.

public RawBool HasTypographicMetrics

Field Value

RawBool

LineGap

The line gap in font design units. Recommended additional white space to add between lines to improve legibility. The recommended line spacing (baseline-to-baseline distance) is the sum of ascent, descent, and lineGap. The line gap is usually positive or zero but can be negative, in which case the recommended line spacing is less than the height of the character alignment box.

public short LineGap

Field Value

short

StrikethroughPosition

The strikethrough position value of the font face in font design units. Strikethrough position is the position of strikethrough relative to the English baseline. The value is usually made positive in order to place the strikethrough above the baseline.

public short StrikethroughPosition

Field Value

short

StrikethroughThickness

The suggested strikethrough thickness value of the font face in font design units.

public short StrikethroughThickness

Field Value

short

SubscriptPositionX

Horizontal position of the subscript relative to the baseline origin. This is typically negative (to the left) in italic and oblique fonts, and zero in regular fonts.

public short SubscriptPositionX

Field Value

short

SubscriptPositionY

Vertical position of the subscript relative to the baseline. This is typically negative.

public short SubscriptPositionY

Field Value

short

SubscriptSizeX

Horizontal size of the subscript em box in design units, used to scale the simulated subscript relative to the full em box size. This is the numerator of the scaling ratio where denominator is the design units per em. If this member is zero, the font does not specify a scale factor, and the client uses its own policy.

public short SubscriptSizeX

Field Value

short

SubscriptSizeY

Vertical size of the subscript em box in design units, used to scale the simulated subscript relative to the full em box size. This is the numerator of the scaling ratio where denominator is the design units per em. If this member is zero, the font does not specify a scale factor, and the client uses its own policy.

public short SubscriptSizeY

Field Value

short

SuperscriptPositionX

Horizontal position of the superscript relative to the baseline origin. This is typically positive (to the right) in italic and oblique fonts, and zero in regular fonts.

public short SuperscriptPositionX

Field Value

short

SuperscriptPositionY

Vertical position of the superscript relative to the baseline. This is typically positive.

public short SuperscriptPositionY

Field Value

short

SuperscriptSizeX

Horizontal size of the superscript em box in design units, used to scale the simulated superscript relative to the full em box size. This is the numerator of the scaling ratio where denominator is the design units per em. If this member is zero, the font does not specify a scale factor, and the client should use its own policy.

public short SuperscriptSizeX

Field Value

short

SuperscriptSizeY

Vertical size of the superscript em box in design units, used to scale the simulated superscript relative to the full em box size. This is the numerator of the scaling ratio where denominator is the design units per em. If this member is zero, the font does not specify a scale factor, and the client should use its own policy.

public short SuperscriptSizeY

Field Value

short

UnderlinePosition

The underline position value of the font face in font design units. Underline position is the position of underline relative to the English baseline. The value is usually made negative in order to place the underline below the baseline.

public short UnderlinePosition

Field Value

short

UnderlineThickness

The suggested underline thickness value of the font face in font design units.

public short UnderlineThickness

Field Value

short

XHeight

The x-height value of the font face in font design units. x-height is the distance from the English baseline to the top of lowercase letter "x", or a similar lowercase character.

public short XHeight

Field Value

short