- copy pixels into a 1D texture image
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 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 left corner
of the row of pixels to be copied.
_param6 Specifies the width of the texture image. Must
be 0 or 2n+2*_param7 for some integer n. The
height of the texture image is 1.
_param7 Specifies the width of the border. Must be
either 0 or 1.
DESCRIPTION
glCopyTexImage1D defines a one-dimensional texture image
with pixels from the current GL_READ_BUFFER.
The screen-aligned pixel row with left corner at
(_eqnparam4,_eqnparam5) and with a length of
_eqnparam6+2*_eqnparam7 defines the texture array at the
mipmap level specified by _param2. _param3 specifies the
internal of the texture array.
The pixels in the row are processed exactly as if
glCopyPixels had been called, but the process stops just
before final conversion. At this point all pixel compo-
nent values are clamped to the range [0, 1] and then con-
Texturing has no effect in color index mode.
1, 2, 3, and 4 are not accepted values for _param3.
An image with 0 width indicates a NULL texture.
When the GL_ARB_imaging extension is supported, the RGBA
components copied 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 one of the
allowable values.
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 _param3 is not an allow-
able value.
GL_INVALID_VALUE is generated if _param6 is less than 0 or
greater than 2 + GL_MAX_TEXTURE_SIZE, or if it cannot be
represented as 2n+2*(_eqnparam7) for some integer value of
n.
GL_INVALID_VALUE is generated if _param7 is not 0 or 1.
GL_INVALID_OPERATION is generated if glCopyTexImage1D is
executed between the execution of glBegin and the corre-
sponding execution of glEnd.
ASSOCIATED GETS
glGetTexImage
glIsEnabled with argument GL_TEXTURE_1D
SEE ALSO
glCopyPixels, glCopyTexImage2D, glCopyTexSubImage1D,
glCopyTexSubImage2D, glPixelStore, glPixelTransfer,
glTexEnv, glTexGen, glTexImage1D, glTexImage2D,
glTexSubImage1D, glTexSubImage2D,
glTexParameter
1