Share via

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。

要求

   
目标平台 Windows
标头 dwrite_3.h
Library Dwrite.lib

请参阅

IDWriteFactory4