eglCreatePixmapSurface
- create a new EGL pixmap surface
EGLSurface eglCreatePixmapSurface(EGLDisplay display, EGLConfig config, NativePixmapType native_pixmap, EGLint const * attrib_list)
display
Specifies the EGL display connection.
config
Specifies the EGL frame buffer configuration that defines the frame buffer resource available to the surface.
native_pixmap
Specifies the native pixmap.
attrib_list
Specifies pixmap surface attributes. Must be NULL
or empty (first attribute is EGL_NONE
).
eglCreatePixmapSurface
creates an off-screen EGL pixmap surface and returns its handle. If eglCreatePixmapSurface
fails to create a pixmap surface, EGL_NO_SURFACE
is returned.
Any EGL rendering context that was created with respect to config
can be used to render into the surface. Use eglMakeCurrent
to attach an EGL rendering context to the surface.
Use eglQuerySurface
to retrieve the ID of config
.
Use eglDestroySurface
to destroy the surface.
EGL_NO_SURFACE
is returned if creation of the context fails.
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_CONFIG
is generated if config
is not an EGL config.
EGL_BAD_NATIVE_PIXMAP
may be generated if native_pixmap
is not a valid native pixmap.
EGL_BAD_ATTRIBUTE
is generated if attrib_list
contains an invalid pixmap attribute or if an attribute value is not recognized or out of range.
EGL_BAD_ALLOC
is generated if there are not enough resources to allocate the new surface.
EGL_BAD_MATCH
is generated if the attributes of native_pixmap
do not correspond to config
or if config
does not support rendering to pixmaps (the EGL_SURFACE_TYPE
attribute does not contain EGL_PIXMAP_BIT
).
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/.
eglDestroySurface
, eglChooseConfig
, eglGetConfigs
, eglMakeCurrent
, eglQuerySurface