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 / gldrawarrays.z / gldrawarrays
Encoding:
Text File  |  2002-10-03  |  7.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss - render primitives from array data
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss( GLenum _m_o_d_e,
  14.                         GLint _f_i_r_s_t,
  15.                         GLsizei _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.      ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss 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.      ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss.
  35.  
  36.      When ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss 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 ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss have an unspecified
  43.      value after ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss returns. For example, if GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY is
  44.      enabled, the value of the current color is undefined after ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss
  45.      executes. Attributes that aren't modified remain well defined.
  46.  
  47. NNNNOOOOTTTTEEEESSSS
  48.      ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is available only if the GL version is 1.1 or greater.
  49.  
  50.      ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is included in display lists. If ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss 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. ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss((((3333GGGG))))               OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee               ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss((((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 ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss is executed between the
  80.      execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding ggggllllEEEEnnnndddd.
  81.  
  82.  
  83. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  84.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss, ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss,
  85.      ggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv, ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr, ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss,
  86.      ggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  87.  
  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.