ID2D1DeviceContext4：：GetColorBitmapGlyphImage 方法 (d2d1_3.h)
从颜色字形缓存中检索颜色位图标志符号的图像。 如果缓存尚未包含请求的资源，则会创建它。 此方法可用于延长字形图像的生存期，即使从颜色字形缓存中逐出该标志符号图像也是如此。
语法
HRESULT GetColorBitmapGlyphImage(
DWRITE_GLYPH_IMAGE_FORMATS glyphImageFormat,
D2D1_POINT_2F glyphOrigin,
[in] IDWriteFontFace *fontFace,
FLOAT fontEmSize,
UINT16 glyphIndex,
BOOL isSideways,
[in, optional] const D2D1_MATRIX_3X2_F *worldTransform,
FLOAT dpiX,
FLOAT dpiY,
[out] D2D1_MATRIX_3X2_F *glyphTransform,
[out] ID2D1Image **glyphImage
);
参数
glyphImageFormat
类型： DWRITE_GLYPH_IMAGE_FORMATS
字形图像的格式。 如果请求的字形没有采用所请求格式的图像数据，此方法将返回错误。
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*
要应用于图像的转换。 此输入转换会影响从字体使用哪个位图的选择。 它还会考虑在输出字形Transform 中。
dpiX
类型： FLOAT
沿 x 轴的每英寸点数。
dpiY
类型： FLOAT
沿 y 轴的每英寸点数。
[out] glyphTransform
类型： D2D1_MATRIX_3X2_F*
输出转换，它从字形的空间转换为与 worldTransform 相同的输出空间。 这包括输入字形Origin、字形与字形Origin 的偏移量，以及任何其他必需的转换。
[out] glyphImage
类型： ID2D1Image**
完成后包含检索到的字形图像。
返回值
类型： HRESULT
此方法返回 HRESULT 成功或错误代码。
要求
| 目标平台 | Windows |
| 标头 | d2d1_3.h |
| DLL | D2d1.dll |