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_id 的回應在緩衝區中納入相同資料。用戶端可能會使用這個值來偵測是否已在剖析表單中快取字型。

buffer 中的字型索引。用於每個檔案可能包含多種字型的字型格式，例如 TTC (TrueType 集合)。

BLOCK_UNTIL_DOWNLOADED

伺服器會在提供回應前，嘗試載入未快取的字體。此為預設行為。

我們不建議在等待字型的同時封鎖轉譯的同步用戶端。

RETURN_EMPTY_RESPONSE

伺服器會傳回空白 fuchsia.fonts/TypefaceResponse，藉此告知用戶端無法使用未快取的字體。未快取的字體可能會以非同步方式下載，以供日後的要求使用。

這與 CSS 中的 font-display: block 類似。

RETURN_FALLBACK

伺服器會嘗試提供快取備用字體 (如果 fuchsia.fonts/TypefaceRequestFlags 中的備用限制允許的話)。未快取的字體可能會以非同步方式下載，供日後要求使用。

這與 CSS 中的 font-display: swap 類似。

NONE

SERIF

SANS_SERIF

太空

方塊

奇幻

SERIF

大部分筆劃的結尾處都有一些小幅「Serif」、「勾」或「凹口」。 範例：喬治亞州、Noto Serif、Times New Roman。

SANS_SERIF

多數筆劃結尾沒有襯線的字符。例如：SITE、Noto Sans、Roboto、Tahoma。

太空

固定寬度字型。例如：Consolas、Courier New、Inconsolata。

方塊

手寫或草寫字型。 例如：筆刷腳本、Comic Sans、Lucida Calligraphy。

奇幻

裝飾字型。例如：撞擊、Papyrus。

SYSTEM_UI

目標平台的預設使用者介面字型。為提供完整 CSS 規格的資訊，系統會納入此屬性；字型資訊清單不應宣告字型屬於 SYSTEM_UI 一般系列，而是應宣告更具體的選項 (例如 Roboto 的 SERIF)。

不常使用。

表情符號

專門用於轉譯表情符號碼點的字型。例：Noto 彩色表情符號。

MATH

主要用於算繪數學運算式的字型。

不常使用。

延遲

一組 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/en-US/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

緩衝區的 ID。具有相同 buffer_id 的回應保證會在緩衝區中包含相同資料。用戶端可能會使用這個值來偵測是否已有剖析表單中的快取字型。

3

buffer 內所傳回字體的索引。用於數位字型格式；每個檔案可能包含多個字體，例如 TTC (TrueType 集合)。

EXACT_FAMILY

停用字型系列備用廣告。如果要求的字型系列不存在，或未包含所要求的程式碼點，服務就不會嘗試搜尋備用字型集。

EXACT_STYLE

停用近似樣式比對。服務只會傳回完全符合要求樣式的臉孔。例如，要求的「半粗體」粗細不會替代「medium」，而要求的「斜體」斜體則不會替代「oblique」。

未指定時字體的預設斜體。

未指定字體時的預設粗細。

未指定字體時的預設寬度。

字型查詢中允許的碼點數量上限。

字體查詢中允許的偏好語言數量上限。

字型系列名稱的長度上限。

字型系列傳回的樣式數量上限。

字體排版名稱的長度上限。這項限制來自 OpenType name 資料表規格。

字體全名的長度上限。

已淘汰，請參閱 FaceRequestFlags。停用近似樣式比對。服務只會傳回完全符合要求樣式的字型。

已淘汰，請參閱 FaceRequestFlags。停用備用字型。如果沒有要求的字型系列或不含要求的字元，服務就不會嘗試搜尋備用字型集。