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
|
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glValidateProgramPipeline - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /></head><body><div class="refentry"><a id="glValidateProgramPipeline"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glValidateProgramPipeline — validate a program pipeline object against current GL state</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">glValidateProgramPipeline</strong>(</code></td><td>GLuint <var class="pdparam">pipeline</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>pipeline</code></em></span></dt><dd><p>
Specifies the name of a program pipeline object to validate.
</p></dd></dl></div></div><div class="refsect1"><a id="description"></a><h2>Description</h2><p>
<code class="function">glValidateProgramPipeline</code> instructs the implementation to validate the
shader executables contained in <em class="parameter"><code>pipeline</code></em> against the current GL state.
The implementation may use this as an opportunity to perform any internal shader modifications
that may be required to ensure correct operation of the installed shaders given the
current GL state.
</p><p>
After a program pipeline has been validated, its validation status is set to <code class="constant">GL_TRUE</code>.
The validation status of a program pipeline object may be queried by calling
<a class="citerefentry" href="glGetProgramPipeline.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgramPipeline</span></span></a> with
parameter <code class="constant">GL_VALIDATE_STATUS</code>.
</p><p>
If <em class="parameter"><code>pipeline</code></em> is a name previously returned from a call to
<a class="citerefentry" href="glGenProgramPipelines.xml"><span class="citerefentry"><span class="refentrytitle">glGenProgramPipelines</span></span></a> but
that has not yet been bound by a call to <a class="citerefentry" href="glBindProgramPipeline.xml"><span class="citerefentry"><span class="refentrytitle">glBindProgramPipeline</span></span></a>,
a new program pipeline object is created with name <em class="parameter"><code>pipeline</code></em> and
the default state vector.
</p></div><div class="refsect1"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_OPERATION</code> is generated if <em class="parameter"><code>pipeline</code></em> is not
a name previously returned from a call to <a class="citerefentry" href="glGenProgramPipelines.xml"><span class="citerefentry"><span class="refentrytitle">glGenProgramPipelines</span></span></a>
or if such a name has been deleted by a call to
<a class="citerefentry" href="glDeleteProgramPipelines.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteProgramPipelines</span></span></a>.
</p></div><div class="refsect1"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
<a class="citerefentry" href="glGetProgramPipeline.xml"><span class="citerefentry"><span class="refentrytitle">glGetProgramPipeline</span></span></a>
with parameter <code class="constant">GL_VALIDATE_STATUS</code>.
</p></div><div class="refsect1"><a id="seealso"></a><h2>See Also</h2><p>
<a class="citerefentry" href="glGenProgramPipelines.xml"><span class="citerefentry"><span class="refentrytitle">glGenProgramPipelines</span></span></a>,
<a class="citerefentry" href="glBindProgramPipeline.xml"><span class="citerefentry"><span class="refentrytitle">glBindProgramPipeline</span></span></a>,
<a class="citerefentry" href="glDeleteProgramPipelines.xml"><span class="citerefentry"><span class="refentrytitle">glDeleteProgramPipelines</span></span></a>
</p></div><div class="refsect1"><a id="Copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2010-2013 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></body></html>
|
