Name

    MESA_opengl_api

Name Strings

    EGL_MESA_opengl_api

Contact

    Adam Jackson <ajax@nwnk.net>

    To discuss, join dri-egl@lists.freedesktop.org

Status

    Preliminary

Version

    1 (15 November 2005)

Number

    TBD

Dependencies

    EGL 1.2 or later.

Overview

    EGL 1.2 provides the ability to use multiple rendering APIs on a context.
    This extension allows the selection of full OpenGL as an EGL API.

Issues

    1. OpenGL and OpenGL|ES export overlapping namespaces.  How should this
    be handled?
    
      For now Mesa only supports the OpenGL namespace.

New Procedures and Functions

    None.

New Types

    None

New Tokens

    Accepted by the <api> parameter of eglBindAPI, and returned by
    eglQueryAPI:
    
        EGL_OPENGL_API_MESA                 0xXXXX

Additions to Chapter 3 of the EGL 1.2 Specification (EGL Functions and Errors)

    In section 3.3, follow the sentence "It is zero terminated and contains a
    space-separated list of API names, ..." with "If the implementation
    supports the EGL_MESA_opengl_api extension, it must not list ''OpenGL_ES''
    as an API, and must list ''OpenGL'' as an API."

    In section 3.7, add EGL_OPENGL_API_MESA to the list of supported APIs.

    Also in section 3.7, change the sentence "The initial value of the current
    rendering API is EGL_OPENGL_ES_API, unless OpenGL ES is not supported by
    an implementation, in which case the initial value is EGL_NONE." to "The
    initial value of the current rendering API is EGL_OPENGL_ES_API if the
    implementation supports OpenGL ES, or EGL_OPENGL_API_MESA if the
    implementation supports the EGL_MESA_opengl_api extension, or EGL_NONE
    otherwise."

Version History

    1. 15 November 2005 - ajax
       Initial version.