HTML5 <canvas>リファレンスマニュアル
説明
HTML5 <canvas> タグは、(スクリプト、通常は JavaScript を使用して)画像を描画するために使用されます。
ただし、<canvas> 要素自体には描画能力はありません(単なるグラフィックのコンテナです)。実際の描画タスクを実行するには、スクリプトを使用する必要があります。
getContext() メソッドは、キャンバス上に描画するためのメソッドとプロパティを提供するオブジェクトを返します。
このマニュアルでは、キャンバス上にテキスト、線、矩形、円などを描画するために使用できる、完全な getContext("2d") オブジェクトのプロパティとメソッドを提供します。
ブラウザサポート
![]()
Internet Explorer 9、Firefox、Opera、Chrome、Safari は <canvas> タグの属性とメソッドをサポートしています。
注意:Internet Explorer 8 およびそれ以前の IE バージョンは <canvas> 要素をサポートしていません。
色、スタイル、シャドウ
| プロパティ | 説明 |
|---|---|
| fillStyle | 描画の塗りつぶしに使用される色、グラデーション、またはパターンを設定または返します。 |
| strokeStyle | ストロークに使用される色、グラデーション、またはパターンを設定または返します。 |
| shadowColor | シャドウに使用される色を設定または返します。 |
| shadowBlur | シャドウのぼかしレベルを設定または返します。 |
| shadowOffsetX | シャドウと形状の水平方向の距離を設定または返します。 |
| shadowOffsetY | シャドウと形状の垂直方向の距離を設定または返します。 |
| メソッド | 説明 |
|---|---|
| createLinearGradient() | 線形グラデーションを作成します(キャンバスコンテンツに使用)。 |
| createPattern() | 指定した方向に指定した要素を繰り返します。 |
| createRadialGradient() | 放射状/円形のグラデーションを作成します(キャンバスコンテンツに使用)。 |
| addColorStop() | グラデーションオブジェクト内の色と停止位置を指定します。 |
線スタイル
| プロパティ | 説明 |
|---|---|
| lineCap | 線の端点(キャップ)のスタイルを設定または返します。 |
| lineJoin | 2本の線が交差するときに作成される角のタイプを設定または返します。 |
| lineWidth | 現在の線の幅を設定または返します。 |
| miterLimit | 最大マイター長を設定または返します。 |
矩形
| メソッド | 説明 |
|---|---|
| rect() | 矩形を作成します。 |
| fillRect() | 塗りつぶした矩形を描画します。 |
| strokeRect() | 矩形を描画します(塗りつぶしなし)。 |
| clearRect() | 指定された矩形内の指定されたピクセルをクリアします。 |
パス
| メソッド | 説明 |
|---|---|
| fill() | 現在の図形(パス)を塗りつぶします。 |
| stroke() | 定義されたパスを描画します。 |
| beginPath() | パスを開始するか、現在のパスをリセットします。 |
| moveTo() | パスをキャンバス内の指定した点に移動します。線は作成しません。 |
| closePath() | 現在の点から開始点に戻るパスを作成します。 |
| lineTo() | 新しい点を追加し、その点から最後に指定した点までの線をキャンバス上に作成します。 |
| clip() | 元のキャンバスから任意の形状とサイズの領域をクリップします。 |
| quadraticCurveTo() | 二次ベジェ曲線を作成します。 |
| bezierCurveTo() | 三次ベジェ曲線を作成します。 |
| arc() | 円弧/曲線を作成します(円または部分円を作成するために使用)。 |
| arcTo() | 2つの接線の間の円弧/曲線を作成します。 |
| isPointInPath() | 指定した点が現在のパス内にある場合は true を返し、それ以外の場合は false を返します。 |
変換
| メソッド | 説明 |
|---|---|
| scale() | 現在の描画を拡大または縮小します。 |
| rotate() | 現在の図形を回転します。 |
| translate() | キャンバス上の (0,0) の位置を再マッピングします。 |
| transform() | 描画の現在の変換行列を置き換えます。 |
| setTransform() | 現在の変換を単位行列にリセットします。次に transform() を実行します。 |
テキスト
| プロパティ | 説明 |
|---|---|
| font | テキストコンテンツの現在のフォントプロパティを設定または返します。 |
| textAlign | テキストコンテンツの現在の配置(アライメント)を設定または返します。 |
| textBaseline | テキストの描画時に使用される現在のテキストベースラインを設定または返します。 |
| メソッド | 説明 |
|---|---|
| fillText() | キャンバス上に「塗りつぶされた」テキストを描画します。 |
| strokeText() | キャンバス上にテキストを描画します(塗りつぶしなし)。 |
| measureText() | 指定したテキストの幅を含むオブジェクトを返します。 |
画像の描画
| メソッド | 説明 |
|---|---|
| drawImage() | キャンバス上に画像、キャンバス、またはビデオを描画します。 |
ピクセル操作
| プロパティ | 説明 |
|---|---|
| width | ImageData オブジェクトの幅を返します。 |
| height | ImageData オブジェクトの高さを返します。 |
| data | 指定された ImageData オブジェクトの画像データを含むオブジェクトを返します。 |
| メソッド | 説明 |
|---|---|
| createImageData() | 新しい空の ImageData オブジェクトを作成します。 |
| getImageData() | キャンバス上の指定された矩形からピクセルデータをコピーした ImageData オブジェクトを返します。 |
| putImageData() | 画像データ(指定された ImageData オブジェクトから)をキャンバスに配置します。 |
合成
| プロパティ | 説明 |
|---|---|
| globalAlpha | 図形の現在のアルファ(不透明度)または透明度の値を設定または返します。 |
| globalCompositeOperation | 新しい画像が既存の画像にどのように描画されるかを設定または返します。 |
その他
| メソッド | 説明 |
|---|---|
| save() | 現在のコンテキストの状態を保存します。 |
| restore() | 以前に保存したパスの状態と属性を復元します。 |
| createEvent() | |
| getContext() | |
| toDataURL() |