IDWriteFontFace2::GetRecommendedRenderingMode メソッド (dwrite_2.h)

フォント、サイズ、ワールド変換、測定モードに基づいて、推奨されるテキストレンダリングとグリッドフィットモードを決定します。

構文

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

パラメーター

[in] fontEmSize

型: FLOAT

DIP の論理フォント サイズ。

[in] dpiX

型: FLOAT

水平方向の論理インチあたりのピクセル数。

[in] dpiY

型: FLOAT

垂直方向の論理インチあたりのピクセル数。

[in, optional] transform

型: const DWRITE_MATRIX*

ワールド変換を記述する DWRITE_MATRIX 構造体。

[in] isSideways

種類: BOOL

フォントを横にするかどうかを指定します。 フォント が横の場合は TRUE。それ以外の場合は FALSE。

[in] outlineThreshold

種類: DWRITE_OUTLINE_THRESHOLD

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

[in] measuringMode

種類: DWRITE_MEASURING_MODE

テキスト レイアウト中に測定するために使用されるメソッドを指定する、 DWRITE_MEASURING_MODE型指定された値。 グリフの間隔を適切に設定するために、このメソッドは、指定した測定モードと互換性のあるレンダリング モードを返します。

[in, optional] renderingParams

型: IDWriteRenderingParams*

レンダリング パラメーター オブジェクトの IDWriteRenderingParams インターフェイスへのポインター。 このパラメーターは、レンダリング パラメーター オブジェクトがレンダリング モードをオーバーライドする場合に必要です。

[out] renderingMode

種類: DWRITE_RENDERING_MODE*

推奨されるレンダリング モードの DWRITE_RENDERING_MODE型指定の値を受け取る変数へのポインター。

[out] gridFitMode

種類: DWRITE_GRID_FIT_MODE*

推奨されるグリッドフィット モードの DWRITE_GRID_FIT_MODE型指定された値を受け取る変数へのポインター。

戻り値

種類: HRESULT

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

要件

要件	値
サポートされている最小のクライアント	Windows 8.1 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	dwrite_2.h
Library	Dwrite.lib
[DLL]	Dwrite.dll

こちらもご覧ください

IDWriteFontFace2