CKTIS / JavaScript
Canvas 2D: transformace, stav kreslení, ořez a obdélníky
Rozlišuj stav kreslení, aktuální cestu a bitmapu, abys mohl ořez omezit na jeden krok kreslení a vymazat jen zamýšlené pixely.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform()
ctx.setTransform(matrix2D)
ctx.save()
ctx.restore()
ctx.beginPath()
ctx.rect(x, y, width, height)
ctx.clip()
ctx.clip(fillRule)
ctx.clip(path)
ctx.clip(path, fillRule)
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.strokeRect(x, y, width, height)Tyto metody patří k webovému rozhraní CanvasRenderingContext2D, nikoli k ECMAScriptu 2024. Podpora se liší podle běhového prostředí. setTransform(a, b, c, d, e, f) matici nahradí, místo aby ji násobila: z (x, y) vznikne (a*x + c*y + e, b*x + d*y + f). Metoda přijímá také objekt DOMMatrix2DInit: výchozí hodnoty a a d jsou 1, ostatní koeficienty jsou 0. Volání bez argumentů tedy nastaví jednotkovou matici. Rozdílné hodnoty v rovnocenných klíčích, například a a m11, vyvolají TypeError. Varianta se šesti čísly matici nezmění, pokud je některý argument nekonečný nebo NaN.
save() vloží na zásobník kopii stavu kreslení včetně transformace, oblasti ořezu a stylů. restore() odebere a obnoví naposledy uložený stav; s prázdným zásobníkem nedělá nic. Aktuální cesta ani pixely se neukládají. beginPath() vyprázdní cestu, aniž změní ořez nebo bitmapu. rect(x, y, width, height) přidá uzavřenou obdélníkovou dílčí cestu bez vykreslení pixelů. Transformace se použije na geometrii této cesty už při jejím vytváření.
clip() nahradí oblast ořezu jejím průnikem s vnitřkem aktuální cesty nebo předaného objektu Path2D. U Path2D se transformace použije při volání clip(), aniž se změní samotný objekt. Volitelné pravidlo vyplňování 'nonzero' (výchozí) testuje, zda je součet překročení se znaménkem nenulový; 'evenodd' testuje, zda je počet překročení lichý. clip() nic nekreslí a další volání oblast nemohou rozšířit. Ulož stav před ořezem a obnov ho po kreslení: nastavení jednotkové matice ořez neodstraní.
fillRect() vyplní obdélník pomocí fillStyle, strokeRect() vykreslí obrys pomocí strokeStyle a nastavení čar a clearRect() vymaže pixely na průhlednou černou (neprůhlednou černou při alpha: false) bez ohledu na stíny, globální alfu a skládání obrazu. Všechny tři působí přímo na bitmapu, respektují transformaci a ořez a cestu nemění. Proto fillRect() neposkytuje geometrii pro clip(). clearRect() neodstraní omezení čtení bitmapy kontaminované daty z jiného původu: getImageData() stále vyvolá SecurityError.
Příklady
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D clipping</title>
<canvas id="canvas" width="20" height="12"></canvas>
<script>
(() => {
const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d', { alpha: true });
if (!ctx) throw new Error('Canvas 2D unavailable');
ctx.fillRect(0, 0, 12, 12);
ctx.save();
try {
ctx.setTransform(1, 0, 0, 1, 4, 2);
ctx.beginPath();
ctx.rect(0, 0, 8, 8);
ctx.clip();
ctx.clearRect(-2, 2, 6, 4);
} finally {
ctx.restore();
}
ctx.lineWidth = 2;
ctx.strokeRect(14, 2, 4, 8);
const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
console.log([3, 5, 9, 14, 16].map(x => alphaAt(x, 5)).join(', '));
})();
</script>Výsledek
255, 0, 255, 255, 0
Ulož příklad jako soubor HTML, otevři ho v prohlížeči a zkontroluj výstup ve vývojářské konzoli. Pět hodnot alfa postupně ukazuje výplň chráněnou ořezem, vymazaný pixel, nedotčenou výplň, obrys vykreslený po obnově stavu a průhledný vnitřek tohoto obrysu.
Související lekce
- JavaScript · Lekce 12 · Pokročilá · Verze: 4
Zdroje
- HTML Standard — The canvas state
- HTML Standard — Transformations
- HTML Standard — Drawing rectangles to the bitmap
- HTML Standard — Drawing paths to the canvas
- HTML Standard — The canvas settings
- CanvasRenderingContext2D: setTransform() method
- CanvasRenderingContext2D: rect() method
- CanvasRenderingContext2D: getImageData() method