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 成功或错误代码。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | d2d1_3.h |
DLL | D2d1.dll |