gpu/GLES2/extensions/CHROMIUM/CHROMIUM_request_extension.txt

   1 Name
   2
   3     CHROMIUM_request_extension
   4
   5 Name Strings
   6
   7     GL_CHROMIUM_request_extension
   8
   9 Version
  10
  11     Last Modifed Date: July 22, 2011
  12
  13 Dependencies
  14
  15     OpenGL ES 2.0 is required.
  16
  17 Overview
  18
  19     This extension is for WebGL only. In some implemenations of OpenGL ES 2.0,
  20     in particular the Chromium implementation, it is possible to create an
  21     OpenGL context and request that most extensions be disabled. From that
  22     point, this extension allows extensions to then be selectively enabled.
  23
  24     WebGL requires the base OpenGL ES 2.0 with NO extensions. So for example,
  25     if an OpenGL ES 2.0 implemention exposed the extension OES_texture_npot, the
  26     WebGL implementation would have to make it appear as though that extension
  27     does not exist. For Chromium WebGL OpenGL contexts, Chromium requests a
  28     context with no extensions. It then queries which extensions exist. If
  29     OES_texture_npot does NOT exist then WebGL can decide to not do the extra
  30     work required to emulate it not existing.
  31
  32     Subsequently, if the user calls
  33     WebGLRenderingContext.getExtension("WEBGL_texture_npot"), assuming such an
  34     extension exists, the WebGL implementation can call this extension to turn
  35     on OES_texture_npot. After calling RequestExtensionCHROMIUM you must call
  36     GetString(GL_EXTENSIONS) in order to find out if the extension was actually
  37     enabled.
  38
  39     Note: This extension really has no meaning outside of WebGL. By default, all
  40     supported extensions are enabled.
  41
  42 Issues
  43
  44
  45 New Tokens
  46
  47     None
  48
  49 New Procedures and Functions
  50
  51     RequestExtensionCHROMIUM(const GLchar *extension)
  52
  53     <extension> is a null terminated string of the extension you wish to enable.
  54     For example "OES_texture_npot".
  55
  56 Errors
  57
  58     None.
  59
  60 New State
  61
  62     None.
  63
  64 Revision History
  65
  66     7/22/2011    Documented the extension