Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GLCOPYTEXIMAGE1D()					    GLCOPYTEXIMAGE1D()

NAME
       glCopyTexImage1D	- copy pixels into a 1D	texture	image

C SPECIFICATION
       void glCopyTexImage1D( GLenum target,
			      GLint level,
			      GLenum internalFormat,
			      GLint x,
			      GLint y,
			      GLsizei width,
			      GLint border )

       delim $$

PARAMETERS
       target	       Specifies the target texture.  Must be GL_TEXTURE_1D.

       level	       Specifies  the  level-of-detail number.	Level 0	is the
		       base image level.  Level	n is the nth mipmap  reduction
		       image.

       internalFormat  Specifies  the internal format of the texture.  Must be
		       one of  the  following  symbolic	 constants:  GL_ALPHA,
		       GL_ALPHA4,  GL_ALPHA8, GL_ALPHA12, GL_ALPHA16, GL_LUMI-
		       NANCE,  GL_LUMINANCE4,  GL_LUMINANCE8,  GL_LUMINANCE12,
		       GL_LUMINANCE16,	GL_LUMINANCE_ALPHA,  GL_LUMINANCE4_AL-
		       PHA4,	GL_LUMINANCE6_ALPHA2,	 GL_LUMINANCE8_ALPHA8,
		       GL_LUMINANCE12_ALPHA4, GL_LUMINANCE12_ALPHA12, GL_LUMI-
		       NANCE16_ALPHA16,	GL_INTENSITY, GL_INTENSITY4, GL_INTEN-
		       SITY8,	 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.

       x, y	       Specify	the  window  coordinates of the	left corner of
		       the row of pixels to be copied.

       width	       Specifies the width of the texture image.  Must be 0 or
		       $2**n  ~+~  2*$border for some integer $n$.  The	height
		       of the texture image is 1.

       border	       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	$("x", "y")$ and  with
       a  length  of $"width"~+~2~*~"border"$ defines the texture array	at the
       mipmap level specified by level.	 internalFormat	specifies the internal
       format 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  component values are clamped to the range [0,	1] and
       then converted to the texture's internal	 format	 for  storage  in  the
       texel array.

       Pixel  ordering is such that lower $x$ screen coordinates correspond to
       lower texture coordinates.

       If  any	of  the	 pixels	 within	 the  specified	 row  of  the  current
       GL_READ_BUFFER  are outside the window associated with the current ren-
       dering context, then the	values obtained	for  those  pixels  are	 unde-
       fined.

NOTES
       glCopyTexImage1D	is available only if the GL version is 1.1 or greater.

       Texturing has no	effect in color	index mode.

       1, 2, 3,	and 4 are not accepted values for internalFormat.

       An image	with 0 width indicates a NULL texture.

ERRORS
       GL_INVALID_ENUM is generated if target is not one of the	allowable val-
       ues.

       GL_INVALID_VALUE	is generated if	level is less than 0.

       GL_INVALID_VALUE	may be generated if level is greater than $log	sub  2
       max$, where $max$ is the	returned value of GL_MAX_TEXTURE_SIZE.

       GL_INVALID_VALUE	 is  generated	if  internalFormat is not an allowable
       value.

       GL_INVALID_VALUE	is generated if	width is less than 0 or	greater	than 2
       +  GL_MAX_TEXTURE_SIZE,	or  if it cannot be represented	as $2 ** n ~+~
       2~*~("border")$ for some	integer	value of n.

       GL_INVALID_VALUE	is generated if	border is not 0	or 1.

       GL_INVALID_OPERATION is generated if glCopyTexImage1D is	 executed  be-
       tween  the  execution  of  glBegin  and	the corresponding execution of
       glEnd.

ASSOCIATED GETS
       glGetTexImage
       glIsEnabled with	argument GL_TEXTURE_1D

SEE ALSO
       glCopyPixels,  glCopyTexImage2D,	 glCopyTexSubImage1D,  glCopyTexSubIm-
       age2D, glPixelStore, glPixelTransfer, glTexEnv, glTexGen, glTexImage1D,
       glTexImage2D, glTexSubImage1D, glTexSubImage2D,
       glTexParameter

							    GLCOPYTEXIMAGE1D()

NAME | C SPECIFICATION | PARAMETERS | DESCRIPTION | NOTES | ERRORS | ASSOCIATED GETS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=glCopyTexImage1D&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help