Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Canvas 2D: trasformazioni, stato di disegno, ritaglio e rettangoli

Distingui lo stato di disegno dal tracciato corrente e dalla bitmap per limitare il ritaglio a una fase del disegno e cancellare solo i pixel desiderati.

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

Sintassi

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform()
ctx.setTransform(matrix2D)
ctx.save()
ctx.restore()
ctx.beginPath()
ctx.rect(x, y, width, height)
ctx.clip()
ctx.clip(fillRule)
ctx.clip(path)
ctx.clip(path, fillRule)
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.strokeRect(x, y, width, height)

Questi metodi appartengono all’interfaccia web CanvasRenderingContext2D, non a ECMAScript 2024. Il supporto dipende dall’ambiente di esecuzione. setTransform(a, b, c, d, e, f) sostituisce la matrice invece di moltiplicarla: (x, y) diventa (a*x + c*y + e, b*x + d*y + f). Accetta anche un oggetto DOMMatrix2DInit: a e d valgono 1 per impostazione predefinita, gli altri coefficienti 0. Una chiamata senza argomenti imposta quindi la matrice identità. Valori discordanti per chiavi equivalenti, come a e m11, generano TypeError. La forma a sei numeri lascia invariata la matrice se un argomento è infinito o vale NaN.

save() mette in pila una copia dello stato di disegno, che comprende trasformazione, area di ritaglio e stili. restore() estrae e ripristina l’ultimo stato salvato; se la pila è vuota, non fa nulla. Né il tracciato corrente né i pixel vengono salvati. beginPath() svuota il tracciato senza modificare il ritaglio o la bitmap. rect(x, y, width, height) aggiunge un sottotracciato rettangolare chiuso senza dipingere pixel. La trasformazione si applica alla geometria di quel tracciato mentre viene costruito.

clip() sostituisce l’area di ritaglio con la sua intersezione con l’interno del tracciato corrente o del Path2D fornito. Con Path2D, la trasformazione si applica al momento della chiamata a clip(), senza modificare l’oggetto. La regola di riempimento facoltativa 'nonzero' (predefinita) verifica che il conteggio con segno degli attraversamenti sia diverso da zero; 'evenodd' verifica che il numero di attraversamenti sia dispari. clip() non dipinge nulla e le chiamate successive non possono ampliare l’area. Salva lo stato prima del ritaglio e ripristinalo dopo il disegno: impostare la matrice identità non rimuove il ritaglio.

fillRect() riempie con fillStyle, strokeRect() traccia il contorno con strokeStyle e le impostazioni della linea, e clearRect() cancella impostando i pixel a nero trasparente (nero opaco con alpha: false), ignorando ombre, alfa globale e compositing. Tutti e tre agiscono direttamente sulla bitmap, rispettano trasformazione e ritaglio e lasciano invariato il tracciato. Quindi fillRect() non fornisce geometria a clip(). clearRect() non rimuove le restrizioni di lettura di una bitmap contaminata da dati di un’altra origine: getImageData() genera ancora SecurityError.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D clipping</title>
<canvas id="canvas" width="20" height="12"></canvas>
<script>
(() => {
  const canvas = document.getElementById('canvas');
  const ctx = canvas.getContext('2d', { alpha: true });
  if (!ctx) throw new Error('Canvas 2D unavailable');

  ctx.fillRect(0, 0, 12, 12);
  ctx.save();
  try {
    ctx.setTransform(1, 0, 0, 1, 4, 2);
    ctx.beginPath();
    ctx.rect(0, 0, 8, 8);
    ctx.clip();
    ctx.clearRect(-2, 2, 6, 4);
  } finally {
    ctx.restore();
  }

  ctx.lineWidth = 2;
  ctx.strokeRect(14, 2, 4, 8);
  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([3, 5, 9, 14, 16].map(x => alphaAt(x, 5)).join(', '));
})();
</script>

Risultato

255, 0, 255, 255, 0

Salva l’esempio come file HTML, aprilo in un browser e controlla la console di sviluppo. I cinque valori alfa mostrano, nell’ordine: il riempimento protetto dal ritaglio, un pixel cancellato, il riempimento intatto, il contorno disegnato dopo il ripristino dello stato e l’interno trasparente del contorno.

Lezioni correlate

  • JavaScript · Lezione 12 · Avanzato · Versione: 4

Fonti