IDWriteFontFace::GetGdiCompatibleGlyphMetrics 方法 (dwrite.h)
获取字体设计单元中的字形指标,其返回值与 GDI 将生成的内容兼容。
语法
HRESULT GetGdiCompatibleGlyphMetrics(
FLOAT emSize,
FLOAT pixelsPerDip,
[in, optional] DWRITE_MATRIX const *transform,
BOOL useGdiNatural,
[in] UINT16 const *glyphIndices,
UINT32 glyphCount,
[out] DWRITE_GLYPH_METRICS *glyphMetrics,
BOOL isSideways
);
参数
emSize
类型: FLOAT
字体的逻辑大小(以 DIP 为单位)。
pixelsPerDip
类型: FLOAT
每个 DIP 的物理像素数。
[in, optional] transform
类型: const DWRITE_MATRIX*
应用于字形及其位置的可选转换。 此转换在字体大小和 pixelPerDip 指定的缩放之后应用。
useGdiNatural
类型: BOOL
设置为 FALSE 时,指标与 GDI 别名文本的指标相同。 设置为 TRUE 时,指标与使用 CLEARTYPE_NATURAL_QUALITY 创建的字体由 GDI 测量的文本的指标相同。
[in] glyphIndices
类型: const UINT16*
要计算其指标的字形索引数组。
glyphCount
类型: UINT32
glyphIndices 数组中的元素数。
[out] glyphMetrics
类型: DWRITE_GLYPH_METRICS*
此函数填充 的DWRITE_GLYPH_METRICS 结构的数组。 指标以字体设计单位表示。
isSideways
类型: BOOL
一个 BOOL 值,该值指示字体是否在横向运行中使用。 如果字体具有倾斜模拟,这可能会影响字形指标,因为侧向倾斜模拟不同于非侧向倾斜模拟。
返回值
类型: HRESULT
标准 HRESULT 错误代码。 如果任何输入字形索引超出了当前字体的有效字形索引范围,则将返回 E_INVALIDARG 。
要求
目标平台 | Windows |
标头 | dwrite.h |
Library | Dwrite.lib |
DLL | Dwrite.dll |