CKTIS / JavaScript
Canvas 2D: vymazání oblasti a vykreslení vyplněného kruhu
Rozlišujte mezi vymazáním pixelů a vyprázdněním cesty. Pomocí `arc()` vytvořte kružnici, nastavte `fillStyle` a vyplňte její vnitřek metodou `fill()`.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
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() jsou metody kontextu CanvasRenderingContext2D; fillStyle je jeho vlastnost. Patří do webového API, nikoli do ECMAScriptu 2024. Na prvku canvas zavolejte canvas.getContext("2d") a ověřte, zda výsledek není null; dostupnost závisí na běhovém prostředí.
clearRect(x, y, width, height) nastaví pixely v obdélníku na průhlednou černou, pokud má kontext povolený alfa kanál. Bere v úvahu aktuální transformaci a oblast ořezu, ale nepoužívá fillStyle ani nemaže cestu. Chcete-li pomocí clearRect(0, 0, canvas.width, canvas.height) vymazat celé plátno, použijte identickou transformaci a ověřte, že ořez nevylučuje žádnou část plátna.
beginPath() vyprázdní aktuální cestu, aniž by měnila pixely nebo styl. Zavolejte ji před vytvořením samostatného tvaru, aby další fill() omylem znovu nevyplnilo předchozí geometrii.
arc(x, y, radius, startAngle, endAngle, counterclockwise) přidá oblouk se středem (x, y), ale nevykreslí ho. Úhly se měří v radiánech od kladné poloosy X. Výchozí směr je po směru hodinových ručiček; true ho ve výchozí soustavě souřadnic obrátí. Úhly 0 a 2 * Math.PI ve výchozím směru vytvoří celou kružnici. Má-li cesta koncový bod, arc() ho spojí se začátkem oblouku úsečkou. Pokud je některý číselný argument NaN, Infinity nebo -Infinity, arc() skončí beze změny cesty. Jsou-li všechny číselné argumenty konečné, záporný poloměr vyvolá výjimku IndexSizeError.
Vlastnost fillStyle přijímá řetězec s barvou CSS, CanvasGradient nebo CanvasPattern. Výchozí barva je černá; neplatný řetězec s barvou ponechá předchozí styl beze změny. Přiřazení nepřebarví již vykreslené pixely.
fill() a fill(fillRule) vyplní aktuální cestu aktuálním stylem. fill(path) a fill(path, fillRule) místo ní vyplní předaný objekt Path2D. Výchozí pravidlo "nonzero" zjišťuje, zda je součet průsečíků polopřímky s cestou se znaménky podle směru křížení nenulový; "evenodd" zjišťuje, zda je počet průsečíků lichý. Při vyplňování se otevřené dílčí cesty považují za uzavřené, ale metoda je nemění ani cestu nevyprázdní.
Pří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ýsledek
255,0,0,255 0,0,0,0 0,0,255,255
Uložte příklad jako soubor HTML a otevřete ho v prohlížeči. Tři zobrazené vzorky RGBA ukazují červený střed prvního kruhu, průhledný pixel na stejném místě po překreslení a modrý střed nového kruhu. Plátno se nepřidává na stránku. `getImageData()` vyvolá `SecurityError`, pokud plátno už není `origin-clean`, například po vykreslení obrázku z jiného zdroje bez povolení CORS; samotné `clearRect()` tento stav neobnoví.
Související lekce
- JavaScript · Lekce 27 · Středně pokročilá · Verze: 3