glcopyteximage1d man page on SunOS

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
SunOS logo
[printable version]

GLCOPYTEXIMAGE1D(3gl)					 GLCOPYTEXIMAGE1D(3gl)

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 )

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_LUMI‐
		       NANCE4_ALPHA4,	   GL_LUMINANCE6_ALPHA2,      GL_LUMI‐
		       NANCE8_ALPHA8,	   GL_LUMINANCE12_ALPHA4,     GL_LUMI‐
		       NANCE12_ALPHA12, GL_LUMINANCE16_ALPHA16,	 GL_INTENSITY,
		       GL_INTENSITY4, GL_INTENSITY8, GL_INTENSITY12, GL_INTEN‐
		       SITY16, 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,
		       GL_RGBA16,   GL_COMPRESSED_ALPHA,   GL_COMPRESSED_LUMI‐
		       NANCE,	   GL_COMPRESSED_LUMINANCE_ALPHA,      GL_COM‐
		       PRESSED_INTENSITY,      GL_COMPRESSED_RGB,      GL_COM‐
		       PRESSED_RGBA.

       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.

       If glCopyTexImage1D is called on a constant texture,  then  a  copy  is
       made  internally	 before	 executing  the call. A texture is a "constant
       texture" if at the time of the specification of the texture no copy was
       made internally. See glTexImage1D and glPixelStore for details.

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  log2max,
       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*(bor‐
       der) 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
       between	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

				   15 Mar 97		 GLCOPYTEXIMAGE1D(3gl)
[top]

List of man pages available for SunOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net