CKTIS / JavaScript
Canvas 2D: czyszczenie obszaru i rysowanie wypełnionego koła
Oddziel czyszczenie pikseli od resetowania ścieżki. Zbuduj okrąg za pomocą `arc()`, ustaw `fillStyle` i wypełnij jego wnętrze metodą `fill()`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
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() i fill() to metody kontekstu CanvasRenderingContext2D, a fillStyle to jego właściwość. To API platformy webowej, nie część ECMAScript 2024. Na elemencie canvas wywołaj canvas.getContext("2d") i sprawdź, czy wynik nie jest null; dostępność zależy od środowiska.
clearRect(x, y, width, height) zmienia piksele w prostokącie na przezroczystą czerń, jeśli kontekst obsługuje przezroczystość. Uwzględnia bieżącą transformację i obszar przycinania, ale nie używa fillStyle ani nie usuwa ścieżki. Aby wyczyścić całe płótno za pomocą clearRect(0, 0, canvas.width, canvas.height), użyj transformacji jednostkowej i upewnij się, że przycinanie nie wyklucza żadnego fragmentu płótna.
beginPath() opróżnia bieżącą ścieżkę, nie zmieniając pikseli ani stylu. Wywołaj ją przed utworzeniem niezależnego kształtu, żeby następne fill() przypadkiem nie wypełniło ponownie starej geometrii.
arc(x, y, radius, startAngle, endAngle, counterclockwise) dodaje łuk o środku (x, y), ale go nie rysuje na bitmapie. Kąty podaje się w radianach, od dodatniego kierunku osi X. Domyślny kierunek jest zgodny z ruchem wskazówek zegara; true go odwraca w domyślnym układzie współrzędnych. Kąty 0 i 2 * Math.PI przy domyślnym kierunku dają pełny okrąg. Jeśli ścieżka ma już punkt końcowy, arc() łączy go odcinkiem z początkiem łuku. Jeśli którykolwiek argument liczbowy ma wartość NaN, Infinity lub -Infinity, metoda kończy działanie bez zmiany ścieżki. Gdy wszystkie argumenty liczbowe są skończone, ujemny promień powoduje wyjątek IndexSizeError.
Właściwość fillStyle przyjmuje kolor CSS jako ciąg znaków, CanvasGradient albo CanvasPattern. Domyślnym kolorem jest czerń; nieprawidłowy ciąg koloru pozostawia poprzedni styl. Przypisanie nie zmienia narysowanych już pikseli.
fill() i fill(fillRule) wypełniają bieżącą ścieżkę aktualnym stylem. fill(path) i fill(path, fillRule) używają przekazanego obiektu Path2D. Reguła domyślna "nonzero" uwzględnia kierunki przecięć ścieżki przez promień i sprawdza, czy ich suma ze znakami jest niezerowa; "evenodd" sprawdza, czy liczba przecięć jest nieparzysta. Wypełnianie traktuje otwarte podścieżki jak zamknięte, ale ich nie zmienia ani nie opróżnia ścieżki.
Przykłady
<!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>Wynik
255,0,0,255 0,0,0,0 0,0,255,255
Zapisz przykład jako plik HTML i otwórz go w przeglądarce. Trzy wyświetlone próbki RGBA to czerwony środek pierwszego koła, przezroczysty piksel w tym samym miejscu po przerysowaniu i niebieski środek nowego koła. Płótno nie jest dołączone do strony. `getImageData()` zgłasza `SecurityError`, jeśli płótno utraciło status `origin-clean`, na przykład po narysowaniu obrazu z innego źródła bez zgody CORS; samo `clearRect()` nie przywraca tego statusu.
Powiązane lekcje
- JavaScript · Lekcja 27 · Średniozaawansowany · Wersja: 3