CKTIS / JavaScript
Canvas 2D: Transformationen, Zeichenzustand, Clipping und Rechtecke
Trenne Zeichenzustand, aktuellen Pfad und Bitmap, um das Clipping auf einen Zeichenschritt zu begrenzen und nur die vorgesehenen Pixel zu löschen.
Version: 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)Diese Methoden gehören zur Webschnittstelle CanvasRenderingContext2D, nicht zu ECMAScript 2024. Die Unterstützung hängt von der Laufzeitumgebung ab. setTransform(a, b, c, d, e, f) ersetzt die Matrix, statt sie zu multiplizieren: Aus (x, y) wird (a*x + c*y + e, b*x + d*y + f). Die Methode akzeptiert auch ein DOMMatrix2DInit-Objekt: a und d haben den Standardwert 1, die übrigen Einträge 0. Ein Aufruf ohne Argumente setzt daher die Einheitsmatrix. Widersprüchliche Werte für gleichbedeutende Schlüssel wie a und m11 lösen TypeError aus. Bei der Form mit sechs Zahlen bleibt die Matrix unverändert, wenn ein Argument unendlich oder NaN ist.
save() legt eine Kopie des Zeichenzustands mit Transformation, Clipbereich und Stilen auf den Stapel. restore() entnimmt den zuletzt gespeicherten Zustand und stellt ihn wieder her; bei leerem Stapel passiert nichts. Der aktuelle Pfad und die Pixel werden nicht gespeichert. beginPath() leert den Pfad, ohne Clipbereich oder Bitmap zu ändern. rect(x, y, width, height) fügt einen geschlossenen rechteckigen Teilpfad hinzu, ohne Pixel zu zeichnen. Die Transformation wirkt bereits beim Aufbau auf die Geometrie des Pfads.
clip() ersetzt den Clipbereich durch dessen Schnittmenge mit dem Inneren des aktuellen Pfads oder eines übergebenen Path2D. Bei Path2D wirkt die Transformation beim Aufruf von clip(), ohne das Objekt zu ändern. Die optionale Füllregel 'nonzero' (Standard) prüft, ob die vorzeichenbehaftete Summe der Kreuzungen ungleich null ist; 'evenodd' prüft, ob die Anzahl der Kreuzungen ungerade ist. clip() zeichnet nichts; weitere Aufrufe können den Bereich nicht erweitern. Speichere den Zustand vor dem Clipping und stelle ihn nach dem Zeichnen wieder her: Die Einheitsmatrix hebt das Clipping nicht auf.
fillRect() füllt mit fillStyle, strokeRect() zeichnet den Umriss mit strokeStyle und den Linieneinstellungen, und clearRect() löscht zu transparentem Schwarz (deckendem Schwarz bei alpha: false), unabhängig von Schatten, globalem Alpha und Compositing. Alle drei wirken direkt auf die Bitmap, berücksichtigen Transformation und Clipbereich und lassen den Pfad unverändert. fillRect() liefert also keine Geometrie für clip(). clearRect() hebt die Auslesesperre einer durch ursprungsfremde Daten verunreinigten Bitmap nicht auf: getImageData() löst weiterhin SecurityError aus.
Beispiele
<!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>Ergebnis
255, 0, 255, 255, 0
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Die fünf Alphawerte zeigen der Reihe nach: durch den Clip geschützte Füllung, gelöschtes Pixel, unveränderte Füllung, nach dem Wiederherstellen gezeichneten Umriss und dessen transparentes Inneres.
Zugehörige Lektionen
- JavaScript · Lektion 12 · Fortgeschritten · Version: 4
Quellen
- 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