home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / opengldoc / glspec / interlace.spec < prev    next >
Encoding:
Text File  |  1996-11-11  |  3.1 KB  |  105 lines
  1.  
  2. Name
  3.  
  4.     SGIX_interlace
  5.  
  6. Name Strings
  7.  
  8.     GL_SGIX_interlace
  9.  
  10. Version
  11.  
  12.     $Date: 1996/04/01 23:22:58 $ $Revision: 1.1 $
  13.  
  14. Number
  15.  
  16.     45
  17.  
  18. Dependencies
  19.  
  20.     None.
  21.  
  22. Overview
  23.  
  24.     This extension provides a way to interlace rows of pixels when
  25.     rasterizing pixel rectangles, and loading texture images.  In this
  26.     context, interlacing means skiping over rows of pixels or texels
  27.     in the destination.  This is useful for dealing with video data
  28.     since a single frame of video is typically composed from two images
  29.     or fields: one image specifying the data for even rows of the frame
  30.     and the other image specifying the data for odd rows of the frame.
  31.  
  32. New Procedures and Functions
  33.  
  34.     None.
  35.  
  36. New Tokens
  37.  
  38.     Accepted by the <cap> parameter of of Enable, Disable, IsEnabled, and by
  39.     the <pname> parameter of GetBooleanv, GetIntegerv, GetFloatv, GetDoublev:
  40.  
  41.     INTERLACE_SGIX
  42.  
  43. Additions to Chapter 2 of the 1.0 Specification (OpenGL Operation)
  44.  
  45.     None.
  46.  
  47. Additions to Chapter 3 of the 1.0 Specification (Rasterization)
  48.  
  49.     The specification of interlace operation is added the GL Specification
  50.     in section 3.6.3 "Rasterization of Pixel Rectangles", immediately
  51.     following the operations described by EXT_histogram, and immediately
  52.     prior to the subsection "Final Conversion".
  53.  
  54.     The interlacing of rows of pixels is enabled or disabled with Enable or
  55.     Disable using the symbolic constant INTERLACE_SGIX.  If INTERLACE_SGIX
  56.     is enabled, then all of the groups which belong to a row m are treated
  57.     as if they belonged to the row 2 * m.  If the source image has a height
  58.     of h rows, this effectively expands the height of the image to 2 * h - 1
  59.     rows.  After interlacing, only every other row of the image is defined.
  60.     If the interlaced pixel rectangle is rasterized to the framebuffer, then
  61.     only these rows are converted to fragments.  If the interlaced pixel
  62.     rectangle is a texture image, then only these rows are written to texure
  63.     memory.
  64.     
  65.     In cases where errors can result from the specification of invalid
  66.     image dimensions, it is the resulting dimensions that are tested, not
  67.     the dimensions of the source image.  (A specific example is TexImage2D,
  68.     which specifies constraints for image dimensions.  Even if TexImage2D
  69.     is called with a null pixel pointer, the dimensions of the resulting
  70.     texture image are those that would result from the effective expansion
  71.     of the specified image due to interlacing.)
  72.  
  73. Additions to Chapter 4 of the 1.0 Specification (Per-Fragment Operations
  74. and the Frame Buffer)
  75.  
  76.     In section 4.3 "Drawing, Reading, and Copying Pixels"
  77.  
  78.     INTERLACE_SGIX has no effect on the operation of ReadPixels.  
  79.  
  80. Additions to Chapter 5 of the 1.0 Specification (Special Functions)
  81.  
  82.     None.
  83.  
  84. Additions to Chapter 6 of the 1.0 Specification (State and State Requests)
  85.  
  86.     None.
  87.  
  88. Additions to the GLX Specification
  89.  
  90.     None.
  91.  
  92. Errors
  93.  
  94.     None.
  95.  
  96. New State
  97.  
  98.     Get Value                Get Command            Type        Initial Value        Attribute
  99.     ---------                -----------            ----        -------------        ---------
  100.     INTERLACE_SGIX            IsEnabled            B        False            pixel/enable
  101.  
  102. New Implementation Dependent State
  103.  
  104.     None.
  105.