Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Canvas 2D: trasformazioni, rettangoli e tracciati

Distingui la trasformazione, i pixel e il tracciato predefinito. Scopri quando si trasformano le coordinate, quali chiamate modificano subito i pixel e che cosa rimane dopo `stroke()`.

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

Sintassi

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform(matrix)
ctx.setTransform()
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.beginPath()
ctx.moveTo(x, y)
ctx.lineTo(x, y)
ctx.stroke()
ctx.stroke(path)

CanvasRenderingContext2D è un’interfaccia di un’API web, non di ECMAScript 2024. Invoca questi metodi sul contesto ctx restituito da canvas.getContext('2d'), che può essere null. Il supporto delle singole forme di chiamata dipende dall’ambiente di esecuzione. I sette metodi restituiscono undefined in una chiamata normale.

setTransform(a, b, c, d, e, f) sostituisce la matrice corrente, mentre transform() la moltiplica. Il punto (x, y) diventa (a*x + c*y + e, b*x + d*y + f). L’overload con oggetto accetta un dizionario per una matrice 2D (DOMMatrix2DInit): i componenti omessi prendono i valori della matrice identità e valori incompatibili per alias come a e m11 provocano un TypeError. Lo standard consente la chiamata senza argomenti per impostare l’identità. Nell’overload con sei numeri, un argomento infinito o NaN lascia invariata la matrice corrente. L’overload con dizionario costruisce una DOMMatrix da un dizionario valido e la imposta come matrice corrente senza questo controllo.

fillRect(x, y, width, height) disegna subito un rettangolo usando fillStyle. Con gli stessi parametri, clearRect() azzera i pixel al nero trasparente (nero opaco con alpha: false), indipendentemente dallo stile di disegno, da globalAlpha e dalla modalità di compositing. Entrambi rispettano la trasformazione e l’area di ritaglio correnti senza modificare il tracciato. Una dimensione nulla non ha effetto; una negativa estende il rettangolo nella direzione opposta a partire da (x, y).

beginPath() svuota il tracciato predefinito senza cancellare pixel. moveTo(x, y) inizia un nuovo sottotracciato senza collegarlo al precedente. lineTo(x, y) aggiunge un segmento rettilineo dall’ultimo punto; se non esiste un sottotracciato, imposta soltanto il punto iniziale. Nessuno di questi tre metodi dipinge. moveTo(), lineTo() e i due metodi per i rettangoli ignorano le chiamate con coordinate o dimensioni infinite o NaN.

stroke() disegna il contorno del tracciato predefinito con strokeStyle e impostazioni di linea come lineWidth. Non chiude i sottotracciati aperti né svuota il tracciato. Le coordinate del tracciato predefinito vengono trasformate quando sono aggiunte, non di nuovo durante il disegno; la matrice corrente influisce comunque sul tratto, per esempio sullo spessore. Con stroke(path), la geometria del Path2D fornito viene trasformata al momento del disegno senza modificare l’oggetto. save() e restore() salvano e ripristinano lo stato di disegno, compresa la matrice, ma non il tracciato predefinito né i pixel.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D</title>
<canvas id="demo" width="32" height="24" hidden></canvas>
<script>
(() => {
  const canvas = document.getElementById('demo');
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D is unavailable');

  ctx.setTransform(1, 0, 0, 1, 8, 4);
  ctx.fillStyle = '#000';
  ctx.fillRect(0, 0, 16, 8);
  ctx.beginPath();
  ctx.moveTo(2, 12);
  ctx.lineTo(14, 12);
  ctx.clearRect(0, 0, 4, 8);

  ctx.setTransform(1, 0, 0, 1, 0, 0);
  ctx.strokeStyle = '#000';
  ctx.lineWidth = 4;
  ctx.stroke();

  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([alphaAt(9, 6), alphaAt(15, 6), alphaAt(15, 16), alphaAt(5, 12)].join(', '));
})();
</script>

Risultato

0, 255, 255, 0

Salva l’esempio come file HTML, aprilo in un browser e controlla la console. I valori alfa attesi `0, 255, 255, 0` corrispondono all’area cancellata, al riempimento rimasto, alla linea traslata e a un punto intatto nel sistema non traslato. `getImageData()` legge nelle coordinate della bitmap. Le impostazioni sulla privacy possono alterare il risultato; la lettura di un canvas contaminato da contenuti non autorizzati di un’altra origine può generare `SecurityError`.

Lezioni correlate

  • JavaScript · Lezione 34 · Avanzato · Versione: 4

Fonti