IDWriteFontFace::GetGdiCompatibleGlyphMetrics 方法 (dwrite.h)
以字型設計單位取得字元度量,其傳回值與 GDI 所產生的值相容。
語法
HRESULT GetGdiCompatibleGlyphMetrics(
FLOAT emSize,
FLOAT pixelsPerDip,
[in, optional] DWRITE_MATRIX const *transform,
BOOL useGdiNatural,
[in] UINT16 const *glyphIndices,
UINT32 glyphCount,
[out] DWRITE_GLYPH_METRICS *glyphMetrics,
BOOL isSideways
);
參數
emSize
類型: FLOAT
DIP 單位字型的邏輯大小。
pixelsPerDip
類型: FLOAT
每個 DIP 的實體圖元數目。
[in, optional] transform
類型:const DWRITE_MATRIX*
套用至字元及其位置的選擇性轉換。 此轉換會在字型大小和 pixelPerDip所指定的縮放比例之後套用。
useGdiNatural
類型: BOOL
當設定為 FALSE時,計量會與 GDI 別名文字的計量相同。 當設定為 TRUE時,計量會與 GDI 使用以 CLEARTYPE_NATURAL_QUALITY建立的字型來測量的文字計量相同。
[in] glyphIndices
類型: const UINT16*
要計算計量的字元索引陣列。
glyphCount
類型: UINT32
glyphIndices陣列中的專案數目。
[out] glyphMetrics
類型: DWRITE_GLYPH_METRICS*
由這個函式填入 DWRITE_GLYPH_METRICS 結構的陣列。 計量以字型設計單位表示。
isSideways
類型: BOOL
BOOL 值,指出字型是否在側邊執行中使用。 如果字型具有斜面模擬,這可能會影響圖像計量,因為側邊斜面模擬與非側邊傾斜模擬不同。
傳回值
類型: HRESULT
標準 HRESULT 錯誤碼。 如果任何輸入圖像索引超出目前字型臉部的有效圖像索引範圍,則會傳回 E_INVALIDARG 。
需求
目標平台 | Windows |
標頭 | dwrite.h |
程式庫 | Dwrite.lib |
Dll | Dwrite.dll |