Standard disclaimer: This is not copy-n-paste. This was all written from memory and then corrected as necessary using the relevant references.
Standard(s): OpenGL (introduced in 1.0)
Language(s): C (this function is also supported by all interfaces from other languages)
Header File: "GL/gl.h"
See also: glBegin, OpenGL rendering pipeline.
void glEnd()
Description
This function should be called after a corresponding glBegin call. It tells OpenGL that your program is finished providing the data the current glBegin call was made to begin.
Examples
All examples are in C++, and are just examples of usage, they're not guaranteed to do anything useful.
The following example is a correct use of this function.
glBegin(GL_POLYGON);
glVertex3f(1.5f, 1.4f, 1.2f);
glVertex3f(1.5f, -1.2f, 1.2f);
glVertex3f(1.5f, -1.2f, 2.5f);
glVertex3f(1.5f, 1.4f, 2.5f);
glEnd();
The following example is an invalid use of this function, which will result in a GL_INVALID_OPERATION error (see below).
glBegin(GL_POINTS);
glVertex3f(0.0f, 1.0f, 0.0f);
glEnd();
glEnd(); // this is incorrect; missing glBegin
For more examples, see glBegin and/or OpenGL rendering pipeline.
Possible Errors
Please see OpenGL error handling for an explanation of what this means.
GL_INVALID_OPERATION is generated if you call this function without having called glBegin first, or if not having called glBegin again since the last glEnd call.
part of the codenode project; edited by: insanefuzzie