CKTIS / JavaScript
Canvas 2D: brisanje, crtanje i uređivanje piksela
Razlikuj operacije crtanja u 2D kontekstu od izravnog čitanja i zapisivanja pojedinih piksela bitmape.
Verzija: 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 i putImageData metode su instance konteksta koji vraća canvas.getContext('2d'). Dio su web API-ja, a ne ECMAScripta 2024. clearRect() poštuje trenutnu transformaciju i područje izrezivanja. Postavlja piksele na prozirnu crnu (na neprozirnu crnu uz alpha: false), bez poništavanja stanja crtanja ili trenutne putanje. Novu putanju započni pozivom beginPath().
drawImage() prihvaća spreman izvor tipa CanvasImageSource, primjerice sliku ili drugo platno, ali ne ImageData. Oblik s 3 argumenta crta cijeli izvor u njegovoj prirodnoj veličini; oblik s 5 određuje ciljnu veličinu; oblik s 9 preslikava izvorni pravokutnik na ciljni. Negativne dimenzije proširuju pravokutnik u suprotnom smjeru bez zrcaljenja slike. Crtanje poštuje transformaciju, izrezivanje i kompoziciju. Ako se slika još učitava i nije spremna za upotrebu, drawImage() je ne iscrtava. Potpuno dostupna slika koja se može dekodirati može se iscrtati bez prethodnog poziva decode() ili unaprijed dekodiranog kadra. Izvorno platno s nultom dimenzijom izaziva InvalidStateError.
getImageData() čita piksele bitmape neovisno o transformaciji i izrezivanju. Vraća samostalnu kopiju ImageData: izmjene u data ne mijenjaju platno. Polje sadrži vrijednosti RGBA po redcima; prvi kanal piksela (x, y) u kopiji nalazi se na indeksu (y * imageData.width + x) * 4. Izvan bitmape očitava se prozirna crna. Negativni sw ili sh proširuju pravokutnik u suprotnom smjeru; nulta dimenzija izaziva IndexSizeError.
putImageData() zamjenjuje piksele bez skaliranja, transformacije, izrezivanja prema kontekstu ili miješanja. Oblik sa 7 argumenata bira podpravokutnik unutar ImageData, a ne na odredištu: piksel (x, y) zapisuje se na (dx + x, dy + y). Odvojeni međuspremnik izaziva InvalidStateError. Pretvorba prostora boja i predmnoženje alfa vrijednošću mogu promijeniti vrijednosti pri ponovnom čitanju, osobito za poluprozirne piksele.
Crtanje resursa s drugog izvora bez dopuštenja CORS može uzrokovati gubitak statusa origin-clean bitmape. Čitanje tada izaziva SecurityError, čak i nakon clearRect(). Za resurse s drugog izvora upotrijebi zahtjev CORS s odgovarajućim dopuštenjem poslužitelja. Zadani format čitanja rgba-unorm8 koristi Uint8ClampedArray; provjeri podršku za opcije poput display-p3 ili rgba-float16 (Float16Array) u ciljanim preglednicima.
Primjeri
<!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
Prvi redak prikazuje izbrisani lijevi piksel i crveni desni. Kod mijenja desni piksel kopije u plavi pa upisuje samo taj piksel s `dx = -1`. Drugi redak prikazuje plavi lijevi piksel i još uvijek crveni desni.
Povezane lekcije
- JavaScript · Lekcija 33 · Napredno · Verzija: 4