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

フォント内のグリフに使用される測定方法。 レンダラーの実装では、次のように、測定方法ごとに異なるレンダリング モードを選択できます。

• 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

種類: IDWriteRenderingParams*

ガンマ レベル、拡張コントラスト、ClearType レベルなどのレンダリング設定を含むオブジェクトへのポインター。 このパラメーターは、レンダリング パラメーター オブジェクトがレンダリング モードをオーバーライドする場合に必要です。

[out] renderingMode

種類: DWRITE_RENDERING_MODE*

このメソッドが戻るときに、 には、使用する推奨レンダリング モードを示す値が含まれます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

要件

こちらもご覧ください

IDWriteFontFace