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

另请参阅

IDWriteFontFace1