The Tor Browser: gfx/angle/extensions/EGL_ANGLE_query_surface

Conditionally force memory storage according to privacy.thirdparty.isolate;
This solves Tor bug #9701, complying with disk avoidance documented in
https://www.torproject.org/projects/torbrowser/design/#disk-avoidance.

     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.

The Tor Browser / file revision

gfx/angle/extensions/EGL_ANGLE_query_surface_pointer.txt@97036ab72558

gfx/angle/extensions/EGL_ANGLE_query_surface_pointer.txt