home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglgetfragmentmaterial.z / fglgetfragmentmaterial
Encoding:
Text File  |  2002-10-03  |  10.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallllffffvvvvSSSSGGGGIIIIXXXX,,,, ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaalllliiiivvvvSSSSGGGGIIIIXXXX - return
  10.      fragment material parameters
  11.  
  12.  
  13. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  14.      SUBROUTINE ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallllffffvvvvSSSSGGGGIIIIXXXX( INTEGER*4 _f_a_c_e,
  15.                                               INTEGER*4 _p_n_a_m_e,
  16.                                               CHARACTER*8 _p_a_r_a_m_s )
  17.      SUBROUTINE ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaalllliiiivvvvSSSSGGGGIIIIXXXX( INTEGER*4 _f_a_c_e,
  18.                                               INTEGER*4 _p_n_a_m_e,
  19.                                               CHARACTER*8 _p_a_r_a_m_s )
  20.  
  21.  
  22. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  23.      _f_a_c_e    Specifies which of the two fragment materials is being queried.
  24.              GGGGLLLL____FFFFRRRROOOONNNNTTTT or GGGGLLLL____BBBBAAAACCCCKKKK are accepted, representing the front and back
  25.              fragment materials, respectively.
  26.  
  27.      _p_n_a_m_e   Specifies the fragment material parameter to return.  GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT,
  28.              GGGGLLLL____DDDDIIIIFFFFFFFFUUUUSSSSEEEE, GGGGLLLL____SSSSPPPPEEEECCCCUUUULLLLAAAARRRR, GGGGLLLL____EEEEMMMMIIIISSSSSSSSIIIIOOOONNNN, GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS, and
  29.              GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXXEEEESSSS are accepted.
  30.  
  31.      _p_a_r_a_m_s  Returns the requested data.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll returns in _p_a_r_a_m_s the value or values of parameter
  35.      _p_n_a_m_e of fragment material _f_a_c_e. Six parameters are defined:
  36.  
  37.      GGGGLLLL____AAAAMMMMBBBBIIIIEEEENNNNTTTT            _p_a_r_a_m_s returns four integer or floating-point
  38.                            values representing the ambient reflectance of the
  39.                            fragment material.  Integer values, when requested,
  40.                            are linearly mapped from the internal floating-
  41.                            point representation such that 1.0 maps to the most
  42.                            positive representable integer value, and -1.0 maps
  43.                            to the most negative representable integer value.
  44.                            If the internal value is outside the range [-1, 1],
  45.                            the corresponding integer return value is
  46.                            undefined. The initial value is (0.2, 0.2, 0.2,
  47.                            1.0)
  48.  
  49.      GGGGLLLL____DDDDIIIIFFFFFFFFUUUUSSSSEEEE            _p_a_r_a_m_s returns four integer or floating-point
  50.                            values representing the diffuse reflectance of the
  51.                            fragment material.  Integer values, when requested,
  52.                            are linearly mapped from the internal floating-
  53.                            point representation such that 1.0 maps to the most
  54.                            positive representable integer value, and -1.0 maps
  55.                            to the most negative representable integer value.
  56.                            If the internal value is outside the range [-1, 1],
  57.                            the corresponding integer return value is
  58.                            undefined. The initial value is (0.8, 0.8, 0.8,
  59.                            1.0).
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____SSSSPPPPEEEECCCCUUUULLLLAAAARRRR           _p_a_r_a_m_s returns four integer or floating-point
  75.                            values representing the specular reflectance of the
  76.                            fragment material.  Integer values, when requested,
  77.                            are linearly mapped from the internal floating-
  78.                            point representation such that 1.0 maps to the most
  79.                            positive representable integer value, and -1.0 maps
  80.                            to the most negative representable integer value.
  81.                            If the internal value is outside the range [-1, 1],
  82.                            the corresponding integer return value is
  83.                            undefined. The initial value is (0, 0, 0, 1).
  84.  
  85.      GGGGLLLL____EEEEMMMMIIIISSSSSSSSIIIIOOOONNNN           _p_a_r_a_m_s returns four integer or floating-point
  86.                            values representing the emitted light intensity of
  87.                            the fragment material.  Integer values, when
  88.                            requested, are linearly mapped from the internal
  89.                            floating-point representation such that 1.0 maps to
  90.                            the most positive representable integer value, and
  91.                            -1.0 maps to the most negative representable
  92.                            integer value.  If the internal value is outside
  93.                            the range [-1, 1.0], the corresponding integer
  94.                            return value is undefined. The initial value is (0,
  95.                            0, 0, 1).
  96.  
  97.      GGGGLLLL____SSSSHHHHIIIINNNNIIIINNNNEEEESSSSSSSS          _p_a_r_a_m_s returns one integer or floating-point value
  98.                            representing the specular exponent of the fragment
  99.                            material.  Integer values, when requested, are
  100.                            computed by rounding the internal floating-point
  101.                            value to the nearest integer value. The initial
  102.                            value is 0.
  103.  
  104.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____IIIINNNNDDDDEEEEXXXXEEEESSSS      _p_a_r_a_m_s returns three integer or floating-point
  105.                            values representing the ambient, diffuse, and
  106.                            specular indices of the fragment material.  These
  107.                            indices are used only for color index lighting.
  108.                            (All the other parameters are used only for RGBA
  109.                            lighting.)  Integer values, when requested, are
  110.                            computed by rounding the internal floating-point
  111.                            values to the nearest integer values.
  112.  
  113. NNNNOOOOTTTTEEEESSSS
  114.      If an error is generated, no change is made to the contents of _p_a_r_a_m_s.
  115.  
  116. EEEERRRRRRRROOOORRRRSSSS
  117.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _f_a_c_e or _p_n_a_m_e is not an accepted value.
  118.  
  119.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll is executed
  120.      between the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of
  121.      ffffggggllllEEEEnnnndddd.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))     OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee     ffffggggllllGGGGeeeettttFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll((((3333GGGG))))
  137.  
  138.  
  139.  
  140. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  141.      The SSSSGGGGIIIIXXXX____ffffrrrraaaaggggmmmmeeeennnntttt____lllliiiigggghhhhttttiiiinnnngggg extension is supported only on Octane2 VPro
  142.      systems.
  143.  
  144.  
  145. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  146.      ffffggggllllFFFFrrrraaaaggggmmmmeeeennnnttttMMMMaaaatttteeeerrrriiiiaaaallll
  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.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.