ID2D1RadialGradientBrush

領域を放射状グラデーションで塗りつぶします。

ID2D1RadialGradientBrush は、グラデーションストップのコレクションをグラデーションにマッピングするという点で ID2D1LinearGradientBrush に似ています。ただし、線形グラデーションがグラデーションベクトルを定義するために始点と終点を持つのに対し、放射状グラデーションは楕円とグラデーションの原点を使用してグラデーションの動作を定義します。楕円の位置とサイズを定義するには、SetCenter、SetRadiusX、SetRadiusY の各メソッドを使用して、楕円の中心、x 半径、y 半径を指定します。グラデーションの原点は、SetGradientOriginOffset メソッドを使用してグラデーションのオフセットを指定しない限り、楕円の中心になります。

このブラシは、グラデーションストップの位置 0.0f をグラデーションの原点にマッピングし、位置 1.0f を楕円の境界にマッピングします。グラデーションの原点が楕円の内側にある場合、楕円の内容にはブラシのグラデーションストップの [0, 1] の範囲全体が含まれます。グラデーションの原点が楕円の境界の外側にある場合でもブラシは機能しますが、そのグラデーションは明確には定義されません。

始点と終点はブラシ空間で記述され、ブラシが使用されるときにレンダーターゲットにマッピングされます。始点と終点の座標は絶対的なものであり、レンダーターゲットのサイズに対する相対値ではないことに注意してください。値 (0, 0) はレンダーターゲットの左上隅にマッピングされ、値 (1, 1) は (0, 0) から対角方向に 1 ピクセルだけ離れた位置にマッピングされます。恒等変換ではないブラシ変換またはレンダーターゲット変換が存在する場合、ブラシの楕円とグラデーションの原点も変換されます。

塗りつぶされる領域を完全には満たさない楕円を指定することもできます。この場合、(ブラシの ID2D1GradientStopCollection によって指定される) D2D1_EXTEND_MODE 設定によって、残りの領域がどのように塗りつぶされるかが決まります。

ID2D1RadialGradientBrush オブジェクトの作成

放射状グラデーションブラシはデバイス依存のリソースです。アプリケーションは、ブラシを使用するレンダーターゲットを初期化した後に放射状グラデーションブラシを作成し、レンダーターゲットの再作成が必要になるたびにブラシを再作成する必要があります。(リソースの詳細については、Resources Overview を参照してください。)

例

放射状グラデーションブラシの作成方法の例については、How to Create a Radial Gradient Brush のトピックを参照してください。

グラデーション楕円の中心を、ブラシの座標空間で指定します。

グラデーション楕円の中心を基準とした、グラデーション原点のオフセットを指定します。

グラデーション楕円の x 半径を、ブラシの座標空間で指定します。

グラデーション楕円の y 半径を、ブラシの座標空間で指定します。

グラデーション楕円の中心を取得します。

型: D2D1_POINT_2F

グラデーション楕円の中心。この値はブラシの座標空間で表されます。

グラデーション楕円の中心を基準とした、グラデーション原点のオフセットを取得します。

型: D2D1_POINT_2F

グラデーション楕円の中心からのグラデーション原点のオフセット。この値はブラシの座標空間で表されます。

グラデーション楕円の x 半径を取得します。

型: FLOAT

グラデーション楕円の x 半径。この値はブラシの座標空間で表されます。

グラデーション楕円の y 半径を取得します。

型: FLOAT

グラデーション楕円の y 半径。この値はブラシの座標空間で表されます。

この放射状グラデーションブラシオブジェクトに関連付けられた ID2D1GradientStopCollection を取得します。

ID2D1GradientStopCollection には、D2D1_GRADIENT_STOP 構造体の配列に加えて、拡張モードや色補間モードなどの追加情報が含まれます。