ID2D1LinearGradientBrush
COM公式ドキュメント
線形グラデーションで領域を塗りつぶします。
解説(Remarks)
ID2D1LinearGradientBrush は、ブラシの開始点と終了点を結ぶ線に沿った線形グラデーションで領域を塗りつぶします。ID2D1GradientStopCollection によって定義されるこのグラデーションは、この線に対して垂直方向に押し出され、その後(指定されていれば)ブラシ変換によって変換されます。
開始点と終了点はブラシ空間で記述され、ブラシが使用されるときにレンダーターゲットへマッピングされます。開始座標と終了座標は絶対値であり、レンダーターゲットのサイズに対する相対値ではない点に注意してください。(0, 0) の値はレンダーターゲットの左上隅にマッピングされ、(1, 1) の値は (0, 0) から対角方向に 1 ピクセル離れた位置にマッピングされます。非単位のブラシ変換またはレンダーターゲット変換がある場合、ブラシの開始点と終了点もそれに応じて変換されます。
グラデーション軸として、塗りつぶされる領域を完全には満たさないものを指定することも可能です。この場合、ID2D1GradientStopCollection で指定された D2D1_EXTEND_MODE によって、残りの領域の塗りつぶし方が決まります。
ID2D1LinearGradientBrush オブジェクトの作成
線形グラデーションブラシを作成するには、そのブラシを使用するレンダーターゲットの ID2D1RenderTarget::CreateLinearGradientBrush メソッドを使用します。ブラシは、それを作成したレンダーターゲット、またはそのレンダーターゲットと互換性のあるターゲットでのみ使用できます。線形グラデーションブラシはデバイス依存リソースです。アプリケーションは、ブラシを使用するレンダーターゲットを初期化した後に線形グラデーションブラシを作成し、レンダーターゲットの再作成が必要になるたびにブラシも再作成する必要があります。(リソースの詳細については、リソースの概要を参照してください。)
メソッド 5
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ブラシの座標空間における線形グラデーションの開始座標を設定します。
| startPoint | D2D_POINT_2F | in | ブラシの座標空間における線形グラデーションの 2 次元の開始座標です。 |
解説(Remarks)
開始点と終了点はブラシ空間で記述され、ブラシが使用されるときにレンダーターゲットへマッピングされます。非単位のブラシ変換またはレンダーターゲット変換がある場合、ブラシの開始点と終了点もそれに応じて変換されます。
ブラシの座標空間における線形グラデーションの終了座標を設定します。
| endPoint | D2D_POINT_2F | in | ブラシの座標空間における線形グラデーションの 2 次元の終了座標です。 |
解説(Remarks)
開始点と終了点はブラシ空間で記述され、ブラシが使用されるときにレンダーターゲットへマッピングされます。非単位のブラシ変換またはレンダーターゲット変換がある場合、ブラシの開始点と終了点もそれに応じて変換されます。
線形グラデーションの開始座標を取得します。
戻り値
ブラシの座標空間における線形グラデーションの 2 次元の開始座標です。
解説(Remarks)
開始点と終了点はブラシ空間で記述され、ブラシが使用されるときにレンダーターゲットへマッピングされます。非単位のブラシ変換またはレンダーターゲット変換がある場合、ブラシの開始点と終了点もそれに応じて変換されます。
線形グラデーションの終了座標を取得します。
戻り値
ブラシの座標空間における線形グラデーションの 2 次元の終了座標です。
解説(Remarks)
開始点と終了点はブラシ空間で記述され、ブラシが使用されるときにレンダーターゲットへマッピングされます。非単位のブラシ変換またはレンダーターゲット変換がある場合、ブラシの開始点と終了点もそれに応じて変換されます。
この線形グラデーションブラシに関連付けられた ID2D1GradientStopCollection を取得します。
| gradientStopCollection | ID2D1GradientStopCollection** | out | この線形グラデーションブラシオブジェクトに関連付けられた ID2D1GradientStopCollection オブジェクトです。このパラメーターは未初期化のまま渡されます。 |
解説(Remarks)
ID2D1GradientStopCollection には、D2D1_GRADIENT_STOP 構造体の配列と、拡張モードや色補間モードなどの情報が含まれます。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ID2D1LinearGradientBrush "{2CD906AB-12E2-11DC-9FED-001143A055F9}"
#usecom global ID2D1LinearGradientBrush IID_ID2D1LinearGradientBrush "{}"
#comfunc global ID2D1LinearGradientBrush_SetStartPoint 8 int
#comfunc global ID2D1LinearGradientBrush_SetEndPoint 9 int
#comfunc global ID2D1LinearGradientBrush_GetStartPoint 10
#comfunc global ID2D1LinearGradientBrush_GetEndPoint 11
#comfunc global ID2D1LinearGradientBrush_GetGradientStopCollection 12 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。