IDWriteFontFace::GetRecommendedRenderingMode 方法 (dwrite.h)
使用指定的大小和呈现参数确定字体的建议呈现模式。
语法
HRESULT GetRecommendedRenderingMode(
FLOAT emSize,
FLOAT pixelsPerDip,
DWRITE_MEASURING_MODE measuringMode,
IDWriteRenderingParams *renderingParams,
[out] DWRITE_RENDERING_MODE *renderingMode
);
参数
emSize
类型: FLOAT
字体的逻辑大小(以 DIP 为单位)。 DIP (“与设备无关的像素”) 等于 1/96 英寸。
pixelsPerDip
类型: FLOAT
每个 DIP 的物理像素数。 例如,如果呈现图面的 DPI 为 96,则此值为 1.0f。 如果 DPI 为 120,则此值为 120.0f/96。
measuringMode
将用于字体字形的测量方法。 呈现器实现可能会为不同的测量方法选择不同的呈现模式,例如:
- DWRITE_MEASURING_MODE_NATURAL DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL
- DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC DWRITE_MEASURING_MODE_GDI_CLASSIC
- DWRITE_MEASURING_MODE_GDI_NATURAL DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL
renderingParams
指向对象的指针,该对象包含呈现设置,例如伽玛级别、增强对比度和 ClearType 级别。 如果呈现参数对象替代呈现模式,则此参数是必需的。
[out] renderingMode
此方法返回时,包含一个值,该值指示要使用的建议呈现模式。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | dwrite.h |
Library | Dwrite.lib |
DLL | Dwrite.dll |