線形グラデーションの作成

GDI+ は、水平方向、垂直方向、および対角線方向の線形グラデーションをサポートしています。既定では、線形グラデーションの色は均等に変化していきます。しかし、線形グラデーションをカスタマイズして、色が不均等に変化していくようにすることもできます。

水平方向の線形グラデーション

直線、楕円、および四角形を水平方向の線形グラデーション ブラシで塗りつぶす例を次に示します。

' Pass in the opaque red and opaque blue as the third and fourth argument, 
' respectively.
Dim linGrBrush As New LinearGradientBrush( _
   New Point(0, 10), _
   New Point(200, 10), _
   Color.FromArgb(255, 255, 0, 0), _
   Color.FromArgb(255, 0, 0, 255))
Dim pen As New Pen(linGrBrush)
  
e.Graphics.DrawLine(pen, 0, 10, 200, 10)
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100)
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30)
[C#]
LinearGradientBrush linGrBrush = new LinearGradientBrush(
   new Point(0, 10),
   new Point(200, 10),
   Color.FromArgb(255, 255, 0, 0),   // Opaque red
   Color.FromArgb(255, 0, 0, 255));  // Opaque blue

Pen pen = new Pen(linGrBrush);

e.Graphics.DrawLine(pen, 0, 10, 200, 10);
e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100);
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30);

LinearGradientBrush コンストラクタは、4 つの引数として 2 つの点と 2 つの色を受け取ります。最初の点 (0, 10) は最初の色 (赤) に関連付けられており、2 番目の点 (200, 10) は 2 番目の色 (青) に関連付けられています。想定されるとおり、(0, 10) から (200, 10) へと描画された直線は、赤から青に段階的に変化していきます。

点 (50, 10) と点 (200, 10) の座標内の 10 という値そのものは重要ではありません。ここで重要なのは、2 つの点の 2 番目の座標が同じであること、つまり 2 つの点を結ぶ直線が水平であるということです。楕円と四角形も水平方向の座標値が 0 から 200 に移動するにつれて、赤から青に段階的に変化していきます。

これらの直線、楕円、および四角形を次の図に示します。水平方向の座標値が 200 を超えた場合は、同じグラデーション パターンが繰り返し適用されます。

線形グラデーションのカスタマイズ

上の例では、水平方向の座標値が 0 から 200 に移動するにつれて、色の要素が線形に変化していきます。たとえば、最初の座標が 0 から 200 までの間にある点は、青の要素も 0 から 255 までの間にあります。

GDI+ では、色がグラデーションの一方の端からもう一方の端へ向かって変化していくようすを調整できます。黒から赤に変化するグラデーション ブラシを次の表に基づいて作成する場合を考えます。

水平方向の座標が 0 から 200 までの値の 20% にしか満たない値のときに、赤の要素の輝度が既に最大値の半分になっています。

LinearGradientBrush オブジェクトの Blend プロパティを設定して、3 つの相対的な輝度値を 3 つの相対位置に関連付ける例を次に示します。上の表で示したように、相対的な輝度値 0.5 を相対位置 0.2 に関連付けます。このコードは、楕円および四角形をグラデーション ブラシで塗りつぶします。

' Pass in the opaque black and opaque red as the third and fourth argument, 
' respectively.
Dim linGrBrush As New LinearGradientBrush( _
   New Point(0, 10), _
   New Point(200, 10), _
   Color.FromArgb(255, 0, 0, 0), _
   Color.FromArgb(255, 255, 0, 0))

Dim relativeIntensities As Single() =  {0F, 0.5F, 1F}
Dim relativePositions As Single() =  {0F, 0.2F, 1F}

'Create a Blend object and assign it to linGrBrush.
Dim blend As New Blend()
blend.Factors = relativeIntensities
blend.Positions = relativePositions
linGrBrush.Blend = blend

e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100)
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30)
[C#]
LinearGradientBrush linGrBrush = new LinearGradientBrush(
   new Point(0, 10),
   new Point(200, 10),
   Color.FromArgb(255, 0, 0, 0),     // Opaque black 
   Color.FromArgb(255, 255, 0, 0));  // Opaque red

float[] relativeIntensities = {0.0f, 0.5f, 1.0f};
float[] relativePositions   = {0.0f, 0.2f, 1.0f};

//Create a Blend object and assign it to linGrBrush.
Blend blend = new Blend();
blend.Factors = relativeIntensities;
blend.Positions = relativePositions;
linGrBrush.Blend = blend;

e.Graphics.FillEllipse(linGrBrush, 0, 30, 200, 100);
e.Graphics.FillRectangle(linGrBrush, 0, 155, 500, 30);

結果として得られた楕円と四角形を次の図に示します。

対角線方向の線形グラデーション

上の例のグラデーションは水平方向であり、つまり、水平線に沿って移動するにつれて色が段階的に変化していきました。垂直方向のグラデーションと対角線方向のグラデーションも定義できます。

LinearGradientBrush コンストラクタに点 (0, 0) と点 (200, 100) を渡す例を次に示します。青色は点 (0, 0) に関連付けられており、緑色は点 (200, 100) に関連付けられています。直線 (ペン幅が 10) と楕円が、線形グラデーション ブラシで塗りつぶされます。

' Pass in the opaque blue and opaque green as the third and fourth 
' argument, respectively.
Dim linGrBrush As New LinearGradientBrush( _
   New Point(0, 0), _
   New Point(200, 100), _
   Color.FromArgb(255, 0, 0, 255), _
   Color.FromArgb(255, 0, 255, 0)) 
      ' opaque blue
      ' opaque green
Dim pen As New Pen(linGrBrush, 10)

e.Graphics.DrawLine(pen, 0, 0, 600, 300)
e.Graphics.FillEllipse(linGrBrush, 10, 100, 200, 100)
[C#]
LinearGradientBrush linGrBrush = new LinearGradientBrush(
   new Point(0, 0),
   new Point(200, 100),
   Color.FromArgb(255, 0, 0, 255),   // opaque blue
   Color.FromArgb(255, 0, 255, 0));  // opaque green

Pen pen = new Pen(linGrBrush, 10);

e.Graphics.DrawLine(pen, 0, 0, 600, 300);
e.Graphics.FillEllipse(linGrBrush, 10, 100, 200, 100);

これらの直線と楕円を次の図に示します。点 (0, 0) から点 (200, 100) を結ぶ直線と平行な直線に沿って移動するにつれて、楕円内の色が段階的に変化しています。