addColorStop(offset, color)メソッドは、グラデーション色を追加する際に使用します。
引数offsetには、グラデーション色のオフセット値を指定します。
オフセット値とは、グラデーションの開始位置からどのくらいの離れているかを表した値のことです。
addColorStop()メソッドでは、グラデーションの開始位置は0.0、終了位置は1.0となります。
指定できるのは0.0～1.0の範囲の数値です。
オフセット値に範囲外の数値や数値以外の値を指定するとエラー（INDEX_SIZE_ERR）となります。
引数colorには、色を指定します。色の値はCSSによる色指定と同じです。
色として解析できない無効な値を指定するとエラー（SYNTAX_ERR）となります。
オフセット値と色を半角カンマ（ , ）区切りのセットで指定することで、
グラデーションのどの辺りがどんな色になるのかを指定することができます。
グラデーション色を３色以上指定すれば、例えば、赤から緑を経由して青に変わるなどのグラデーションも可能です。
グラデーションには、線形グラデーションと円形グラデーションを指定することができます。
線形グラデーションを指定する場合にはcreateLinearGradient()メソッドを、
円形グラデーションを指定する場合にはcreateRadialGradient()メソッドを使用します。
線形グラデーションで塗りつぶした四角形を描画する場合は以下のような流れとなります。
円形グラデーションで塗りつぶした円を描画する場合は以下のような流れとなります。
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>canvasで図形を描く</title>
<script type="text/javascript">
<!--
function test() {
//描画コンテキストの取得
var canvas = document.getElementById('sample');
if (canvas.getContext) {
var context = canvas.getContext('2d');
//ここに具体的な描画内容を指定する
//新しいパスを開始する
context.beginPath();
//線形グラデーションを指定する
var gradient = context.createLinearGradient(20,0,70,0);
//赤→緑→青となるように、グラデーション色を３つ追加する
gradient.addColorStop(0.0 , 'rgb(255,0,0)');
gradient.addColorStop(0.5 , 'rgb(0,255,0)');
gradient.addColorStop(1.0 , 'rgb(0,0,255)');
//上で指定したグラデーション内容を塗りつぶしスタイルに代入する
context.fillStyle = gradient;
//左から20上から20の位置に幅50高さ50の輪郭の四角形を作成する
context.rect(20,20,50,50);
//現在のパスを塗りつぶす
context.fill();
}
}
//-->
</script>
</head>
<body onLoad="test()">
<h2>Canvasで図形を描く</h2>
<canvas width="300" height="150" id="sample" style="background-color:yellow;">
図形を表示するには、canvasタグをサポートしたブラウザが必要です。
</canvas>
</body>
</html>