ID2D1RadialGradientBrush インターフェイス (d2d1.h)
放射状グラデーションを使用して領域を塗りつぶします。
継承
ID2D1RadialGradientBrush インターフェイスは、ID2D1Brush から継承されます。 ID2D1RadialGradientBrush には、次の種類のメンバーもあります。
メソッド
ID2D1RadialGradientBrush インターフェイスには、これらのメソッドがあります。
| ID2D1RadialGradientBrush::GetCenter グラデーションの楕円の中心を取得します。 |
| ID2D1RadialGradientBrush::GetGradientOriginOffset グラデーションの楕円の中心を基準としたグラデーションの原点のオフセットを取得します。 |
| ID2D1RadialGradientBrush::GetGradientStopCollection この放射状グラデーション ブラシ オブジェクトに関連付けられている ID2D1GradientStopCollection を取得します。 |
| ID2D1RadialGradientBrush::GetRadiusX グラデーションの楕円の x 半径を取得します。 |
| ID2D1RadialGradientBrush::GetRadiusY グラデーションの楕円の y 半径を取得します。 |
| ID2D1RadialGradientBrush::SetCenter ブラシの座標空間におけるグラデーションの楕円の中心を指定します。 |
| ID2D1RadialGradientBrush::SetGradientOriginOffset グラデーションの楕円の中心を基準としたグラデーションの原点のオフセットを指定します。 |
| ID2D1RadialGradientBrush::SetRadiusX ブラシの座標空間におけるグラデーションの楕円の x 半径を指定します。 |
| ID2D1RadialGradientBrush::SetRadiusY ブラシの座標空間のグラデーション楕円の y 半径を指定します。 |
注釈
ID2D1RadialGradientBrush は ID2D1LinearGradientBrush と似ていますが、どちらもグラデーションの分岐点のコレクションをグラデーションにマップします。 ただし、線形グラデーションにはグラデーション ベクトルを定義するための始点と終点があり、放射状グラデーションでは楕円とグラデーションの原点を使用してそのグラデーションの動作が定義されます。 楕円の位置とサイズを定義するには、 SetCenter、 SetRadiusX、 および SetRadiusY メソッドを使用して、楕円の中心、x 半径、および y 半径を指定します。 グラデーションの原点は、 SetGradientOriginOffset メソッドを使用してグラデーション オフセットを指定しない限り、楕円の中心です。
ブラシはグラデーションの原点のグラデーションの停止位置 0.0f をマップし、位置 1.0f は楕円境界にマップされます。 グラデーションの原点が楕円内にある場合、楕円の内容はブラシグラデーションの [0, 1] 範囲全体を囲みます。 グラデーションの原点が楕円の境界外にある場合、ブラシは引き続き機能しますが、グラデーションは明確に定義されていません。
始点と終点はブラシ空間で記述され、ブラシの使用時にレンダー ターゲットにマップされます。 開始座標と終了座標は絶対座標であり、レンダー ターゲット サイズに対する相対座標ではないことに注意してください。 値 (0,0) はレンダー ターゲットの左上隅にマップされ、値 (1, 1) は (0, 0) から斜め 1 ピクセルだけマップされます。 非識別ブラシ変換またはレンダー ターゲット変換がある場合は、ブラシの楕円とグラデーションの原点も変換されます。
塗りつぶす領域を完全に塗りつぶさない楕円を指定できます。 この場合、 D2D1_EXTEND_MODE と設定 (ブラシ ID2D1GradientStopCollection で指定) によって、残りの領域の塗りつぶし方法が決まります。
ID2D1RadialGradientBrush オブジェクトの作成
放射状グラデーション ブラシを作成するには、ブラシを使用するレンダー ターゲットの ID2D1RenderTarget::CreateRadialGradientBrush メソッドを使用します。 ブラシは、ブラシを作成したレンダー ターゲット、またはそのレンダー ターゲットの互換性のあるターゲットでのみ使用できます。放射状グラデーション ブラシはデバイスに依存するリソースです。アプリケーションでは、ブラシを使用するレンダー ターゲットを初期化した後に放射状グラデーション ブラシを作成し、レンダー ターゲットを再作成する必要がある場合は常にブラシを再作成する必要があります。 (リソースの詳細については、「リソースの 概要」を参照してください)。
例
放射状グラデーション ブラシを作成する方法の例については、「放射状グラデーション ブラシ を作成する方法 」トピックを参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | d2d1.h |