gfx/angle/extensions/EGL_ANGLE_query_surface_pointer.txt

Wed, 31 Dec 2014 06:09:35 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Wed, 31 Dec 2014 06:09:35 +0100
changeset 0
6474c204b198
permissions
-rw-r--r--

Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.

     1 Name
     3     ANGLE_query_surface_pointer
     5 Name Strings
     7     EGL_ANGLE_query_surface_pointer
     9 Contributors
    11     Vladimir Vukicevic
    12     Daniel Koch
    14 Contacts
    16     Vladimir Vukicevic (vladimir 'at' pobox.com)
    18 Status
    20     Complete
    21     Implemented (ANGLE r558)
    23 Version
    25     Version 3, February 11, 2011
    27 Number
    29     EGL Extension #28
    31 Dependencies
    33     This extension is written against the wording of the EGL 1.4
    34     Specification. 
    36 Overview
    38     This extension allows querying pointer-sized surface attributes,
    39     thus avoiding problems with coercing 64-bit pointers into a 32-bit
    40     integer.
    42 New Types
    44     None
    46 New Procedures and Functions
    48     EGLBoolean eglQuerySurfacePointerANGLE(
    49                         EGLDisplay dpy,
    50                         EGLSurface surface,
    51                         EGLint attribute,
    52                         void **value);
    54 New Tokens
    56     None
    58 Additions to Chapter 3 of the EGL 1.4 Specification (EGL Functions and Errors)
    60     Add to the end of the paragraph starting with "To query an
    61     attribute associated with an EGLSurface" in section 3.5.6,
    62     "Surface Attributes":
    64     "If the attribute type in table 3.5 is 'pointer', then
    65     eglQuerySurface returns EGL_FALSE and an EGL_BAD_PARAMETER error
    66     is generated.  To query pointer attributes, call:
    68          EGLBoolean eglQuerySurfacePointerANGLE(
    69                              EGLDisplay dpy,
    70                              EGLSurface surface,
    71                              EGLint attribute,
    72                              void **value);
    74      eglQuerySurfacePointerANGLE behaves identically to eglQuerySurface,
    75      except that only attributes of type 'pointer' can be queried.
    76      If an attribute queried via eglQuerySurfacePointerANGLE is not
    77      of type 'pointer', then eglQuerySurfacePointer returns EGL_FALSE
    78      and an EGL_BAD_PARAMETER error is generated."
    80 Issues
    82 Revision History
    84     Version 3, 2011/02/11 - publish
    86     Version 2, 2010/12/21 - fix typos.
    88     Version 1, 2010/12/07 - first draft.

mercurial