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

NAME

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

C SPECIFICATION

9       void glCopyTexImage2D(GLenum target, GLint level,
10                             GLenum internalformat, GLint x, GLint y,
11                             GLsizei width, GLsizei height, GLint border);
12

PARAMETERS

14       target
15           Specifies the target texture. Must be GL_TEXTURE_2D,
16           GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X,
17           GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y,
18           GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
19
20       level
21           Specifies the level-of-detail number. Level 0 is the base image
22           level. Level n is the nth mipmap reduction image.
23
24       internalformat
25           Specifies the internal format of the texture. Must be one of the
26           following symbolic constants: GL_COMPRESSED_RED, GL_COMPRESSED_RG,
27           GL_COMPRESSED_RGB, GL_COMPRESSED_RGBA.  GL_COMPRESSED_SRGB,
28           GL_COMPRESSED_SRGB_ALPHA.  GL_DEPTH_COMPONENT,
29           GL_DEPTH_COMPONENT16, GL_DEPTH_COMPONENT24, GL_DEPTH_COMPONENT32,
30           GL_RED, GL_RG, GL_RGB, GL_R3_G3_B2, GL_RGB4, GL_RGB5, GL_RGB8,
31           GL_RGB10, GL_RGB12, GL_RGB16, GL_RGBA, GL_RGBA2, GL_RGBA4,
32           GL_RGB5_A1, GL_RGBA8, GL_RGB10_A2, GL_RGBA12, GL_RGBA16, GL_SRGB,
33           GL_SRGB8, GL_SRGB_ALPHA, or GL_SRGB8_ALPHA8.
34
35       x, y
36           Specify the window coordinates of the lower left corner of the
37           rectangular region of pixels to be copied.
38
39       width
40           Specifies the width of the texture image. Must be 0 or 2 n + 2 ⁡
41           border for some integer n.
42
43       height
44           Specifies the height of the texture image. Must be 0 or 2 m + 2 ⁡
45           border for some integer m.
46
47       border
48           Specifies the width of the border. Must be either 0 or 1.
49

DESCRIPTION

51       glCopyTexImage2D defines a two-dimensional texture image, or cube-map
52       texture image with pixels from the current GL_READ_BUFFER.
53
54       The screen-aligned pixel rectangle with lower left corner at (x, y) and
55       with a width of width + 2 ⁡ border and a height of height + 2 ⁡ border
56       defines the texture array at the mipmap level specified by level.
57       internalformat specifies the internal format of the texture array.
58
59       The pixels in the rectangle are processed exactly as if glReadPixels()
60       had been called, but the process stops just before final conversion. At
61       this point all pixel component values are clamped to the range 0 1 and
62       then converted to the texture's internal format for storage in the
63       texel array.
64
65       Pixel ordering is such that lower x and y screen coordinates correspond
66       to lower s and t texture coordinates.
67
68       If any of the pixels within the specified rectangle of the current
69       GL_READ_BUFFER are outside the window associated with the current
70       rendering context, then the values obtained for those pixels are
71       undefined.
72
73       When internalformat is one of the sRGB types, the GL does not
74       automatically convert the source pixels to the sRGB color space. In
75       this case, the glPixelMap function can be used to accomplish the
76       conversion.
77

NOTES

79       1, 2, 3, and 4 are not accepted values for internalformat.
80
81       An image with height or width of 0 indicates a NULL texture.
82

ERRORS

84       GL_INVALID_ENUM is generated if target is not GL_TEXTURE_2D,
85       GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X,
86       GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y,
87       GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
88
89       GL_INVALID_VALUE is generated if level is less than 0.
90
91       GL_INVALID_VALUE may be generated if level is greater than log 2 ⁢ max,
92       where max is the returned value of GL_MAX_TEXTURE_SIZE.
93
94       GL_INVALID_VALUE is generated if width is less than 0 or greater than
95       GL_MAX_TEXTURE_SIZE.
96
97       GL_INVALID_VALUE is generated if non-power-of-two textures are not
98       supported and the width or depth cannot be represented as 2 k + 2 ⁡
99       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 an accepted
104       format.
105
106       GL_INVALID_OPERATION is generated if internalformat is
107       GL_DEPTH_COMPONENT, GL_DEPTH_COMPONENT16, GL_DEPTH_COMPONENT24, or
108       GL_DEPTH_COMPONENT32 and there is no depth buffer.
109

ASSOCIATED GETS

111       glGetTexImage()
112

SEE ALSO

114       glCopyTexImage1D(), glCopyTexSubImage1D(), glCopyTexSubImage2D(),
115       glPixelStore(), glTexImage1D(), glTexImage2D(), glTexSubImage1D(),
116       glTexSubImage2D(), glTexParameter()
117

119       Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed
120       under the SGI Free Software B License. For details, see
121       http://oss.sgi.com/projects/FreeB/.
122

AUTHORS

124       opengl.org
125
126
127
128opengl.org                        06/10/2014              GLCOPYTEXIMAGE2D(3G)
Impressum