CKTIS / JavaScript
Canvas 2D: Einen Bereich löschen und einen gefüllten Kreis zeichnen
Unterscheide das Löschen von Pixeln vom Zurücksetzen des Pfads. Erzeuge mit `arc()` einen Kreis, setze `fillStyle` und fülle die Fläche mit `fill()`.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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() und fill() sind Methoden von CanvasRenderingContext2D; fillStyle ist eine Eigenschaft dieses Kontexts. Sie gehören zur Webplattform, nicht zu ECMAScript 2024. Rufe für ein Canvas-Element canvas.getContext("2d") auf und prüfe auf null; die Verfügbarkeit hängt von der Laufzeitumgebung ab.
clearRect(x, y, width, height) setzt die Pixel eines Rechtecks bei aktiviertem Alphakanal auf transparentes Schwarz. Die aktuelle Transformation und der Beschneidungsbereich gelten weiterhin; fillStyle wird nicht verwendet und der Pfad bleibt bestehen. Damit clearRect(0, 0, canvas.width, canvas.height) die gesamte Zeichenfläche löscht, verwende die Identitätstransformation und stelle sicher, dass kein Teil der Fläche durch den Beschneidungsbereich ausgeschlossen ist.
beginPath() leert den aktuellen Pfad, ohne Pixel oder Zeichenstile zu ändern. Rufe die Methode vor einer unabhängigen Form auf, damit das nächste fill() nicht versehentlich alte Geometrie erneut füllt.
arc(x, y, radius, startAngle, endAngle, counterclockwise) fügt einen Kreisbogen mit Mittelpunkt (x, y) zum Pfad hinzu, ohne ihn zu zeichnen. Die Winkel werden im Bogenmaß ab der positiven X-Achse gemessen. Standardmäßig verläuft der Bogen im Uhrzeigersinn; true kehrt die Richtung im Standardkoordinatensystem um. Mit 0 und 2 * Math.PI entsteht in Standardrichtung ein Vollkreis. Hat der Pfad bereits einen Endpunkt, verbindet arc() ihn geradlinig mit dem Bogenanfang. Ist eines der numerischen Argumente NaN, Infinity oder -Infinity, kehrt arc() zurück, ohne den Pfad zu ändern. Sind alle numerischen Argumente endlich, löst ein negativer Radius IndexSizeError aus.
Die Eigenschaft fillStyle akzeptiert eine CSS-Farbe als Zeichenfolge, ein CanvasGradient- oder ein CanvasPattern-Objekt. Der Standard ist Schwarz; eine ungültige Farbzeichenfolge lässt den vorherigen Stil unverändert. Die Zuweisung färbt bereits gezeichnete Pixel nicht um.
fill() und fill(fillRule) füllen den aktuellen Pfad mit dem aktuellen Stil. fill(path) und fill(path, fillRule) füllen stattdessen das angegebene Path2D-Objekt. Die Standardregel "nonzero" prüft, ob die Summe der Pfadkreuzungen entlang eines Strahls mit Vorzeichen für die Richtung ungleich null ist; "evenodd" prüft, ob die Anzahl der Kreuzungen ungerade ist. Beim Füllen gelten offene Teilpfade als geschlossen, ohne dass die Methode sie verändert oder den Pfad leert.
Beispiele
<!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>Ergebnis
255,0,0,255 0,0,0,0 0,0,255,255
Speichere das Beispiel als HTML-Datei und öffne sie im Browser. Die drei angezeigten RGBA-Proben zeigen den roten Mittelpunkt des ersten Kreises, das transparente Pixel an derselben Position nach dem Neuzeichnen und den blauen Mittelpunkt des neuen Kreises. Das Canvas-Element wird nicht in die Seite eingefügt. `getImageData()` löst `SecurityError` aus, wenn das Canvas nicht mehr `origin-clean` ist, etwa nach dem Zeichnen eines Bildes fremder Herkunft ohne CORS-Freigabe. `clearRect()` allein stellt diesen Status nicht wieder her.
Zugehörige Lektionen
- JavaScript · Lektion 27 · Mittlere Stufe · Version: 3