2003-2014 The Khronos Group Inc.
eglCopyBuffers 3G
eglCopyBuffers copy EGL surface color buffer to a native pixmap

## C Specification

EGLBoolean `eglCopyBuffers` EGLDisplay display EGLSurface surface NativePixmapType native_pixmap

## Parameters

display

  Specifies the EGL display connection.

surface

  Specifies the EGL surface whose color buffer is to be copied.

native_pixmap

  Specifies the native pixmap as target of the copy.

## Description

`eglCopyBuffers` copies the color buffer of surface to native_pixmap.

`eglCopyBuffers` performs an implicit glFlush before it returns. Subsequent GL commands may be issued immediately after calling `eglCopyBuffers`, but are not executed until copying of the color buffer is completed.

## Notes

The color buffer of surface is left unchanged after calling `eglCopyBuffers`.

## Errors

`EGL_FALSE` is returned if swapping of the surface buffers fails, `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 drawing surface.

`EGL_BAD_NATIVE_PIXMAP` is generated if the implementation does not support native pixmaps.

`EGL_BAD_NATIVE_PIXMAP` may be generated if native_pixmap is not a valid native pixmap.

`EGL_BAD_MATCH` is generated if the format of native_pixmap is not compatible with the color buffer of surface.

`EGL_CONTEXT_LOST` is generated if a power management event has occurred. The application must destroy all contexts and reinitialise OpenGL ES state and objects to continue rendering.

## See Also

glFlush, eglSwapBuffers