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 / glconvolutionparameterext.z / glconvolutionparameterext
Encoding:
Text File  |  1996-11-11  |  13.8 KB  |  201 lines
  1.  
  2.  
  3.  
  4. ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee  ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffEEEEXXXXTTTT,,,, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiiEEEEXXXXTTTT,,,,
  10.      ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffvvvvEEEEXXXXTTTT,,,, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiivvvvEEEEXXXXTTTT - set
  11.      convolution parameters
  12.  
  13.  
  14. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  15.      void ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  16.                                       GLenum _p_n_a_m_e,
  17.                                       GLfloat _p_a_r_a_m_s )
  18.      void ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiiEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  19.                                       GLenum _p_n_a_m_e,
  20.                                       GLint _p_a_r_a_m_s )
  21.  
  23. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  24.      _t_a_r_g_e_t  The target for the convolution parameter.  Must be one of
  25.              GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____1111DDDD____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____2222DDDD____EEEEXXXXTTTT, or
  26.              GGGGLLLL____SSSSEEEEPPPPAAAARRRRAAAABBBBLLLLEEEE____2222DDDD____EEEEXXXXTTTT.
  27.  
  28.      _p_n_a_m_e   The parameter to be set.  Must be GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT.
  29.  
  30.      _p_a_r_a_m_s  The parameter value.  Must be GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE____EEEEXXXXTTTT.
  31.  
  32.  
  33.  
  34. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  35.      void ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrffffvvvvEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  36.                                        GLenum _p_n_a_m_e,
  37.                                        const GLfloat *_p_a_r_a_m_s )
  38.      void ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrriiiivvvvEEEEXXXXTTTT( GLenum _t_a_r_g_e_t,
  39.                                        GLenum _p_n_a_m_e,
  40.                                        const GLint *_p_a_r_a_m_s )
  41.  
  43. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  44.      _t_a_r_g_e_t
  45.           The target for the convolution parameter.  Must be one of
  46.           GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____1111DDDD____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____2222DDDD____EEEEXXXXTTTT, or
  47.           GGGGLLLL____SSSSEEEEPPPPAAAARRRRAAAABBBBLLLLEEEE____2222DDDD____EEEEXXXXTTTT.
  48.  
  49.      _p_n_a_m_e
  50.           The parameter to be set.  Must be one of
  51.           GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT, or
  52.           GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____BBBBIIIIAAAASSSS____EEEEXXXXTTTT.
  53.  
  54.      _p_a_r_a_m_s
  55.           The parameter value.  Must be GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE____EEEEXXXXTTTT if _p_n_a_m_e is
  56.           GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT.  Otherwise, must be a vector of four
  57.           values (for red, green, blue, and alpha, respectively) to be used
  58.           for scaling (when _p_n_a_m_e is GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT) or for
  59.           biasing (when _p_n_a_m_e is GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____BBBBIIIIAAAASSSS____EEEEXXXXTTTT) a convolution
  60.           filter kernel.
  61.  
  62.  
  63.  
  64.  
  65.                                                                         PPPPaaaaggggeeee 1111
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72. ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee  ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))
  73.  
  74.  
  75.  
  76. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  77.      ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT sets the value of a convolution parameter.
  78.  
  79.      _t_a_r_g_e_t selects the convolution filter to be affected:
  80.      GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____1111DDDD____EEEEXXXXTTTT, GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____2222DDDD____EEEEXXXXTTTT, or GGGGLLLL____SSSSEEEEPPPPAAAARRRRAAAABBBBLLLLEEEE____2222DDDD____EEEEXXXXTTTT for
  81.      the 1D, 2D, or separable 2D filter, respectively.
  82.  
  83.      _p_n_a_m_e selects the parameter to be changed.
  84.      GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____SSSSCCCCAAAALLLLEEEE____EEEEXXXXTTTT and GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____FFFFIIIILLLLTTTTEEEERRRR____BBBBIIIIAAAASSSS____EEEEXXXXTTTT affect
  85.      the definition of the convolution filter kernel; see
  86.      ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDDEEEEXXXXTTTT, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDDEEEEXXXXTTTT, and
  87.      ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDDEEEEXXXXTTTT for details.  In these cases, _p_a_r_a_m_s is an array
  88.      of four values to be applied to red, green, blue, and alpha values
  89.      respectively.
  90.  
  91.      A _p_n_a_m_e value of GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT controls the convolution
  92.      border mode.  Currently the only acceptable parameter value is
  93.      GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE____EEEEXXXXTTTT.  When this mode is in effect, the image resulting from
  94.      convolution is smaller than the source image.  If the filter width is _W_f
  95.      and height is _H_f, and the source image width is _W_s and height is _H_s, then
  96.      the convolved image width will be _W_s-_W_f+1 and height will be _H_s-_H_f+1.
  97.      (If this reduction would generate an image with zero or negative width
  98.      and/or height, the output is simply null, with no error generated.)  The
  99.      coordinates of the image resulting from convolution are zero through _W_s-
  100.      _W_f in width and zero through _H_s-_H_f in height.
  101.  
  102. NNNNOOOOTTTTEEEESSSS
  103.      In cases where errors can result from the specification of invalid image
  104.      dimensions, it is the dimensions after convolution that are tested, not
  105.      the dimensions of the source image.  For example, ggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD requires
  106.      power-of-two image size.  When REDUCE_EXT border mode is in effect
  107.      (currently this is always true), the source image must be larger than the
  108.      final power-of-two size by one less than the size of the 1D filter
  109.      kernel.
  110.  
  111. EEEERRRRRRRROOOORRRRSSSS
  112.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not one of the allowable
  113.      values.
  114.  
  115.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _p_n_a_m_e is not one of the allowable values.
  116.  
  117.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _p_n_a_m_e is GGGGLLLL____CCCCOOOONNNNVVVVOOOOLLLLUUUUTTTTIIIIOOOONNNN____BBBBOOOORRRRDDDDEEEERRRR____MMMMOOOODDDDEEEE____EEEEXXXXTTTT
  118.      and _p_a_r_a_m_s is not GGGGLLLL____RRRREEEEDDDDUUUUCCCCEEEE____EEEEXXXXTTTT.
  119.  
  120.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT is
  121.      executed between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding execution
  122.      of ggggllllEEEEnnnndddd.
  123.  
  124. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  125.      ggggllllGGGGeeeettttCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT
  126.  
  127.  
  128.  
  129.  
  130.  
  131.                                                                         PPPPaaaaggggeeee 2222
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))  OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee  ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT((((3333GGGG))))
  139.  
  140.  
  141.  
  142. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  143.      ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr1111DDDDEEEEXXXXTTTT, ggggllllCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnFFFFiiiilllltttteeeerrrr2222DDDDEEEEXXXXTTTT,
  144.      ggggllllSSSSeeeeppppaaaarrrraaaabbbblllleeeeFFFFiiiilllltttteeeerrrr2222DDDDEEEEXXXXTTTT, ggggllllGGGGeeeettttCCCCoooonnnnvvvvoooolllluuuuttttiiiioooonnnnPPPPaaaarrrraaaammmmeeeetttteeeerrrrEEEEXXXXTTTT.
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.                                                                         PPPPaaaaggggeeee 3333
  198.  
  199.  
  200.  
  201.