Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Canvas 2D : effacer, dessiner et modifier des pixels

Distinguez les opérations de dessin du contexte 2D de la lecture et de l’écriture directes des pixels du bitmap.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const ctx = canvas.getContext('2d');

ctx.clearRect(x, y, width, height);

ctx.drawImage(image, dx, dy);
ctx.drawImage(image, dx, dy, dw, dh);
ctx.drawImage(image, sx, sy, sw, sh, dx, dy, dw, dh);

const snapshot = ctx.getImageData(sx, sy, sw, sh);
const configuredSnapshot = ctx.getImageData(sx, sy, sw, sh, settings);

ctx.putImageData(imageData, dx, dy);
ctx.putImageData(imageData, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight);

clearRect, drawImage, getImageData et putImageData sont des méthodes d’instance du contexte renvoyé par canvas.getContext('2d'). Elles relèvent des API Web, pas d’ECMAScript 2024. clearRect() tient compte de la transformation et de la zone de découpe courantes. La méthode met les pixels à noir transparent (noir opaque avec alpha: false), sans réinitialiser l’état de dessin ni le tracé courant. Pour commencer un nouveau tracé, appelez beginPath().

drawImage() attend une source CanvasImageSource prête à l’emploi, comme une image ou un autre canevas, et non un ImageData. Avec 3 arguments, la méthode dessine la source entière à sa taille intrinsèque ; avec 5, elle fixe la taille de destination ; avec 9, elle fait correspondre un rectangle source à un rectangle de destination. Des dimensions négatives étendent le rectangle dans l’autre sens sans retourner l’image. Le dessin tient compte de la transformation, de la découpe et de la composition. Si une image est encore en cours de chargement et n’est pas encore utilisable, drawImage() ne la dessine pas. Une image entièrement disponible et décodable peut être dessinée sans appel préalable à decode() ni trame déjà décodée. Un canevas source de dimension nulle déclenche InvalidStateError.

getImageData() lit les pixels du bitmap sans tenir compte de la transformation ni de la découpe. La méthode renvoie une copie ImageData indépendante : modifier data ne change pas le canevas. Le tableau contient les valeurs RGBA ligne par ligne ; le premier canal du pixel (x, y) de la copie se trouve à l’indice (y * imageData.width + x) * 4. Hors du bitmap, le résultat est noir transparent. Des valeurs négatives de sw ou sh étendent le rectangle dans l’autre sens ; une dimension nulle déclenche IndexSizeError.

putImageData() remplace les pixels sans mise à l’échelle, transformation, découpe du contexte ni mélange. La forme à 7 arguments sélectionne un sous-rectangle dans ImageData, pas dans la destination : le pixel (x, y) est écrit à (dx + x, dy + y). Un tampon détaché déclenche InvalidStateError. La conversion d’espace colorimétrique et la prémultiplication de l’alpha peuvent changer les valeurs à la relecture, surtout pour les pixels translucides.

Dessiner une ressource d’une autre origine sans autorisation CORS peut faire perdre au bitmap son statut origin-clean. La lecture déclenche alors SecurityError, même après clearRect(). Pour une ressource d’une autre origine, utilisez une requête CORS et l’autorisation appropriée du serveur. Le format de lecture par défaut rgba-unorm8 utilise Uint8ClampedArray ; vérifiez la prise en charge d’options comme display-p3 ou rgba-float16 (Float16Array) dans les navigateurs ciblés.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel readback</title>
<canvas id="source" width="2" height="1" hidden></canvas>
<canvas id="destination" width="2" height="1" hidden></canvas>
<script>
  const source = document.getElementById('source');
  const canvas = document.getElementById('destination');
  const src = source.getContext('2d');
  const ctx = canvas.getContext('2d');
  src.fillStyle = '#ff0000';
  src.fillRect(0, 0, 2, 1);
  ctx.drawImage(source, 0, 0);
  ctx.clearRect(0, 0, 1, 1);

  const snapshot = ctx.getImageData(0, 0, 2, 1);
  console.log(snapshot.data.join(','));
  snapshot.data.set([0, 0, 255, 255], 4);
  ctx.putImageData(snapshot, -1, 0, 1, 0, 1, 1);
  console.log(ctx.getImageData(0, 0, 2, 1).data.join(','));
</script>

Résultat

0,0,0,0,255,0,0,255
0,0,255,255,255,0,0,255

La première ligne montre le pixel gauche effacé et le pixel droit rouge. Le code passe au bleu le pixel droit de la copie, puis écrit uniquement ce pixel avec `dx = -1`. La seconde ligne montre le pixel gauche bleu et le pixel droit toujours rouge.

Leçons associées

  • JavaScript · Leçon 33 · Avancé · Version : 4

Sources