IDWriteFontFace3::GetRecommendedRenderingMode メソッド (dwrite_3.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_MODE1   *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_MODE1*

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

[out] gridFitMode

種類: DWRITE_GRID_FIT_MODE*

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

戻り値

型: HRESULT

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

要件

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

関連項目

IDWriteFontFace3