CKTIS / JavaScript
Canvas 2D: transformacije, pravokotniki in poti
Loči transformacijo, slikovne pike in privzeto pot. Nauči se, kdaj se koordinate transformirajo, kateri klici takoj spremenijo slikovne pike in kaj ostane po klicu `stroke()`.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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 vmesnik spletnega API-ja, ne del ECMAScripta 2024. Metode kliči na kontekstu ctx, ki ga vrne canvas.getContext('2d'); rezultat je lahko null. Podpora za posamezne oblike klica je odvisna od izvajalnega okolja. Vseh sedem metod ob običajnem klicu vrne undefined.
setTransform(a, b, c, d, e, f) zamenja trenutno matriko, medtem ko jo transform() množi. Točko (x, y) preslika v (a*x + c*y + e, b*x + d*y + f). Objektna različica sprejme slovar za matriko 2D (DOMMatrix2DInit): izpuščene komponente privzamejo vrednosti identične matrike, nasprotujoče si vrednosti za vzdevka, kot sta a in m11, pa sprožijo TypeError. Po standardu klic brez argumentov nastavi identično matriko. Pri različici s šestimi števili trenutna matrika ostane nespremenjena, če je kateri od argumentov NaN ali neskončen. Različica s slovarjem iz veljavnega slovarja ustvari DOMMatrix in jo brez tega preverjanja nastavi kot trenutno matriko.
fillRect(x, y, width, height) takoj izriše pravokotnik z uporabo fillStyle. Metoda clearRect() z enakimi parametri nastavi slikovne pike na prosojno črno (neprosojno črno pri alpha: false), ne glede na slog, globalAlpha ali način sestavljanja. Obe upoštevata trenutno transformacijo in območje obrezovanja ter ne spreminjata poti. Ničelna mera nima učinka; negativna mera razširi pravokotnik od (x, y) v nasprotno smer.
beginPath() izprazni privzeto pot, ne da bi izbrisala slikovne pike. moveTo(x, y) začne novo podpot, ne da bi jo povezala s prejšnjo. lineTo(x, y) doda ravno daljico od zadnje točke; če podpot še ne obstaja, le določi začetno točko. Nobena od teh treh metod ne riše. moveTo(), lineTo() in obe metodi za pravokotnike prezrejo klice z neskončnimi vrednostmi ali NaN v koordinatah ali merah.
stroke() izriše trenutno privzeto pot s strokeStyle in nastavitvami črte, kot je lineWidth. Odprtih podpoti ne zapre in poti ne izprazni. Koordinate privzete poti se transformirajo ob dodajanju, ne ponovno ob izrisu, vendar takratna matrika še vedno vpliva na potezo, na primer na njeno debelino. Pri stroke(path) se geometrija podanega objekta Path2D transformira ob izrisu, ne da bi se objekt spremenil. save() in restore() shranita in obnovita stanje risanja, vključno z matriko, ne pa privzete poti ali slikovnih pik.
Primeri
<!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>Rezultat
0, 255, 255, 0
Primer shrani kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli. Pričakovane vrednosti alfa `0, 255, 255, 0` ustrezajo izbrisanemu območju, preostalemu polnilu, premaknjeni daljici in nedotaknjeni točki v nepremaknjenem koordinatnem sistemu. `getImageData()` bere v koordinatah bitne slike. Nastavitve zasebnosti lahko spremenijo rezultat; branje platna, onesnaženega z nedovoljeno vsebino drugega izvora, lahko sproži `SecurityError`.
Povezane lekcije
- JavaScript · Lekcija 34 · Napredna · Različica: 4
Viri
- 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