CKTIS / JavaScript
HTMLCanvasElement: Renderingkontext und Bitmap-Abmessungen
Wähle mit `getContext()` einen Renderingkontext und lege mit `width` und `height` die Bitmap-Größe fest. Anders als eine Größenänderung per CSS setzt das Schreiben dieser Eigenschaften im 2D-Modus den Zeichenstatus zurück.
Version: Current web platform; runtime support varies
Syntax
canvas.getContext(contextId)
canvas.getContext(contextId, options)
canvas.width
canvas.height
canvas.width = bitmapWidth
canvas.height = bitmapHeightHTMLCanvasElement ist eine in HTML definierte Browserschnittstelle und kein Bestandteil von ECMAScript 2024. canvas.getContext(contextId, options) erwartet eine Kennung als Zeichenkette und optionale modusspezifische Einstellungen. "2d" wählt CanvasRenderingContext2D, "bitmaprenderer" wählt ImageBitmapRenderingContext, "webgl" wählt WebGLRenderingContext, "webgl2" wählt WebGL2RenderingContext und "webgpu" wählt GPUCanvasContext. Welche Modi und Optionen verfügbar sind, hängt von der Laufzeitumgebung ab.
Der erste erfolgreiche Aufruf legt den Modus des Elements fest. Ein weiterer Aufruf mit derselben Kennung liefert dasselbe Objekt, ohne neue Einstellungen anzuwenden. Ist ein Modus nicht unterstützt oder nicht verfügbar oder wird ein anderer Modus angefordert, lautet das Ergebnis null. Nach einem erfolgreichen transferControlToOffscreen() ist das Element ein Platzhalter: getContext() und Zuweisungen an width oder height lösen InvalidStateError aus.
canvas.width und canvas.height spiegeln die gleichnamigen HTML-Attribute wider. Sie geben die Breite und Höhe der Bitmap als nichtnegative Ganzzahlen an. Fehlt ein Attribut oder schlägt seine Auswertung fehl, gilt der jeweilige Standardwert 300 oder 150. Nur canvas.style.width oder canvas.style.height zu setzen, ändert die Anzeigegröße, nicht die Bitmap-Auflösung; durch Skalierung kann das Bild unscharf werden.
Im 2D-Modus löscht jede Zuweisung an eine der beiden Dimensionen die Bitmap, selbst bei unverändertem Wert. Zeichenstatus, aktueller Pfad, Transformation und Stile werden zurückgesetzt, das Kontextobjekt bleibt erhalten. Lege die Abmessungen vor dem Zeichnen fest. Stelle nach einer Größenänderung den benötigten Status wieder her und zeichne neu. Andere Modi müssen sich dabei nicht gleich verhalten.
Zeichnest du ein Bild von einem anderen Origin ohne passende CORS-Freigabe, kann die Bitmap ihren Status origin-clean verlieren. Dann löst getImageData() einen SecurityError aus. Eine Größenänderung der 2D-Bitmap verwirft ihren Inhalt, statt die gesperrten Pixel offenzulegen.
Beispiele
<!doctype html>
<meta charset="utf-8">
<title>Canvas 2D resize reset</title>
<script>
(() => {
const canvas = document.createElement("canvas");
console.log(`${canvas.width}x${canvas.height}`);
canvas.width = 4;
canvas.height = 3;
console.log(`${canvas.width}x${canvas.height}`);
const ctx = canvas.getContext("2d");
if (ctx === null) throw new Error("2D canvas context unavailable");
ctx.fillRect(0, 0, 1, 1);
ctx.globalAlpha = 0.5;
const alphaAtOrigin = () => ctx.getImageData(0, 0, 1, 1).data[3];
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
canvas.width = canvas.width;
console.log(`${alphaAtOrigin()} ${ctx.globalAlpha}`);
console.log(canvas.getContext("2d") === ctx);
console.log(canvas.getContext("bitmaprenderer") === null);
})();
</script>Ergebnis
300x150 4x3 255 0.5 0 1 true true
Speichere das Beispiel als HTML-Datei, öffne es im Browser und lies die Ausgabe in der Entwicklerkonsole ab. Die ersten beiden Zeilen zeigen die Abmessungen. Die Zuweisung derselben Breite ändert den Alpha-Wert des Pixels von `255` auf `0` und setzt `globalAlpha` von `0.5` auf `1` zurück. Die beiden `true`-Werte zeigen, dass der Kontext erhalten bleibt und ein anderer Modus abgelehnt wird.
Zugehörige Lektionen
- JavaScript · Lektion 12 · Fortgeschritten · Version: 4
- JavaScript · Lektion 33 · Fortgeschritten · Version: 4
- JavaScript · Lektion 34 · Fortgeschritten · Version: 4