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_MEASURING_MODE_GDI_CLASSIC DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC
- DWRITE_MEASURING_MODE_GDI_NATURAL DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL
renderingParams
物件的指標,其中包含呈現設定,例如 gamma 層級、增強對比和 ClearType 層級。 如果轉譯參數物件覆寫轉譯模式,則需要此參數。
[out] renderingMode
當這個方法傳回時,會包含值,指出要使用的建議轉譯模式。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | dwrite.h |
程式庫 | Dwrite.lib |
Dll | Dwrite.dll |