drawImage(image, dx, dy)－Canvasリファレンス

トップページ > Canvas > drawImage(image, dx, dy)

★Canvasリファレンス

context . drawImage(image, dx, dy) …… イメージを描画する
Internet Explorer9

drawImage(image, dx, dy)メソッドは、canvas上にイメージを描画する際に使用します。

引数imageは、描画するイメージを表します。具体的には <img>要素・ <canvas>要素・ <video>要素のいずれかを指定することができます。

引数(dx, dy)は、描画するイメージを配置する座標を表します。

引数の単位はピクセルです。イメージにおける1ピクセルは、canvas座標空間の1単位として換算されます。

イメージの描画は現在のパスには影響を与えません。また、影・透明度・切り抜き・合成の対象となります。

■引数（値）の説明

image: 描画するイメージ（指定できるのは<img>要素・ <canvas>要素・ <video>要素のいずれか）
dx: 描画イメージ矩形のx座標
dy: 描画イメージ矩形のy座標

■使用例

HTML + JavaScriptソース

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>canvasで図形を描く</title>
<script type="text/javascript">
<!--
//Imageオブジェクトを生成して、画像ファイルを先読みしておく
var img01 = new Image();
img01.src = "../images/kaeru.gif";

function test() {
  //描画コンテキストの取得
  var canvas = document.getElementById('sample');
  if (canvas.getContext) {
    var context = canvas.getContext('2d');
    //座標(10, 10)の位置にイメージを表示
    context.drawImage(img01, 10, 10);
  }
}
//-->
</script>
</head>
<body onLoad="test()">
<h2>Canvasで図形を描く</h2>
<canvas width="300" height="150" id="sample" style="background-color:yellow;">
図形を表示するには、canvasタグをサポートしたブラウザが必要です。
</canvas>
</body>
</html>

↓↓↓

ブラウザ上の表示

Canvasで図形を描く

■関連項目

<canvas> …… 図形を描く