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.