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

原始 「base」 字元執行的指標。

[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。

需求

目標平台	Windows
標頭	dwrite_3.h
程式庫	Dwrite.lib

另請參閱

IDWriteFactory4