upstream-man-pages/man4/xhtml/glMultiDrawElements.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "xhtml1-transitional.dtd">
   3 <!-- saved from url=(0013)about:internet -->
   4 <?xml-stylesheet type="text/xsl" href="mathml.xsl"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:pref="http://www.w3.org/2002/Math/preference" pref:renderer="mathplayer-dl"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><link rel="stylesheet" type="text/css" href="opengl-man.css" /><title>glMultiDrawElements - OpenGL 4 Reference Pages</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /></head><body><div class="refentry" lang="en" xml:lang="en"><a id="glMultiDrawElements"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>glMultiDrawElements — render multiple sets of primitives by specifying indices of array data elements</p></div><div class="refsynopsisdiv"><h2>C Specification</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0"><tr><td><code class="funcdef">void <b class="fsfunc">glMultiDrawElements</b>(</code></td><td>GLenum  </td><td><var class="pdparam">mode</var>, </td></tr><tr><td> </td><td>const GLsizei *  </td><td><var class="pdparam">count</var>, </td></tr><tr><td> </td><td>GLenum  </td><td><var class="pdparam">type</var>, </td></tr><tr><td> </td><td>const GLvoid **  </td><td><var class="pdparam">indices</var>, </td></tr><tr><td> </td><td>GLsizei  </td><td><var class="pdparam">primcount</var><code>)</code>;</td></tr></table></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="parameters"></a><h2>Parameters</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>mode</code></em></span></dt><dd><p>
   5                     Specifies what kind of primitives to render.
   6                     Symbolic constants
   7                     <code class="constant">GL_POINTS</code>,
   8                     <code class="constant">GL_LINE_STRIP</code>,
   9                     <code class="constant">GL_LINE_LOOP</code>,
  10                     <code class="constant">GL_LINES</code>,
  11                     <code class="constant">GL_LINE_STRIP_ADJACENCY</code>,
  12                     <code class="constant">GL_LINES_ADJACENCY</code>,
  13                     <code class="constant">GL_TRIANGLE_STRIP</code>,
  14                     <code class="constant">GL_TRIANGLE_FAN</code>,
  15                     <code class="constant">GL_TRIANGLES</code>,
  16                     <code class="constant">GL_TRIANGLE_STRIP_ADJACENCY</code>,
  17                     <code class="constant">GL_TRIANGLES_ADJACENCY</code> and <code class="constant">GL_PATCHES</code>
  18                     are accepted.
  19                 </p></dd><dt><span class="term"><em class="parameter"><code>count</code></em></span></dt><dd><p>
  20                     Points to an array of the elements counts.
  21                 </p></dd><dt><span class="term"><em class="parameter"><code>type</code></em></span></dt><dd><p>
  22                     Specifies the type of the values in <em class="parameter"><code>indices</code></em>. Must be one of
  23                     <code class="constant">GL_UNSIGNED_BYTE</code>, <code class="constant">GL_UNSIGNED_SHORT</code>, or
  24                     <code class="constant">GL_UNSIGNED_INT</code>.
  25                 </p></dd><dt><span class="term"><em class="parameter"><code>indices</code></em></span></dt><dd><p>
  26                     Specifies a pointer to the location where the indices are stored.
  27                 </p></dd><dt><span class="term"><em class="parameter"><code>primcount</code></em></span></dt><dd><p>
  28                     Specifies the size of the <em class="parameter"><code>count</code></em> array.
  29                 </p></dd></dl></div></div><div class="refsect1" lang="en" xml:lang="en"><a id="description"></a><h2>Description</h2><p>
  30             <code class="function">glMultiDrawElements</code> specifies multiple sets of geometric primitives with very few subroutine
  31             calls. Instead of calling a GL function to pass each individual vertex,
  32             normal, texture coordinate, edge flag, or color, you can prespecify
  33             separate arrays of vertices, normals, and so on, and use them to construct a
  34             sequence of primitives with a single call to <code class="function">glMultiDrawElements</code>.
  35         </p><p>
  36             <code class="function">glMultiDrawElements</code> is identical in operation to <a href="glDrawElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawElements</span></span></a> except that
  37             <em class="parameter"><code>primcount</code></em> separate lists of elements are specified.
  38         </p><p>
  39             Vertex attributes that are modified by <code class="function">glMultiDrawElements</code> have an
  40             unspecified value after <code class="function">glMultiDrawElements</code> returns. Attributes that aren't
  41             modified maintain their previous values.
  42         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="notes"></a><h2>Notes</h2><p>
  43             <code class="constant">GL_LINE_STRIP_ADJACENCY</code>,
  44             <code class="constant">GL_LINES_ADJACENCY</code>,
  45             <code class="constant">GL_TRIANGLE_STRIP_ADJACENCY</code> and
  46             <code class="constant">GL_TRIANGLES_ADJACENCY</code>
  47             are available only if the GL version is 3.2 or greater.
  48         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="errors"></a><h2>Errors</h2><p>
  49             <code class="constant">GL_INVALID_ENUM</code> is generated if <em class="parameter"><code>mode</code></em> is not an accepted value.
  50         </p><p>
  51             <code class="constant">GL_INVALID_VALUE</code> is generated if <em class="parameter"><code>primcount</code></em> is negative.
  52         </p><p>
  53             <code class="constant">GL_INVALID_OPERATION</code> is generated if a non-zero buffer object name is bound to an
  54             enabled array or the element array and the buffer object's data store is currently mapped.
  55         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="seealso"></a><h2>See Also</h2><p>
  56             <a href="glDrawArrays.xml"><span class="citerefentry"><span class="refentrytitle">glDrawArrays</span></span></a>,
  57             <a href="glDrawRangeElements.xml"><span class="citerefentry"><span class="refentrytitle">glDrawRangeElements</span></span></a>
  58         </p></div><div class="refsect1" lang="en" xml:lang="en"><a id="Copyright"></a><h2>Copyright</h2><p>
  59             Copyright <span class="trademark"></span>© 1991-2006
  60             Silicon Graphics, Inc. This document is licensed under the SGI
  61             Free Software B License. For details, see
  62             <a href="http://oss.sgi.com/projects/FreeB/" target="_top">http://oss.sgi.com/projects/FreeB/</a>.
  63         </p></div></div></body></html>