home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 1.iso / toolbox / documents / OpenGL / extensions / man / glsamplepatternsgis.z / glsamplepatternsgis
Encoding:
Text File  |  1996-11-11  |  9.1 KB  |  133 lines

  1.  
  2.  
  3.  
  4. ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS - set pattern for multisampling
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS( GLenum _p_a_t_t_e_r_n )
  14.  
  15.  
  16. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  17.      _p_a_t_t_e_r_n  A symbolic constant that indicates the sampling pattern to be
  18.               used when multisampling is enabled.  The allowable values are
  19.               GGGGLLLL____1111PPPPAAAASSSSSSSS____SSSSGGGGIIIISSSS, GGGGLLLL____2222PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS, GGGGLLLL____2222PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS,
  20.               GGGGLLLL____4444PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS, GGGGLLLL____4444PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS, GGGGLLLL____4444PPPPAAAASSSSSSSS____2222____SSSSGGGGIIIISSSS, and
  21.               GGGGLLLL____4444PPPPAAAASSSSSSSS____3333____SSSSGGGGIIIISSSS.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS is part of the SGIS_multisample extension.  This
  25.      extension provides multisampling, a mechanism for antialiasing all GL
  26.      primitives: points, lines, polygons, bitmaps, and images.  Multisample
  27.      antialiasing is most valuable for rendering polygons, because it requires
  28.      no sorting for hidden surface elimination, and it correctly handles
  29.      adjacent polygons, object silhouettes, and even intersecting polygons.
  30.      If only points or lines are being rendered, the "smooth" antialiasing
  31.      mechanism provided by the base GL may result in a higher quality image.
  32.      This extension is designed to allow multisample and smooth antialiasing
  33.      techniques to be alternated during the rendering of a single scene.
  34.  
  35.      The technique is to sample all primitives multiple times at each pixel.
  36.      The color sample values are resolved to a single, displayable color each
  37.      time a pixel is updated, so the antialiasing appears to be automatic at
  38.      the application level.  Because each sample includes depth and stencil
  39.      information, the depth and stencil functions perform equivalently to the
  40.      single-sample mode.
  41.  
  42.      An additional buffer, called the multisample buffer, is required.  Pixel
  43.      sample values, including color, depth, and stencil values, are stored in
  44.      this buffer.  When the frame buffer includes a multisample buffer, it
  45.      does not also include separate depth or stencil buffers, even if the
  46.      multisample buffer does not store depth or stencil values.  Color buffers
  47.      (left/right, front/ back, and aux) do coexist with the multisample
  48.      buffer, however.
  49.  
  50.      The locations of the sample points are relatively static.  They change
  51.      only when ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS is called, and are a repeatable function of
  52.      the parameter _p_a_t_t_e_r_n.  The default pattern GGGGLLLL____1111PPPPAAAASSSSSSSS____SSSSGGGGIIIISSSS is designed to
  53.      produce a well antialiased result in a single rendering pass.  Patterns
  54.      GGGGLLLL____2222PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS and GGGGLLLL____2222PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS together specify twice the number of
  55.      sample points per pixel.  It is intended that a scene be completely
  56.      rendered using pattern GGGGLLLL____2222PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS, then completely rendered again
  57.      using GGGGLLLL____2222PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS.  When these two images are averaged using the
  58.      accumulation buffer, the result is as if a single pass had been rendered
  59.      with a pattern of twice the number of sample points.  Patterns
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____4444PPPPAAAASSSSSSSS____0000____SSSSGGGGIIIISSSS, GGGGLLLL____4444PPPPAAAASSSSSSSS____1111____SSSSGGGGIIIISSSS, GGGGLLLL____4444PPPPAAAASSSSSSSS____2222____SSSSGGGGIIIISSSS, and GGGGLLLL____4444PPPPAAAASSSSSSSS____3333____SSSSGGGGIIIISSSS
  75.      together define a pattern of four times the number of sample points. They
  76.      can be used to accumulate an image after four complete rendering passes.
  77.  
  78.  
  79. NNNNOOOOTTTTEEEESSSS
  80.      It is not possible to query the actual sample locations of a pixel.
  81.  
  82.      Some sample locations may lie outside the unit square that is considered
  83.      to bound the pixel.
  84.  
  85.      ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS is part of the SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee extension, not part
  86.      of the core GL command set.  If GGGGLLLL____SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee is included in the
  87.      string returned by ggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg, when called with argument GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS,
  88.      extension SSSSGGGGIIIISSSS____mmmmuuuullllttttiiiissssaaaammmmpppplllleeee is supported by the connection.
  89.  
  90.  
  91. EEEERRRRRRRROOOORRRRSSSS
  92.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllSSSSaaaammmmpppplllleeeePPPPaaaatttttttteeeerrrrnnnnSSSSGGGGIIIISSSS is executed
  93.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  94.      ggggllllEEEEnnnndddd.
  95.  
  96.  
  97. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  98.      ggggllllGGGGeeeetttt with argument GGGGLLLL____SSSSAAAAMMMMPPPPLLLLEEEE____PPPPAAAATTTTTTTTEEEERRRRNNNN____SSSSGGGGIIII.
  99.  
  100.  
  101.  
  102. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  103.      Multisampling is supported only on RealityEngine, RealityEngine2, and VTX
  104.      systems.  Currently, it affects windows of multisample-capable Visual
  105.      types, but not pixmaps.
  106.  
  107.  
  108. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  109.      ggggllllSSSSaaaammmmpppplllleeeeMMMMaaaasssskkkkSSSSGGGGIIII, ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb, ggggllllXXXXGGGGeeeettttCCCCoooonnnnffffiiiigggg, ggggllllXXXXCCCChhhhoooooooosssseeeeVVVViiiissssuuuuaaaallll, ggggllllEEEEnnnnaaaabbbblllleeee
  110.      with argument GGGGLLLL____MMMMUUUULLLLTTTTIIIISSSSAAAAMMMMPPPPLLLLEEEE____SSSSGGGGIIIISSSS.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.