Функция glBegin
Функции glBegin и glend разделяют вершины примитива или группы подобных примитивов.
Синтаксис
void WINAPI glBegin(
GLenum mode
);
Параметры
-
mode
-
Примитивы или примитивы, которые будут созданы из вершин, представленных между glBegin и последующим glend. Ниже приведены допустимые символьные константы и их значения.
Значение Значение - GL_POINTS
Рассматривает каждую вершину как единую точку. Вершина n определяет точку n. Отрисовывается N точек. - GL_LINES
Обрабатывает каждую пару вершин как независимый сегмент линии. Вершины 2n - 1 и 2n определяют строку n. Рисуются N/2 линии. - GL_LINE_STRIP
Рисует соединенную группу сегментов линий от первой вершины до последней. Вершины n и n+1 определяют строку n. N — рисуется 1 линия. - GL_LINE_LOOP
Рисует соединенную группу сегментов линий от первой вершины до последней, а затем обратно к первой. Вершины n и n + 1 определяют строку n. Последняя строка, однако, определяется вершинами N и 1. Рисуется N линий. - GL_TRIANGLES
Рассматривает каждый триплет вершин как независимый треугольник. Вершины 3n - 2, 3n - 1 и 3n определяют треугольник n. Рисуются N/3 треугольников. - GL_TRIANGLE_STRIP
Рисует соединенную группу треугольников. Для каждой вершины, представленной после первых двух вершин, определяется один треугольник. Для нечетных n вершин n, n + 1 и n + 2 определяют треугольник n. Для четных n вершины n + 1, n и n + 2 определяют треугольник n. N — рисуются 2 треугольника. - GL_TRIANGLE_FAN
Рисует соединенную группу треугольников. Для каждой вершины, представленной после первых двух вершин, определяется один треугольник. Вершины 1, n + 1, n + 2 определяют треугольник n. N — рисуются 2 треугольника. - GL_QUADS
Рассматривает каждую группу из четырех вершин как независимый четырехугольник. Вершины 4n - 3, 4n - 2, 4n - 1 и 4n определяют четырехугольник n. Рисуются n/4 четырехугольника. - GL_QUAD_STRIP
Рисует соединенную группу четырехугольника. Для каждой пары вершин, представленной после первой пары, определяется один четырехугольник. Вершины 2n - 1, 2n, 2n + 2 и 2n + 1 определяют четырехугольник n. N/2 — рисуется 1 четырехугольник. Обратите внимание, что порядок, в котором вершины используются для создания четырехугольника из полосовых данных, отличается от порядка, используемого с независимыми данными. - GL_POLYGON
Рисует один выпуклый многоугольник. Вершины от 1 до N определяют этот многоугольник.
Возвращаемое значение
Эта функция не возвращает значение.
Коды ошибок
Следующие коды ошибок могут быть получены функцией glGetError .
| Имя | Значение |
|---|---|
|
для параметра mode задано непринятое значение. |
|
Функция, отличаемая от glVertex, glColor, glIndex, glNormal, glTexCoord, glEvalCoord, glEvalPoint, glMaterial, glEdgeFlag, glCallList или glCallLists , была вызвана между glBegin и соответствующим glend glend. Функция glend была вызвана до вызова соответствующего glBegin , или glBegin был вызван в последовательности glBegin glBegin/glend . |
Комментарии
Функции glBegin и glend разделяют вершины, которые определяют примитив или группу подобных примитивов. Функция glBegin принимает один аргумент, указывающий, какие из десяти примитивов составляют вершины. Принимая n как целочисленное число, начиная с единицы, и N как общее число указанных вершин, интерпретации будут следующим образом:
Между glBegin и glend можно использовать только подмножество функций OpenGL. Вы можете использовать следующие функции:
Вы также можете использовать glCallList или glCallLists для выполнения списков отображения, включающих только предыдущие функции. Если между glBegin и glend вызывается какая-либо другая функция OpenGL, устанавливается флаг ошибки, а функция игнорируется.
Независимо от значения, выбранного для режима в glBegin, количество вершин, которые можно определить между glBegin и glend, не ограничено. Линии, треугольники, четырехугольник и многоугольник, которые не указаны полностью, не рисуются. Неполные результаты спецификации, если предоставлено слишком мало вершин для указания даже одного примитива или указано неверное число вершин. Неполный примитив игнорируется; рисуются полные примитивы.
Минимальная спецификация вершин для каждого примитива:
Минимальное число вершин Тип примитива 1 point 2 line 3 треугольник 4 Четырехугольник 3 polygon Режимы, для которых требуется определенное число вершин, имеют GL_LINES (2), GL_TRIANGLES (3), GL_QUADS (4) и GL_QUAD_STRIP (2).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Заголовок |
|
| Библиотека |
|
| DLL |
|