CanvasRenderingContext2D: save() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die CanvasRenderingContext2D.save()-Methode der Canvas 2D API speichert den gesamten Zustand der Leinwand, indem sie den aktuellen Zustand auf einen Stapel schiebt.
Syntax
js
save()
Parameter
Keine.
Rückgabewert
Keiner (undefined).
Beschreibung
Der Zeichenstatus, der auf einen Stapel gespeichert wird, besteht aus:
- Der aktuellen Transformationsmatrix.
- Der aktuellen Clipping-Region.
- Der aktuellen Strichliste.
- Den aktuellen Werten der folgenden Attribute:
directionfillStylefilterfontfontKerningfontStretchfontVariantCapsglobalAlphaglobalCompositeOperationimageSmoothingEnabledimageSmoothingQualityletterSpacinglineCaplineDashOffsetlineJoinlineWidthmiterLimitshadowBlurshadowColorshadowOffsetXshadowOffsetYstrokeStyletextAligntextBaselinetextRenderingwordSpacing
Beispiele
>Speichern des Zeichenstatus
Dieses Beispiel verwendet die save()-Methode, um den aktuellen Zustand zu speichern und restore(), um ihn später wiederherzustellen, damit Sie in der Lage sind, später ein Rechteck mit dem aktuellen Zustand zu zeichnen.
HTML
html
<canvas id="canvas"></canvas>
JavaScript
js
const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");
// Save the current state
ctx.save();
ctx.fillStyle = "green";
ctx.fillRect(10, 10, 100, 100);
// Restore to the state saved by the most recent call to save()
ctx.restore();
ctx.fillRect(150, 40, 100, 100);
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| HTML> # dom-context-2d-save-dev> |
Browser-Kompatibilität
Siehe auch
- Das Interface, das diese Methode definiert:
CanvasRenderingContext2D CanvasRenderingContext2D.restore()