IDWriteFactory4::TranslateColorGlyphRun メソッド (dwrite_3.h)

グリフの実行を一連のカラー グリフの実行に変換します。これは、元の "基本" 実行の色表現を生成するためにレンダリングできます。

構文

HRESULT TranslateColorGlyphRun(
                 D2D1_POINT_2F                      baselineOrigin,
  [in]           DWRITE_GLYPH_RUN const             *glyphRun,
  [in, optional] DWRITE_GLYPH_RUN_DESCRIPTION const *glyphRunDescription,
                 DWRITE_GLYPH_IMAGE_FORMATS         desiredGlyphImageFormats,
                 DWRITE_MEASURING_MODE              measuringMode,
  [in, optional] DWRITE_MATRIX const                *worldAndDpiTransform,
                 UINT32                             colorPaletteIndex,
  [out]          IDWriteColorGlyphRunEnumerator1    **colorLayers
);

パラメーター

baselineOrigin

種類: D2D1_POINT_2F

基本グリフの水平方向および垂直方向の原点は、事前変換座標で実行されます。

[in] glyphRun

種類: DWRITE_GLYPH_RUN

元の "基本" グリフ実行へのポインター。

[in, optional] glyphRunDescription

種類: DWRITE_GLYPH_RUN_DESCRIPTION

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

desiredGlyphImageFormats

種類: DWRITE_GLYPH_IMAGE_FORMATS

実行を分割する必要があるデータ形式。

measuringMode

種類: DWRITE_MEASURING_MODE

測定モード。各グリフの原点を計算するために必要です。

[in, optional] worldAndDpiTransform

種類: DWRITE_MATRIX

クライアントの座標空間からデバイス座標 (ピクセル) に変換する行列。つまり、ワールド変換に DPI スケーリングを乗算します。

colorPaletteIndex

型: UINT32

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

[out] colorLayers

型: IDWriteColorGlyphRunEnumerator1**

関数が成功した場合、カラー グリフの実行を取得するために使用できる列挙子オブジェクトへのポインターを受け取ります。 基本実行にカラー グリフがない場合、出力ポインターは NULL になり、メソッドは DWRITE_E_NOCOLORを返します。

戻り値

型: HRESULT

フォントに色情報がない場合、グリフ実行にカラー グリフが含まれていない場合、または指定したカラー パレットインデックスが範囲外の場合は、DWRITE_E_NOCOLORを返します。 この場合、クライアントは元のグリフ実行をレンダリングする必要があります。 それ以外の場合は、標準の HRESULT エラー コードを返します。

解説

IDWriteFactory2::TranslateColorGlyphRun の呼び出しは、次の形式で IDWriteFactory4::TranslateColorGlyph 実行を呼び出すことと同じです:DWRITE_GLYPH_IMAGE_FORMATS_TRUETYPE|DWRITE_GLYPH_IMAGE_FORMATS_CFF|DWRITE_GLYPH_IMAGE_FORMATS_COLR。

要件

対象プラットフォーム	Windows
ヘッダー	dwrite_3.h
Library	Dwrite.lib

関連項目

IDWriteFactory4