- specify a two-dimensional texture subimage



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 a  texel  offset  in  the  x  direction
                within the texture array.

       _param4  Specifies  a  texel  offset  in  the  y direction
                within the texture array.

       _param5  Specifies the width of the texture subimage.

       _param6  Specifies the height of the texture subimage.

       _param7  Specifies the  of the pixel data.  The  following
                symbolic  values  are  accepted:  GL_COLOR_INDEX,
                GL_RED,  GL_GREEN,  GL_BLUE,  GL_ALPHA,   GL_RGB,
                GL_BGR,   GL_RGBA,   GL_BGRA,  GL_LUMINANCE,  and
                GL_LUMINANCE_ALPHA.

       _param8  Specifies the data type of the pixel  data.   The
                following    symbolic    values   are   accepted:
                GL_UNSIGNED_BYTE,       GL_BYTE,       GL_BITMAP,
                GL_UNSIGNED_SHORT,   GL_SHORT,   GL_UNSIGNED_INT,
                GL_INT,     GL_FLOAT,     GL_UNSIGNED_BYTE_3_3_2,
                GL_UNSIGNED_BYTE_2_3_3_REV,
                GL_UNSIGNED_SHORT_5_6_5,
                GL_UNSIGNED_SHORT_5_6_5_REV,
                GL_UNSIGNED_SHORT_4_4_4_4,
                GL_UNSIGNED_SHORT_4_4_4_4_REV,
                GL_UNSIGNED_SHORT_5_5_5_1,
                GL_UNSIGNED_SHORT_1_5_5_5_REV,
                GL_UNSIGNED_INT_8_8_8_8,
                GL_UNSIGNED_INT_8_8_8_8_REV,
                GL_UNSIGNED_INT_10_10_10_2,                   and
                GL_UNSIGNED_INT_2_10_10_10_REV.

       _param9  Specifies  a pointer to the image data in memory.


DESCRIPTION

       Texturing maps a portion of a specified texture image onto
       each  graphical  primitive for which texturing is enabled.
       To enable  and  disable  two-dimensional  texturing,  call
       glEnable and glDisable with argument GL_TEXTURE_2D.
       or greater.

       Texturing has no effect in color index mode.

       glPixelStore  and  glPixelTransfer  modes  affect  texture
       images in exactly the way they affect glDrawPixels.

       Formats     GL_BGR,     and     GL_BGRA     and      types
       GL_UNSIGNED_BYTE_3_3_2,        GL_UNSIGNED_BYTE_2_3_3_REV,
       GL_UNSIGNED_SHORT_5_6_5,      GL_UNSIGNED_SHORT_5_6_5_REV,
       GL_UNSIGNED_SHORT_4_4_4_4,  GL_UNSIGNED_SHORT_4_4_4_4_REV,
       GL_UNSIGNED_SHORT_5_5_5_1,  GL_UNSIGNED_SHORT_1_5_5_5_REV,
       GL_UNSIGNED_INT_8_8_8_8,      GL_UNSIGNED_INT_8_8_8_8_REV,
       GL_UNSIGNED_INT_10_10_10_2,                            and
       GL_UNSIGNED_INT_2_10_10_10_REV  are  available only if the
       GL version is 1.2 or greater.

       When  the  GL_ARB_multitexture  extension  is   supported,
       glTexSubImage2D  specifies  a  two-dimensional sub texture
       for   the   current   texture   unit,    specified    with
       glActiveTextureARB.

       When  the  GL_ARB_imaging extension is supported, the RGBA
       components specified in _param9 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_OPERATION is generated if the texture array has
       not been defined by a previous glTexImage2D operation.

       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    _eqnparam3<-b,
       (_eqnparam3+_eqnparam5)>(w-b),      _eqnparam4<-b,      or
       (_eqnparam4+_eqnparam6)>(h-b),    where    w    is     the
       GL_TEXTURE_WIDTH, h is the GL_TEXTURE_HEIGHT, and b is the
       border width of the texture image  being  modified.   Note
       that w and h include twice the border width.

       GL_INVALID_VALUE  is  generated  if  _param5 or _param6 is
       less than 0.

       GL_INVALID_ENUM is generated if _param7 is not an accepted
        constant.


       GL_INVALID_OPERATION is generated if  _param8  is  one  of
       GL_UNSIGNED_SHORT_4_4_4_4,  GL_UNSIGNED_SHORT_4_4_4_4_REV,
       GL_UNSIGNED_SHORT_5_5_5_1,  GL_UNSIGNED_SHORT_1_5_5_5_REV,
       GL_UNSIGNED_INT_8_8_8_8,      GL_UNSIGNED_INT_8_8_8_8_REV,
       GL_UNSIGNED_INT_10_10_10_2,                             or
       GL_UNSIGNED_INT_2_10_10_10_REV   and  _param7  is  neither
       GL_RGBA nor GL_BGRA.


ASSOCIATED GETS

       glGetTexImage
       glIsEnabled with argument GL_TEXTURE_2D


SEE ALSO

       glActiveTextureARB,  glCopyTexImage1D,   glCopyTexImage2D,
       glCopyTexSubImage1D,                  glCopyTexSubImage2D,
       glCopyTexSubImage3D,      glDrawPixels,      glPixelStore,
       glPixelTransfer,    glTexEnv,    glTexGen,   glTexImage1D,
       glTexImage2D,        glTexImage3D,        glTexSubImage1D,
       glTexSubImage3D, glTexParameter




                                                                1