GLAPI/glPrimitiveRestartIndex: Difference between revisions
m Bot: Adjusting API page category. |
m Bot: Adding better formatting. |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glPrimitiveRestartIndex'''(GLuint | void '''glPrimitiveRestartIndex'''(GLuint {{param|index}}); | ||
; index | ; index | ||
| Line 19: | Line 19: | ||
When one of the '''Draw*''' commands transfers a set of generic attribute array elements to the GL, if the index within the vertex arrays corresponding to that set is equal to the primitive restart index, then the GL does not process those elements as a vertex. Instead, it is as if the drawing command ended with the immediately preceding transfer, and another drawing command is immediately started with the same parameters, but only transferring the immediately following element through the end of the originally specified elements. | When one of the '''Draw*''' commands transfers a set of generic attribute array elements to the GL, if the index within the vertex arrays corresponding to that set is equal to the primitive restart index, then the GL does not process those elements as a vertex. Instead, it is as if the drawing command ended with the immediately preceding transfer, and another drawing command is immediately started with the same parameters, but only transferring the immediately following element through the end of the originally specified elements. | ||
When | When one of the {{code|BaseVertex}} functions is used, the primitive restart comparison occurs before the {{param|basevertex}} offset is added to the array index. | ||
== Notes == | == Notes == | ||
| Line 27: | Line 27: | ||
== See Also == | == See Also == | ||
[[ | [[:Category:Core API Ref Vertex Rendering]] | ||
== Copyright == | == Copyright == | ||
| Line 33: | Line 33: | ||
Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. [http://opencontent.org/openpub/ http://opencontent.org/openpub/]. | Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. [http://opencontent.org/openpub/ http://opencontent.org/openpub/]. | ||
[[Category:API | [[Category:Core API Ref Vertex Specification|PrimitiveRestartIndex]] | ||
[[Category: | [[Category:Core API Reference|PrimitiveRestartIndex]] | ||
Latest revision as of 01:53, 27 September 2012
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 3.1 | |
glPrimitiveRestartIndex: specify the primitive restart index
Function Definition
void glPrimitiveRestartIndex(GLuint index);
- index
- Specifies the value to be interpreted as the primitive restart index.
Description
glPrimitiveRestartIndex specifies a vertex array element that is treated specially when primitive restarting is enabled. This is known as the primitive restart index.
When one of the Draw* commands transfers a set of generic attribute array elements to the GL, if the index within the vertex arrays corresponding to that set is equal to the primitive restart index, then the GL does not process those elements as a vertex. Instead, it is as if the drawing command ended with the immediately preceding transfer, and another drawing command is immediately started with the same parameters, but only transferring the immediately following element through the end of the originally specified elements.
When one of the BaseVertex functions is used, the primitive restart comparison occurs before the basevertex offset is added to the array index.
Notes
glPrimitiveRestartIndex is available only if the GL version is 3.1 or greater.
See Also
Category:Core API Ref Vertex Rendering
Copyright
Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.