CKTIS / JavaScript
Canvas 2D: Pixel löschen, zeichnen und bearbeiten
Unterscheide Zeichenoperationen im 2D-Kontext vom direkten Lesen und Schreiben von Pixeln in der Bitmap.
Version: 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 und putImageData sind Instanzmethoden des Kontexts aus canvas.getContext('2d'). Sie gehören zur Web-API, nicht zu ECMAScript 2024. clearRect() berücksichtigt die aktuelle Transformation und den Clipping-Bereich. Es setzt Pixel auf transparentes Schwarz (bei alpha: false auf deckendes Schwarz), ohne den Zeichenzustand oder den aktuellen Pfad zurückzusetzen. Beginne einen neuen Pfad mit beginPath().
drawImage() erwartet eine einsatzbereite Quelle vom Typ CanvasImageSource, etwa ein Bild oder einen anderen Canvas, aber kein ImageData. Mit 3 Argumenten wird die gesamte Quelle in ihrer natürlichen Größe gezeichnet, mit 5 wird die Zielgröße festgelegt, mit 9 wird ein Quellrechteck auf ein Zielrechteck abgebildet. Negative Maße erweitern ein Rechteck in die Gegenrichtung, ohne das Bild zu spiegeln. Beim Zeichnen gelten Transformation, Clipping und Komposition. Wenn ein Bild noch lädt und nicht verwendbar ist, zeichnet drawImage() es nicht. Ein vollständig verfügbares, dekodierbares Bild lässt sich zeichnen, ohne zuvor decode() aufzurufen oder einen Frame vorab zu dekodieren. Ein Quell-Canvas mit einer Nulldimension löst InvalidStateError aus.
getImageData() liest Bitmap-Pixel unabhängig von Transformation und Clipping. Es gibt eine eigenständige ImageData-Kopie zurück: Änderungen an data verändern den Canvas nicht. Das Array enthält RGBA-Werte zeilenweise; der erste Kanal des Pixels (x, y) in der Kopie liegt bei (y * imageData.width + x) * 4. Außerhalb der Bitmap erhältst du transparentes Schwarz. Negative sw oder sh erweitern das Rechteck in die Gegenrichtung; null löst IndexSizeError aus.
putImageData() ersetzt Pixel ohne Skalierung, Transformation, Kontext-Clipping oder Mischung. Die Variante mit 7 Argumenten wählt einen Teilbereich in ImageData, nicht im Ziel: Pixel (x, y) landet bei (dx + x, dy + y). Ein abgetrennter Puffer löst InvalidStateError aus. Farbraumkonvertierung und Alpha-Prämultiplikation können beim erneuten Lesen andere Werte ergeben, besonders bei teiltransparenten Pixeln.
Wird eine Ressource fremder Herkunft ohne CORS-Freigabe gezeichnet, kann die Bitmap ihren Status origin-clean verlieren. Das Auslesen löst dann selbst nach clearRect() einen SecurityError aus. Verwende für solche Ressourcen eine CORS-Anfrage mit passender Serverfreigabe. Das Standardleseformat rgba-unorm8 verwendet Uint8ClampedArray; prüfe die Unterstützung für Optionen wie display-p3 oder rgba-float16 (Float16Array) in den Zielbrowsern.
Beispiele
<!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>Ergebnis
0,0,0,0,255,0,0,255 0,0,255,255,255,0,0,255
Die erste Zeile zeigt links das gelöschte und rechts das rote Pixel. Der Code färbt das rechte Pixel der Kopie blau und schreibt nur dieses Pixel mit `dx = -1`. In der zweiten Zeile ist das linke Pixel blau und das rechte weiterhin rot.
Zugehörige Lektionen
- JavaScript · Lektion 33 · Fortgeschritten · Version: 4