CKTIS / JavaScript
Canvas 2D: transformácie, stav kreslenia, orezanie a obdĺžniky
Rozlišuj stav kreslenia, aktuálnu cestu a bitmapu, aby si orezanie obmedzil na jeden krok kreslenia a vymazal len zamýšľané pixely.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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)Tieto metódy patria do webového rozhrania CanvasRenderingContext2D, nie do ECMAScriptu 2024. Podpora závisí od prostredia vykonávania. setTransform(a, b, c, d, e, f) maticu nahradí namiesto jej násobenia: (x, y) sa zobrazí na (a*x + c*y + e, b*x + d*y + f). Prijíma aj objekt DOMMatrix2DInit: predvolené hodnoty a a d sú 1, ostatné koeficienty sú 0. Volanie bez argumentov teda nastaví jednotkovú maticu. Rozdielne hodnoty rovnocenných kľúčov, napríklad a a m11, vyvolajú TypeError. Variant so šiestimi číslami maticu nezmení, ak je niektorý argument nekonečný alebo NaN.
save() vloží na zásobník kópiu stavu kreslenia vrátane transformácie, oblasti orezania a štýlov. restore() odoberie a obnoví naposledy uložený stav; pri prázdnom zásobníku neurobí nič. Aktuálna cesta ani pixely sa neukladajú. beginPath() vyprázdni cestu bez zmeny orezania alebo bitmapy. rect(x, y, width, height) pridá uzavretú obdĺžnikovú čiastkovú cestu bez vykreslenia pixelov. Transformácia sa použije na geometriu tejto cesty už pri jej vytváraní.
clip() nahradí oblasť orezania jej prienikom s vnútrom aktuálnej cesty alebo odovzdaného objektu Path2D. Pri Path2D sa transformácia použije pri volaní clip() bez zmeny objektu. Voliteľné pravidlo vypĺňania 'nonzero' (predvolené) zisťuje, či je súčet prekročení so znamienkom nenulový; 'evenodd' zisťuje, či je počet prekročení nepárny. clip() nič nekreslí a ďalšie volania nemôžu oblasť zväčšiť. Ulož stav pred orezaním a obnov ho po kreslení: nastavenie jednotkovej matice orezanie neodstráni.
fillRect() vyplní obdĺžnik pomocou fillStyle, strokeRect() vykreslí obrys pomocou strokeStyle a nastavení čiar a clearRect() vymaže pixely na priehľadnú čiernu (nepriehľadnú čiernu pri alpha: false) bez ohľadu na tiene, globálnu alfu a skladanie obrazu. Všetky tri pôsobia priamo na bitmapu, rešpektujú transformáciu a orezanie a cestu nemenia. Preto fillRect() neposkytuje geometriu pre clip(). clearRect() neodstráni obmedzenie čítania bitmapy kontaminovanej údajmi z iného pôvodu: getImageData() naďalej vyvolá SecurityError.
Prí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ýsledok
255, 0, 255, 255, 0
Ulož príklad ako súbor HTML, otvor ho v prehliadači a skontroluj výstup vo vývojárskej konzole. Päť hodnôt alfa postupne ukazuje výplň chránenú orezaním, vymazaný pixel, nedotknutú výplň, obrys vykreslený po obnovení stavu a priehľadné vnútro tohto obrysu.
Súvisiace lekcie
- JavaScript · Lekcia 12 · Pokročilá · Verzia: 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