<?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>eglSurfaceAttrib</title><meta name="generator" content="DocBook XSL Stylesheets V1.74.0" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="eglSurfaceAttrib"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>eglSurfaceAttrib — 
            set an <acronym class="acronym">EGL</acronym> surface attribute
        </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">EGLBoolean <b class="fsfunc">eglSurfaceAttrib</b>(</code></td><td>EGLDisplay <var class="pdparam">display</var>, </td></tr><tr><td> </td><td>EGLSurface <var class="pdparam">surface</var>, </td></tr><tr><td> </td><td>EGLint <var class="pdparam">attribute</var>, </td></tr><tr><td> </td><td>EGLint <var class="pdparam">value</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>display</code></em></span></dt><dd><p>
                        Specifies the EGL display connection.
                    </p></dd><dt><span class="term"><em class="parameter"><code>surface</code></em></span></dt><dd><p>
                        Specifies the EGL surface.
                    </p></dd><dt><span class="term"><em class="parameter"><code>attribute</code></em></span></dt><dd><p>
                        Specifies the EGL surface attribute to set.
                    </p></dd><dt><span class="term"><em class="parameter"><code>value</code></em></span></dt><dd><p>
                        Specifies the attributes required value.
                    </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
            <code class="function">eglSurfaceAttrib</code> sets the value of <em class="parameter"><code>attribute</code></em>
            for <em class="parameter"><code>surface</code></em> to <em class="parameter"><code>value</code></em>.
            <em class="parameter"><code>attribute</code></em> can be one of the following:
        </p><div class="variablelist"><dl><dt><span class="term"><code class="constant">EGL_MIPMAP_LEVEL</code></span></dt><dd><p>
                    For mipmap textures, the <code class="constant">EGL_MIPMAP_LEVEL</code> attribute indicates which level
                    of the mipmap should be rendered. If the value of this attribute is outside the
                    range of supported mipmap levels, the closest valid mipmap level is selected for
                    rendering. The default value is <code class="constant">0</code>.
                </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
            If the value of pbuffer attribute <code class="constant">EGL_TEXTURE_FORMAT</code> is <code class="constant">EGL_NO_TEXTURE</code>, if
            the value of attribute <code class="constant">EGL_TEXTURE_TYPE</code> is <code class="constant">EGL_NO_TEXTURE</code>, or if surface is not
            a pbuffer, then attribute <code class="constant">EGL_MIPMAP_LEVEL</code> may be set, but has no effect.
        </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
            <code class="constant">EGL_FALSE</code> is returned on failure,
            <code class="constant">EGL_TRUE</code> otherwise.
        </p><p>
            <code class="constant">EGL_BAD_DISPLAY</code> is generated if
            <em class="parameter"><code>display</code></em> is not an EGL display connection.
        </p><p>
            <code class="constant">EGL_NOT_INITIALIZED</code> is generated if
            <em class="parameter"><code>display</code></em> has not been initialized.
        </p><p>
            <code class="constant">EGL_BAD_SURFACE</code> is generated if
            <em class="parameter"><code>surface</code></em> is not an EGL surface.
        </p><p>
            <code class="constant">EGL_BAD_ATTRIBUTE</code> is generated if
            <em class="parameter"><code>attribute</code></em> is not a valid surface attribute.
        </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
            <a class="citerefentry" href="eglCreatePbufferSurface.xml"><span class="citerefentry"><span class="refentrytitle">eglCreatePbufferSurface</span></span></a>,
            <a class="citerefentry" href="eglCreatePixmapSurface.xml"><span class="citerefentry"><span class="refentrytitle">eglCreatePixmapSurface</span></span></a>,
            <a class="citerefentry" href="eglCreateWindowSurface.xml"><span class="citerefentry"><span class="refentrytitle">eglCreateWindowSurface</span></span></a>,
            <a class="citerefentry" href="eglQuerySurface.xml"><span class="citerefentry"><span class="refentrytitle">eglQuerySurface</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>

