glreadvideopixelssun man page on SunOS

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

GLREADVIDEOPIXELSSUN(3gl)			     GLREADVIDEOPIXELSSUN(3gl)

NAME
       glReadVideoPixelsSUN - read a block of post-convolved, filtered pixels

C SPECIFICATION
       void glReadVideoPixelsSUN( GLint x,
				  GLint y,
				  GLsizei width,
				  GLsizei height,
				  GLenum format,
				  GLenum type,
				  GLvoid *pixels )

PARAMETERS
       x, y Specify  the  window  coordinates  of the first pixel that is read
	    from the frame buffer.  This location is the lower left corner  of
	    a rectangular block of pixels.

       width, height
	    Specify  the  dimensions of the pixel rectangle.  width and height
	    of one correspond to a single pixel.

       format
	    Specifies the format of the pixel data.   The  following  symbolic
	    values  are accepted: GL_RGB, GL_BGR, GL_BGRA, GL_RGB_DEGAMMA_SUN,
	    GL_BGR_DEGAMMA_SUN, and GL_BGRA_DEGAMMA_SUN

       type Specifies the data type of the  pixel  data.   The	following  are
	    accepted: GL_UNSIGNED_BYTE and GL_UNSIGNED_INT_8_8_8_8_REV

       pixels
	    Returns the pixel data.

DESCRIPTION
       glReadVideoPixelsSUN   uses  the	 video	read-back  path	 available  on
       XVR-4000 to read the post-convolved pixel data starting with the	 pixel
       at  location  (x,  y)  into  client memory starting at location pixels.
       Which buffer to read the video data from, can be specified with glRead‐
       Buffer  call.  Currently	 all  front  buffers, i.e., GL_LEFT, GL_FRONT,
       GL_FRONT_LEFT, GL_RIGHT, GL_FRONT_RIGHT	are  supported.	 The  returned
       pixel  format  can  be  GL_RGB,	GL_BGR	or GL_BGRA. By default glRead‐
       VideoPixelsSUN returns gamma-corrected pixels. To  get  non-gamma  cor‐
       rected  pixels glReadVideoPixelsSUN supports corresponding degamma for‐
       mats: GL_RGB_DEGAMMA_SUN, GL_BGR_DEGAMMA_SUN  and  GL_BGRA_DEGAMMA_SUN.
       When  these  degamma formats are used glReadVideoPixelsSUN does degamma
       before returning the pixels.  The type of the pixels  returned  can  be
       GL_UNSIGNED_BYTE	      or       GL_UNSIGNED_INT_8_8_8_8_REV.	  Type
       GL_UNSIGNED_INT_8_8_8_8_REV can only be used  with  format  GL_BGRA  or
       GL_BGRA_DEGAMMA_SUN.  The  alpha	 value	returned for format GL_BGRA or
       GL_BGRA_DEGAMMA_SUN is always 1.	 The size of the  pixel	 rectangle  is
       specified using width and height arguments.

       glReadVideoPixelsSUN  returns  values  from  each pixel with lower left
       corner at (x + i, y + j) for  0≤i<width	 and  0≤j<height.  Pixels  are
       returned in row order from the lowest to the highest row, left to right
       in each row.

       glReadVideoPixelsSUN does not read from back buffers,  pbuffer  or  any
       other  auxiliary buffers. Pixel operations such as glPixelMap, glPixel‐
       Transfer, glPixelStore, and glPixelZoom will have no affect on  glRead‐
       VideoPixelsSUN.

       NOTES  Values  for  pixels that lie outside the window connected to the
	      current GL context are undefined.

       If an error is generated, no change is made to the contents of pixels.

ERRORS
       GL_INVALID_ENUM is generated if format  or  type	 is  not  an  accepted
       value.

       GL_INVALID_VALUE is generated if either width or height is negative.

       GL_INVALID_OPERATION is generated if the current read buffer is not one
       of GL_LEFT, GL_FRONT, GL_FRONT_LEFT, GL_RIGHT, GL_FRONT_RIGHT.

       GL_INVALID_OPERATION    is     generated	    if	   the	   type	    is
       GL_UNSIGNED_INT_8_8_8_8_REV and the format is not GL_BGRA.

       GL_INVALID_OPERATION  is	 generated if glReadVideoPixelsSUN is executed
       between the execution of glBegin and  the  corresponding	 execution  of
       glEnd.

       GL_INVALID_OPERATION  is	 generated if glReadVideoPixelsSUN is executed
       on any other frame buffer that doesn't support this extension.

SEE ALSO
       glReadSamplesSUN, glWriteSamplesSUN, glReadPixels

				   13 Aug 02	     GLREADVIDEOPIXELSSUN(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