• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1Name
2
3    CHROMIUM_copy_texture
4
5Name Strings
6
7    GL_CHROMIUM_copy_texture
8
9Version
10
11    Last Modifed Date: April 1, 2013
12
13Dependencies
14
15    OpenGL ES 2.0 is required.
16
17    CHROMIUM_flipy affects the definition of this extension.
18    EXT_texture_format_BGRA8888 affects the definition of this extension.
19
20Overview
21
22    This extension expands on the functionality provided by the
23    glCopyTexImage2D command.  A new function is exported,
24    glCopyTextureCHROMIUM, that performs the same copy operation as
25    glCopyTexImage2D, while respecting the pixel-storage modifiers
26    UNPACK_FLIP_Y_CHROMIUM, GL_UNPACK_PREMULTIPLY_ALPHA_CHROMIUM and
27    GL_UNPACK_UNPREMULTIPLY_ALPHA_CHROMIUM.
28
29    If GL_UNPACK_PREMULTIPLY_ALPHA_CHROMIUM and
30    GL_UNPACK_UNPREMULTIPLY_ALPHA_CHROMIUM are enabled.  Then no alpha
31    processing occurs.  This is the equivalent of having neither flag set.
32
33    The extension also supports copying BGRA textures and copying
34    EXTERNAL_OES texture to BGRA texture, which is not explicitly
35    granted by EXT_texture_format_BGRA8888.
36
37New Procedures and Functions
38
39    void glCopyTextureCHROMIUM (GLenum target, GLenum source_id,
40                                GLenum dest_id, GLint level,
41                                GLint internal_format, GLenum dest_type)
42
43    Copies the contents of texture referred to by <source_id> to texture
44    <dest_id>.
45
46    Texture level 0 is copied from the source image to level <level> of the
47    destination texture. The level parameter must be 0 at present.
48
49    The internal format of the destination texture is converted to that
50    specified by <internal_format>.
51
52    The format type of the destination texture is converted to that specified
53    by <dest_type>.
54
55    <target> uses the same parameters as TexImage2D.
56
57    INVALID_VALUE is generated if <target> is not GL_TEXTURE_2D.
58
59    INVALID_VALUE is generated if <source_id> or <dest_id> are not valid texture
60    objects.
61
62    INVALID_VALUE is generated if textures corresponding to <dest_id> have not
63    been bound as GL_TEXTURE_2D object.
64
65    INVALID_VALUE is generated if textures corresponding to <source_id> have not
66    been bound as GL_TEXTURE_2D or GL_TEXTURE_EXTERNAL_OES objects.
67
68    INVALID_VALUE is generated if <level> is not a valid level of the
69    destination texture, or if level 0 of the source texture is not defined.
70
71Errors
72
73    None.
74
75New Tokens
76
77    None.
78
79New State
80
81    None.
82
83Revision History
84
85    8/1/2011    Documented the extension
86    7/4/2013    Add a new parameter dest_type to glCopyTextureCHROMIUM()
87