KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Canvas 2D: transformaties, rechthoeken en paden

Houd de transformatie, de pixels en het standaardpad uit elkaar. Leer wanneer coördinaten veranderen, welke aanroepen direct pixels aanpassen en wat na `stroke()` behouden blijft.

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

Syntax

ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform(matrix)
ctx.setTransform()
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.beginPath()
ctx.moveTo(x, y)
ctx.lineTo(x, y)
ctx.stroke()
ctx.stroke(path)

CanvasRenderingContext2D is een interface van een web-API, geen onderdeel van ECMAScript 2024. Roep de methoden aan op de context ctx die je krijgt van canvas.getContext('2d'); die aanroep kan null opleveren. Welke aanroepvormen worden ondersteund, hangt af van de runtime. Alle zeven methoden geven bij een normale aanroep undefined terug.

setTransform(a, b, c, d, e, f) vervangt de huidige matrix, terwijl transform() die vermenigvuldigt. Het punt (x, y) wordt (a*x + c*y + e, b*x + d*y + f). De objectvariant accepteert een dictionary voor een 2D-matrix (DOMMatrix2DInit). Weggelaten componenten krijgen de waarden van de identiteitsmatrix; conflicterende waarden voor aliassen zoals a en m11 veroorzaken een TypeError. Volgens de standaard stelt een aanroep zonder argumenten de identiteitsmatrix in. Bij de variant met zes getallen blijft de huidige matrix ongewijzigd als een van de argumenten NaN of oneindig is. De dictionaryvariant maakt uit een geldige dictionary een DOMMatrix en stelt die zonder deze controle in als huidige matrix.

fillRect(x, y, width, height) tekent meteen een gevulde rechthoek met fillStyle. Met dezelfde parameters wist clearRect() pixels naar transparant zwart (dekkend zwart bij alpha: false), ongeacht de tekenstijl, globalAlpha en de compositiemodus. Beide houden rekening met de huidige transformatie en het clipgebied en laten het pad ongemoeid. Een afmeting van nul doet niets; een negatieve afmeting laat de rechthoek vanaf (x, y) de andere kant op lopen.

beginPath() maakt het standaardpad leeg zonder pixels te wissen. moveTo(x, y) begint een nieuw deelpad zonder verbinding met het vorige. lineTo(x, y) voegt vanaf het laatste punt een recht lijnstuk toe; zonder deelpad stelt het alleen het beginpunt in. Geen van deze drie methoden tekent pixels. moveTo(), lineTo() en beide rechthoekmethoden negeren aanroepen met oneindige waarden of NaN voor coördinaten of afmetingen.

stroke() tekent het huidige standaardpad met strokeStyle en lijninstellingen zoals lineWidth. Het sluit open deelpaden niet en maakt het pad niet leeg. Coördinaten van het standaardpad worden bij het toevoegen getransformeerd, niet opnieuw bij het tekenen. De dan geldende matrix beïnvloedt de lijn zelf nog wel, bijvoorbeeld de dikte. Met stroke(path) wordt de geometrie van de meegegeven Path2D bij het tekenen getransformeerd zonder het object te wijzigen. save() en restore() bewaren en herstellen de tekentoestand, waaronder de matrix, maar niet het standaardpad of de pixels.

Voorbeelden

<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D</title>
<canvas id="demo" width="32" height="24" hidden></canvas>
<script>
(() => {
  const canvas = document.getElementById('demo');
  const ctx = canvas.getContext('2d');
  if (!ctx) throw new Error('Canvas 2D is unavailable');

  ctx.setTransform(1, 0, 0, 1, 8, 4);
  ctx.fillStyle = '#000';
  ctx.fillRect(0, 0, 16, 8);
  ctx.beginPath();
  ctx.moveTo(2, 12);
  ctx.lineTo(14, 12);
  ctx.clearRect(0, 0, 4, 8);

  ctx.setTransform(1, 0, 0, 1, 0, 0);
  ctx.strokeStyle = '#000';
  ctx.lineWidth = 4;
  ctx.stroke();

  const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
  console.log([alphaAt(9, 6), alphaAt(15, 6), alphaAt(15, 16), alphaAt(5, 12)].join(', '));
})();
</script>

Resultaat

0, 255, 255, 0

Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de browserconsole. De verwachte alfawaarden `0, 255, 255, 0` horen bij het gewiste gebied, de resterende vulling, het verschoven lijnstuk en een onaangeroerde plek in het onverschoven assenstelsel. `getImageData()` leest in bitmapcoördinaten. Privacy-instellingen kunnen het resultaat wijzigen; uitlezen van een canvas met niet-toegestane inhoud van een andere herkomst kan `SecurityError` veroorzaken.

Gerelateerde lessen

  • JavaScript · Les 34 · Gevorderd · Versie: 4

Bronnen