Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

CanvasRenderingContext2D — disegnare su una bitmap

CanvasRenderingContext2D offre un’interfaccia di disegno 2D con stato per rettangoli, tracciati, testo, immagini e pixel. Distingui lo stato del contesto, il tracciato corrente e il contenuto della bitmap.

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

Sintassi

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

Ottieni CanvasRenderingContext2D tramite canvas.getContext('2d'); controlla che il risultato non sia null. È una Web API dello standard HTML, non di ECMAScript. I motori dei browser moderni supportano queste operazioni di base; Node 24 non ne dimostra la disponibilità. Imposta canvas.width e canvas.height prima di disegnare: assegnare loro un valore reimposta la bitmap e lo stato.

fillRect riempie un rettangolo, strokeRect ne traccia il contorno e clearRect cancella un’area, normalmente rendendola nero trasparente; con alpha: false, nero opaco. Non modificano il tracciato. beginPath elimina il tracciato corrente; moveTo avvia un sottotracciato, lineTo aggiunge un segmento e closePath chiude il sottotracciato. arc aggiunge un arco con angoli in radianti; rect aggiunge un rettangolo. fill riempie il tracciato e stroke ne traccia il contorno.

fillStyle e strokeStyle specificano colori, gradienti o motivi; lineWidth specifica lo spessore della linea. fillText riempie il testo e strokeText ne traccia il contorno; font seleziona carattere e dimensione, mentre textBaseline seleziona la linea di base di riferimento. measureText restituisce TextMetrics, incluso width; le metriche dipendono dal font.

save salva lo stato e restore lo ripristina, senza annullare i pixel né il tracciato. setTransform(a, b, c, d, e, f) sostituisce la trasformazione. clip interseca la regione di ritaglio con il tracciato; usa save/restore per limitarne l’ambito. drawImage disegna una sorgente immagine, con ritaglio e ridimensionamento facoltativi.

getImageData legge i pixel come ImageData e putImageData li scrive; entrambi ignorano la trasformazione e la scrittura ignora anche il ritaglio. Un’immagine di un’altra origine senza CORS adeguato può contaminare la bitmap: la lettura genera SecurityError. Fornisci un’alternativa accessibile al contenuto della bitmap.

Identificatori di riferimento trattati in questa voce: 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.

Esempi

(() => {
  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(','));
})();

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti