IDWriteFactory2::TranslateColorGlyphRun メソッド (dwrite_2.h)

このメソッドはグリフ実行で呼び出され、複数のカラー グリフ実行に変換されます。

構文

HRESULT TranslateColorGlyphRun(
                 FLOAT                              baselineOriginX,
                 FLOAT                              baselineOriginY,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldToDeviceTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator     **colorLayers
);

パラメーター

baselineOriginX

型: FLOAT

元のグリフ実行の水平ベースラインの原点。

baselineOriginY

型: FLOAT

元のグリフ実行の垂直方向のベースラインの原点。

[in] glyphRun

型: const DWRITE_GLYPH_RUN*

モノクロ グリフ ID を含む元のグリフ実行。

[in, optional] glyphRunDescription

型: const DWRITE_GLYPH_RUN_DESCRIPTION*

省略可能なグリフ実行の説明。

measuringMode

種類: DWRITE_MEASURING_MODE

実行にカラー グリフが含まれている場合にグリフの位置を計算するために使用される測定モード。

[in, optional] worldToDeviceTransform

型: const DWRITE_MATRIX*

ワールド変換に DPI スケーリングを掛けます。 これは、実行にカラー グリフが含まれており、測定モードが DWRITE_MEASURING_MODE_NATURALされていない場合にグリフの位置を計算するために必要です。 このパラメーターが NULL の場合、ID 変換が想定されます。

colorPaletteIndex

型: UINT32

使用するカラー パレットの 0 から始まるインデックス。 IDWriteFontFace2::GetColorPaletteCount によって返されるように、有効なインデックスはフォント内のパレットの数よりも少なくなります。

[out] colorLayers

型: IDWriteColorGlyphRunEnumerator**

元のグリフ実行にカラー グリフが含まれている場合、このパラメーターは IDWriteColorGlyphRunEnumerator インターフェイスへのポインターを受け取ります。 クライアントは、返されたインターフェイスを使用して、グリフの実行に関する情報と、元のグリフ実行の代わりにレンダリングする関連色を取得します。 元のグリフ実行にカラー グリフが含まれていない場合、このメソッドは DWRITE_E_NOCOLOR を返し、出力ポインターは NULL です。

戻り値

型: HRESULT

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

解説

コードが色情報を含まないグリフ実行でこのメソッドを呼び出す場合、メソッドは DWRITE_E_NOCOLOR を返して、元のグリフ実行を描画できることをアプリケーションに通知します。 グリフ実行に色情報が含まれている場合、関数は、実行と関連付けられた色を公開するために 列挙できる オブジェクトを返します。 次に、アプリケーションは DrawGlyphRun を呼び出し、返される各グリフの実行と前景色を指定します。

要件

関連項目

IDWriteFactory2