CKTIS / JavaScript
Canvas 2D: vymazanie oblasti a vykreslenie vyplneného kruhu
Rozlišujte medzi vymazaním pixelov a vyprázdnením cesty. Pomocou `arc()` vytvorte kružnicu, nastavte `fillStyle` a vyplňte jej vnútro metódou `fill()`.
Verzia: 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() a fill() sú metódy kontextu CanvasRenderingContext2D; fillStyle je jeho vlastnosť. Patria do webového API, nie do ECMAScriptu 2024. Na prvku canvas zavolajte canvas.getContext("2d") a overte, či výsledok nie je null; dostupnosť závisí od prostredia, v ktorom kód beží.
clearRect(x, y, width, height) nastaví pixely v obdĺžniku na priehľadnú čiernu, ak má kontext zapnutý alfa kanál. Zohľadňuje aktuálnu transformáciu a oblasť orezania, ale nepoužíva fillStyle ani neodstraňuje cestu. Ak chcete pomocou clearRect(0, 0, canvas.width, canvas.height) vymazať celé plátno, použite identickú transformáciu a overte, že orezanie nevylučuje žiadnu časť plátna.
beginPath() vyprázdni aktuálnu cestu bez zmeny pixelov alebo štýlu. Zavolajte ju pred vytvorením samostatného tvaru, aby nasledujúce fill() omylom znova nevyplnilo predchádzajúcu geometriu.
arc(x, y, radius, startAngle, endAngle, counterclockwise) pridá oblúk so stredom (x, y) bez toho, aby ho vykreslilo. Uhly sa merajú v radiánoch od kladnej polosi X. Predvolený smer je v smere hodinových ručičiek; true ho v predvolenej súradnicovej sústave obráti. Uhly 0 a 2 * Math.PI v predvolenom smere vytvoria celú kružnicu. Ak má cesta koncový bod, arc() ho spojí so začiatkom oblúka úsečkou. Ak je niektorý číselný argument NaN, Infinity alebo -Infinity, arc() skončí bez zmeny cesty. Ak sú všetky číselné argumenty konečné, záporný polomer vyvolá výnimku IndexSizeError.
Vlastnosť fillStyle prijíma reťazec s farbou CSS, CanvasGradient alebo CanvasPattern. Predvolená farba je čierna; neplatný reťazec s farbou ponechá predchádzajúci štýl bezo zmeny. Priradenie neprefarbí už vykreslené pixely.
fill() a fill(fillRule) vyplnia aktuálnu cestu aktuálnym štýlom. fill(path) a fill(path, fillRule) namiesto nej vyplnia zadaný objekt Path2D. Predvolené pravidlo "nonzero" skúma, či je súčet priesečníkov polpriamky s cestou so znamienkami podľa smeru kríženia nenulový; "evenodd" skúma, či je ich počet nepárny. Pri vypĺňaní sa otvorené čiastkové cesty považujú za uzavreté bez toho, aby ich metóda zmenila alebo vyprázdnila cestu.
Príklady
<!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>Výsledok
255,0,0,255 0,0,0,0 0,0,255,255
Uložte príklad ako súbor HTML a otvorte ho v prehliadači. Tri zobrazené vzorky RGBA ukazujú červený stred prvého kruhu, priehľadný pixel na rovnakom mieste po prekreslení a modrý stred nového kruhu. Plátno sa nepridáva na stránku. `getImageData()` vyvolá `SecurityError`, ak plátno už nie je `origin-clean`, napríklad po vykreslení obrázka z iného zdroja bez povolenia CORS; samotné `clearRect()` tento stav neobnoví.
Súvisiace lekcie
- JavaScript · Lekcia 27 · Stredne pokročilá · Verzia: 3