GLint leve )

PARAMETERS
       target  Specifies the target texture.  Must be GL_TEXTURE_1D.

       leve    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 the width of the texture subimage.

       _param5 Specifies  the format 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.

       _param6 Specifies the data type of the pixel data.  The  following  sym‐
               bolic 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.

       _param7 Specifies a pointer to the image data in memory.

DESCRIPTION
       Texturing maps a portion of a specified texture image onto each  graphi‐
       cal primitive for which texturing is enabled.  To enable or disable one-
       dimensional  texturing,  call  glEnable  and  glDisable  with   argument
       GL_TEXTURE_1D.

       glTexSubImage1D  redefines a contiguous subregion of an existing one-di‐
       mensional texture image.  The texels referenced by _param7  replace  the
       portion  of  the existing texture array with x indices _param3 and _eqn‐
       param3+_eqnparam4−1,inclusive.  This region may not include  any  texels
       outside  the  range of the texture array as it was originally specified.
       It is not an error to specify a subtexture with width of 0, but  such  a
       specification has no effect.

NOTES
       glTexSubImage1D is available only if the GL version is 1.1 or greater.

       Texturing has no effect in color index mode.

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

       specified in _param7 may be processed  by  the  imaging  pipeline.   See
       glTexImage1D for specific details.

ERRORS
       GL_INVALID_ENUM  is generated if target is not one of the allowable val‐
       ues.

       GL_INVALID_OPERATION is generated if the texture array has not been  de‐
       fined by a previous glTexImage1D operation.

       GL_INVALID_VALUE is generated if leve is less than 0.

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

       GL_INVALID_VALUE is generated if _eqnparam3<−b, or if  (_eqnparam3+_eqn‐
       param4)>(w−b),  where  w  is the GL_TEXTURE_WIDTH, and b is the width of
       the GL_TEXTURE_BORDER of the texture image being modified.  Note that  w
       includes twice the border width.

       GL_INVALID_VALUE is generated if _param4 is less than 0.

       GL_INVALID_ENUM  is  generated if _param5 is not an accepted format con‐
       stant.

       GL_INVALID_ENUM is generated if _param6 is not a type constant.

       GL_INVALID_ENUM is generated if _param6 is GL_BITMAP and _param5 is  not
       GL_COLOR_INDEX.

       GL_INVALID_OPERATION is generated if glTexSubImage1D is executed between
       the execution of glBegin and the corresponding execution of glEnd.

       GL_INVALID_OPERATION   is   generated   if    _param6    is    one    of
       GL_UNSIGNED_BYTE_3_3_2,                      GL_UNSIGNED_BYTE_2_3_3_REV,
       GL_UNSIGNED_SHORT_5_6_5, or GL_UNSIGNED_SHORT_5_6_5_REV and  _param5  is
       not GL_RGB.

       GL_INVALID_OPERATION    is    generated    if    _param6   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
       _param5 is neither GL_RGBA nor GL_BGRA.

ASSOCIATED GETS
       glGetTexImage
       glIsEnabled with argument GL_TEXTURE_1D

SEE ALSO
       glActiveTextureARB,         glCopyTexImage1D,          glCopyTexImage2D,
       glCopyTexSubImage1D,      glCopyTexSubImage2D,      glCopyTexSubImage3D,