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 / swap_control.spec < prev    next >
Encoding:
Text File  |  1996-11-11  |  2.0 KB  |  93 lines
  1. Name
  2.  
  3.     SGI_swap_control
  4.  
  5. Name Strings
  6.  
  7.     GLX_SGI_swap_control
  8.  
  9. Version
  10.  
  11.     $Date: 1996/04/02 00:08:48 $ $Revision: 1.2 $
  12.  
  13. Number
  14.  
  15.     40
  16.  
  17. Dependencies
  18.  
  19.     None
  20.  
  21. Overview
  22.  
  23.     This extension allows an application to specify a minimum periodicity
  24.     of color buffer swaps, measured in video frame periods.
  25.  
  26. New Procedures and Functions
  27.  
  28.     int glXSwapIntervalSGI(int interval)
  29.  
  30. New Tokens
  31.  
  32.     None
  33.  
  34. Additions to Chapter 2 of the 1.0 Specification (OpenGL Operation)
  35.  
  36.     None
  37.  
  38. Additions to Chapter 3 of the 1.0 Specification (Rasterization)
  39.  
  40.     None
  41.  
  42. Additions to Chapter 4 of the 1.0 Specification (Per-Fragment Operations and
  43. the Framebuffer)
  44.  
  45.     None
  46.  
  47. Additions to Chapter 5 of the 1.0 Specification (Special Functions)
  48.  
  49.     None
  50.  
  51. Additions to Chapter 6 of the 1.0 Specification (State and State Requests)
  52.  
  53.     None
  54.  
  55. Additions to the GLX Specification
  56.  
  57.     [Add the following to Section 3.2.6 of the GLX Specification (Double
  58.      Buffering)]
  59.  
  60.     glXSwapIntervalSGI specifies the minimum number of video frame periods
  61.     per buffer swap.  (e.g. a value of two means that the color buffers
  62.     will be swapped at most every other video frame.)  A return value
  63.     of zero indicates success; otherwise an error occurred.  The interval
  64.     takes effect when glXSwapBuffers is first called subsequent to the
  65.     glXSwapIntervalSGI call.
  66.  
  67.     A video frame period is the time required by the monitor to display a 
  68.     full frame of video data.  In the case of an interlaced monitor,
  69.     this is typically the time required to display both the even and odd 
  70.     fields of a frame of video data.
  71.  
  72. Errors
  73.  
  74.     glXSwapIntervalSGI returns GLX_BAD_VALUE if parameter <interval> is
  75.     less than or equal to zero.
  76.  
  77.     glXSwapIntervalSGI returns GLX_BAD_CONTEXT if there is no current
  78.     GLXContext.
  79.  
  80. New State
  81.  
  82.     None
  83.  
  84.     Get Value        Get Command    Type        Initial Value
  85.     ---------        -----------    ----        -------------
  86.     [swap interval]    [none]        Z+        1
  87.  
  88. New Implementation Dependent State
  89.  
  90.     None
  91.  
  92.  
  93.