opengl/specs/EGL_ANDROID_framebuffer_target.txt

   1 Name
   2
   3     ANDROID_framebuffer_target
   4
   5 Name Strings
   6
   7     EGL_ANDROID_framebuffer_target
   8
   9 Contributors
  10
  11     Jamie Gennis
  12
  13 Contact
  14
  15     Jamie Gennis, Google Inc. (jgennis 'at' google.com)
  16
  17 Status
  18
  19     Complete
  20
  21 Version
  22
  23     Version 1, September 20, 2012
  24
  25 Number
  26
  27     EGL Extension #47
  28
  29 Dependencies
  30
  31     Requires EGL 1.0
  32
  33     This extension is written against the wording of the EGL 1.4 Specification
  34
  35 Overview
  36
  37     Android supports a number of different ANativeWindow implementations that
  38     can be used to create an EGLSurface.  One implementation, which is used to
  39     send the result of performing window composition to a display, may have
  40     some device-specific restrictions.  Because of this, some EGLConfigs may
  41     be incompatible with these ANativeWindows.  This extension introduces a
  42     new boolean EGLConfig attribute that indicates whether the EGLConfig
  43     supports rendering to an ANativeWindow for which the buffers are passed to
  44     the HWComposer HAL as a framebuffer target layer.
  45
  46 New Types
  47
  48     None.
  49
  50 New Procedures and Functions
  51
  52     None.
  53
  54 New Tokens
  55
  56     Accepted by the <attribute> parameter of eglGetConfigAttrib and
  57     the <attrib_list> parameter of eglChooseConfig:
  58
  59         EGL_FRAMEBUFFER_TARGET_ANDROID         0x3147
  60
  61 Changes to Chapter 3 of the EGL 1.4 Specification (EGL Functions and Errors)
  62
  63     Section 3.4, Configuration Management, add a row to Table 3.1.
  64
  65               Attribute                    Type                  Notes
  66         ------------------------------    -------     ---------------------------
  67         EGL_FRAMEBUFFER_TARGET_ANDROID    boolean     whether use as a HWComposer
  68                                                       framebuffer target layer is
  69                                                       supported
  70
  71     Section 3.4, Configuration Management, add a row to Table 3.4.
  72
  73               Attribute                    Default     Selection  Sort   Sort
  74                                                        Criteria   Order  Priority
  75         ------------------------------  -------------  ---------  -----  --------
  76         EGL_FRAMEBUFFER_TARGET_ANDROID  EGL_DONT_CARE    Exact    None
  77
  78     Section 3.4, Configuration Management, add a paragraph at the end of the
  79     subsection titled Other EGLConfig Attribute Descriptions.
  80
  81         EGL_FRAMEBUFFER_TARGET_ANDROID is a boolean indicating whether the
  82         config may be used to create an EGLSurface from an ANativeWindow for
  83         which the buffers are to be passed to HWComposer as a framebuffer
  84         target layer.
  85
  86     Section 3.4.1, Querying Configurations, change the last paragraph as follow
  87
  88         EGLConfigs are not sorted with respect to the parameters
  89         EGL_BIND_TO_TEXTURE_RGB, EGL_BIND_TO_TEXTURE_RGBA, EGL_CONFORMANT,
  90         EGL_LEVEL, EGL_NATIVE_RENDERABLE, EGL_MAX_SWAP_INTERVAL,
  91         EGL_MIN_SWAP_INTERVAL, EGL_RENDERABLE_TYPE, EGL_SURFACE_TYPE,
  92         EGL_TRANSPARENT_TYPE, EGL_TRANSPARENT_RED_VALUE,
  93         EGL_TRANSPARENT_GREEN_VALUE, EGL_TRANSPARENT_BLUE_VALUE, and
  94         EGL_RECORDABLE_ANDROID.
  95
  96 Issues
  97
  98
  99 Revision History
 100
 101 #1 (Jamie Gennis, September 20, 2012)
 102     - Initial draft.