eglGetDisplay - EGL Reference Pages

## Name

eglGetDisplay — return an EGL display connection

## C Specification

`EGLDisplay eglGetDisplay(` | NativeDisplayType native_display`)`;

## Parameters

`native_display`

  Specifies the display to connect to. `EGL_DEFAULT_DISPLAY` indicates the default display.

## Description

`eglGetDisplay` obtains the EGL display connection for the native display `native_display`.

The behavior of `eglGetDisplay` is similar to that of eglGetPlatformDisplay, but is specified in terms of implementation-specific behavior rather than platform-specific extensions. As for eglGetPlatformDisplay, EGL considers the returned EGLDisplay as belonging to the same platform as `display_id`. However, the set of platforms to which `display_id` is permitted to belong, as well as the actual type of `display_id`, are implementation-specific. If `display_id` is `EGL_DEFAULT_DISPLAY`, a default display is returned. Multiple calls made to `eglGetDisplay` with the same `display_id` will return the same EGLDisplay handle.

If `display_id` is `EGL_DEFAULT_DISPLAY`, a default display connection is returned.

If no display connection matching `native_display` is available, `EGL_NO_DISPLAY` is returned. No error is generated.

Use eglInitialize to initialize the display connection.

## See Also

eglInitialize, eglGetPlatformDisplay

Copyright © 2003-2014 The Khronos Group Inc. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or associated documentation files (the "Materials"), to deal in the Materials without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to the condition that this copyright notice and permission notice shall be included in all copies or substantial portions of the Materials.