- specify a one-dimensional texture subimage



C SPECIFICATION


PARAMETERS

       _param1  Specifies    the   target   texture.    Must   be
                GL_TEXTURE_1D.

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

       _param5  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.

       _param6  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.

       _param7  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  or  disable  one-dimensional  texturing,  call
       glEnable and glDisable with argument GL_TEXTURE_1D.

       glTexSubImage1D redefines a  contiguous  subregion  of  an
       existing one-dimensional texture image.  The texels refer-
       enced by _param7 replace the portion of the existing  tex-
       ture     array     with     x    indices    _param3    and
       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,
       glTexSubImage1D  specifies  a  one-dimensional sub texture
       for   the   current   texture   unit,    specified    with
       glActiveTextureARB.

       When  the  GL_ARB_imaging extension is supported, the RGBA
       components specified in _param7 may be  processed  by  the
       imaging  pipeline.  See glTexImage1D for specific details.


ERRORS

       GL_INVALID_ENUM is generated if _param1 is not one of  the
       allowable values.

       GL_INVALID_OPERATION is generated if the texture array has
       not been defined by a previous glTexImage1D 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,  or  if
       (_eqnparam3+_eqnparam4)>(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
        constant.

       GL_INVALID_ENUM is generated if _param6 is not a type con-
       stant.

       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
       GL_RGBA nor GL_BGRA.


ASSOCIATED GETS

       glGetTexImage
       glIsEnabled with argument GL_TEXTURE_1D


SEE ALSO

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




                                                                1