forked from BSVino/docs.gl
-
Notifications
You must be signed in to change notification settings - Fork 0
/
glReleaseShaderCompiler.xhtml
27 lines (27 loc) · 3.89 KB
/
glReleaseShaderCompiler.xhtml
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
<div class="refentry"><a id="glReleaseShaderCompiler"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glReleaseShaderCompiler — release resources allocated by the shader compiler</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">void <strong class="fsfunc">glReleaseShaderCompiler</strong>(</code></td><td> <var class="pdparam">void</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a id="description"></a><h2>Description</h2><p>For implementations that support a shader compiler,
<code class="function">glReleaseShaderCompiler</code>
frees resources allocated by the shader compiler. This is a hint from the application
that additional shader compilations are unlikely to occur, at least for some period of time,
and that the resources consumed by the shader compiler may be released and put to better use
elsewhere.</p><p>However, if a call to <a class="citerefentry" href="glCompileShader"><span class="citerefentry"><span class="refentrytitle">glCompileShader</span></span></a>
is made after a call to <code class="function">glReleaseShaderCompiler</code>, the shader compiler must be restored
to service the compilation request as if <code class="function">glReleaseShaderCompiler</code> had never been called.</p></div><div class="refsect1"><a id="notes"></a><h2>Notes</h2><p>Shader compiler support is optional, and thus must be queried
before use by calling <a class="citerefentry" href="glGet"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
with argument <code class="constant">GL_SHADER_COMPILER</code>. <a class="citerefentry" href="glShaderSource"><span class="citerefentry"><span class="refentrytitle">glShaderSource</span></span></a>,
<a class="citerefentry" href="glCompileShader"><span class="citerefentry"><span class="refentrytitle">glCompileShader</span></span></a>,
<a class="citerefentry" href="glGetShaderPrecisionFormat"><span class="citerefentry"><span class="refentrytitle">glGetShaderPrecisionFormat</span></span></a>, and
<code class="function">glReleaseShaderCompiler</code> will
each generate <code class="constant">GL_INVALID_OPERATION</code> on implementations
that do not support a shader compiler. Such implementations instead offer the
<a class="citerefentry" href="glShaderBinary"><span class="citerefentry"><span class="refentrytitle">glShaderBinary</span></span></a>
alternative for supplying a pre-compiled shader binary.</p></div><div class="refsect1"><a id="errors"></a><h2>Errors</h2><p><code class="constant">GL_INVALID_OPERATION</code> is generated if
a shader compiler is not supported.</p></div><div class="refsect1"><a id="associatedgets"></a><h2>Associated Gets</h2><p><a class="citerefentry" href="glGet"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
with argument <code class="constant">GL_SHADER_COMPILER</code></p></div>
{$pipelinestall}{$examples}
<div class="refsect1"><a id="seealso"></a><h2>See Also</h2><p><a class="citerefentry" href="glCompileShader"><span class="citerefentry"><span class="refentrytitle">glCompileShader</span></span></a>,
<a class="citerefentry" href="glShaderSource"><span class="citerefentry"><span class="refentrytitle">glShaderSource</span></span></a></p></div><div class="refsect1"><div id="Copyright"><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2008 Khronos Group.
This material may be distributed subject to the terms and conditions set forth in
the Open Publication License, v 1.0, 8 June 1999.
<a class="ulink" href="http://opencontent.org/openpub/" target="_top">http://opencontent.org/openpub/</a>.
</p></div></div></div>