KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Canvas 2D: pixels wissen, tekenen en bewerken

Maak onderscheid tussen tekenen in de 2D-context en pixels rechtstreeks uit de bitmap lezen of naar de bitmap schrijven.

Versie: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

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 en putImageData zijn instantiemethoden van de context die canvas.getContext('2d') teruggeeft. Ze horen bij de web-API’s, niet bij ECMAScript 2024. clearRect() houdt rekening met de huidige transformatie en het uitsnedegebied. De methode zet pixels op transparant zwart (dekkend zwart bij alpha: false), zonder de tekenstatus of het huidige pad te herstellen. Begin een nieuw pad met beginPath().

drawImage() verwacht een bruikbare CanvasImageSource, zoals een afbeelding of een ander canvas, niet ImageData. Met 3 argumenten teken je de hele bron op intrinsieke grootte; met 5 bepaal je de doelgrootte; met 9 beeld je een bronrechthoek af op een doelrechthoek. Negatieve afmetingen verlengen een rechthoek in de andere richting zonder het beeld te spiegelen. Bij tekenen gelden de transformatie, de uitsnede en de compositie-instellingen. Als een afbeelding nog wordt geladen en nog niet bruikbaar is, tekent drawImage() die niet. Een volledig beschikbare afbeelding die kan worden gedecodeerd, kun je tekenen zonder vooraf decode() aan te roepen of een reeds gedecodeerd frame nodig te hebben. Een broncanvas met een afmeting van nul geeft InvalidStateError.

getImageData() leest bitmappixels zonder de transformatie of uitsnede toe te passen. Het resultaat is een zelfstandige ImageData-kopie: wijzigingen in data veranderen het canvas niet. De array bevat RGBA-waarden per rij; het eerste kanaal van pixel (x, y) in de kopie staat op (y * imageData.width + x) * 4. Buiten de bitmap levert de methode transparant zwart op. Negatieve sw of sh verlengen de rechthoek in de andere richting; een afmeting van nul geeft IndexSizeError.

putImageData() vervangt pixels zonder schalen, transformatie, contextuitsnede of menging. De vorm met 7 argumenten selecteert een deelrechthoek in ImageData, niet op de bestemming: pixel (x, y) komt op (dx + x, dy + y). Een losgekoppelde buffer geeft InvalidStateError. Conversie tussen kleurruimten en vooraf vermenigvuldigen met alfa kunnen de teruggelezen waarden veranderen, vooral bij halftransparante pixels.

Het tekenen van een bron van een andere origin zonder CORS-toestemming kan de status origin-clean van de bitmap opheffen. Uitlezen geeft dan SecurityError, zelfs na clearRect(). Gebruik voor zulke bronnen een CORS-verzoek met de juiste toestemming van de server. Het standaard uitleesformaat rgba-unorm8 gebruikt Uint8ClampedArray; controleer of de doelbrowsers opties zoals display-p3 of rgba-float16 (Float16Array) ondersteunen.

Voorbeelden

<!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>

Resultaat

0,0,0,0,255,0,0,255
0,0,255,255,255,0,0,255

De eerste regel toont links de gewiste pixel en rechts de rode pixel. De code maakt de rechterpixel in de kopie blauw en schrijft alleen die pixel met `dx = -1`. De tweede regel toont links blauw en rechts nog steeds rood.

Gerelateerde lessen

  • JavaScript · Les 33 · Gevorderd · Versie: 4

Bronnen