glCopyTexImage2D(3gl)

1GLCOPYTEXIMAGE2D(3G)                                      GLCOPYTEXIMAGE2D(3G)
2
3
4

NAME

6       glCopyTexImage2D - copy pixels into a 2D texture image
7
8

C SPECIFICATION

10       void glCopyTexImage2D( GLenum target,
11                              GLint level,
12                              GLenum internalformat,
13                              GLint x,
14                              GLint y,
15                              GLsizei width,
16                              GLsizei height,
17                              GLint border )
18
19

PARAMETERS

21       target          Specifies the target texture.  Must be GL_TEXTURE_2D.
22
23       level           Specifies  the  level-of-detail number.  Level 0 is the
24                       base image level.  Level n is the nth mipmap  reduction
25                       image.
26
27       internalformat  Specifies the internal  of the texture.  Must be one of
28                       the following symbolic constants: GL_ALPHA,  GL_ALPHA4,
29                       GL_ALPHA8,    GL_ALPHA12,   GL_ALPHA16,   GL_LUMINANCE,
30                       GL_LUMINANCE4,      GL_LUMINANCE8,      GL_LUMINANCE12,
31                       GL_LUMINANCE16,                     GL_LUMINANCE_ALPHA,
32                       GL_LUMINANCE4_ALPHA4,             GL_LUMINANCE6_ALPHA2,
33                       GL_LUMINANCE8_ALPHA8,            GL_LUMINANCE12_ALPHA4,
34                       GL_LUMINANCE12_ALPHA12,         GL_LUMINANCE16_ALPHA16,
35                       GL_INTENSITY,       GL_INTENSITY4,       GL_INTENSITY8,
36                       GL_INTENSITY12,  GL_INTENSITY16,  GL_RGB,  GL_R3_G3_B2,
37                       GL_RGB4,    GL_RGB5,   GL_RGB8,   GL_RGB10,   GL_RGB12,
38                       GL_RGB16,  GL_RGBA,  GL_RGBA2,  GL_RGBA4,   GL_RGB5_A1,
39                       GL_RGBA8, GL_RGB10_A2, GL_RGBA12, or GL_RGBA16.
40
41       x, y            Specify the window coordinates of the lower left corner
42                       of the rectangular region of pixels to be copied.
43
44       width           Specifies the width of the texture image.  Must be 0 or
45                       2n+2*border for some integer n.
46
47       height          Specifies  the  height of the texture image.  Must be 0
48                       or 2m+2*border for some integer m.
49
50       border          Specifies the width of the border.  Must be either 0 or
51                       1.
52

DESCRIPTION

54       glCopyTexImage2D  defines  a  two-dimensional texture image with pixels
55       from the current GL_READ_BUFFER.
56
57       The screen-aligned pixel rectangle with lower left corner at (x, y) and
58       with  a width of width+2*border and a height of height+2*border defines
59       the texture array at the mipmap level specified by level.  internalfor‐
60       mat specifies the internal  of the texture array.
61
62       The  pixels  in  the rectangle are processed exactly as if glCopyPixels
63       had been called, but the process stops just  before  final  conversion.
64       At this point all pixel component values are clamped to the range [0,1]
65       and then converted to the texture's internal  for storage in the  texel
66       array.
67
68       Pixel ordering is such that lower x and y screen coordinates correspond
69       to lower s and t texture coordinates.
70
71       If any of the pixels within the  specified  rectangle  of  the  current
72       GL_READ_BUFFER  are outside the window associated with the current ren‐
73       dering context, then the values obtained for  those  pixels  are  unde‐
74       fined.
75

NOTES

77       glCopyTexImage2D is available only if the GL version is 1.1 or greater.
78
79       Texturing has no effect in color index mode.
80
81       1, 2, 3, and 4 are not accepted values for internalformat.
82
83       An image with height or width of 0 indicates a NULL texture.
84
85       When  the  GL_ARB_imaging  extension  is supported, the RGBA components
86       read from the framebuffer may be processed  by  the  imaging  pipeline.
87       See glTexImage1D for specific details.
88

ERRORS

90       GL_INVALID_ENUM is generated if target is not GL_TEXTURE_2D.
91
92       GL_INVALID_VALUE is generated if level is less than 0.
93
94       GL_INVALID_VALUE  may  be  generated  if level is greater than log2max,
95       where max is the returned value of GL_MAX_TEXTURE_SIZE.
96
97       GL_INVALID_VALUE is generated if  width  or  height  is  less  than  0,
98       greater  than  2+GL_MAX_TEXTURE_SIZE,  or  if width or height cannot be
99       represented as 2k+2*border for some integer k.
100
101       GL_INVALID_VALUE is generated if border is not 0 or 1.
102
103       GL_INVALID_VALUE is generated if  internalformat  is  not  one  of  the
104       allowable values.
105
106       GL_INVALID_OPERATION  is  generated  if  glCopyTexImage2D  is  executed
107       between the execution of glBegin and  the  corresponding  execution  of
108       glEnd.
109

ASSOCIATED GETS

111       glGetTexImage
112       glIsEnabled with argument GL_TEXTURE_2D
113