CKTIS / JavaScript
Canvas 2D: transformácie, obdĺžniky a cesty
Rozlišujte transformáciu, pixely a predvolenú cestu. Zistite, kedy sa transformujú súradnice, ktoré volania hneď menia pixely a čo zostane po volaní `stroke()`.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform(matrix)
ctx.setTransform()
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.beginPath()
ctx.moveTo(x, y)
ctx.lineTo(x, y)
ctx.stroke()
ctx.stroke(path)CanvasRenderingContext2D je rozhranie webového API, nie súčasť ECMAScriptu 2024. Metódy volajte na kontexte ctx získanom cez canvas.getContext('2d'); výsledok môže byť null. Podpora jednotlivých foriem volania závisí od prostredia vykonávania. Všetkých sedem metód pri bežnom volaní vracia undefined.
setTransform(a, b, c, d, e, f) nahradí aktuálnu maticu, na rozdiel od transform(), ktorá ju násobí. Bod (x, y) sa zmení na (a*x + c*y + e, b*x + d*y + f). Preťaženie s objektom prijíma slovník pre 2D maticu (DOMMatrix2DInit): vynechané zložky dostanú hodnoty jednotkovej matice a rozporné hodnoty aliasov, napríklad a a m11, vyvolajú TypeError. Podľa štandardu volanie bez argumentov nastaví jednotkovú maticu. Pri variante so šiestimi číslami zostane aktuálna matica bez zmeny, ak je niektorý argument nekonečný alebo NaN. Variant so slovníkom vytvorí z platného slovníka DOMMatrix a bez tejto kontroly ju nastaví ako aktuálnu maticu.
fillRect(x, y, width, height) ihneď vykreslí obdĺžnik pomocou fillStyle. S rovnakými parametrami clearRect() nastaví pixely na priehľadnú čiernu (pri alpha: false na nepriehľadnú čiernu) bez ohľadu na štýl, globalAlpha a režim kompozície. Obe metódy rešpektujú aktuálnu transformáciu a oblasť orezania a nemenia cestu. Nulový rozmer nemá účinok; záporný rozmer rozšíri obdĺžnik od (x, y) opačným smerom.
beginPath() vyprázdni predvolenú cestu bez vymazania pixelov. moveTo(x, y) začne novú podcestu bez spojenia s predchádzajúcou. lineTo(x, y) pridá priamu úsečku od posledného bodu; ak podcesta neexistuje, nastaví iba začiatočný bod. Žiadna z týchto troch metód nekreslí. moveTo(), lineTo() a obe metódy pre obdĺžniky ignorujú volania s nekonečnými hodnotami alebo NaN v súradniciach či rozmeroch.
stroke() vykreslí aktuálnu predvolenú cestu pomocou strokeStyle a nastavení čiary ako lineWidth. Neuzatvorí otvorené podcesty ani cestu nevyprázdni. Súradnice predvolenej cesty sa transformujú pri pridaní, nie opäť pri vykreslení, hoci aktuálna matica stále ovplyvňuje samotný ťah, napríklad jeho hrúbku. Pri stroke(path) sa geometria odovzdaného Path2D transformuje až pri vykreslení bez zmeny objektu. save() a restore() uložia a obnovia stav kreslenia vrátane matice, ale nie predvolenú cestu ani pixely.
Príklady
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D</title>
<canvas id="demo" width="32" height="24" hidden></canvas>
<script>
(() => {
const canvas = document.getElementById('demo');
const ctx = canvas.getContext('2d');
if (!ctx) throw new Error('Canvas 2D is unavailable');
ctx.setTransform(1, 0, 0, 1, 8, 4);
ctx.fillStyle = '#000';
ctx.fillRect(0, 0, 16, 8);
ctx.beginPath();
ctx.moveTo(2, 12);
ctx.lineTo(14, 12);
ctx.clearRect(0, 0, 4, 8);
ctx.setTransform(1, 0, 0, 1, 0, 0);
ctx.strokeStyle = '#000';
ctx.lineWidth = 4;
ctx.stroke();
const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
console.log([alphaAt(9, 6), alphaAt(15, 6), alphaAt(15, 16), alphaAt(5, 12)].join(', '));
})();
</script>Výsledok
0, 255, 255, 0
Uložte príklad ako súbor HTML, otvorte ho v prehliadači a skontrolujte výstup v konzole. Očakávané hodnoty alfa `0, 255, 255, 0` patria vymazanej oblasti, zvyšnej výplni, posunutej úsečke a nedotknutému bodu v neposunutej sústave. `getImageData()` číta v súradniciach bitovej mapy. Nastavenia ochrany súkromia môžu výsledok zmeniť; čítanie z plátna znečisteného nepovoleným obsahom z iného zdroja môže vyvolať `SecurityError`.
Súvisiace lekcie
- JavaScript · Lekcia 34 · Pokročilá · Verzia: 4
Zdroje
- HTML Standard — The canvas settings
- HTML Standard — The canvas state
- HTML Standard — Building paths
- HTML Standard — Transformations
- HTML Standard — Drawing rectangles to the bitmap
- HTML Standard — Drawing paths to the canvas
- CanvasRenderingContext2D: setTransform() method
- CanvasRenderingContext2D: getImageData() method