Share via

IDWriteFontFace1::GetRecommendedRenderingMode メソッド (dwrite_1.h)

  • [アーティクル]

指定したサイズとレンダリング パラメーターを使用して、フォントに推奨されるレンダリング モードを決定します。

構文

HRESULT GetRecommendedRenderingMode(
                 FLOAT                    fontEmSize,
                 FLOAT                    dpiX,
                 FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
                 BOOL                     isSideways,
                 DWRITE_OUTLINE_THRESHOLD outlineThreshold,
                 DWRITE_MEASURING_MODE    measuringMode,
  [out]          DWRITE_RENDERING_MODE    *renderingMode
);

パラメーター

fontEmSize

型: FLOAT

DIP 単位のフォントの論理サイズ。 DIP ("デバイスに依存しないピクセル") は 1/96 インチです。

dpiX

型: FLOAT

水平方向の位置における DIP あたりの物理ピクセル数。 たとえば、レンダリング サーフェイスの DPI が 96 の場合、この値は 1.0f です。 DPI が 120 の場合、この値は 120.0f/96 です。

dpiY

型: FLOAT

垂直位置の DIP あたりの物理ピクセル数。 たとえば、レンダリング サーフェイスの DPI が 96 の場合、この値は 1.0f です。 DPI が 120 の場合、この値は 120.0f/96 です。

[in, optional] transform

型: const DWRITE_MATRIX*

ワールド変換を指定します。

isSideways

種類: BOOL

ラン内のグリフが横になっているかどうか。

outlineThreshold

種類: DWRITE_OUTLINE_THRESHOLD

グラフィックス システムのアウトライン レンダリングの品質を指定する DWRITE_OUTLINE_THRESHOLD型指定された値は、アウトライン レンダリングが使用されるサイズのしきい値に影響します。

measuringMode

種類: DWRITE_MEASURING_MODE

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

[out] renderingMode

種類: DWRITE_RENDERING_MODE*

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

戻り値

型: HRESULT

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

注釈

このメソッドは、レンダリング パラメーター オブジェクトのレンダリング モードがDWRITE_RENDERING_MODE_DEFAULT場合に、実際のレンダリング モードを決定するために使用する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー dwrite_1.h
Library Dwrite_1.lib
[DLL] Dwrite_1.dll

こちらもご覧ください

IDWriteFontFace1