102f4aeb0Sopenharmony_ci<?xml version="1.0" encoding="UTF-8" standalone="no"?> 202f4aeb0Sopenharmony_ci<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml"> 302f4aeb0Sopenharmony_ci <head> 402f4aeb0Sopenharmony_ci <title xmlns:xlink="http://www.w3.org/1999/xlink">eglSurfaceAttrib - EGL Reference Pages</title> 502f4aeb0Sopenharmony_ci <link rel="stylesheet" type="text/css" href="khronos-man.css"/> 602f4aeb0Sopenharmony_ci <meta name="generator" content="DocBook XSL Stylesheets V1.79.1"/> 702f4aeb0Sopenharmony_ci </head> 802f4aeb0Sopenharmony_ci <body> 902f4aeb0Sopenharmony_ci <header/> 1002f4aeb0Sopenharmony_ci <div class="refentry" id="eglSurfaceAttrib"> 1102f4aeb0Sopenharmony_ci <div class="titlepage"/> 1202f4aeb0Sopenharmony_ci <div class="refnamediv"> 1302f4aeb0Sopenharmony_ci <h2>Name</h2> 1402f4aeb0Sopenharmony_ci <p>eglSurfaceAttrib — 1502f4aeb0Sopenharmony_ci set an <abbr class="acronym">EGL</abbr> surface attribute 1602f4aeb0Sopenharmony_ci </p> 1702f4aeb0Sopenharmony_ci </div> 1802f4aeb0Sopenharmony_ci <div class="refsynopsisdiv"> 1902f4aeb0Sopenharmony_ci <h2>C Specification</h2> 2002f4aeb0Sopenharmony_ci <div class="funcsynopsis"> 2102f4aeb0Sopenharmony_ci <table style="border: 0; cellspacing: 0; cellpadding: 0;" class="funcprototype-table"> 2202f4aeb0Sopenharmony_ci <tr> 2302f4aeb0Sopenharmony_ci <td> 2402f4aeb0Sopenharmony_ci <code class="funcdef">EGLBoolean <strong class="fsfunc">eglSurfaceAttrib</strong>(</code> 2502f4aeb0Sopenharmony_ci </td> 2602f4aeb0Sopenharmony_ci <td>EGLDisplay <var class="pdparam">display</var>, </td> 2702f4aeb0Sopenharmony_ci </tr> 2802f4aeb0Sopenharmony_ci <tr> 2902f4aeb0Sopenharmony_ci <td> </td> 3002f4aeb0Sopenharmony_ci <td>EGLSurface <var class="pdparam">surface</var>, </td> 3102f4aeb0Sopenharmony_ci </tr> 3202f4aeb0Sopenharmony_ci <tr> 3302f4aeb0Sopenharmony_ci <td> </td> 3402f4aeb0Sopenharmony_ci <td>EGLint <var class="pdparam">attribute</var>, </td> 3502f4aeb0Sopenharmony_ci </tr> 3602f4aeb0Sopenharmony_ci <tr> 3702f4aeb0Sopenharmony_ci <td> </td> 3802f4aeb0Sopenharmony_ci <td>EGLint <var class="pdparam">value</var><code>)</code>;</td> 3902f4aeb0Sopenharmony_ci </tr> 4002f4aeb0Sopenharmony_ci </table> 4102f4aeb0Sopenharmony_ci <div class="funcprototype-spacer"> </div> 4202f4aeb0Sopenharmony_ci </div> 4302f4aeb0Sopenharmony_ci </div> 4402f4aeb0Sopenharmony_ci <div class="refsect1" id="parameters"> 4502f4aeb0Sopenharmony_ci <h2>Parameters</h2> 4602f4aeb0Sopenharmony_ci <div class="variablelist"> 4702f4aeb0Sopenharmony_ci <dl class="variablelist"> 4802f4aeb0Sopenharmony_ci <dt> 4902f4aeb0Sopenharmony_ci <span class="term"> 5002f4aeb0Sopenharmony_ci <em class="parameter"> 5102f4aeb0Sopenharmony_ci <code>display</code> 5202f4aeb0Sopenharmony_ci </em> 5302f4aeb0Sopenharmony_ci </span> 5402f4aeb0Sopenharmony_ci </dt> 5502f4aeb0Sopenharmony_ci <dd> 5602f4aeb0Sopenharmony_ci <p> 5702f4aeb0Sopenharmony_ci Specifies the EGL display connection. 5802f4aeb0Sopenharmony_ci </p> 5902f4aeb0Sopenharmony_ci </dd> 6002f4aeb0Sopenharmony_ci <dt> 6102f4aeb0Sopenharmony_ci <span class="term"> 6202f4aeb0Sopenharmony_ci <em class="parameter"> 6302f4aeb0Sopenharmony_ci <code>surface</code> 6402f4aeb0Sopenharmony_ci </em> 6502f4aeb0Sopenharmony_ci </span> 6602f4aeb0Sopenharmony_ci </dt> 6702f4aeb0Sopenharmony_ci <dd> 6802f4aeb0Sopenharmony_ci <p> 6902f4aeb0Sopenharmony_ci Specifies the EGL surface. 7002f4aeb0Sopenharmony_ci </p> 7102f4aeb0Sopenharmony_ci </dd> 7202f4aeb0Sopenharmony_ci <dt> 7302f4aeb0Sopenharmony_ci <span class="term"> 7402f4aeb0Sopenharmony_ci <em class="parameter"> 7502f4aeb0Sopenharmony_ci <code>attribute</code> 7602f4aeb0Sopenharmony_ci </em> 7702f4aeb0Sopenharmony_ci </span> 7802f4aeb0Sopenharmony_ci </dt> 7902f4aeb0Sopenharmony_ci <dd> 8002f4aeb0Sopenharmony_ci <p> 8102f4aeb0Sopenharmony_ci Specifies the EGL surface attribute to set. 8202f4aeb0Sopenharmony_ci </p> 8302f4aeb0Sopenharmony_ci </dd> 8402f4aeb0Sopenharmony_ci <dt> 8502f4aeb0Sopenharmony_ci <span class="term"> 8602f4aeb0Sopenharmony_ci <em class="parameter"> 8702f4aeb0Sopenharmony_ci <code>value</code> 8802f4aeb0Sopenharmony_ci </em> 8902f4aeb0Sopenharmony_ci </span> 9002f4aeb0Sopenharmony_ci </dt> 9102f4aeb0Sopenharmony_ci <dd> 9202f4aeb0Sopenharmony_ci <p> 9302f4aeb0Sopenharmony_ci Specifies the attributes required value. 9402f4aeb0Sopenharmony_ci </p> 9502f4aeb0Sopenharmony_ci </dd> 9602f4aeb0Sopenharmony_ci </dl> 9702f4aeb0Sopenharmony_ci </div> 9802f4aeb0Sopenharmony_ci </div> 9902f4aeb0Sopenharmony_ci <div class="refsect1" id="description"> 10002f4aeb0Sopenharmony_ci <h2>Description</h2> 10102f4aeb0Sopenharmony_ci <p> 10202f4aeb0Sopenharmony_ci <code class="function">eglSurfaceAttrib</code> sets the value of 10302f4aeb0Sopenharmony_ci <em class="parameter"><code>attribute</code></em> for 10402f4aeb0Sopenharmony_ci <em class="parameter"><code>surface</code></em> to 10502f4aeb0Sopenharmony_ci <em class="parameter"><code>value</code></em>. 10602f4aeb0Sopenharmony_ci <em class="parameter"><code>attribute</code></em> can be one of the 10702f4aeb0Sopenharmony_ci following: 10802f4aeb0Sopenharmony_ci </p> 10902f4aeb0Sopenharmony_ci <div class="variablelist"> 11002f4aeb0Sopenharmony_ci <dl class="variablelist"> 11102f4aeb0Sopenharmony_ci <dt> 11202f4aeb0Sopenharmony_ci <span class="term"> 11302f4aeb0Sopenharmony_ci <code class="constant">EGL_MIPMAP_LEVEL</code> 11402f4aeb0Sopenharmony_ci </span> 11502f4aeb0Sopenharmony_ci </dt> 11602f4aeb0Sopenharmony_ci <dd> 11702f4aeb0Sopenharmony_ci <p> 11802f4aeb0Sopenharmony_ci For mipmap textures, the 11902f4aeb0Sopenharmony_ci <code class="constant">EGL_MIPMAP_LEVEL</code> attribute 12002f4aeb0Sopenharmony_ci indicates which level of the mipmap should be 12102f4aeb0Sopenharmony_ci rendered. If the value of this attribute is outside 12202f4aeb0Sopenharmony_ci the range of supported mipmap levels, the closest 12302f4aeb0Sopenharmony_ci valid mipmap level is selected for rendering. The 12402f4aeb0Sopenharmony_ci default value is <code class="constant">0</code>. 12502f4aeb0Sopenharmony_ci </p> 12602f4aeb0Sopenharmony_ci </dd> 12702f4aeb0Sopenharmony_ci <dt> 12802f4aeb0Sopenharmony_ci <span class="term"> 12902f4aeb0Sopenharmony_ci <code class="constant">EGL_MULTISAMPLE_RESOLVE</code> 13002f4aeb0Sopenharmony_ci </span> 13102f4aeb0Sopenharmony_ci </dt> 13202f4aeb0Sopenharmony_ci <dd> 13302f4aeb0Sopenharmony_ci <p> 13402f4aeb0Sopenharmony_ci Specifies the filter to use when resolving the 13502f4aeb0Sopenharmony_ci multisample buffer (this may occur when swapping or 13602f4aeb0Sopenharmony_ci copying the surface, or when changing the client API 13702f4aeb0Sopenharmony_ci context bound to the surface). A 13802f4aeb0Sopenharmony_ci <em class="parameter"><code>value</code></em> of 13902f4aeb0Sopenharmony_ci <code class="constant">EGL_MULTISAMPLE_RESOLVE_DEFAULT</code> 14002f4aeb0Sopenharmony_ci chooses the default implementation-defined filtering 14102f4aeb0Sopenharmony_ci method, while 14202f4aeb0Sopenharmony_ci <code class="constant">EGL_MULTISAMPLE_RESOLVE_BOX</code> 14302f4aeb0Sopenharmony_ci chooses a one-pixel wide box filter placing equal 14402f4aeb0Sopenharmony_ci weighting on all multisample values. 14502f4aeb0Sopenharmony_ci </p> 14602f4aeb0Sopenharmony_ci <p> 14702f4aeb0Sopenharmony_ci The initial value of 14802f4aeb0Sopenharmony_ci <code class="constant">EGL_MULTISAMPLE_RESOLVE</code> is 14902f4aeb0Sopenharmony_ci <code class="constant">EGL_MULTISAMPLE_RESOLVE_DEFAULT</code>. 15002f4aeb0Sopenharmony_ci </p> 15102f4aeb0Sopenharmony_ci </dd> 15202f4aeb0Sopenharmony_ci <dt> 15302f4aeb0Sopenharmony_ci <span class="term"> 15402f4aeb0Sopenharmony_ci <code class="constant">EGL_SWAP_BEHAVIOR</code> 15502f4aeb0Sopenharmony_ci </span> 15602f4aeb0Sopenharmony_ci </dt> 15702f4aeb0Sopenharmony_ci <dd> 15802f4aeb0Sopenharmony_ci <p> 15902f4aeb0Sopenharmony_ci Specifies the effect on the color buffer of posting 16002f4aeb0Sopenharmony_ci a surface with 16102f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglSwapBuffers.xhtml"><span class="citerefentry"><span class="refentrytitle">eglSwapBuffers</span></span></a>. 16202f4aeb0Sopenharmony_ci A <em class="parameter"><code>value</code></em> of 16302f4aeb0Sopenharmony_ci <code class="constant">EGL_BUFFER_PRESERVED</code> indicates 16402f4aeb0Sopenharmony_ci that color buffer contents are unaffected, while 16502f4aeb0Sopenharmony_ci <code class="constant">EGL_BUFFER_DESTROYED</code> indicates 16602f4aeb0Sopenharmony_ci that color buffer contents may be destroyed or 16702f4aeb0Sopenharmony_ci changed by the operation. 16802f4aeb0Sopenharmony_ci </p> 16902f4aeb0Sopenharmony_ci <p> 17002f4aeb0Sopenharmony_ci The initial value of 17102f4aeb0Sopenharmony_ci <code class="constant">EGL_SWAP_BEHAVIOR</code> is chosen by 17202f4aeb0Sopenharmony_ci the implementation. 17302f4aeb0Sopenharmony_ci </p> 17402f4aeb0Sopenharmony_ci </dd> 17502f4aeb0Sopenharmony_ci </dl> 17602f4aeb0Sopenharmony_ci </div> 17702f4aeb0Sopenharmony_ci </div> 17802f4aeb0Sopenharmony_ci <div class="refsect1" id="notes"> 17902f4aeb0Sopenharmony_ci <h2>Notes</h2> 18002f4aeb0Sopenharmony_ci <p> 18102f4aeb0Sopenharmony_ci Attribute <code class="constant">EGL_MULTISAMPLE_RESOLVE</code> is 18202f4aeb0Sopenharmony_ci supported only if the EGL version is 1.4 or greater. 18302f4aeb0Sopenharmony_ci </p> 18402f4aeb0Sopenharmony_ci <p> 18502f4aeb0Sopenharmony_ci Attribute <code class="constant">EGL_SWAP_BEHAVIOR</code> is 18602f4aeb0Sopenharmony_ci supported only if the EGL version is 1.2 or greater. 18702f4aeb0Sopenharmony_ci </p> 18802f4aeb0Sopenharmony_ci <p> 18902f4aeb0Sopenharmony_ci If the value of pbuffer attribute 19002f4aeb0Sopenharmony_ci <code class="constant">EGL_TEXTURE_FORMAT</code> is 19102f4aeb0Sopenharmony_ci <code class="constant">EGL_NO_TEXTURE</code>, the value of attribute 19202f4aeb0Sopenharmony_ci <code class="constant">EGL_TEXTURE_TARGET</code> is 19302f4aeb0Sopenharmony_ci <code class="constant">EGL_NO_TEXTURE</code>, or 19402f4aeb0Sopenharmony_ci <em class="parameter"><code>surface</code></em> is not a pbuffer, then 19502f4aeb0Sopenharmony_ci attribute <code class="constant">EGL_MIPMAP_LEVEL</code> may be set, 19602f4aeb0Sopenharmony_ci but has no effect. 19702f4aeb0Sopenharmony_ci </p> 19802f4aeb0Sopenharmony_ci </div> 19902f4aeb0Sopenharmony_ci <div class="refsect1" id="errors"> 20002f4aeb0Sopenharmony_ci <h2>Errors</h2> 20102f4aeb0Sopenharmony_ci <p> 20202f4aeb0Sopenharmony_ci <code class="constant">EGL_FALSE</code> is returned on failure, 20302f4aeb0Sopenharmony_ci <code class="constant">EGL_TRUE</code> otherwise. 20402f4aeb0Sopenharmony_ci </p> 20502f4aeb0Sopenharmony_ci <p> 20602f4aeb0Sopenharmony_ci <code class="constant">EGL_BAD_DISPLAY</code> is generated if 20702f4aeb0Sopenharmony_ci <em class="parameter"><code>display</code></em> is not an EGL display connection. 20802f4aeb0Sopenharmony_ci </p> 20902f4aeb0Sopenharmony_ci <p> 21002f4aeb0Sopenharmony_ci <code class="constant">EGL_BAD_MATCH</code> is generated if 21102f4aeb0Sopenharmony_ci <em class="parameter"><code>attribute</code></em> is 21202f4aeb0Sopenharmony_ci <code class="constant">EGL_MULTISAMPLE_RESOLVE</code>, 21302f4aeb0Sopenharmony_ci <em class="parameter"><code>value</code></em> is 21402f4aeb0Sopenharmony_ci <code class="constant">EGL_MULTISAMPLE_RESOLVE_BOX</code>, and the 21502f4aeb0Sopenharmony_ci <code class="constant">EGL_SURFACE_TYPE</code> attribute of the 21602f4aeb0Sopenharmony_ci <span class="type">EGLConfig</span> used to create 21702f4aeb0Sopenharmony_ci <em class="parameter"><code>surface</code></em> does not contain 21802f4aeb0Sopenharmony_ci <code class="constant">EGL_MULTISAMPLE_RESOLVE_BOX_BIT</code>. 21902f4aeb0Sopenharmony_ci </p> 22002f4aeb0Sopenharmony_ci <p> 22102f4aeb0Sopenharmony_ci <code class="constant">EGL_BAD_MATCH</code> is generated if 22202f4aeb0Sopenharmony_ci <em class="parameter"><code>attribute</code></em> is 22302f4aeb0Sopenharmony_ci <code class="constant">EGL_SWAP_BEHAVIOR</code>, 22402f4aeb0Sopenharmony_ci <em class="parameter"><code>value</code></em> is 22502f4aeb0Sopenharmony_ci <code class="constant">EGL_BUFFER_PRESERVED</code>, and the 22602f4aeb0Sopenharmony_ci <code class="constant">EGL_SURFACE_TYPE</code> attribute of the 22702f4aeb0Sopenharmony_ci <span class="type">EGLConfig</span> used to create 22802f4aeb0Sopenharmony_ci <em class="parameter"><code>surface</code></em> does not contain 22902f4aeb0Sopenharmony_ci <code class="constant">EGL_SWAP_BEHAVIOR_PRESERVED_BIT</code>. 23002f4aeb0Sopenharmony_ci </p> 23102f4aeb0Sopenharmony_ci <p> 23202f4aeb0Sopenharmony_ci <code class="constant">EGL_NOT_INITIALIZED</code> is generated if 23302f4aeb0Sopenharmony_ci <em class="parameter"><code>display</code></em> has not been initialized. 23402f4aeb0Sopenharmony_ci </p> 23502f4aeb0Sopenharmony_ci <p> 23602f4aeb0Sopenharmony_ci <code class="constant">EGL_BAD_SURFACE</code> is generated if 23702f4aeb0Sopenharmony_ci <em class="parameter"><code>surface</code></em> is not an EGL surface. 23802f4aeb0Sopenharmony_ci </p> 23902f4aeb0Sopenharmony_ci <p> 24002f4aeb0Sopenharmony_ci <code class="constant">EGL_BAD_ATTRIBUTE</code> is generated if 24102f4aeb0Sopenharmony_ci <em class="parameter"><code>attribute</code></em> is not a valid surface attribute. 24202f4aeb0Sopenharmony_ci </p> 24302f4aeb0Sopenharmony_ci </div> 24402f4aeb0Sopenharmony_ci <div class="refsect1" id="seealso"> 24502f4aeb0Sopenharmony_ci <h2>See Also</h2> 24602f4aeb0Sopenharmony_ci <p> 24702f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglCreatePbufferSurface.xhtml"><span class="citerefentry"><span class="refentrytitle">eglCreatePbufferSurface</span></span></a>, 24802f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglCreatePixmapSurface.xhtml"><span class="citerefentry"><span class="refentrytitle">eglCreatePixmapSurface</span></span></a>, 24902f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglCreateWindowSurface.xhtml"><span class="citerefentry"><span class="refentrytitle">eglCreateWindowSurface</span></span></a>, 25002f4aeb0Sopenharmony_ci <a class="citerefentry" href="eglQuerySurface.xhtml"><span class="citerefentry"><span class="refentrytitle">eglQuerySurface</span></span></a> 25102f4aeb0Sopenharmony_ci </p> 25202f4aeb0Sopenharmony_ci </div> 25302f4aeb0Sopenharmony_ci <p> 25402f4aeb0Sopenharmony_ci </p> 25502f4aeb0Sopenharmony_ci <div class="refsect3" id="copyright"> 25602f4aeb0Sopenharmony_ci <img src="KhronosLogo.jpg"/> 25702f4aeb0Sopenharmony_ci <p> 25802f4aeb0Sopenharmony_ci Copyright © 2003-2014 The Khronos Group Inc. 25902f4aeb0Sopenharmony_ci Permission is hereby granted, free of charge, to any person obtaining a 26002f4aeb0Sopenharmony_ci copy of this software and/or associated documentation files (the 26102f4aeb0Sopenharmony_ci "Materials"), to deal in the Materials without restriction, including 26202f4aeb0Sopenharmony_ci without limitation the rights to use, copy, modify, merge, publish, 26302f4aeb0Sopenharmony_ci distribute, sublicense, and/or sell copies of the Materials, and to 26402f4aeb0Sopenharmony_ci permit persons to whom the Materials are furnished to do so, subject to 26502f4aeb0Sopenharmony_ci the condition that this copyright notice and permission notice shall be included 26602f4aeb0Sopenharmony_ci in all copies or substantial portions of the Materials. 26702f4aeb0Sopenharmony_ci </p> 26802f4aeb0Sopenharmony_ci </div> 26902f4aeb0Sopenharmony_ci <p> 27002f4aeb0Sopenharmony_ci</p> 27102f4aeb0Sopenharmony_ci </div> 27202f4aeb0Sopenharmony_ci <footer/> 27302f4aeb0Sopenharmony_ci </body> 27402f4aeb0Sopenharmony_ci</html> 275
