• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    EXT_read_format_bgra
4
5Name Strings
6
7    GL_EXT_read_format_bgra
8
9Notice
10
11    Copyright Imagination Technologies Limited, 2005 - 2009.
12
13Contact
14
15    Imagination Technologies (devtech 'at' imgtec 'dot' com)
16
17Status
18
19    Complete
20
21Version
22
23    1.1, 26 October 2009
24
25Number
26
27    OpenGL ES Extension #66
28
29Dependencies
30
31    GL_OES_read_format or OpenGL ES 1.1 or 2.0 is required
32
33    The extension is written against the OpenGLES 1.0 Specification,
34    which in turn is based OpenGL 1.3. Thus this spec is effectively
35    written against OpenGL 1.3 but does not address sections explicitly
36    removed or reduced by OpenGL-ES 1.0.
37
38Overview
39
40    This extension is intended to supplement the GL_OES_read_format
41    extension by adding support for more format/type combinations to be used
42    when calling ReadPixels.  ReadPixels currently accepts one fixed
43    format/type combination (format RGBA and type UNSIGNED_BYTE) for
44    portability, and an implementation specific format/type combination
45    queried using the tokens IMPLEMENTATION_COLOR_READ_FORMAT_OES and
46    IMPLEMENTATION_COLOR_READ_TYPE_OES (GL_OES_read_format extension).  This
47    extension adds the following format/type combinations to those currently
48    allowed to be returned by GetIntegerV:
49
50    format                      type
51    ------                      ----
52    BGRA_EXT                    UNSIGNED_BYTE
53    BGRA_EXT                    UNSIGNED_SHORT_4_4_4_4_REV_EXT
54    BGRA_EXT                    UNSIGNED_SHORT_1_5_5_5_REV_EXT
55
56    E.g. Calling GetIntegerv with a <pname> parameter of
57    IMPLEMENTATION_COLOR_READ_FORMAT_OES can now return BGRA_EXT, with the
58    corresponding call to GetIntegerv using a <pname> parameter of
59    IMPLEMENTATION_COLOR_READ_TYPE_OES returning UNSIGNED_BYTE;
60
61IP Status
62
63    Unknown
64
65Issues
66
67    None.
68
69New Procedures and Functions
70
71    None.
72
73New Tokens
74
75    Accepted by the <format> parameter of ReadPixels:
76
77        GL_BGRA_EXT                          0x80E1
78
79    Accepted by the <type> parameter of ReadPixels:
80
81        GL_UNSIGNED_SHORT_4_4_4_4_REV_EXT    0x8365
82        GL_UNSIGNED_SHORT_1_5_5_5_REV_EXT    0x8366
83
84Additions to Chapter 2 of the OpenGL 1.3 Specification (OpenGL Operation)
85
86    None
87
88Additions to Chapter 3 of the OpenGL 1.3 Specification (Rasterization)
89
90    None
91
92Additions to Chapter 4 of the OpenGL 1.3 Specification (Per-Fragment Operations and the Frame Buffer)
93
94    None
95
96Additions to Chapter 5 of the OpenGL 1.3 Specification (Special Functions)
97
98    None
99
100Additions to Chapter 6 of the OpenGL 1.3 Specification (State and State Requests)
101
102    None
103
104Errors
105
106    None
107
108New State
109
110    None
111
112New Implementation Dependent State
113
114    None
115
116Revision History
117
118    1.0,  04/06/2009  bcb:  Tidied for publication.
119    1.1,  10/26/2009  Benj Lipchak:  Add suffixes to overview text.
120