gfx/angle/extensions/ANGLE_texture_compression_dxt.txt@129ffea94266
gfx/angle/extensions/ANGLE_texture_compression_dxt.txt
Sat, 03 Jan 2015 20:18:00 +0100
- author
- Michael Schloh von Bennewitz <michael@schloh.com>
- date
- Sat, 03 Jan 2015 20:18:00 +0100
- branch
- TOR_BUG_3246
- changeset 7
- 129ffea94266
- permissions
- -rw-r--r--
Conditionally enable double key logic according to:
private browsing mode or privacy.thirdparty.isolate preference and
implement in GetCookieStringCommon and FindCookie where it counts...
With some reservations of how to convince FindCookie users to test
condition and pass a nullptr when disabling double key logic.
1 Name
3 ANGLE_texture_compression_dxt
5 Name Strings
7 GL_ANGLE_texture_compression_dxt1
8 GL_ANGLE_texture_compression_dxt3
9 GL_ANGLE_texture_compression_dxt5
11 Contributors
13 Gregg Tavares, Google Inc.
14 Daniel Koch, TransGaming Inc.
15 Al Patrick, Google Inc.
17 Contacts
19 Gregg Tavares, Google Inc. (gman 'at' google 'dot' com)
21 Status
23 Implemented in ANGLE ES2
25 Version
27 Last Modified Date: Sept 22, 2012
28 Author Revision: 2
30 Number
32 OpenGL ES Extension #111
34 Dependencies
36 Requires OpenGL ES 1.0.
38 The extension is written against the OpenGL ES 2.0 specification.
40 Overview
42 These extensions are exactly the same as EXT_texture_compression_dxt1
43 except they additionally expose the COMPRESSED_RGBA_S3TC_DXT3_ANGLE and
44 COMPRESSED_RGBA_S3TC_DXT5_ANGLE formats and have a size restrictions
45 such that the size must be a multiple of four (except for mip levels
46 where the dimensions are either 2 or 1).
48 See EXT_texture_compression_dxt1 for the full list of changes. Also
49 see EXT_texture_compression_s3tc for a description of the formats.
51 IP Status
53 A license to the S3TC Intellectual Property may be necessary for
54 implementation of this extension. You should consult with your
55 Attorney to determine the need for a license.
57 New Procedures and Functions
59 None.
61 New Types
63 None.
65 New Tokens
67 Accepted by the <internalformat> parameter of CompressedTexImage2D
68 and the <format> parameter of CompressedTexSubImage2D:
70 COMPRESSED_RGB_S3TC_DXT1_ANGLE 0x83F0
71 COMPRESSED_RGBA_S3TC_DXT1_ANGLE 0x83F1
72 COMPRESSED_RGBA_S3TC_DXT3_ANGLE 0x83F2
73 COMPRESSED_RGBA_S3TC_DXT5_ANGLE 0x83F3
75 Additions to Chapter 3 of the OpenGL ES 2.0 Specification (Rasterization)
77 Add the following to Section 3.7.3 (Compressed Texture Images)
78 (at the end of the description of the CompressedTexImage2D command):
80 Compressed Internal Format Base Internal Format
81 ========================== ====================
82 COMPRESSED_RGB_S3TC_DXT1_ANGLE RGB
83 COMPRESSED_RGBA_S3TC_DXT1_ANGLE RGBA
84 COMPRESSED_RGBA_S3TC_DXT3_ANGLE RGBA
85 COMPRESSED_RGBA_S3TC_DXT5_ANGLE RGBA
87 Table 3.x: Specific Compressed Internal Formats
89 If <internalformat> is one of the S3TC formats listed in Table 3.x,
90 the compressed texture is stored in the appropriate S3TC compressed
91 texture format (see Appendix). The GL and the S3TC texture compression
92 algorithm support only 2D images without borders.
94 CompressedTexImage2D will produce the INVALID_OPERATION error when
95 <internalformat> is one of the values from Table 3.x under the following
96 conditions:
98 * <border> is non-zero.
99 * <width> is not one, two, or a multiple of four.
100 * <height> is not one, two, or a multiple of four.
102 Add the following to Section 3.7.3 (Compressed Texture Images)
103 (at the end of the description of the CompressedTexSubImage2D command):
105 If the internal format of the texture image being modified is listed
106 in Table 3.x, the texture is stored in the appropriate S3TC compressed
107 texture format (see Appendix). Since DXT/S3TC images are easily edited
108 along 4x4 texel boundaries, the limitations of CompressedTexSubImage2D
109 are relaxed. CompressedTexSubImage2D will result in an INVALID_OPERATION
110 error only if one of the following conditions occurs:
112 * <width> is not a multiple of four or equal to TEXTURE_WIDTH.
113 * <height> is not a multipls of four or equal to TEXTURE_HEIGHT.
114 * <xoffset> or <yoffset> is not a multiple of four.
115 * <format> does not match the internal format of the texture image
116 being modified.
118 The following restrictions at the end of section 3.7.3 do not apply
119 to S3TC DXT texture formats, since subimage modification is straightforward
120 as long as the subimage is properly aligned.
122 Errors
124 INVALID_OPERATION is generated by CompressedTexImage2D if <internalformat>
125 is one of the compressed internal formats from Table 3.x and any of the
126 following apply:
127 - <border> is not equal to zero.
128 - <width> is not one, two, or a multiple of four.
129 - <height> is not one, two, or a multiple of four.
131 INVALID_OPERATION is generated by TexImage2D and CopyTexImage2D if
132 <internalformat> is one of the compressed internal formats from
133 Table 3.x.
135 INVALID_OPERATION is generated by TexSubImage2D and CopyTexSubImage2D
136 if the internal format of the texture currently bound to <target> is
137 one of the compressed internal formats from Table 3.x.
139 INVALID_OPERATION is generated by CompressedTexSubImage2D if <format>
140 is one of the compressed interal formats from Table 3.x and any of the
141 following apply:
142 - <width> is not a multiple of four or equal to TEXTURE_WIDTH;
143 - <height> is not a multiple of four or equal to TEXTURE_HEIGHT;
144 - <xoffset> or <yoffset> is not a multiple of four;
145 - <format> does not match the internal format of the texture image
146 being modified.
148 New State
150 None.
152 Appendix:
154 The format for the S3TC Compressed Texture Images Formats is documented
155 in the appendix of EXT_texture_compression_s3tc.
157 Revision History
159 Revision 1, 2010/08/06 - gman
160 - Initial revision
161 Revision 2, 2012/09/22 - dgkoch
162 - Added DXT1 formats and documented multiple of 4 restriction.
