Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori