通过

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

另请参阅

ID2D1DeviceContext4