fuchsia.fonts

Canonical font family name. Note that this may be different from the value passed to GetFamilyInfo() because GetFamilyInfo() also resolves font aliases and ignores case. For example GetFamilyInfo("robotoslab") will FamilyInfo.name = "Robot Slab".

Unordered list of all available styles in the family.

The characters that make up the name.

Desired font family name, e.g. "Roboto". Font family search is case-insensitive. In case when there is no specified family or the specified family doesn't have glyph for the requested character then a font from another family may be returned. This behavior can be disabled using REQUEST_FLAG_NO_FALLBACK.

For example, 400 is normal, 700 is bold.

Numeric values matching OS/2 & Windows Metrics usWidthClass table. https://www.microsoft.com/typography/otspec/os2.htm For example, 5 is normal.

BCP47 language tags in order of preference. See https://tools.ietf.org/html/bcp47 .

Codepoint for the character that must be present in the returned font or 0. Caller that specify this field are expected to extract character set from the result and cache it in order to avoid calling the API more than necessary.

Fallback group preference. Caller can leave this field set to NONE. In that case the font provider will use fallback group of the specified font family.

Buffer identifier for the buffer. Responses with the same buffer_id are guaranteed to contain the same data in the buffer. Clients may use this value to detect if they already have the font cached in parsed form.

Font index within buffer. Used for font formats that may contain more than one font per file, e.g. TTC (TrueType Collection).

BLOCK_UNTIL_DOWNLOADED

The server will attempt to load the uncached typeface before providing a response. This is the default behavior.

This option is not recommended for synchronous clients that block rendering while waiting for a font.

RETURN_EMPTY_RESPONSE

The server will tell the client that the uncached typeface is unavailable, by returning an empty fuchsia.fonts/TypefaceResponse. The uncached typeface may be downloaded asynchronously to be available for future requests.

This is similar to font-display: block in CSS.

RETURN_FALLBACK

The server will attempt to provide a cached fallback typeface (if allowed by the fallback restrictions in fuchsia.fonts/TypefaceRequestFlags). The uncached typeface may be downloaded asynchronously to be available for future requests.

This is similar to font-display: swap in CSS.

NONE

SERIF

SANS_SERIF

MONOSPACE

CURSIVE

FANTASY

SERIF

Glyphs have little "serifs", hooks, or notches at the ends of most strokes. Examples: Georgia, Noto Serif, Times New Roman.

SANS_SERIF

Glyphs that have no serifs at the ends of most strokes. Examples: Arial, Noto Sans, Roboto, Tahoma.

MONOSPACE

Fixed-width fonts. Examples: Consolas, Courier New, Inconsolata.

CURSIVE

Handwritten or cursive fonts. Examples: Brush Script, Comic Sans, Lucida Calligraphy.

FANTASY

Decorative fonts. Examples: Impact, Papyrus.

SYSTEM_UI

The default user interface font on the target platform. This is included for completeness with the CSS specification; font manifests should not declare that a font belongs to the SYSTEM_UI generic family, but instead should declare a more specific option (e.g. SERIF for Roboto).

Not commonly used.

EMOJI

Fonts that are used specifically for rendering emoji code points. Examples: Noto Color Emoji.

MATH

Fonts that are used primarily for rendering mathematical expressions.

Not commonly used.

FANGSONG

A group of Chinese fonts between serif and cursive, often used for official Chinese Government documents.

Not commonly used.

UPRIGHT

The default; upright glyphs.

ITALIC

Specially designed, slanted and slightly calligraphic glyphs.

OBLIQUE

Skewed glyphs. Oblique usually means an geometric transformation of the upright variant, rather than a custom-designed variant.

ULTRA_CONDENSED

50% of normal width

EXTRA_CONDENSED

62.5% of normal width

CONDENSED

75% of normal width

SEMI_CONDENSED

87.5% of normal width

NORMAL

Normal width

SEMI_EXPANDED

112.5% of normal width

EXPANDED

125% of normal width

EXTRA_EXPANDED

150% of normal width

ULTRA_EXPANDED

200% of normal width

1

Canonical font family name. Note that this may be different from the value passed to GetFontFamilyInfo() due to the resolution of font aliases, and/or differences in whitespace and capitalization.

2

Unordered list of all available styles in the family.

1

See Slant.

2

Weight or thickness of the glyphs. Allowed values are integers in the range [1, 1000], but most real-world font families only support some integer multiples of 100: {100, 200, ..., 900}. Normal text (WEIGHT_NORMAL) is 400; WEIGHT_BOLD is 700.

See: https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight#Common_weight_name_mapping https://docs.microsoft.com/en-us/typography/opentype/spec/os2#usweightclass

3

See Width.

1

Desired font family name, e.g. "Roboto". Font family search is case-insensitive.

Note: In cases where the specified family doesn't exist, or the specified family doesn't have a glyph for the requested code_point, a face from another family may be returned. This behavior can be disabled using TypefaceRequestFlags.EXACT_FAMILY.

2

Style properties of the desired typeface.

3

Language tags in order of preference. This allows disambiguating code points that map to different glyphs in different languages (e.g. CJK code points).

See fuchsia.intl.LocaleId.

4

Optional code points for which glyphs must be present in the returned face.

Callers that specify this field are expected to extract the character set from the result and cache it in order to avoid calling the API more than necessary.

5

A generic font family to fall back to if an exact match is unavailable or does not contain the requested code point.

Every font family belongs to a generic family (configured in the font manifest). If a particular font family doesn't contain a requested code point, the provider can search for the code point in other font families in the same generic family as a fallback.

Specifying fallback_family in a query allows the client to override the generic family that would be used as a fallback.

6

The exact Postscript name of the typeface to look up. This corresponds to name ID 6 in the TrueType/OpenType name table.

All characters must be in the printable ASCII range (U+0021 to U+007E), and must not be '[', ']', '(', ')', '{', '}', '<', '>', '/', or '%'.

If this field is specified, all the other query fields are ignored.

7

The exact full name of the typeface to look up. This corresponds to name ID 4 in the TrueType/OpenType name table.

If this field is specified, all the other query fields are ignored.

1

Parameters for looking up a typeface.

2

Flags for how to process the request, such as which kinds of substitutions are permitted.

3

Setting for what to do if the requested typeface exists but is not cached, and therefore cannot be served immediately.

If this field is empty, the default policy is fuchsia.fonts/CacheMissPolicy.BLOCK_UNTIL_DOWNLOADED.

If the client needs an immediate response, it can choose one of the non-blocking policies. In this case, clients can also register to be notified when new fonts have been added to the cache by calling fuchsia.fonts/Provider.RegisterFontSetEventListener.

1

A memory buffer containing the bytes of a digital font file. It is the client's responsibility to identify the type of file and to parse it (usually by delegating to FreeType or a similar library).

2

Identifier for the buffer. Responses with the same buffer_id are guaranteed to contain the same data in the buffer. Clients may use this value to detect if they already have the font cached in parsed form.

3

Index of the returned typeface within buffer. Used for digital font formats that may contain more than one typeface per file, e.g. TTC (TrueType Collection).

EXACT_FAMILY

Disables font family fallback. The service won't try to search the fallback font set if the requested font family doesn't exist or if it doesn't contain the requested code point.

EXACT_STYLE

Disables approximate style matching. The service will only return a face that matches the requested style exactly. For example, there will be no substitutions of "medium" for a requested "semi-bold" weight, or "oblique" for a requested "italic" slant.

Default slant of a typeface when none is specified.

Default weight of a typeface when none is specified.

Default width of a typeface when none is specified.

The maximum number of code points allowed in a typeface query.

The maximum number of preferred languages allowed in a typeface query.

The maximum length of a font family name.

The maximum number of styles that will be returned for a font family.

The maximum length of a typeface's Postscript name. The limit comes from the OpenType name table specification.

The maximum length of a typeface's full name.

Deprecated. See FaceRequestFlags. Disables approximate style matching. The service will only return font that matches the requested style exactly.

Deprecated. See FaceRequestFlags. Disables font fallback. The service won't try to search fallback font set if there is no requested font family or if it doesn't contain requested character.