Fuchsia.fonts

规范字体系列名称。请注意，这可能与传递给 GetFamilyInfo() 的值不同，因为 GetFamilyInfo() 也会解析字体别名并忽略大小写。例如，GetFamilyInfo("robotoslab") 将为 FamilyInfo.name = "Robot Slab"。

相应系列中所有可用样式的无序列表。

组成名称的字符。

所需的字体系列名称，例如“Roboto”。字体系列搜索不区分大小写。如果没有指定系列，或者指定的系列没有所请求的 character 的字形，则可能会返回其他系列的字体。可以使用 REQUEST_FLAG_NO_FALLBACK 停用此行为。

例如，400 是正常的，700 是粗体。

与 OS/2 和 Windows Metrics usWidthClass 表匹配的数值。 https://www.microsoft.com/typography/otspec/os2.htm 例如，5 表示正常。

BCP47 语言标记（按优先顺序排列）。请参阅 https://tools.ietf.org/html/bcp47。

必须出现在返回的字体中的字符的代码点或 0。 指定此字段的调用方应从结果中提取字符集并将其缓存，以避免不必要的调用 API。

后备组偏好设置。来电者可以将此字段设为“无”。在这种情况下，字体提供程序将使用指定字体系列的回退组。

缓冲区的缓冲区标识符。具有相同缓冲区 ID 的响应保证在缓冲区中包含相同的数据。客户端可以使用此值检测是否已以解析形式缓存字体。

buffer 中的字体索引。用于每个文件可能包含多种字体的字体格式，例如 TTC (TrueType Collection)。

BLOCK_UNTIL_DOWNLOADED

服务器会先尝试加载未缓存的字体，然后再提供响应。这是默认行为。

对于在等待字体时阻止渲染的同步客户端，不建议使用此选项。

RETURN_EMPTY_RESPONSE

服务器将返回空的 fuchsia.fonts/TypefaceResponse，以告知客户端未缓存的字体不可用。未缓存的字体可以异步下载，以供将来的请求使用。

这类似于 CSS 中的 font-display: block。

RETURN_FALLBACK

服务器将尝试提供缓存的回退字体（如果 fuchsia.fonts/TypefaceRequestFlags 中的回退限制允许的话）。可异步下载未缓存的字体，以供将来的请求使用。

这类似于 CSS 中的 font-display: swap。

无

SERIF

SANS_SERIF

单空间

斜体

奇幻

SERIF

字形在大多数笔画的末端都有小的“衬线”、钩子或凹口。 示例：佐治亚州、Noto Serif、Times New Roman。

SANS_SERIF

大多数笔画末尾没有衬线的字形。 示例：Crashlytics、Noto Sans、Roboto、Tahoma。

单空间

固定宽度的字体。 示例：Consolas、Courier New、Inconsolata。

斜体

手写或手写字体。 示例：Brush Script、Comic Sans、Lucida 书法。

奇幻

装饰性字体。 示例：Impact、Papyrus。

SYSTEM_UI

目标平台上的默认界面字体。 添加此属性是为了保证 CSS 规范的完整性；字体清单不应声明字体属于 SYSTEM_UI 通用系列，而应声明更具体的选项（例如，用于 Roboto 的 SERIF）。

不常用。

表情符号

专门用于渲染表情符号代码点的字体。 示例：Noto Color Emoji。

MATH

主要用于渲染数学表达式的字体。

不常用。

FANGSONG

介于 Serif 和手写体之间的一组中文字体，通常用于中国政府官方文件。

不常用。

竖直

默认；直立字形。

经过专门设计、倾斜且略带书写字形的字形。

遗漏

字形偏斜。倾斜通常是指直立变体的几何变形，而不是定制设计的变体。

ULTRA_CONDENSED

正常宽度的 50%

EXTRA_CONDENSED

正常宽度的 62.5%

浓缩

正常宽度的 75%

SEMI_CONDENSED

正常宽度的 87.5%

NORMAL

正常宽度

SEMI_EXPANDED

正常宽度的 112.5%

加大型

正常宽度的 125%

EXTRA_EXPANDED

正常宽度的 150%

ULTRA_EXPANDED

正常宽度的 200%

1

规范字体系列名称。请注意，由于字体别名的解析和/或空白和大小写的差异，这可能与传递给 GetFontFamilyInfo() 的值不同。

2

相应系列中所有可用样式的无序列表。

1

请参阅Slant。

2

字形的粗细或粗细。允许的值是 [1, 1000] 范围内的整数，但大多数实际字体系列仅支持 100 的一些整数倍：{100, 200, ..., 900}。普通文本 (WEIGHT_NORMAL) 为 400；WEIGHT_BOLD 为 700。

请参阅： https://developer.mozilla.org/zh-CN/docs/Web/CSS/font-weight#Common_weight_name_mapping https://docs.microsoft.com/en-us/typography/opentype/spec/os2#usweightclass

3

请参阅Width。

1

所需的字体系列名称，例如“Roboto”。字体系列搜索不区分大小写。

注意：如果指定的族不存在，或者指定的族没有所请求的 code_point 的字形，就可能会返回其他族的面孔。可以使用 TypefaceRequestFlags.EXACT_FAMILY 停用此行为。

2

所需字型的样式属性。

3

按优先顺序排列的语言标记。这样就可以消除映射到不同语言的不同字形的码位（例如，CJK 码位）。

请参阅fuchsia.intl.LocaleId。

4

（可选）返回的人脸中必须存在字形的码位。

指定此字段的调用方应从结果中提取字符集并将其缓存，以避免不必要的调用 API。

5

在无完全匹配或不包含请求的代码点时回退的通用字体系列。

每个字体系列都属于一个通用系列（在字体清单中配置）。如果特定字体系列未包含所请求的代码点，提供程序可以在同一通用系列的其他字体系列中搜索该代码点作为回退。

在查询中指定 fallback_family 可让客户端替换将用作回退的通用系列。

6

要查找的字体的确切 Postscript 名称。对应于 TrueType/OpenType name 表中的名称 ID 6。

所有字符都必须在可打印的 ASCII 范围（U+0021 至 U+007E）内，且不得为“[”、“]”、“('、')”、“{”、“}”、“<”、“>”、“/”或“%”。

如果指定此字段，系统会忽略所有其他查询字段。

7

要查找的字体的确切全名。对应于 TrueType/OpenType name 表中的名称 ID 4。

如果指定此字段，系统会忽略所有其他查询字段。

1

用于查找字体的参数。

2

用于指示如何处理请求的标志，例如允许哪些类型的替换。

3

设置当请求的字体存在但未被缓存，因此无法立即传送时的处理方式。

如果此字段为空，则默认政策为 fuchsia.fonts/CacheMissPolicy.BLOCK_UNTIL_DOWNLOADED。

如果客户端需要立即响应，可以选择其中一项非阻止政策。 在这种情况下，客户端还可以通过调用 fuchsia.fonts/Provider.RegisterFontSetEventListener，注册并在将新字体添加到缓存时收到通知。

1

包含数字字体文件字节的内存缓冲区。客户端需负责识别文件类型并对其进行解析（通常通过委托给 FreeType 或类似库）。

2

缓冲区的标识符。具有相同 buffer_id 的响应保证在缓冲区中包含相同的数据。客户端可以使用此值检测其是否已以解析形式缓存字体。

3

buffer 中返回的字体的索引。用于每个文件可能包含多个字体的数字字体格式，例如 TTC (TrueType Collection)。

EXACT_FAMILY

停用字体系列回退。如果请求的字体系列不存在或不包含请求的代码点，服务将不会尝试搜索设置的回退字体。

EXACT_STYLE

停用近似样式匹配。该服务将仅返回与请求的样式完全匹配的人脸。例如，所请求的“半粗体”粗细不能替换成“中”；所请求的“斜体”斜体不能替换为“斜体”。

未指定字体时字体的默认倾斜度。

未指定字体时字体的默认粗细。

未指定字体时字体的默认宽度。

一个字体查询中允许的最大码位数量。

一个字体查询中允许的首选语言数量上限。

字体系列名称的最大长度。

将为字体系列返回的样式数量上限。

字体的 Postscript 名称的最大长度。此限制来自 OpenType name 表规范。

字体全名的最大长度。

已弃用。请参阅 FaceRequestFlags。 停用近似样式匹配。该服务将仅返回与所请求样式完全匹配的字体。

已弃用。请参阅 FaceRequestFlags。 停用字体回退。如果没有请求的字体系列或不包含请求的字符，服务将不会尝试搜索设置的回退字体。