Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Canvas 2D: cancellare un’area e disegnare un cerchio pieno

Distingui la cancellazione dei pixel dall’azzeramento del tracciato. Crea un cerchio con `arc()`, imposta `fillStyle` e riempilo con `fill()`.

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

Sintassi

const ctx = canvas.getContext("2d"); // CanvasRenderingContext2D or null

ctx.clearRect(x, y, width, height);
ctx.beginPath();
ctx.arc(x, y, radius, startAngle, endAngle);
ctx.arc(x, y, radius, startAngle, endAngle, counterclockwise);
ctx.fillStyle = style; // CSS color string, CanvasGradient, or CanvasPattern
ctx.fill();
ctx.fill(fillRule);
ctx.fill(path);
ctx.fill(path, fillRule); // path: Path2D; fillRule: "nonzero" or "evenodd"

clearRect(), beginPath(), arc() e fill() sono metodi di CanvasRenderingContext2D; fillStyle è una proprietà. Fanno parte delle API della piattaforma web, non di ECMAScript 2024. Su un elemento canvas, chiama canvas.getContext("2d") e verifica che il risultato non sia null: la disponibilità dipende dall’ambiente di esecuzione.

clearRect(x, y, width, height) imposta i pixel del rettangolo a nero trasparente nei contesti con il canale alfa attivo. Tiene conto della trasformazione e dell’area di ritaglio correnti, ma non usa fillStyle né elimina il tracciato. Per cancellare tutta la superficie con clearRect(0, 0, canvas.width, canvas.height), usa la trasformazione identità e assicurati che il ritaglio non escluda alcuna parte della superficie.

beginPath() svuota il tracciato corrente senza modificare i pixel o lo stile. Chiamalo prima di costruire una forma indipendente per evitare che il prossimo fill() riempia per errore anche la geometria precedente.

arc(x, y, radius, startAngle, endAngle, counterclockwise) aggiunge un arco con centro in (x, y) senza dipingerlo. Gli angoli si misurano in radianti a partire dal semiasse X positivo. Il verso predefinito è orario; true lo inverte nel sistema di coordinate predefinito. Gli angoli 0 e 2 * Math.PI, nel verso predefinito, formano una circonferenza completa. Se il tracciato ha già un punto finale, arc() lo collega all’inizio dell’arco con un segmento. Se un argomento numerico è NaN, Infinity o -Infinity, arc() termina senza modificare il tracciato. Se tutti gli argomenti numerici sono finiti, un raggio negativo genera IndexSizeError.

La proprietà fillStyle accetta una stringa di colore CSS, un CanvasGradient o un CanvasPattern. Il valore predefinito è il nero; una stringa di colore non valida lascia invariato lo stile precedente. L’assegnazione non cambia il colore dei pixel già disegnati.

fill() e fill(fillRule) riempiono il tracciato corrente usando lo stile corrente. fill(path) e fill(path, fillRule) riempiono invece l’oggetto Path2D fornito. La regola predefinita "nonzero" verifica che la somma degli attraversamenti del tracciato lungo una semiretta, contati con segno in base al verso, sia diversa da zero; "evenodd" verifica che il numero di attraversamenti sia dispari. Il riempimento tratta i sottotracciati aperti come chiusi, senza modificarli né svuotare il tracciato.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel samples</title>
<pre id="output"></pre>
<script>
  const canvas = document.createElement("canvas");
  canvas.width = 48;
  canvas.height = 24;
  const ctx = canvas.getContext("2d");
  if (!ctx) throw new Error("Canvas 2D is unavailable");

  const rgba = (x, y) => ctx.getImageData(x, y, 1, 1).data.join(",");

  ctx.beginPath();
  ctx.arc(12, 12, 8, 0, 2 * Math.PI);
  ctx.fillStyle = "#ff0000";
  ctx.fill();
  const samples = [rgba(12, 12)];

  ctx.clearRect(0, 0, canvas.width, canvas.height);
  ctx.beginPath();
  ctx.arc(36, 12, 8, 0, 2 * Math.PI);
  ctx.fillStyle = "#0000ff";
  ctx.fill();
  samples.push(rgba(12, 12), rgba(36, 12));

  document.getElementById("output").textContent = samples.join("\n");
</script>

Risultato

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

Salva l’esempio come file HTML e aprilo in un browser. I tre campioni RGBA visualizzati sono il centro rosso del primo cerchio, il pixel trasparente nella stessa posizione dopo il ridisegno e il centro blu del nuovo cerchio. Il canvas non viene aggiunto alla pagina. `getImageData()` genera `SecurityError` se il canvas non è più `origin-clean`, ad esempio dopo aver disegnato un’immagine da un’altra origine senza autorizzazione CORS; `clearRect()` da solo non ripristina questo stato.

Lezioni correlate

  • JavaScript · Lezione 27 · Intermedio · Versione: 3

Fonti