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

CKTIS / JavaScript

CanvasRenderingContext2D — dessiner sur un bitmap

CanvasRenderingContext2D fournit une interface de dessin 2D avec état pour les rectangles, les tracés, le texte, les images et les pixels. Distinguez l’état du contexte, le tracé courant et le contenu du bitmap.

Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntaxe

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

Obtenez CanvasRenderingContext2D avec canvas.getContext('2d') ; vérifiez que le résultat n’est pas null. Il s’agit d’une API Web de la norme HTML, et non d’ECMAScript. Ces opérations de base sont prises en charge par les moteurs de navigateur modernes ; Node 24 ne prouve pas qu’elles y sont disponibles. Définissez canvas.width et canvas.height avant de dessiner : leur affectation réinitialise le bitmap et l’état.

fillRect remplit un rectangle, strokeRect en dessine le contour et clearRect efface une zone, normalement en noir transparent ; avec alpha: false, en noir opaque. Ces méthodes ne modifient pas le tracé. beginPath abandonne le tracé courant ; moveTo commence un sous-tracé, lineTo ajoute un segment et closePath ferme le sous-tracé. arc ajoute un arc dont les angles sont en radians ; rect ajoute un rectangle. fill remplit le tracé et stroke en dessine le contour.

fillStyle et strokeStyle définissent les couleurs, dégradés ou motifs ; lineWidth définit l’épaisseur du trait. fillText remplit le texte et strokeText en dessine le contour ; font choisit la police et sa taille, tandis que textBaseline choisit la ligne de base de référence. measureText renvoie TextMetrics, notamment width ; les métriques dépendent de la police.

save enregistre l’état et restore le rétablit, sans annuler les pixels ni le tracé. setTransform(a, b, c, d, e, f) remplace la transformation. clip intersecte la région de découpage avec le tracé ; utilisez save/restore pour en limiter la portée. drawImage dessine une source d’image, avec recadrage et mise à l’échelle facultatifs.

getImageData lit les pixels sous forme de ImageData et putImageData les écrit ; les deux ignorent la transformation, et l’écriture ignore aussi le découpage. Une image d’origine différente sans CORS approprié peut contaminer le bitmap : la lecture déclenche SecurityError. Fournissez une alternative accessible au contenu du bitmap.

Identifiants de référence couverts par cette entrée : CanvasRenderingContext2D.clearRect, CanvasRenderingContext2D.fillRect, CanvasRenderingContext2D.strokeRect, CanvasRenderingContext2D.beginPath, CanvasRenderingContext2D.moveTo, CanvasRenderingContext2D.lineTo, CanvasRenderingContext2D.closePath, CanvasRenderingContext2D.stroke, CanvasRenderingContext2D.arc, CanvasRenderingContext2D.fill, CanvasRenderingContext2D.fillText, CanvasRenderingContext2D.strokeText, CanvasRenderingContext2D.lineWidth, CanvasRenderingContext2D.strokeStyle, CanvasRenderingContext2D.fillStyle, CanvasRenderingContext2D.font, CanvasRenderingContext2D.textBaseline, CanvasRenderingContext2D.save, CanvasRenderingContext2D.restore, CanvasRenderingContext2D.measureText, CanvasRenderingContext2D.setTransform, CanvasRenderingContext2D.rect, CanvasRenderingContext2D.clip, CanvasRenderingContext2D.drawImage, CanvasRenderingContext2D.getImageData, CanvasRenderingContext2D.putImageData.

Exemples

(() => {
  const canvas = document.createElement('canvas');
  canvas.width = 64;
  canvas.height = 48;
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D unavailable');
  document.body.append(canvas);

  ctx.clearRect(0, 0, 64, 48);
  ctx.save();
  ctx.setTransform(1, 0, 0, 1, 0, 0);
  ctx.beginPath();
  ctx.rect(0, 0, 32, 48);
  ctx.clip();
  ctx.fillStyle = '#ff0000';
  ctx.fillRect(0, 0, 64, 48);
  ctx.restore();
  ctx.beginPath();

  const pixel = ctx.getImageData(8, 8, 1, 1);
  ctx.putImageData(pixel, 48, 8);
  console.log(Array.from(ctx.getImageData(48, 8, 1, 1).data).join(','));
  console.log(Array.from(ctx.getImageData(40, 8, 1, 1).data).join(','));
})();

Résultat

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

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources