Home | History | Annotate | Download | only in CHROMIUM 
      1 Name
      2 
      3     CHROMIUM_copy_texture
      4 
      5 Name Strings
      6 
      7     GL_CHROMIUM_copy_texture
      8 
      9 Version
     10 
     11     Last Modifed Date: April 1, 2013
     12 
     13 Dependencies
     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 
     20 Overview
     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 
     37 New 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 
     71 Errors
     72 
     73     None.
     74 
     75 New Tokens
     76 
     77     None.
     78 
     79 New State
     80 
     81     None.
     82 
     83 Revision History
     84 
     85     8/1/2011    Documented the extension
     86     7/4/2013    Add a new parameter dest_type to glCopyTextureCHROMIUM()
     87