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

请参阅

IDWriteFontFace