Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Canvas 2D: cancellare, disegnare e modificare i pixel

Distingui le operazioni di disegno nel contesto 2D dalla lettura e dalla scrittura diretta dei pixel della bitmap.

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

Sintassi

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 e putImageData sono metodi di istanza del contesto restituito da canvas.getContext('2d'). Fanno parte delle API Web, non di ECMAScript 2024. clearRect() rispetta la trasformazione e la regione di ritaglio correnti. Imposta i pixel al nero trasparente (nero opaco con alpha: false) senza azzerare lo stato di disegno o il tracciato corrente. Usa beginPath() per iniziare un nuovo tracciato.

drawImage() accetta una sorgente CanvasImageSource pronta all’uso, come un’immagine o un altro canvas, non ImageData. Con 3 argomenti disegna l’intera sorgente nelle dimensioni intrinseche; con 5 imposta le dimensioni di destinazione; con 9 mappa un rettangolo sorgente su un rettangolo di destinazione. Le dimensioni negative estendono il rettangolo nella direzione opposta senza ribaltare l’immagine. Il disegno rispetta trasformazione, ritaglio e composizione. Se un’immagine è ancora in fase di caricamento e non è utilizzabile, drawImage() non la disegna. Un’immagine interamente disponibile e decodificabile può essere disegnata senza chiamare prima decode() e senza che un fotogramma sia già stato decodificato. Un canvas sorgente con una dimensione nulla genera InvalidStateError.

getImageData() legge i pixel della bitmap senza applicare trasformazione o ritaglio. Restituisce una copia ImageData indipendente: modificare data non cambia il canvas. L’array contiene valori RGBA per riga; il primo canale del pixel (x, y) della copia è all’indice (y * imageData.width + x) * 4. Fuori dalla bitmap si ottiene nero trasparente. Valori negativi di sw o sh estendono il rettangolo nella direzione opposta; una dimensione nulla genera IndexSizeError.

putImageData() sostituisce i pixel senza ridimensionamento, trasformazione, ritaglio del contesto o miscelazione. La forma a 7 argomenti seleziona un sottorettangolo in ImageData, non nella destinazione: il pixel (x, y) va in (dx + x, dy + y). Un buffer scollegato genera InvalidStateError. La conversione dello spazio colore e la premoltiplicazione dell’alfa possono cambiare i valori alla rilettura, soprattutto per i pixel semitrasparenti.

Disegnare una risorsa di un’altra origine senza autorizzazione CORS può far perdere alla bitmap lo stato origin-clean. La lettura genera allora SecurityError, anche dopo clearRect(). Per le risorse di un’altra origine usa una richiesta CORS e l’autorizzazione appropriata del server. Il formato di lettura predefinito rgba-unorm8 usa Uint8ClampedArray; verifica il supporto per opzioni come display-p3 o rgba-float16 (Float16Array) nei browser di destinazione.

Esempi

<!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>

Risultato

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

La prima riga mostra il pixel sinistro cancellato e quello destro rosso. Il codice rende blu il pixel destro della copia, poi scrive solo quel pixel con `dx = -1`. La seconda riga mostra il pixel sinistro blu e quello destro ancora rosso.

Lezioni correlate

  • JavaScript · Lezione 33 · Avanzato · Versione: 4

Fonti