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 / fgldrawarrays.z / fgldrawarrays
Encoding:
Text File  |  2002-10-03  |  7.3 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss - render primitives from array data
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss( INTEGER*4 _m_o_d_e,
  14.                                INTEGER*4 _f_i_r_s_t,
  15.                                INTEGER*4 _c_o_u_n_t )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _m_o_d_e   Specifies what kind of primitives to render.  Symbolic constants
  20.             GGGGLLLL____PPPPOOOOIIIINNNNTTTTSSSS, GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____LLLLIIIINNNNEEEE____LLLLOOOOOOOOPPPP, GGGGLLLL____LLLLIIIINNNNEEEESSSS,
  21.             GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____FFFFAAAANNNN, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEESSSS, GGGGLLLL____QQQQUUUUAAAADDDD____SSSSTTTTRRRRIIIIPPPP,
  22.             GGGGLLLL____QQQQUUUUAAAADDDDSSSS, and GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN are accepted.
  23.  
  24.      _f_i_r_s_t  Specifies the starting index in the enabled arrays.
  25.  
  26.      _c_o_u_n_t  Specifies the number of indices to be rendered.
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss specifies multiple geometric primitives with very few
  30.      subroutine calls. Instead of calling a GL procedure to pass each
  31.      individual vertex, normal, texture coordinate, edge flag, or color, you
  32.      can prespecify separate arrays of vertices, normals, and colors and use
  33.      them to construct a sequence of primitives with a single call to
  34.      ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss.
  35.  
  36.      When ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is called, it uses _c_o_u_n_t sequential elements from each
  37.      enabled array to construct a sequence of geometric primitives, beginning
  38.      with element _f_i_r_s_t. _m_o_d_e specifies what kind of primitives are
  39.      constructed, and how the array elements construct those primitives. If
  40.      GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY is not enabled, no geometric primitives are generated.
  41.  
  42.      Vertex attributes that are modified by ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss have an unspecified
  43.      value after ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss returns. For example, if GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY is
  44.      enabled, the value of the current color is undefined after ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss
  45.      executes. Attributes that aren't modified remain well defined.
  46.  
  47. NNNNOOOOTTTTEEEESSSS
  48.      ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is available only if the GL version is 1.1 or greater.
  49.  
  50.      ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is included in display lists. If ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is entered
  51.      into a display list, the necessary array data (determined by the array
  52.      pointers and enables) is also entered into the display list. Because the
  53.      array pointers and enables are client-side state, their values affect
  54.      display lists when the lists are created, not when the lists are
  55.      executed.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss((((3333GGGG))))              OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee              ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss((((3333GGGG))))
  71.  
  72.  
  73.  
  74. ERRORS
  75.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is not an accepted value.
  76.  
  77.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _c_o_u_n_t is negative.
  78.  
  79.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is executed between
  80.      the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding ffffggggllllEEEEnnnndddd.
  81.  
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      ffffggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ffffggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ffffggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss, ffffggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss,
  85.      ffffggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ffffggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv, ffffggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr,
  86.      ffffggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss, ffffggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ffffggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr,
  87.      ffffggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  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.