gpu/GLES2/extensions/CHROMIUM/CHROMIUM_compressed_copy_texture.txt

   1 Name
   2
   3     CHROMIUM_copy_compressed_texture
   4
   5 Name Strings
   6
   7     GL_CHROMIUM_copy_compressed_texture
   8
   9 Version
  10
  11     Last Modifed Date: Jun 15, 2015
  12
  13 Dependencies
  14
  15     OpenGL ES 2.0 is required.
  16
  17     GL_AMD_compressed_ATC_texture, GL_ATI_texture_compression_atitc,
  18     GL_EXT_texture_compression_dxt1, GL_ANGLE_texture_compression_dxt5,
  19     GL_EXT_texture_compression_s3tc and GL_OES_compressed_ETC1_RGB8_texture
  20     affects the definition of this extension.
  21
  22 Overview
  23
  24     This extension provides functionality for copying compressed textures. It
  25     adds a new function glCompressedCopyTextureCHROMIUM that works similarily
  26     to glCopyTextureCHROMIUM, but for compressed textures.
  27
  28     Which compressed texture formats that this extension supports depends on
  29     the supported texture compression formats of the host GPU.
  30
  31 Issues
  32
  33     glCompressedCopyTextureCHROMIUM will first try to copy into a compressed
  34     texture of the same format as the source texture. If unsucessful, the
  35     destination texture format will be changed to GL_RGBA and the texture will
  36     be stored uncompressed.
  37
  38 New Procedures and Functions
  39
  40     The command
  41
  42         void glCompressedCopyTextureCHROMIUM (GLenum target, GLenum source_id,
  43                                               GLenum dest_id)
  44
  45     Copies the contents of a compressed texture referred to by <source_id> to
  46     <dest_id> texture.
  47
  48     Texture level 0 is copied from the source image to level 0 of the
  49     destination texture.
  50
  51     The internal format of the source texture must be one of the following
  52     symbolic constants: GL_ATC_RGB_AMD, GL_ATC_RGBA_INTERPOLATED_ALPHA_AMD,
  53     GL_COMPRESSED_RGB_S3TC_DXT1_EXT, GL_COMPRESSED_RGBA_S3TC_DXT5_EXT,
  54     GL_ETC1_RGB8_OES
  55
  56     The destination texture will be created or replaced with the same internal
  57     format as the source texture.
  58
  59     <target> uses the same parameters as TexImage2D.
  60
  61     INVALID_OPERATION is generated if internal format of source texture is not
  62     one of the valid formats described above.
  63
  64     INVALID_OPERATION is generated if destination texture is immutable.
  65
  66     INVALID_VALUE is generated if <source_id> or <dest_id> are not valid texture
  67     objects.
  68
  69     INVALID_VALUE is generated if textures corresponding to <dest_id> have not
  70     been bound as GL_TEXTURE_2D object.
  71
  72     INVALID_VALUE is generated if level 0 of the source texture is not defined.
  73
  74 Errors
  75
  76     None.
  77
  78 New Tokens
  79
  80     None.
  81
  82 New State
  83
  84     None.
  85
  86 Revision History
  87
  88     15/6/2015    Documented the extension.