CKTIS / JavaScript
Canvas 2D: brisanje, risanje in urejanje slikovnih pik
Loči risalne operacije v kontekstu 2D od neposrednega branja in zapisovanja slikovnih pik bitne slike.
Različica: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const ctx = canvas.getContext('2d');
ctx.clearRect(x, y, width, height);
ctx.drawImage(image, dx, dy);
ctx.drawImage(image, dx, dy, dw, dh);
ctx.drawImage(image, sx, sy, sw, sh, dx, dy, dw, dh);
const snapshot = ctx.getImageData(sx, sy, sw, sh);
const configuredSnapshot = ctx.getImageData(sx, sy, sw, sh, settings);
ctx.putImageData(imageData, dx, dy);
ctx.putImageData(imageData, dx, dy, dirtyX, dirtyY, dirtyWidth, dirtyHeight);clearRect, drawImage, getImageData in putImageData so metode primerka konteksta, ki ga vrne canvas.getContext('2d'). So del spletnega API-ja, ne ECMAScripta 2024. clearRect() upošteva trenutno transformacijo in območje obrezovanja. Slikovne pike nastavi na prosojno črno (pri alpha: false na neprosojno črno), ne da bi ponastavil stanje risanja ali trenutno pot. Novo pot začni z beginPath().
drawImage() sprejme pripravljen vir tipa CanvasImageSource, na primer sliko ali drugo platno, ne pa ImageData. Oblika s 3 argumenti nariše celoten vir v njegovi naravni velikosti; oblika s 5 določi ciljno velikost; oblika z 9 preslika izvorni pravokotnik v ciljnega. Negativne dimenzije pravokotnik razširijo v nasprotno smer, ne da bi zrcalile sliko. Risanje upošteva transformacijo, obrezovanje in sestavljanje. Če se slika še nalaga in še ni pripravljena za uporabo, je drawImage() ne nariše. Sliko, ki je v celoti na voljo in jo je mogoče dekodirati, lahko narišeš brez predhodnega klica decode() ali vnaprej dekodiranega okvirja. Izvorno platno z ničelno dimenzijo sproži InvalidStateError.
getImageData() bere slikovne pike bitne slike neodvisno od transformacije in obrezovanja. Vrne samostojno kopijo ImageData: spreminjanje data ne spremeni platna. Polje hrani vrednosti RGBA po vrsticah; prvi kanal slikovne pike (x, y) v kopiji je na indeksu (y * imageData.width + x) * 4. Zunaj bitne slike branje vrne prosojno črno. Negativna sw ali sh razširita pravokotnik v nasprotno smer; ničelna dimenzija sproži IndexSizeError.
putImageData() zamenja slikovne pike brez spreminjanja merila, transformacije, obrezovanja konteksta ali mešanja. Oblika s 7 argumenti izbere podpravokotnik znotraj ImageData, ne v cilju: slikovna pika (x, y) se zapiše na (dx + x, dy + y). Odklopljen medpomnilnik sproži InvalidStateError. Pretvorba barvnega prostora in predmnoženje z alfo lahko pri ponovnem branju spremenita vrednosti, zlasti pri polprosojnih slikovnih pikah.
Risanje vira z drugega izvora brez dovoljenja CORS lahko povzroči, da bitna slika izgubi stanje origin-clean. Branje nato sproži SecurityError, tudi po clearRect(). Za vire z drugega izvora uporabi zahtevo CORS in ustrezno dovoljenje strežnika. Privzeti format branja rgba-unorm8 uporablja Uint8ClampedArray; v ciljnih brskalnikih preveri podporo za možnosti, kot sta display-p3 in rgba-float16 (Float16Array).
Primeri
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D pixel readback</title>
<canvas id="source" width="2" height="1" hidden></canvas>
<canvas id="destination" width="2" height="1" hidden></canvas>
<script>
const source = document.getElementById('source');
const canvas = document.getElementById('destination');
const src = source.getContext('2d');
const ctx = canvas.getContext('2d');
src.fillStyle = '#ff0000';
src.fillRect(0, 0, 2, 1);
ctx.drawImage(source, 0, 0);
ctx.clearRect(0, 0, 1, 1);
const snapshot = ctx.getImageData(0, 0, 2, 1);
console.log(snapshot.data.join(','));
snapshot.data.set([0, 0, 255, 255], 4);
ctx.putImageData(snapshot, -1, 0, 1, 0, 1, 1);
console.log(ctx.getImageData(0, 0, 2, 1).data.join(','));
</script>Rezultat
0,0,0,0,255,0,0,255 0,0,255,255,255,0,0,255
Prva vrstica pokaže izbrisano levo in rdečo desno slikovno piko. Koda obarva desno piko v kopiji modro in zapiše samo to piko z `dx = -1`. Druga vrstica pokaže modro levo in še vedno rdečo desno piko.
Povezane lekcije
- JavaScript · Lekcija 33 · Napredna · Različica: 4