- copy pixels into a 2D texture image



C SPECIFICATION


PARAMETERS

       _param1  Specifies    the   target   texture.    Must   be
                GL_TEXTURE_2D.

       _param2  Specifies the level-of-detail number.  Level 0 is
                the  base image level.  Level n is the nth mipmap
                reduction image.

       _param3  Specifies the internal  of the texture.  Must  be
                one   of   the   following   symbolic  constants:
                GL_ALPHA,   GL_ALPHA4,   GL_ALPHA8,   GL_ALPHA12,
                GL_ALPHA16,      GL_LUMINANCE,     GL_LUMINANCE4,
                GL_LUMINANCE8,  GL_LUMINANCE12,   GL_LUMINANCE16,
                GL_LUMINANCE_ALPHA,         GL_LUMINANCE4_ALPHA4,
                GL_LUMINANCE6_ALPHA2,       GL_LUMINANCE8_ALPHA8,
                GL_LUMINANCE12_ALPHA4,    GL_LUMINANCE12_ALPHA12,
                GL_LUMINANCE16_ALPHA16,             GL_INTENSITY,
                GL_INTENSITY4,   GL_INTENSITY8,   GL_INTENSITY12,
                GL_INTENSITY16,  GL_RGB,  GL_R3_G3_B2,   GL_RGB4,
                GL_RGB5,  GL_RGB8,  GL_RGB10, GL_RGB12, GL_RGB16,
                GL_RGBA,    GL_RGBA2,    GL_RGBA4,    GL_RGB5_A1,
                GL_RGBA8, GL_RGB10_A2, GL_RGBA12, or GL_RGBA16.

       _param4, _param5
                Specify  the window coordinates of the lower left
                corner of the rectangular region of pixels to  be
                copied.

       _param6  Specifies  the  width of the texture image.  Must
                be 0 or 2n+2*_param8 for some integer n.

       _param7  Specifies the height of the texture image.   Must
                be 0 or 2m+2*_param8 for some integer m.

       _param8  Specifies  the  width  of  the  border.   Must be
                either 0 or 1.


DESCRIPTION

       glCopyTexImage2D defines a two-dimensional  texture  image
       with pixels from the current GL_READ_BUFFER.

       The  screen-aligned pixel rectangle with lower left corner
       at   (_param4,   _param5)   and   with    a    width    of
       _param6+2*_param8   and   a  height  of  _param7+2*_param8
       defines the texture array at the mipmap level specified by
       _param2.   _param3  specifies the internal  of the texture
       array.




NOTES

       glCopyTexImage2D  is  available  only if the GL version is
       1.1 or greater.

       Texturing has no effect in color index mode.

       1, 2, 3, and 4 are not accepted values for _param3.

       An image with height or width of 0 indicates a  NULL  tex-
       ture.

       When  the  GL_ARB_imaging extension is supported, the RGBA
       components read from the framebuffer may be  processed  by
       the  imaging  pipeline.   See  glTexImage1D  for  specific
       details.


ERRORS

       GL_INVALID_ENUM   is   generated   if   _param1   is   not
       GL_TEXTURE_2D.

       GL_INVALID_VALUE is generated if _param2 is less than 0.

       GL_INVALID_VALUE  may  be  generated if _param2 is greater
       than  log2max,  where  max  is  the  returned   value   of
       GL_MAX_TEXTURE_SIZE.

       GL_INVALID_VALUE  is  generated  if  _param6 or _param7 is
       less than 0, greater  than  2+GL_MAX_TEXTURE_SIZE,  or  if
       _param6  or  _param7 cannot be represented as 2k+2*_param8
       for some integer k.

       GL_INVALID_VALUE is generated if _param8 is not 0 or 1.

       GL_INVALID_VALUE is generated if _param3 is not one of the
       allowable values.

       GL_INVALID_OPERATION  is  generated if glCopyTexImage2D is
       executed between the execution of glBegin and  the  corre-
       sponding execution of glEnd.


ASSOCIATED GETS

       glGetTexImage
       glIsEnabled with argument GL_TEXTURE_2D


SEE ALSO

       glCopyPixels,    glCopyTexImage1D,    glCopyTexSubImage1D,
       glCopyTexSubImage2D,    glPixelStore,     glPixelTransfer,
       glTexEnv,     glTexGen,     glTexImage1D,    glTexImage2D,
       glTexSubImage1D, glTexSubImage2D,
       glTexParameter