1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
---
title: CanvasRenderingContext2D.save()
slug: Web/API/CanvasRenderingContext2D/save
tags:
- API
- Canvas
- CanvasRenderingContext2D
- Referencia
- metodo
translation_of: Web/API/CanvasRenderingContext2D/save
---
<div>{{APIRef}}</div>
<p>El método <code><strong>CanvasRenderingContext2D</strong></code><strong><code>.save()</code></strong> del API Canvas 2D guarda el estado completo del canvas añadiendo el estado actual a una pila.</p>
<h3 id="El_estado_del_dibujo">El estado del dibujo</h3>
<p>El estado del dibujo que se almacena en una pila consiste en los siguientes elementos:</p>
<ul>
<li>La matriz de transformación actual.</li>
<li>La región de recorte actual.</li>
<li>La lista de punteado actual.</li>
<li>Los valores actuales de los siguientes atributos: {{domxref("CanvasRenderingContext2D.strokeStyle", "strokeStyle")}}, {{domxref("CanvasRenderingContext2D.fillStyle", "fillStyle")}}, {{domxref("CanvasRenderingContext2D.globalAlpha", "globalAlpha")}}, {{domxref("CanvasRenderingContext2D.lineWidth", "lineWidth")}}, {{domxref("CanvasRenderingContext2D.lineCap", "lineCap")}}, {{domxref("CanvasRenderingContext2D.lineJoin", "lineJoin")}}, {{domxref("CanvasRenderingContext2D.miterLimit", "miterLimit")}}, {{domxref("CanvasRenderingContext2D.lineDashOffset", "lineDashOffset")}}, {{domxref("CanvasRenderingContext2D.shadowOffsetX", "shadowOffsetX")}}, {{domxref("CanvasRenderingContext2D.shadowOffsetY", "shadowOffsetY")}}, {{domxref("CanvasRenderingContext2D.shadowBlur", "shadowBlur")}}, {{domxref("CanvasRenderingContext2D.shadowColor", "shadowColor")}}, {{domxref("CanvasRenderingContext2D.globalCompositeOperation", "globalCompositeOperation")}}, {{domxref("CanvasRenderingContext2D.font", "font")}}, {{domxref("CanvasRenderingContext2D.textAlign", "textAlign")}}, {{domxref("CanvasRenderingContext2D.textBaseline", "textBaseline")}}, {{domxref("CanvasRenderingContext2D.direction", "direction")}}, {{domxref("CanvasRenderingContext2D.imageSmoothingEnabled", "imageSmoothingEnabled")}}.</li>
</ul>
<h2 id="Sintaxis">Sintaxis</h2>
<pre class="syntaxbox">void <em>ctx</em>.save();</pre>
<h2 id="Ejemplos">Ejemplos</h2>
<h3 id="Guardando_el_estado_del_dibujo">Guardando el estado del dibujo</h3>
<p>Este ejemplo usa el método <code>save()</code> para guardar el estado por defecto y el método <code>restore()</code> para restaurarlo luego, de tal manera que luego se puede dibujar el segundo rectángulo con el estado por defecto.</p>
<h4 id="HTML">HTML</h4>
<pre class="brush: html"><canvas id="canvas"></canvas>
</pre>
<h4 id="JavaScript">JavaScript</h4>
<pre class="brush: js; highlight:[5]">const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');
// Guardar el estado por defecto
ctx.save();
ctx.fillStyle = 'green';
ctx.fillRect(10, 10, 100, 100);
// Restaurar el estado por defecto
ctx.restore();
ctx.fillRect(150, 40, 100, 100);
</pre>
<h4 id="Resultado">Resultado</h4>
<p>{{ EmbedLiveSample('Saving_the_drawing_state', 700, 180) }}</p>
<h2 id="Especificaciones">Especificaciones</h2>
<table class="standard-table">
<tbody>
<tr>
<th scope="col">Especificación</th>
<th scope="col">Estado</th>
<th scope="col">Comentarios</th>
</tr>
<tr>
<td>{{SpecName('HTML WHATWG', "scripting.html#dom-context-2d-save", "CanvasRenderingContext2D.save")}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td></td>
</tr>
</tbody>
</table>
<h2 id="Compatibilidad_con_exploradores">Compatibilidad con exploradores</h2>
<p>{{Compat("api.CanvasRenderingContext2D.save")}}</p>
<h2 id="Véase_también">Véase también</h2>
<ul>
<li>La interfaz donde se define este método: {{domxref("CanvasRenderingContext2D")}}</li>
<li>{{domxref("CanvasRenderingContext2D.restore()")}}</li>
</ul>
|
