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 / gldrawrangeelements.z / gldrawrangeelements
Encoding:
Text File  |  2002-10-03  |  10.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss - render primitives from array data
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss( GLenum _m_o_d_e,
  14.                                GLuint _s_t_a_r_t,
  15.                                GLuint _e_n_d,
  16.                                GLsizei _c_o_u_n_t,
  17.                                GLenum _t_y_p_e,
  18.                                const GLvoid *_i_n_d_i_c_e_s )
  19.  
  20.  
  21. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  22.      _m_o_d_e     Specifies what kind of primitives to render.  Symbolic constants
  23.               GGGGLLLL____PPPPOOOOIIIINNNNTTTTSSSS, GGGGLLLL____LLLLIIIINNNNEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____LLLLIIIINNNNEEEE____LLLLOOOOOOOOPPPP, GGGGLLLL____LLLLIIIINNNNEEEESSSS,
  24.               GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____SSSSTTTTRRRRIIIIPPPP, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEE____FFFFAAAANNNN, GGGGLLLL____TTTTRRRRIIIIAAAANNNNGGGGLLLLEEEESSSS, GGGGLLLL____QQQQUUUUAAAADDDD____SSSSTTTTRRRRIIIIPPPP,
  25.               GGGGLLLL____QQQQUUUUAAAADDDDSSSS, and GGGGLLLL____PPPPOOOOLLLLYYYYGGGGOOOONNNN are accepted.
  26.  
  27.      _s_t_a_r_t    Specifies the minimum array index contained in _i_n_d_i_c_e_s.
  28.  
  29.      _e_n_d      Specifies the maximum array index contained in _i_n_d_i_c_e_s.
  30.  
  31.      _c_o_u_n_t    Specifies the number of elements to be rendered.
  32.  
  33.      _t_y_p_e     Specifies the type of the values in _c_o_u_n_t. Must be one of
  34.               GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, or GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT.
  35.  
  36.      _i_n_d_i_c_e_s  Specifies a pointer to the location where the indices are
  37.               stored.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is a restricted form of ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss. _m_o_d_e, _s_t_a_r_t,
  41.      _e_n_d, and _c_o_u_n_t match the corresponding arguments to ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss, with
  42.      the additional constraint that all values in the arrays _c_o_u_n_t must lie
  43.      between _s_t_a_r_t and _e_n_d, inclusive.
  44.  
  45.      Implementations denote recommended maximum amounts of vertex and
  46.      index data, which may be queried by calling ggggllllGGGGeeeetttt with argument
  47.      GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____VVVVEEEERRRRTTTTIIIICCCCEEEESSSS and GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____IIIINNNNDDDDIIIICCCCEEEESSSS.  If end - start + 1
  48.      is greater than the value of GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____VVVVEEEERRRRTTTTIIIICCCCEEEESSSS, or if _c_o_u_n_t is
  49.      greater than the value of GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____IIIINNNNDDDDIIIICCCCEEEESSSS, then the call may
  50.      operate at reduced performance.  There is no requirement that all
  51.      vertices in the range [_s_t_a_r_t, _e_n_d] be referenced.  However, the
  52.      implementation may partially process unused vertices, reducing
  53.      performance from what could be achieved with an optimal index set.
  54.  
  55.      When ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is called, it uses _s_t_a_r_t sequential elements
  56.      from an enabled array, starting at _c_o_u_n_t to construct a sequence of
  57.      geometric primitives. _m_o_d_e specifies what kind of primitives are
  58.      constructed, and how the array elements construct these primitives. If
  59.      more than one array is enabled, each is used. If GGGGLLLL____VVVVEEEERRRRTTTTEEEEXXXX____AAAARRRRRRRRAAAAYYYY is not
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee        ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      enabled, no geometric primitives are constructed.
  75.  
  76.      Vertex attributes that are modified by ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss have an
  77.      unspecified value after ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss returns. For example, if
  78.      GGGGLLLL____CCCCOOOOLLLLOOOORRRR____AAAARRRRRRRRAAAAYYYY is enabled, the value of the current color is undefined
  79.      after ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss executes. Attributes that aren't modified
  80.      maintain their previous values.
  81.  
  82. NNNNOOOOTTTTEEEESSSS
  83.      ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is available only if the GL version is 1.2 or
  84.      greater.
  85.  
  86.      ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is included in display lists. If ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss
  87.      is entered into a display list, the necessary array data (determined by
  88.      the array pointers and enables) is also entered into the display list.
  89.      Because the array pointers and enables are client-side state, their
  90.      values affect display lists when the lists are created, not when the
  91.      lists are executed.
  92.  
  93. EEEERRRRRRRROOOORRRRSSSS
  94.      It is an error for indices to lie outside the range [_s_t_a_r_t, _e_n_d], but
  95.      implementations may not check for this situation. Such indices cause
  96.      implementation-dependent behavior.
  97.  
  98.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _m_o_d_e is not an accepted value.
  99.  
  100.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _c_o_u_n_t is negative.
  101.  
  102.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _e_n_d < _s_t_a_r_t.
  103.  
  104.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ggggllllDDDDrrrraaaawwwwRRRRaaaannnnggggeeeeEEEElllleeeemmmmeeeennnnttttssss is executed
  105.      between the execution of ggggllllBBBBeeeeggggiiiinnnn and the corresponding ggggllllEEEEnnnndddd.
  106.  
  107. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  108.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____VVVVEEEERRRRTTTTIIIICCCCEEEESSSS
  109.  
  110.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____EEEELLLLEEEEMMMMEEEENNNNTTTTSSSS____IIIINNNNDDDDIIIICCCCEEEESSSS
  111.  
  112.  
  113. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  114.      ggggllllAAAArrrrrrrraaaayyyyEEEElllleeeemmmmeeeennnntttt, ggggllllCCCCoooolllloooorrrrPPPPooooiiiinnnntttteeeerrrr, ggggllllDDDDrrrraaaawwwwAAAArrrrrrrraaaayyyyssss, ggggllllDDDDrrrraaaawwwwEEEElllleeeemmmmeeeennnnttttssss,
  115.      ggggllllEEEEddddggggeeeeFFFFllllaaaaggggPPPPooooiiiinnnntttteeeerrrr, ggggllllGGGGeeeettttPPPPooooiiiinnnntttteeeerrrrvvvv, ggggllllIIIInnnnddddeeeexxxxPPPPooooiiiinnnntttteeeerrrr, ggggllllIIIInnnntttteeeerrrrlllleeeeaaaavvvveeeeddddAAAArrrrrrrraaaayyyyssss,
  116.      ggggllllNNNNoooorrrrmmmmaaaallllPPPPooooiiiinnnntttteeeerrrr, ggggllllTTTTeeeexxxxCCCCoooooooorrrrddddPPPPooooiiiinnnntttteeeerrrr, ggggllllVVVVeeeerrrrtttteeeexxxxPPPPooooiiiinnnntttteeeerrrr
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.