D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES 構造体
グラデーションの原点のオフセット、および ID2D1RadialGradientBrush のグラデーション楕円のサイズと位置を格納します。
構文
struct D2D1_RADIAL_GRADIENT_BRUSH_PROPERTIES {
D2D1_POINT_2F center;
D2D1_POINT_2F gradientOriginOffset;
FLOAT radiusX;
FLOAT radiusY;
};
メンバー
- center
D2D1_POINT_2F ブラシの座標空間では、グラデーション楕円の中心。 - gradientOriginOffset
D2D1_POINT_2F ブラシの座標空間では、グラデーション楕円の中心と相対的なグラデーション原点のオフセット。 - radiusX
FLOAT ブラシの座標空間では、グラデーション楕円の X 半径。 - radiusY
FLOAT ブラシの座標空間では、グラデーション楕円の Y 半径。
解説
center、gradientOriginOffset、radiusX、または radiusY の値が異なると、生成されるグラデーションも異なります。次の図は、さまざまな角度からライトで円を照らした場合の外観を作成して、グラデーションの原点のオフセットが異なる、いくつかの放射状グラデーションを示しています。
便宜上、Direct2D には、D2D1_RADIAL_GRADIENT_BRUSH 構造体を作成するための D2D1::RadialGradientBrushProperties 関数が用意されています。
例
次の例では、CreateRadialGradientBrush を呼び出し、ID2D1RadialGradientBrush を作成します。D2D1::RadialGradientBrushProperties ヘルパー関数を使用して、center の値が (75, 5)、gradientOriginOffset の値が (0, 0)、および radiusX と radiusY の値が 75 の D2D1_RADIAL_GRADIENT_BRUSH 構造体を作成し、その構造体を CreateRadialGradientBrush メソッドに渡します。グラデーション ブラシを使用して四角形を塗りつぶすと、次の出力が生成されます。
// The center of the gradient is in the center of the box.
// The gradient origin offset was set to zero(0, 0) or center in this case.
if (SUCCEEDED(hr))
{
hr = m_pRenderTarget->CreateRadialGradientBrush(
D2D1::RadialGradientBrushProperties(
D2D1::Point2F(75, 75),
D2D1::Point2F(0, 0),
75,
75),
pGradientStops,
&m_pRadialGradientBrush
);
}
この例では、コードが省略されています。完全なコードについては、「ブラシの種類の例」を参照してください。放射状グラデーション ブラシの詳細については、「放射状グラデーション ブラシを作成する方法」および「ブラシの概要」を参照してください。
要件
クライアントの最小要件 |
Windows 7, Windows Vista SP2 および Windows Vista 用のプラットフォーム更新プログラム |
サーバーの最小要件 |
Windows Server 2008 R2, Windows Server 2008 SP2 および Windows Server 2008 用のプラットフォーム更新プログラム |
ヘッダー |
D2d1.h |