CKTIS / JavaScript
Canvas 2D: transformaties, tekenstatus, clipping en rechthoeken
Houd de tekenstatus, het huidige pad en de bitmap uit elkaar om clipping te beperken tot één tekenstap en alleen de bedoelde pixels te wissen.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
ctx.setTransform(a, b, c, d, e, f)
ctx.setTransform()
ctx.setTransform(matrix2D)
ctx.save()
ctx.restore()
ctx.beginPath()
ctx.rect(x, y, width, height)
ctx.clip()
ctx.clip(fillRule)
ctx.clip(path)
ctx.clip(path, fillRule)
ctx.clearRect(x, y, width, height)
ctx.fillRect(x, y, width, height)
ctx.strokeRect(x, y, width, height)Deze methoden horen bij de webinterface CanvasRenderingContext2D, niet bij ECMAScript 2024. De ondersteuning verschilt per uitvoeromgeving. setTransform(a, b, c, d, e, f) vervangt de matrix in plaats van die te vermenigvuldigen: (x, y) wordt (a*x + c*y + e, b*x + d*y + f). De methode accepteert ook een DOMMatrix2DInit-object: a en d zijn standaard 1 en de overige coëfficiënten 0. Een aanroep zonder argumenten stelt dus de identiteitsmatrix in. Tegenstrijdige waarden voor synonieme sleutels zoals a en m11 veroorzaken TypeError. Bij de vorm met zes getallen blijft de matrix ongewijzigd als een argument oneindig of NaN is.
save() zet een kopie van de tekenstatus op de stapel, inclusief transformatie, clipgebied en stijlen. restore() haalt de laatst opgeslagen status van de stapel en herstelt die; bij een lege stapel doet de methode niets. Het huidige pad en de pixels worden niet opgeslagen. beginPath() maakt het pad leeg zonder het clipgebied of de bitmap te wijzigen. rect(x, y, width, height) voegt een gesloten rechthoekig deelpad toe zonder pixels te tekenen. De transformatie wordt toegepast op de geometrie van dat pad terwijl je het opbouwt.
clip() vervangt het clipgebied door de doorsnede met het binnengebied van het huidige pad of een meegegeven Path2D. Bij Path2D wordt de transformatie toegepast bij de aanroep van clip(), zonder het object te wijzigen. De optionele vulregel 'nonzero' (standaard) toetst of de som van de kruisingen met teken niet nul is; 'evenodd' toetst of het aantal kruisingen oneven is. clip() tekent niets en volgende aanroepen kunnen het gebied niet vergroten. Sla de status vóór het clippen op en herstel die na het tekenen: de identiteitsmatrix heft het clipgebied niet op.
fillRect() vult met fillStyle, strokeRect() tekent de omtrek met strokeStyle en de lijninstellingen, en clearRect() wist naar transparant zwart (ondoorzichtig zwart bij alpha: false), ongeacht schaduwen, globale alpha en compositing. Alle drie werken rechtstreeks op de bitmap, houden rekening met de transformatie en het clipgebied en laten het pad ongewijzigd. fillRect() levert dus geen geometrie aan clip(). clearRect() heft de leesbeperking van een door gegevens van een andere origin besmette bitmap niet op: getImageData() blijft SecurityError veroorzaken.
Voorbeelden
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D clipping</title>
<canvas id="canvas" width="20" height="12"></canvas>
<script>
(() => {
const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d', { alpha: true });
if (!ctx) throw new Error('Canvas 2D unavailable');
ctx.fillRect(0, 0, 12, 12);
ctx.save();
try {
ctx.setTransform(1, 0, 0, 1, 4, 2);
ctx.beginPath();
ctx.rect(0, 0, 8, 8);
ctx.clip();
ctx.clearRect(-2, 2, 6, 4);
} finally {
ctx.restore();
}
ctx.lineWidth = 2;
ctx.strokeRect(14, 2, 4, 8);
const alphaAt = (x, y) => ctx.getImageData(x, y, 1, 1).data[3];
console.log([3, 5, 9, 14, 16].map(x => alphaAt(x, 5)).join(', '));
})();
</script>Resultaat
255, 0, 255, 255, 0
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de ontwikkelaarsconsole. De vijf alfawaarden tonen achtereenvolgens: vulling die door het clipgebied beschermd bleef, een gewiste pixel, onaangetaste vulling, de omtrek die na herstel van de status is getekend en het transparante binnengebied van die omtrek.
Gerelateerde lessen
- JavaScript · Les 12 · Gevorderd · Versie: 4
Bronnen
- HTML Standard — The canvas state
- HTML Standard — Transformations
- HTML Standard — Drawing rectangles to the bitmap
- HTML Standard — Drawing paths to the canvas
- HTML Standard — The canvas settings
- CanvasRenderingContext2D: setTransform() method
- CanvasRenderingContext2D: rect() method
- CanvasRenderingContext2D: getImageData() method