CKTIS / JavaScript
Canvas 2D: transformacije, stanje risanja, obrezovanje in pravokotniki
Loči stanje risanja od trenutne poti in bitne slike, da lahko obrezovanje omejiš na en korak risanja in izbrišeš samo želene slikovne pike.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
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)Te metode pripadajo spletnemu vmesniku CanvasRenderingContext2D, ne standardu ECMAScript 2024. Podpora je odvisna od izvajalnega okolja. setTransform(a, b, c, d, e, f) matriko zamenja, namesto da bi jo pomnožil: (x, y) se preslika v (a*x + c*y + e, b*x + d*y + f). Metoda sprejme tudi objekt DOMMatrix2DInit: privzeti vrednosti a in d sta 1, preostali koeficienti pa so 0. Klic brez argumentov torej nastavi identično matriko. Nasprotujoče si vrednosti enakovrednih ključev, kot sta a in m11, sprožijo TypeError. Oblika s šestimi števili matrike ne spremeni, če je kateri od argumentov neskončen ali NaN.
save() na sklad doda kopijo stanja risanja, vključno s transformacijo, območjem obrezovanja in slogi. restore() s sklada odstrani in obnovi nazadnje shranjeno stanje; če je sklad prazen, ne naredi ničesar. Trenutna pot in slikovne pike se ne shranijo. beginPath() izprazni pot, ne da bi spremenil območje obrezovanja ali bitno sliko. rect(x, y, width, height) doda zaprto pravokotno podpot, ne da bi izrisal slikovne pike. Transformacija se uporabi na geometriji te poti ob njenem ustvarjanju.
clip() zamenja območje obrezovanja z njegovim presekom z notranjostjo trenutne poti ali podanega objekta Path2D. Pri Path2D se transformacija uporabi ob klicu clip(), ne da bi se objekt spremenil. Izbirno pravilo polnjenja 'nonzero' (privzeto) preveri, ali je vsota prečkanj s predznakom različna od nič; 'evenodd' preveri, ali je število prečkanj liho. clip() ničesar ne izriše, zaporedni klici pa območja ne morejo povečati. Shrani stanje pred obrezovanjem in ga obnovi po risanju: nastavitev identične matrike obrezovanja ne odstrani.
fillRect() zapolni pravokotnik z fillStyle, strokeRect() izriše obris z strokeStyle in nastavitvami črt, clearRect() pa izbriše v prosojno črno (neprosojno črno pri alpha: false), ne glede na sence, globalno vrednost alfa in sestavljanje slike. Vse tri metode delujejo neposredno na bitni sliki, upoštevajo transformacijo in obrezovanje ter poti ne spremenijo. Zato fillRect() ne zagotovi geometrije za clip(). clearRect() ne odpravi omejitev branja bitne slike, onesnažene s podatki iz drugega izvora: getImageData() še vedno sproži SecurityError.
Primeri
<!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>Rezultat
255, 0, 255, 255, 0
Shrani primer kot datoteko HTML, odpri jo v brskalniku in preveri izpis v razvijalski konzoli. Pet vrednosti alfa po vrsti prikazuje polnilo, zaščiteno z obrezovanjem, izbrisano slikovno piko, nedotaknjeno polnilo, obris, izrisan po obnovitvi stanja, in prosojno notranjost tega obrisa.
Povezane lekcije
- JavaScript · Lekcija 12 · Napredna · Različica: 4
Viri
- 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