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 。

需求

另請參閱

IDWriteFontFace