ID2D1DeviceContext4：：GetSvgGlyphImage 方法 (d2d1_3.h)

从颜色字形缓存中检索 SVG 字形的图像。 如果缓存尚未包含请求的资源，则会创建它。 此方法可用于延长字形图像的生存期，即使从颜色字形缓存中逐出该标志符号图像也是如此。

语法

HRESULT GetSvgGlyphImage(
                 D2D1_POINT_2F           glyphOrigin,
  [in]           IDWriteFontFace         *fontFace,
                 FLOAT                   fontEmSize,
                 UINT16                  glyphIndex,
                 BOOL                    isSideways,
  [in, optional] const D2D1_MATRIX_3X2_F *worldTransform,
  [in, optional] ID2D1Brush              *defaultFillBrush,
  [in, optional] ID2D1SvgGlyphStyle      *svgGlyphStyle,
                 UINT32                  colorPaletteIndex,
  [out]          D2D1_MATRIX_3X2_F       *glyphTransform,
  [out]          ID2D1CommandList        **glyphImage
);

参数

glyphOrigin

类型： D2D1_POINT_2F

字形的起源。

[in] fontFace

类型： IDWriteFontFace*

对包含字体类型、相应文件引用、人脸识别数据和各种字体数据（如指标、名称和字形轮廓）的字体的引用。

fontEmSize

类型： FLOAT

指定的字号会影响输出字形Transform，使其正确缩放字形。

glyphIndex

类型： UINT16

要检索的字形的索引。

isSideways

类型： BOOL

如果为 true，则指定标志符号向左旋转 90 度，并使用垂直指标。 垂直写入是通过将 isSideways 指定为 true 并通过旋转转换将整个运行向右旋转 90 度来实现的。

[in, optional] worldTransform

类型： const D2D1_MATRIX_3X2_F*

要应用于图像的转换。

[in, optional] defaultFillBrush

类型： ID2D1Brush*

描述如何绘制区域。

[in, optional] svgGlyphStyle

类型： ID2D1SvgGlyphStyle*

呈现 SVG 字形时使用的上下文填充、上下文笔划和上下文值的值。

colorPaletteIndex

类型： UINT32

用于在颜色字体中选择调色板的索引。 请注意，这与DWRITE_COLOR_GLYPH_RUN结构中的 paletteIndex 不同，后者与 SVG 字形无关。

[out] glyphTransform

类型： D2D1_MATRIX_3X2_F*

输出转换，它从字形的空间转换为与 worldTransform 相同的输出空间。 这包括输入字形Origin、字形与字形Origin 的偏移量，以及任何其他必需的转换。

[out] glyphImage

类型： ID2D1CommandList**

完成后，包含检索到的字形图像。

返回值

类型： HRESULT

此方法返回 HRESULT 成功或错误代码。

要求

另请参阅

ID2D1DeviceContext4