gfx/angle/extensions/EGL_ANGLE_query_surface_pointer.txt
author Benoit Jacob <jacob.benoit.1@gmail.com>
Thu, 26 Jan 2012 12:04:15 -0500
changeset 85491 f9be3f46122e1ea481f08a43d22eb53228e833d8
parent 70098 478015023b8aad08073980ee1a8a6bd118d60601
permissions -rw-r--r--
Bug 720438 - Update ANGLE to r963 - no review No review because this is just syncing us with upstream: http://code.google.com/p/angleproject/ This is also doing some cleanup, removing stale/empty files and updating patches. The main benefit from this update is that long-identifier-shortening has been fixed.

Name

    ANGLE_query_surface_pointer

Name Strings

    EGL_ANGLE_query_surface_pointer

Contributors

    Vladimir Vukicevic
    Daniel Koch

Contacts

    Vladimir Vukicevic (vladimir 'at' pobox.com)

Status

    Complete
    Implemented (ANGLE r558)

Version

    Version 3, February 11, 2011

Number

    EGL Extension #28

Dependencies

    This extension is written against the wording of the EGL 1.4
    Specification. 

Overview

    This extension allows querying pointer-sized surface attributes,
    thus avoiding problems with coercing 64-bit pointers into a 32-bit
    integer.

New Types

    None

New Procedures and Functions

    EGLBoolean eglQuerySurfacePointerANGLE(
                        EGLDisplay dpy,
                        EGLSurface surface,
                        EGLint attribute,
                        void **value);

New Tokens

    None

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

    Add to the end of the paragraph starting with "To query an
    attribute associated with an EGLSurface" in section 3.5.6,
    "Surface Attributes":

    "If the attribute type in table 3.5 is 'pointer', then
    eglQuerySurface returns EGL_FALSE and an EGL_BAD_PARAMETER error
    is generated.  To query pointer attributes, call:

         EGLBoolean eglQuerySurfacePointerANGLE(
                             EGLDisplay dpy,
                             EGLSurface surface,
                             EGLint attribute,
                             void **value);

     eglQuerySurfacePointerANGLE behaves identically to eglQuerySurface,
     except that only attributes of type 'pointer' can be queried.
     If an attribute queried via eglQuerySurfacePointerANGLE is not
     of type 'pointer', then eglQuerySurfacePointer returns EGL_FALSE
     and an EGL_BAD_PARAMETER error is generated."

Issues

Revision History

    Version 3, 2011/02/11 - publish

    Version 2, 2010/12/21 - fix typos.

    Version 1, 2010/12/07 - first draft.