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

要使用的調色盤的零基索引。 有效的索引小於字型中的調色盤數目，如 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。

需求

另請參閱

IDWrite工廠4