EGL_ANDROID_framebuffer_target.txt 3.1 KB

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