IDWriteFontFace1::GetGdiCompatibleGlyphAdvances 方法 (dwrite_1.h)
返回字形序列的像素对齐前移。
语法
HRESULT GetGdiCompatibleGlyphAdvances(
FLOAT emSize,
FLOAT pixelsPerDip,
[in, optional] DWRITE_MATRIX const *transform,
BOOL useGdiNatural,
BOOL isSideways,
UINT32 glyphCount,
[in] UINT16 const *glyphIndices,
[out] INT32 *glyphAdvances
);
参数
emSize
类型: FLOAT
字体的逻辑大小(以 DIP 单位为单位)。 DIP (“与设备无关的像素”) 等于 1/96 英寸。
pixelsPerDip
类型: FLOAT
每个 DIP 的物理像素数。 例如,如果呈现图面的 DPI 为 96,则此值为 1.0f。 如果 DPI 为 120,则此值为 120.0f/96。
[in, optional] transform
类型: const DWRITE_MATRIX*
应用于字形及其位置的可选转换。 此转换在字体大小和像素PerDip 指定的缩放后应用。
useGdiNatural
类型: BOOL
如果为 FALSE,则指标与 GDI 别名文本 (DWRITE_MEASURING_MODE_GDI_CLASSIC) 相同。 如果为 TRUE,则指标与使用 CLEARTYPE_NATURAL_QUALITY (DWRITE_MEASURING_MODE_GDI_NATURAL) 字体通过 GDI 测量的指标相同。
isSideways
类型: BOOL
检索字形的垂直前进而不是水平前进。
glyphCount
类型: UINT32
要检索其调整的总字形。
[in] glyphIndices
类型: const UINT16*
要检索前进的字形 ID 的数组。
[out] glyphAdvances
类型: const INT32*
返回的每个字形的字体设计单位的先进性。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
这相当于调用 GetGdiCompatibleGlyphMetrics 并仅使用前进宽度和高度。
与 GetGdiCompatibleGlyphMetrics 一样,它们位于设计单元中,这意味着它们必须按 DWRITE_FONT_METRICS::d esignUnitsPerEm 进行缩减。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 适用于 Windows 7 的Windows 8和平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 适用于 Windows Server 2008 R2 的Windows Server 2012和平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | dwrite_1.h |
Library | Dwrite_1.lib |
DLL | Dwrite_1.dll |