CKTIS / JavaScript
Canvas 2D: brisanje območja in risanje zapolnjenega kroga
Loči brisanje slikovnih pik od praznjenja poti. Z metodo `arc()` ustvari krožnico, nastavi `fillStyle` in zapolni notranjost z metodo `fill()`.
Različica: 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() in fill() so metode konteksta CanvasRenderingContext2D, fillStyle pa je njegova lastnost. Spadajo v spletno platformo, ne v ECMAScript 2024. Na elementu canvas pokliči canvas.getContext("2d") in preveri, ali je rezultat null; razpoložljivost je odvisna od izvajalnega okolja.
clearRect(x, y, width, height) nastavi slikovne pike v pravokotniku na prosojno črno, če ima kontekst omogočen kanal alfa. Upošteva trenutno transformacijo in območje obrezovanja, vendar ne uporabi fillStyle in ne odstrani poti. Če želiš z clearRect(0, 0, canvas.width, canvas.height) izbrisati celotno platno, uporabi identično transformacijo in poskrbi, da obrezovanje ne izključi nobenega dela platna.
beginPath() izprazni trenutno pot, ne da bi spremenil slikovne pike ali slog. Pokliči ga pred sestavljanjem neodvisne oblike, da naslednji fill() ne bo pomotoma znova zapolnil prejšnje geometrije.
arc(x, y, radius, startAngle, endAngle, counterclockwise) doda krožni lok s središčem v (x, y), ne da bi ga izrisal. Koti so v radianih od pozitivne polosi X. Privzeta smer je v smeri urnega kazalca; true jo v privzetem koordinatnem sistemu obrne. Kota 0 in 2 * Math.PI v privzeti smeri tvorita celotno krožnico. Če ima pot že končno točko, jo arc() z ravno črto poveže z začetkom loka. Če je kateri od številskih argumentov NaN, Infinity ali -Infinity, se arc() konča, ne da bi spremenil pot. Če so vsi številski argumenti končni, negativen polmer sproži izjemo IndexSizeError.
Lastnost fillStyle sprejme niz z barvo CSS, CanvasGradient ali CanvasPattern. Privzeta barva je črna; neveljaven barvni niz ne spremeni prejšnjega sloga. Prireditev ne prebarva že izrisanih slikovnih pik.
fill() in fill(fillRule) zapolnita trenutno pot s trenutnim slogom. fill(path) in fill(path, fillRule) namesto nje zapolnita podani Path2D. Privzeto pravilo "nonzero" preveri, ali je vsota presečišč poltraka s potjo, označenih s predznakom glede na smer prečkanja, različna od nič; "evenodd" preveri, ali je število presečišč liho. Med polnjenjem se odprte podpotí obravnavajo kot zaprte, ne da bi se spremenile ali da bi se pot izpraznila.
Primeri
<!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
Shrani primer kot datoteko HTML in jo odpri v brskalniku. Trije prikazani vzorci RGBA so rdeče središče prvega kroga, prosojna slikovna pika na istem mestu po ponovnem izrisu ter modro središče novega kroga. Platno ni dodano na stran. `getImageData()` sproži `SecurityError`, če platno ni več `origin-clean`, na primer po izrisu slike z drugega izvora brez dovoljenja CORS; sam `clearRect()` tega stanja ne obnovi.
Povezane lekcije
- JavaScript · Lekcija 27 · Srednja · Različica: 3