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 / glminmaxext.z / glminmaxext
Encoding:
Text File  |  1996-11-11  |  11.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT - define minmax table
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  14.                        GLenum _i_n_t_e_r_n_a_l_f_o_r_m_a_t,
  15.                        GLboolean _s_i_n_k )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _t_a_r_g_e_t          The minmax table whose parameters are to be set.  Must be
  20.                      GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX____EEEEXXXXTTTT.
  21.  
  22.      _i_n_t_e_r_n_a_l_f_o_r_m_a_t  The format of entries in the minmax table.  Must be one
  23.                      of GGGGLLLL____AAAALLLLPPPPHHHHAAAA, GGGGLLLL____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT, GGGGLLLL____AAAALLLLPPPPHHHHAAAA8888____EEEEXXXXTTTT,
  24.                      GGGGLLLL____AAAALLLLPPPPHHHHAAAA11112222____EEEEXXXXTTTT, GGGGLLLL____AAAALLLLPPPPHHHHAAAA11116666____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE,
  25.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____EEEEXXXXTTTT,
  26.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE____AAAALLLLPPPPHHHHAAAA,
  27.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE4444____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE6666____AAAALLLLPPPPHHHHAAAA2222____EEEEXXXXTTTT,
  28.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE8888____AAAALLLLPPPPHHHHAAAA8888____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA4444____EEEEXXXXTTTT,
  29.                      GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11112222____AAAALLLLPPPPHHHHAAAA11112222____EEEEXXXXTTTT, GGGGLLLL____LLLLUUUUMMMMIIIINNNNAAAANNNNCCCCEEEE11116666____AAAALLLLPPPPHHHHAAAA11116666____EEEEXXXXTTTT,
  30.                      GGGGLLLL____RRRRGGGGBBBB, GGGGLLLL____RRRRGGGGBBBB2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB4444____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB5555____EEEEXXXXTTTT,
  31.                      GGGGLLLL____RRRRGGGGBBBB8888____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB11110000____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB11112222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB11116666____EEEEXXXXTTTT,
  32.                      GGGGLLLL____RRRRGGGGBBBBAAAA, GGGGLLLL____RRRRGGGGBBBBAAAA2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA4444____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB5555____AAAA1111____EEEEXXXXTTTT,
  33.                      GGGGLLLL____RRRRGGGGBBBBAAAA8888____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBB11110000____AAAA2222____EEEEXXXXTTTT, GGGGLLLL____RRRRGGGGBBBBAAAA11112222____EEEEXXXXTTTT, or
  34.                      GGGGLLLL____RRRRGGGGBBBBAAAA11116666____EEEEXXXXTTTT.
  35.  
  36.      _s_i_n_k            If GGGGLLLL____TTTTRRRRUUUUEEEE, pixels will be consumed by the minmax process
  37.                      and no drawing or texture loading will take place.  If
  38.                      GGGGLLLL____FFFFAAAALLLLSSSSEEEE, pixels will proceed to the final conversion
  39.                      process after minmax.
  40.  
  41. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  42.      Minmax is part of the GL pixel transfer process.  It takes place
  43.      immediately after histogramming.  Minmax is performed only for RGBA
  44.      pixels (though these may be specified originally as color indices and
  45.      converted to RGBA by index table lookup).  Minmax is enabled with
  46.      ggggllllEEEEnnnnaaaabbbblllleeee and disabled with ggggllllDDDDiiiissssaaaabbbblllleeee.
  47.  
  48.      When GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX____EEEEXXXXTTTT is enabled, the RGBA components of incoming pixels are
  49.      compared to the minimum and maximum values for each component, which are
  50.      stored in the 2-element minmax table.  (The first element stores the
  51.      minima, and the second element stores the maxima.)  If a pixel component
  52.      is greater than the corresponding component in the maximum element, then
  53.      the maximum element is updated with the pixel component value.  If a
  54.      pixel component is less than the corresponding component in the minimum
  55.      element, then the minimum element is updated with the pixel component
  56.      value.  (In both cases, if the internal format of the minmax table
  57.      includes luminance, then the R color component of incoming pixels is used
  58.      for comparison.)  The contents of the minmax table may be retrieved at a
  59.      later time by calling ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT redefines the current minmax table to have entries of the
  75.      format specified by _i_n_t_e_r_n_a_l_f_o_r_m_a_t.  The maximum element is initialized
  76.      with the smallest possible component values, and the minimum element is
  77.      initialized with the largest possible component values.  The values in
  78.      the previous minmax table, if any, are lost.  If _s_i_n_k is GGGGLLLL____TTTTRRRRUUUUEEEE, then
  79.      pixels are discarded after minmax; no further processing of the pixels
  80.      takes place, and no drawing, texture loading, or pixel readback will
  81.      result.
  82.  
  83.      The minmax state information may be queried by calling
  84.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT with a _t_a_r_g_e_t of GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX____EEEEXXXXTTTT and one of the
  85.      following values for the _p_n_a_m_e argument:
  86.  
  87.                Parameter            Description
  88.                ____________________________________________________
  89.                GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX____FFFFOOOORRRRMMMMAAAATTTT     Internal format of minmax table
  90.                GGGGLLLL____MMMMIIIINNNNMMMMAAAAXXXX____SSSSIIIINNNNKKKK____EEEEXXXXTTTT   Value of the _s_i_n_k parameter
  91.  
  92.  
  93. NNNNOOOOTTTTEEEESSSS
  94.      ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT is part of the EEEEXXXXTTTT____bbbblllleeeennnndddd____mmmmiiiinnnnmmmmaaaaxxxx extension, not part of the
  95.      core GL command set. If GGGGLLLL____EEEEXXXXTTTT____bbbblllleeeennnndddd____mmmmiiiinnnnmmmmaaaaxxxx is included in the string
  96.      returned by ggggllllGGGGeeeettttSSSSttttrrrriiiinnnngggg, when called with argument GGGGLLLL____EEEEXXXXTTTTEEEENNNNSSSSIIIIOOOONNNNSSSS,
  97.      extension EEEEXXXXTTTT____bbbblllleeeennnndddd____mmmmiiiinnnnmmmmaaaaxxxx is supported by the connection.
  98.  
  99.  
  100. EEEERRRRRRRROOOORRRRSSSS
  101.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not one of the allowable
  102.      values.
  103.  
  104.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _i_n_t_e_r_n_a_l_f_o_r_m_a_t is not one of the
  105.      allowable values.
  106.  
  107.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT is executed between the
  108.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ggggllllEEEEnnnndddd.
  109.  
  110. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  111.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT.
  112.  
  113.  
  114. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  115.      Histogramming and minmax are supported only on RealityEngine,
  116.      RealityEngine2, and VTX systems.  However, on these systems histogram and
  117.      minmax may not be used when rendering to pixmaps.
  118.  
  119.  
  120. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  121.      ggggllllGGGGeeeettttMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT, ggggllllRRRReeeesssseeeettttMMMMiiiinnnnmmmmaaaaxxxxEEEEXXXXTTTT.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.