IDWriteFontFace1::GetGdiCompatibleGlyphAdvances メソッド (dwrite_1.h)

一連のグリフのピクセルアラインされた進みを返します。

構文

HRESULT GetGdiCompatibleGlyphAdvances(
                 FLOAT               emSize,
                 FLOAT               pixelsPerDip,
  [in, optional] DWRITE_MATRIX const *transform,
                 BOOL                useGdiNatural,
                 BOOL                isSideways,
                 UINT32              glyphCount,
  [in]           UINT16 const        *glyphIndices,
  [out]          INT32               *glyphAdvances
);

パラメーター

emSize

型: FLOAT

DIP 単位のフォントの論理サイズ。 DIP ("デバイスに依存しないピクセル") は 1/96 インチです。

pixelsPerDip

型: FLOAT

DIP あたりの物理ピクセル数。 たとえば、レンダリング サーフェイスの DPI が 96 の場合、この値は 1.0f です。 DPI が 120 の場合、この値は 120.0f/96 です。

[in, optional] transform

型: const DWRITE_MATRIX*

グリフとその位置に適用されるオプションの変換。 この変換は、フォント サイズと pixelsPerDip で指定されたスケーリングの後に適用されます。

useGdiNatural

種類: BOOL

FALSE の場合、メトリックは GDI エイリアステキスト (DWRITE_MEASURING_MODE_GDI_CLASSIC) と同じです。 TRUE の場合、メトリックは、CLEARTYPE_NATURAL_QUALITY (DWRITE_MEASURING_MODE_GDI_NATURAL) を使用してフォントを使用して GDI によって測定されるものと同じです。

isSideways

種類: BOOL

水平方向の進みではなく、グリフの垂直方向の進み方を取得します。

glyphCount

型: UINT32

調整を取得するグリフの合計。

[in] glyphIndices

型: const UINT16*

アドバンスを取得するグリフ ID の配列。

[out] glyphAdvances

型: const INT32*

返された は、各グリフのフォント デザイン単位で進みます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

これは、 GetGdiCompatibleGlyphMetrics を 呼び出し、事前の幅と高さのみを使用することと同じです。

GetGdiCompatibleGlyphMetrics と同様に、これらはデザイン 単位であり、DWRITE_FONT_METRICS::d esignUnitsPerEm によってスケールダウンする必要があります。

要件

こちらもご覧ください

IDWriteFontFace1