CKTIS / JavaScript
Canvas 2D: Transformationen, Rechtecke und Pfade
Unterscheide Transformation, Pixel und Standardpfad. So erkennst du, wann Koordinaten umgerechnet werden, welche Aufrufe sofort Pixel ändern und was nach `stroke()` erhalten bleibt.
Version: 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 gehört zu einer Web-API, nicht zu ECMAScript 2024. Rufe die Methoden auf dem Kontext ctx auf, den canvas.getContext('2d') liefert; der Rückgabewert kann null sein. Welche Aufrufformen verfügbar sind, hängt von der Laufzeitumgebung ab. Alle sieben Methoden geben bei einem normalen Aufruf undefined zurück.
setTransform(a, b, c, d, e, f) ersetzt die aktuelle Matrix, während transform() sie multipliziert. Aus (x, y) wird (a*x + c*y + e, b*x + d*y + f). Die Objektvariante erwartet ein Dictionary für eine 2D-Matrix (DOMMatrix2DInit). Fehlende Komponenten erhalten die Werte der Einheitsmatrix; widersprüchliche Aliaswerte wie bei a und m11 führen zu TypeError. Laut Standard setzt ein Aufruf ohne Argumente die Einheitsmatrix. Bei der Variante mit sechs Zahlen bleibt die aktuelle Matrix unverändert, wenn eines der Argumente NaN oder unendlich ist. Die Dictionary-Variante erzeugt aus einem gültigen Dictionary eine DOMMatrix und setzt sie ohne diese Prüfung als aktuelle Matrix ein.
fillRect(x, y, width, height) zeichnet sofort ein Rechteck mit fillStyle. Mit denselben Parametern setzt clearRect() die Pixel auf transparentes Schwarz (bei alpha: false auf deckendes Schwarz), unabhängig vom Zeichenstil, von globalAlpha und vom Kompositionsmodus. Beide Methoden berücksichtigen Matrix und Clipping-Bereich und lassen den Pfad unverändert. Eine Nulldimension hat keine Wirkung; eine negative Dimension erstreckt das Rechteck von (x, y) aus in die Gegenrichtung.
beginPath() leert den Standardpfad, ohne Pixel zu löschen. moveTo(x, y) beginnt einen neuen Teilpfad ohne Verbindung zum vorherigen. lineTo(x, y) fügt eine gerade Strecke vom letzten Punkt hinzu; ohne Teilpfad setzt es nur den Startpunkt. Keine dieser drei Methoden zeichnet Pixel. moveTo(), lineTo() und beide Rechteckmethoden ignorieren Aufrufe mit NaN oder unendlichen Werten für Koordinaten oder Abmessungen.
stroke() zeichnet den aktuellen Standardpfad mit strokeStyle und Linieneinstellungen wie lineWidth. Es schließt offene Teilpfade nicht und leert den Pfad nicht. Die Koordinaten des Standardpfads werden beim Hinzufügen transformiert, nicht erneut beim Zeichnen. Die dann aktuelle Matrix beeinflusst aber den Strich selbst, etwa seine Dicke. Bei stroke(path) wird die Geometrie des übergebenen Path2D erst beim Zeichnen transformiert, ohne das Objekt zu ändern. save() und restore() sichern und restaurieren den Zeichenzustand einschließlich Matrix, aber weder den Standardpfad noch die Pixel.
Beispiele
<!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>Ergebnis
0, 255, 255, 0
Speichere das Beispiel als HTML-Datei, öffne sie im Browser und prüfe die Ausgabe in der Browserkonsole. Die erwarteten Alphawerte `0, 255, 255, 0` stehen für den gelöschten Bereich, die verbleibende Füllung, die verschobene Linie und eine unberührte Stelle im unverschobenen Koordinatensystem. `getImageData()` liest in Bitmap-Koordinaten. Datenschutzeinstellungen können das Ergebnis verändern; bei nicht autorisierten Inhalten fremder Herkunft kann das Auslesen `SecurityError` auslösen.
Zugehörige Lektionen
- JavaScript · Lektion 34 · Fortgeschritten · Version: 4
Quellen
- HTML Standard — The canvas settings
- HTML Standard — The canvas state
- HTML Standard — Building paths
- HTML Standard — Transformations
- HTML Standard — Drawing rectangles to the bitmap
- HTML Standard — Drawing paths to the canvas
- CanvasRenderingContext2D: setTransform() method
- CanvasRenderingContext2D: getImageData() method