IDWriteFontFace::GetGlyphRunOutline 方法 (dwrite.h)
呼叫大綱接收介面,以計算字元回合的大綱。
語法
HRESULT GetGlyphRunOutline(
FLOAT emSize,
[in] UINT16 const *glyphIndices,
[in, optional] FLOAT const *glyphAdvances,
[in, optional] DWRITE_GLYPH_OFFSET const *glyphOffsets,
UINT32 glyphCount,
BOOL isSideways,
BOOL isRightToLeft,
IDWriteGeometrySink *geometrySink
);
參數
emSize
類型: FLOAT
DIP 單位中字型的邏輯大小。 DIP (「裝置獨立圖元」) 等於1/96英吋。
[in] glyphIndices
類型: const UINT16*
字元索引的陣列。 字元是以邏輯順序排列,而前進方向取決於 isRightToLeft 參數。 陣列必須配置,而且能夠包含 glyphCount 所指定的項目數目。
[in, optional] glyphAdvances
類型: const FLOAT*
選擇性的字元陣列會以 DIP 前進。 圖像的進階是繪製圖像之後,以基準) 方向前進位置 (的數量。 glyphAdvances 包含 glyphCount 所指定的元素數目。
[in, optional] glyphOffsets
類型: const DWRITE_GLYPH_OFFSET*
圖像位移的選擇性陣列,其中每一個都會指定相對於目前畫筆位置之圖像基準的位移沿著基準的位移和垂直位移。 glyphOffsets 包含 glyphCount 所指定的項目數目。
glyphCount
類型: UINT32
執行中的字元數目。
isSideways
類型: BOOL
如果 為 TRUE,字元的遞增會沿著基準執行。 如果 為 FALSE,則字元遞增程式會與基準垂直執行。 例如,垂直基準上的英文字母會設定 為FALSE。
用戶端可以藉由將 isSideways 設定為 TRUE ,並使用轉換將產生的幾何 90 度旋轉至右邊,來轉譯垂直執行。 isSideways 和 isRightToLeft 參數不可以是 true。
isRightToLeft
類型: BOOL
圖像的視覺順序。 如果此參數為 FALSE,則字元前移會從左至右。 如果 為 TRUE,則前進方向為由右至左。 根據預設,前進方向是由左至右。
geometrySink
類型: IDWriteGeometrySink*
呼叫回介面的指標,以執行大綱繪圖作業。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | dwrite.h |
程式庫 | Dwrite.lib |
Dll | Dwrite.dll |