Skip to content

Commit

Permalink
GLES import from Khronos.
Browse files Browse the repository at this point in the history
  • Loading branch information
@BSVino
BSVino committed Aug 15, 2014
1 parent a428c13 commit 48e8e10
Show file tree
Hide file tree
Showing 465 changed files with 93,851 additions and 0 deletions.
66 changes: 66 additions & 0 deletions es1/glActiveTexture.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
<?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" /><title>glActiveTexture</title><meta name="generator" content="DocBook XSL Stylesheets V1.74.0" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glActiveTexture"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glActiveTexture — select server-side active texture unit</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glActiveTexture</b>(</code></td><td>GLenum <var class="pdparam">texture</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term">
<em class="parameter"><code>texture</code></em>
</span></dt><dd><p>
Specifies which texture unit to make active. The
number of texture units is implementation dependent, but
must be at least two.
<em class="parameter"><code>texture</code></em> must be one of
<code class="constant">GL_TEXTURE</code><em class="replaceable"><code>i</code></em>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mn>0</mml:mn>
<mml:mo>&lt;=</mml:mo>
<mml:mi>i</mml:mi>
<mml:mo>&lt;</mml:mo>
<mml:mi>GL_MAX_TEXTURE_UNITS</mml:mi>
</mml:math>,
which is an implementation-dependent value. The intial value is
<code class="constant">GL_TEXTURE0</code>.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
<code class="function">glActiveTexture</code>
selects which texture unit subsequent texture state calls will
affect. The number of texture units an implementation supports
is implementation dependent, it must be at least 2.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if
<em class="parameter"><code>texture</code></em> is not one of
<code class="constant">GL_TEXTURE</code><em class="replaceable"><code>i</code></em>,
where
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mn>0</mml:mn>
<mml:mo>&lt;=</mml:mo>
<mml:mi>i</mml:mi>
<mml:mo>&lt;</mml:mo>
<mml:mi>GL_MAX_TEXTURE_UNITS</mml:mi>
</mml:math>.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>It is always the case that
<mml:math xmlns:mml="http://www.w3.org/1998/Math/MathML" overflow="scroll">
<mml:mi>GL_TEXTURE</mml:mi><mml:mi>i</mml:mi> <mml:mo>=</mml:mo>
<mml:mi>GL_TEXTURE0</mml:mi><mml:mo>+</mml:mo><mml:mi>i</mml:mi>
</mml:math>.</p><p>A texture unit consists of the texture enable state,
texture matrix stack, texture environment and currently bound
texture. Modifying any of these states has an effect only on
the active texture unit.
</p><p>Vertex arrays are client-side GL resources, which are
selected by the
<a class="citerefentry" href="glClientActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glClientActiveTexture</span></span></a>
routine.</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="associatedgets"></a><h2>Associated Gets</h2><p>
<a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>
with argument <code class="constant">GL_ACTIVE_TEXTURE</code> or
<code class="constant">GL_MAX_TEXTURE_UNITS</code>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a class="citerefentry" href="glBindTexture.xml"><span class="citerefentry"><span class="refentrytitle">glBindTexture</span></span></a>,
<a class="citerefentry" href="glClientActiveTexture.xml"><span class="citerefentry"><span class="refentrytitle">glClientActiveTexture</span></span></a>,
<a class="citerefentry" href="glEnable.xml"><span class="citerefentry"><span class="refentrytitle">glEnable</span></span></a>,
<a class="citerefentry" href="glGet.xml"><span class="citerefentry"><span class="refentrytitle">glGet</span></span></a>,
<a class="citerefentry" href="glMatrixMode.xml"><span class="citerefentry"><span class="refentrytitle">glMatrixMode</span></span></a>,
<a class="citerefentry" href="glMultiTexCoord.xml"><span class="citerefentry"><span class="refentrytitle">glMultiTexCoord</span></span></a>,
<a class="citerefentry" href="glTexEnv.xml"><span class="citerefentry"><span class="refentrytitle">glTexEnv</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2003-2004
Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<a class="ulink" href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
</p></div></div></body></html>
93 changes: 93 additions & 0 deletions es1/glAlphaFunc.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,93 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
<!-- saved from url=(0013)about:internet -->
<?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" /><title>glAlphaFunc</title><meta name="generator" content="DocBook XSL Stylesheets V1.74.0" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glAlphaFunc"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glAlphaFunc — specify the alpha test function</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glAlphaFunc</b>(</code></td><td>GLenum <var class="pdparam">func</var>, </td></tr><tr><td> </td><td>GLclampf <var class="pdparam">ref</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><tr><td><code class="funcdef">void <b class="fsfunc">glAlphaFuncx</b>(</code></td><td>GLenum <var class="pdparam">func</var>, </td></tr><tr><td> </td><td>GLclampx <var class="pdparam">ref</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term">
<em class="parameter"><code>func</code></em>
</span></dt><dd><p>Specifies the alpha comparison function. Symbolic
constants
<code class="constant">GL_NEVER</code>,
<code class="constant">GL_LESS</code>,
<code class="constant">GL_EQUAL</code>,
<code class="constant">GL_LEQUAL</code>,
<code class="constant">GL_GREATER</code>,
<code class="constant">GL_NOTEQUAL</code>,
<code class="constant">GL_GEQUAL</code>, and
<code class="constant">GL_ALWAYS</code>
are accepted. The initial value is
<code class="constant">GL_ALWAYS</code>.
</p></dd><dt><span class="term">
<em class="parameter"><code>ref</code></em>
</span></dt><dd><p>Specifies the reference value that incoming alpha
values are compared to. This value is clamped to the
range [0, 1], where 0 represents the lowest possible
alpha value and 1 the highest possible value. The initial
reference value is 0.
</p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>The alpha test discards fragments depending on the
outcome of a comparison between an incoming fragment's alpha
value and a constant reference value.
<code class="function">glAlphaFunc</code>
specifies the reference value and the comparison function. The
comparison is performed only if alpha testing is enabled.
To enable and disable alpha testing, call
<a class="citerefentry" href="glEnable.xml"><span class="citerefentry"><span class="refentrytitle">glEnable</span></span></a> and
<a class="citerefentry" href="glDisable.xml"><span class="citerefentry"><span class="refentrytitle">glDisable</span></span></a>
with argument <code class="constant">GL_ALPHA_TEST</code>.
Alpha testing is initially disabled. When disabled, it is as if the comparison
always passes.

</p><p>
<em class="parameter"><code>func</code></em> and <em class="parameter"><code>ref</code></em>
specify the conditions under which the pixel is drawn. The
incoming alpha value is compared to <em class="parameter"><code>ref</code></em>
using the function specified by <em class="parameter"><code>func</code></em>.

If the value passes the comparison, the incoming fragment is
drawn if it also passes subsequent stencil and depth buffer
tests. If the value fails the comparison, no change is made to
the frame buffer at that pixel location. The comparison
functions are as follows:
</p><div class="variablelist"><dl><dt><span class="term">
<code class="constant">GL_NEVER</code>
</span></dt><dd><p>Never passes.</p></dd><dt><span class="term">
<code class="constant">GL_LESS</code>
</span></dt><dd><p>Passes if the incoming alpha value is less than the
reference value.</p></dd><dt><span class="term">
<code class="constant">GL_EQUAL</code>
</span></dt><dd><p>Passes if the incoming alpha value is equal to the
reference value.</p></dd><dt><span class="term">
<code class="constant">GL_LEQUAL</code>
</span></dt><dd><p>Passes if the incoming alpha value is less than or
equal to the reference value.</p></dd><dt><span class="term">
<code class="constant">GL_GREATER</code>
</span></dt><dd><p>Passes if the incoming alpha value is greater than
the reference value.</p></dd><dt><span class="term">
<code class="constant">GL_NOTEQUAL</code>
</span></dt><dd><p>Passes if the incoming alpha value is not equal to
the reference value.</p></dd><dt><span class="term">
<code class="constant">GL_GEQUAL</code>
</span></dt><dd><p>Passes if the incoming alpha value is greater than
or equal to the reference value.</p></dd><dt><span class="term">
<code class="constant">GL_ALWAYS</code>
</span></dt><dd><p>Always passes (initial value).</p></dd></dl></div><p>
<code class="function">glAlphaFunc</code>
operates on all pixel write operations, including those
resulting from the scan conversion of points, lines, and
polygons.
<code class="function">glAlphaFunc</code>
does not affect
<a class="citerefentry" href="glClear.xml"><span class="citerefentry"><span class="refentrytitle">glClear</span></span></a>.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
<code class="constant">GL_INVALID_ENUM</code> is generated if
<em class="parameter"><code>func</code></em> is not an accepted value.
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
<a class="citerefentry" href="glBlendFunc.xml"><span class="citerefentry"><span class="refentrytitle">glBlendFunc</span></span></a>,
<a class="citerefentry" href="glClear.xml"><span class="citerefentry"><span class="refentrytitle">glClear</span></span></a>,
<a class="citerefentry" href="glDepthFunc.xml"><span class="citerefentry"><span class="refentrytitle">glDepthFunc</span></span></a>,
<a class="citerefentry" href="glEnable.xml"><span class="citerefentry"><span class="refentrytitle">glEnable</span></span></a>,
<a class="citerefentry" href="glStencilFunc.xml"><span class="citerefentry"><span class="refentrytitle">glStencilFunc</span></span></a>
</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="copyright"></a><h2>Copyright</h2><p>
Copyright <span class="trademark"></span>© 2003-2004
Silicon Graphics, Inc. This document is licensed under the SGI
Free Software B License. For details, see
<a class="ulink" href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
</p></div></div></body></html>
Loading

0 comments on commit 48e8e10

Please sign in to comment.