Name

eglSurfaceAttrib - set an EGL surface attribute

C Specification

EGLBoolean eglSurfaceAttrib(EGLDisplay display,
    EGLSurface surface,
    EGLint attribute,
    EGLint value)

Parameters

display

Specifies the EGL display connection.

surface

Specifies the EGL surface.

attribute

Specifies the EGL surface attribute to set.

value

Specifies the attributes required value.

Description

eglSurfaceAttrib sets the value of attribute for surface to value. attribute can be one of the following:

EGL_MIPMAP_LEVEL

For mipmap textures, the EGL_MIPMAP_LEVEL 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 0.

Notes

If the value of pbuffer attribute EGL_TEXTURE_FORMAT is EGL_NO_TEXTURE, if the value of attribute EGL_TEXTURE_TYPE is EGL_NO_TEXTURE, or if surface is not a pbuffer, then attribute EGL_MIPMAP_LEVEL may be set, but has no effect.

Errors

EGL_FALSE is returned on failure, EGL_TRUE otherwise.

EGL_BAD_DISPLAY is generated if display is not an EGL display connection.

EGL_NOT_INITIALIZED is generated if display has not been initialized.

EGL_BAD_SURFACE is generated if surface is not an EGL surface.

EGL_BAD_ATTRIBUTE is generated if attribute is not a valid surface attribute.

Copyright

Copyright © 2003-2004 Silicon Graphics, Inc.

This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.

See Also

eglCreatePbufferSurface, eglCreatePixmapSurface, eglCreateWindowSurface, eglQuerySurface