C SPECIFICATION

       void GLAPIENTRY glTexSubImage3D( GLenum target,
                                        GLint leve )

PARAMETERS

       target  Specifies the target texture.  Must be GL_TEXTURE_3D.

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

       _param5 Specifies a texel offset in the z direction within the  texture
               array.

       _param6 Specifies the width of the texture subimage.

       _param7 Specifies the height of the texture subimage.

       _param8 Specifies the depth of the texture subimage.

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

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

       _param11
               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  and  disable
       three-dimensional  texturing, call glEnable and glDisable with argument
       GL_TEXTURE_3D.
       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, glTexSubImage3D
       specifies a three-dimensional sub texture for the current texture unit,
       specified with glActiveTextureARB.

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

ERRORS

       GL_INVALID_ENUM is generated if target is not GL_TEXTURE_3D.

       GL_INVALID_OPERATION  is  generated  if  the texture array has not been
       defined by a previous glTexImage3D 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,  (_eqnparam3+_eqn-
       param6)>(w-b),  _eqnparam4<-b,  or  (_eqnparam4+_eqnparam7)>(h-b),   or
       _eqnparam5<-b,   or   (_eqnparam5+_eqnparam8)>(d-b),  where  w  is  the
       GL_TEXTURE_WIDTH, h is the GL_TEXTURE_HEIGHT, d is the GL_TEXTURE_DEPTH
       and  b  is  the border width of the texture image being modified.  Note
       that w, h, and d include twice the border width.

       GL_INVALID_VALUE is generated if _param6, _param7, or _param8  is  less
       than 0.

       GL_INVALID_ENUM  is generated if _param9 is not an accepted format con-
       stant.

       GL_INVALID_ENUM is generated if _param10 is not a type constant.

       GL_INVALID_ENUM is generated if _param10 is GL_BITMAP  and  _param9  is
       not GL_COLOR_INDEX.

       GL_INVALID_OPERATION   is  generated  if  glTexSubImage3D  is  executed

ASSOCIATED GETS

       glGetTexImage
       glIsEnabled with argument GL_TEXTURE_3D

SEE ALSO

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




                                                           GLTEXSUBIMAGE3D(3G)