IDWriteFactory4：：TranslateColorGlyphRun 方法 （dwrite_3.h）

将字形运行转换为颜色字形运行序列，该序列可以呈现以生成原始“base”运行的颜色表示形式。

Syntax

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。

要求

另请参阅

IDWriteFactory4