CKTIS / JavaScript
Canvas 2D: brisanje područja i crtanje ispunjenog kruga
Razlikuj brisanje piksela od pražnjenja putanje. Izradi kružnicu metodom `arc()`, postavi `fillStyle` i ispuni unutrašnjost metodom `fill()`.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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() metode su konteksta CanvasRenderingContext2D, a fillStyle je njegovo svojstvo. Dio su web-platforme, a ne ECMAScripta 2024. Na elementu canvas pozovi canvas.getContext("2d") i provjeri je li rezultat null; dostupnost ovisi o izvršnom okruženju.
clearRect(x, y, width, height) postavlja piksele pravokutnika na prozirnu crnu ako kontekst ima uključen alfa kanal. Uvažava trenutačnu transformaciju i područje izrezivanja, ali ne koristi fillStyle niti uklanja putanju. Za brisanje cijelog platna pomoću clearRect(0, 0, canvas.width, canvas.height) upotrijebi transformaciju identiteta i provjeri da izrezivanje ne isključuje nijedan dio platna.
beginPath() prazni trenutačnu putanju, ne mijenjajući piksele ni stil. Pozovi je prije izrade neovisnog oblika kako sljedeći fill() ne bi greškom ponovno ispunio prethodnu geometriju.
arc(x, y, radius, startAngle, endAngle, counterclockwise) dodaje kružni luk sa središtem u (x, y) bez iscrtavanja. Kutovi se mjere u radijanima od pozitivnog dijela osi X. Zadani je smjer u smjeru kazaljke na satu; true ga obrće u zadanom koordinatnom sustavu. Kutovi 0 i 2 * Math.PI u zadanom smjeru tvore cijelu kružnicu. Ako putanja već ima završnu točku, arc() je spaja s početkom luka dužinom. Ako je neki brojčani argument NaN, Infinity ili -Infinity, arc() završava bez promjene putanje. Ako su svi brojčani argumenti konačni, negativan polumjer izaziva iznimku IndexSizeError.
Svojstvo fillStyle prihvaća niz znakova s CSS bojom, CanvasGradient ili CanvasPattern. Zadana je boja crna; neispravan zapis boje ostavlja prethodni stil nepromijenjenim. Pridruživanje ne mijenja boju već iscrtanih piksela.
fill() i fill(fillRule) ispunjavaju trenutačnu putanju trenutačnim stilom. fill(path) i fill(path, fillRule) umjesto nje ispunjavaju zadani Path2D. Zadano pravilo "nonzero" provjerava je li zbroj presijecanja putanje polupravcem, s predznakom koji ovisi o smjeru presijecanja, različit od nule; "evenodd" provjerava je li broj presijecanja neparan. Pri ispunjavanju se otvoreni dijelovi putanje tretiraju kao zatvoreni, ali ih metoda ne mijenja niti prazni putanju.
Primjeri
<!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>Rezultat
255,0,0,255 0,0,0,0 0,0,255,255
Spremi primjer kao HTML datoteku i otvori je u pregledniku. Tri prikazana RGBA uzorka predstavljaju crveno središte prvog kruga, prozirni piksel na istom mjestu nakon ponovnog iscrtavanja i plavo središte novog kruga. Platno se ne dodaje stranici. `getImageData()` izaziva `SecurityError` ako platno više nema status `origin-clean`, primjerice nakon crtanja slike s drugog izvora bez dopuštenja CORS; sam `clearRect()` ne vraća taj status.
Povezane lekcije
- JavaScript · Lekcija 27 · Srednje · Verzija: 3