files/zh-cn/web/api/webglrenderingcontext/getcontextattributes/index.html


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

---
title: WebGLRenderingContext.getContextAttributes()
slug: Web/API/WebGLRenderingContext/getContextAttributes
translation_of: Web/API/WebGLRenderingContext/getContextAttributes
---
<div>{{APIRef("WebGL")}}</div>

<p><code><strong>WebGLRenderingContext.getContextAttributes()</strong></code> 方法返回一个包含实际上下文参数的 <code>WebGLContextAttributes</code> 对象。如果上下文丢失，可能返回 {{jsxref("null")}}。</p>

<h2 id="语法">语法</h2>

<pre class="syntaxbox"><var><em>gl</em></var>.getContextAttributes();</pre>

<h3 id="返回值">返回值</h3>

<p>一个包含实际上下文参数的 <code>WebGLContextAttributes</code> 的对象，或 {{jsxref("null")}} （如果上下文丢失）。</p>

<h2 id="实例">实例</h2>

<p>给定 {{HTMLElement("canvas")}} 元素</p>

<pre class="brush: html">&lt;canvas id="canvas"&gt;&lt;/canvas&gt;
</pre>

<p>和给定 WebGL 上下文</p>

<pre class="brush: js">var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
gl.getContextAttributes();
</pre>

<p><code>getContextAttributes</code> 方法返回描述在此上下文中设置的属性的对象，例如：</p>

<pre class="brush: js">{
  alpha: true,
  antialias: true,
  depth: true,
  failIfMajorPerformanceCaveat: false,
  premultipliedAlpha: true,
  preserveDrawingBuffer: false,
  stencil: false
}</pre>

<p>上下文的属性可以在用 {{domxref("HTMLCanvasElement.getContext()")}} 方法创建上下文时设置：</p>

<pre class="brush: js">canvas.getContext('webgl',
                 { antialias: false,
                   depth: false });</pre>

<p>有关各个属性的更多信息，请参阅 {{domxref("HTMLCanvasElement.getContext()", "getContext()")}}。</p>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">规范</th>
   <th scope="col">状态</th>
   <th scope="col">注释</th>
  </tr>
  <tr>
   <td>{{SpecName("WebGL", "#5.14.2", "WebGLRenderingContext.getContextAttributes")}}</td>
   <td>{{Spec2("WebGL")}}</td>
   <td>初始定义</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<p class="hidden">此页面中的兼容性表格由结构化数据生成。 如果您想为数据做出贡献，请查看 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 并向我们发送合并请求。</p>

<p>{{Compat("api.WebGLRenderingContext.getContextAttributes")}}</p>

<h2 id="另请参阅">另请参阅</h2>

<ul>
 <li>{{domxref("WebGLRenderingContext")}}</li>
</ul>