Win32 API 日本語リファレンス
ホーム › Graphics.DirectWrite › IDWriteRenderingParams

IDWriteRenderingParams

COM
📘 Microsoft Learn (日本語) · English
IID2f0da53a-2add-47cd-82ee-d9ec34688e75継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

グリフのラスタライズおよびフィルタリングに用いる、ClearType レベル、コントラスト強調、ガンマ補正などのテキストレンダリング設定を表します。

メソッド 5

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 FLOAT GetGamma()

ガンマ補正に使用されるガンマ値を取得します。有効な値は 0 より大きく、256 を超えない必要があります。

戻り値

型: FLOAT

ガンマ補正に使用されるガンマ値を返します。有効な値は 0 より大きく、256 を超えない必要があります。

解説(Remarks)

ガンマ値はガンマ補正に使用され、ほとんどのモニターがもつ非線形な輝度応答を補正します。

vtbl 4 FLOAT GetEnhancedContrast()

レンダリングパラメータオブジェクトのコントラスト強調プロパティを取得します。有効な値は 0 以上です。

戻り値

型: FLOAT

コントラスト強調の量を返します。有効な値は 0 以上です。

解説(Remarks)

コントラスト強調とはテキストの暗さを増加させる量であり、通常は 0 から 1 の範囲です。0 はコントラスト強調を行わないことを意味します。

vtbl 5 FLOAT GetClearTypeLevel()

レンダリングパラメータオブジェクトの ClearType レベルを取得します。

戻り値

型: FLOAT

レンダリングパラメータオブジェクトの ClearType レベル。

解説(Remarks)

ClearType レベルは ClearType の適用量、すなわち各ピクセルの赤、緑、青のサブピクセルをどの程度個別に扱うかの度合いを表します。有効な値は 0(ClearType なし。グレースケールのアンチエイリアシングと同等)から 1(完全な ClearType)までの範囲です。

vtbl 6 DWRITE_PIXEL_GEOMETRY GetPixelGeometry()

レンダリングパラメータオブジェクトのピクセルジオメトリを取得します。

戻り値

型: DWRITE_PIXEL_GEOMETRY

レンダリングパラメータオブジェクトで使用されるピクセルジオメトリの種類を示す値。

vtbl 7 DWRITE_RENDERING_MODE GetRenderingMode()

レンダリングパラメータオブジェクトのレンダリングモードを取得します。

戻り値

型: DWRITE_RENDERING_MODE

レンダリングパラメータオブジェクトのレンダリングモードを示す値。

解説(Remarks)

既定では、レンダリングモードは DWRITE_RENDERING_MODE_DEFAULT に初期化されます。これはレンダリングモードがフォントとサイズに基づいて自動的に決定されることを意味します。特定のフォント、サイズ、およびレンダリングパラメータオブジェクトに対して推奨されるレンダリングモードを判定するには、IDWriteFontFace::GetRecommendedRenderingMode メソッドを使用します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

#define global IID_IDWriteRenderingParams "{2F0DA53A-2ADD-47CD-82EE-D9EC34688E75}"
#usecom global IDWriteRenderingParams IID_IDWriteRenderingParams "{}"
#comfunc global IDWriteRenderingParams_GetGamma             3
#comfunc global IDWriteRenderingParams_GetEnhancedContrast  4
#comfunc global IDWriteRenderingParams_GetClearTypeLevel    5
#comfunc global IDWriteRenderingParams_GetPixelGeometry     6
#comfunc global IDWriteRenderingParams_GetRenderingMode     7
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。