Функция glFeedbackBuffer

Статья
06/13/2023

Функция glFeedbackBuffer управляет режимом обратной связи.

Синтаксис

void WINAPI glFeedbackBuffer(
   GLsizei size,
   GLenum  type,
   GLfloat *buffer
);

Параметры

size: Максимальное количество значений, которые можно записать в буфер.
type: Символьная константа, описывающая сведения, которые будут возвращены для каждой вершины. Принимаются следующие символьные константы: GL_2D, GL_3D, GL_3D_COLOR, GL_3D_COLOR_TEXTURE и GL_4D_COLOR_TEXTURE.
Буфера: Возвращает данные обратной связи.

Возвращаемое значение

Эта функция не возвращает значение.

Коды ошибок

Следующие коды ошибок могут быть получены функцией glGetError .

Имя	Значение
GL_INVALID_ENUM	Тип не является допустимым значением.
GL_INVALID_ENUM	размер был отрицательным.
GL_INVALID_OPERATION	glFeedbackBuffer был вызван, когда режим отрисовки был GL_FEEDBACK, или glRenderMode был вызван с аргументом GL_FEEDBACK до вызова glFeedbackBuffer по крайней мере один раз.
GL_INVALID_OPERATION	Функция была вызвана между вызовом glBegin и соответствующим вызовом glEnd.

Функция glFeedbackBuffer управляет обратной связью. Обратная связь, как и выбор, является режимом OpenGL. Режим выбирается путем вызова glRenderMode с GL_FEEDBACK. Если OpenGL находится в режиме обратной связи, то при растеризации пиксели не создаются. Вместо этого сведения о примитивах, которые были бы растеризованы, передаются в приложение с помощью OpenGL.

Функция glFeedbackBuffer имеет три аргумента:

buffer — это указатель на массив значений с плавающей запятой, в который помещаются сведения об обратной связи.
size указывает размер массива.
type — это символьная константа, описывающая сведения, которые передаются для каждой вершины.

Необходимо выдать glFeedbackBuffer до включения режима обратной связи (путем вызова glRenderMode с аргументом GL_FEEDBACK). Установка GL_FEEDBACK без установки буфера обратной связи или вызова glFeedbackBuffer , когда OpenGL находится в режиме обратной связи, является ошибкой.

Выведите OpenGL из режима обратной связи, вызвав glRenderMode со значением параметра, отличном от GL_FEEDBACK. При этом, когда OpenGL находится в режиме обратной связи, glRenderMode возвращает количество записей, помещенных в массив отзывов. Возвращаемое значение никогда не превышает размер. Если для данных обратной связи требуется больше места, чем было доступно в буфере, glRenderMode возвращает отрицательное значение.

В режиме обратной связи каждый примитив, который будет растеризован, создает блок значений, копируемый в массив отзывов. Если это приведет к тому, что количество записей превысит максимальное значение, glFeedbackBuffer частично записывает блок для заполнения массива (если вообще остается какое-либо пространство) и устанавливает флаг переполнения. Каждый блок начинается с кода, указывающего тип примитива, за которым следуют значения, описывающие вершины примитива и связанные с ними данные. Функция glFeedbackBuffer также записывает записи для растровых изображений и прямоугольников пикселей. Обратная связь возникает после отбраковки многоугольников и интерпретации многоугольников glPolygonMode , поэтому многоугольников, которые отбираются, не возвращаются в буфер обратной связи. Это также может произойти после разбиения многоугольников с более чем тремя ребрами на треугольники, если реализация OpenGL отрисовывает многоугольник путем выполнения этой декомпозиции.

Вы можете вставить маркер в буфер обратной связи с помощью glPassThrough.

Ниже приведена грамматика для блоков значений, записанных в буфер обратной связи. Каждый примитив обозначается уникальным идентифицирующие значения, за которым следует некоторое количество вершин. Записи многоугольников содержат целочисленное значение, указывающее, сколько вершин следует. Вершина возвращается в виде некоторого количества значений с плавающей запятой, определяемых типом . Цвета передаются в виде четырех значений в режиме RGBA и одного значения в режиме цветового индекса.

feedbackList < feedbackItem FeedbackList | feedbackItem

вершина GL_POINT_TOKEN точки <

lineSegment < GL_LINE_TOKEN вершины | вершина GL_LINE_RESET_TOKEN

polygon < GL_POLYGON_TOKEN n polySpec

polySpec < polySpec vertex | вершина вершины вершины

точечный рисунок < GL_BITMAP_TOKEN вершине

pixelRectangle < GL_DRAW_PIXEL_TOKEN вершины | вершина GL_COPY_PIXEL_TOKEN

Значение GL_PASS_THROUGH_TOKEN passThru <

< вершина 2d | 3d | 3dColor | 3dColorTexture | 4dColorTexture

2d-значение <

Значение 3d-значения <

3dColor value < value value value color

3dColorTexture < value value value color tex

4dColorTexture < value value value value value color tex

color < rgba | index

rgba < value value value value

значение индекса <

tex < value value value value

Параметр value является числом с плавающей запятой, а n — целым числом с плавающей запятой, дающим количество вершин в многоугольнике. Ниже приведены символьные константы с плавающей запятой: GL_POINT_TOKEN, GL_LINE_TOKEN, GL_LINE_RESET_TOKEN, GL_POLYGON_TOKEN, GL_BITMAP_TOKEN, GL_DRAW_PIXEL_TOKEN, GL_COPY_PIXEL_TOKEN и GL_PASS_THROUGH_TOKEN. GL_LINE_RESET_TOKEN возвращается при каждом сбросе шаблона строки. Данные, возвращаемые в виде вершины, зависят от типа обратной связи.

В следующей таблице приведено соответствие между типом и числом значений для каждой вершины. k — 1 в режиме цветового индекса и 4 в режиме RGBA.

Тип	Координаты	Цвет	Текстура	Общее количество значений
GL_2D	x, y			2
GL_3D	x, y, z			3
GL_3D_COLOR	x, y, z	k		3 + k
GL_3D_COLOR_TEXTURE	x, y, z,	k	4	7 + k
GL_4D_COLOR_TEXTURE	x, y, z, w	k	4	8 + k

Координаты вершин обратной связи находятся в координатах окна, за исключением w, который находится в координатах клипа. Цвета обратной связи светятся, если освещение включено. Координаты текстур обратной связи создаются, если включено создание координат текстуры. Они всегда преобразуются матрицей текстуры.

Функция glFeedbackBuffer , используемая в отображаемом списке, не компилируется в отображаемый список, а выполняется немедленно.

Следующая функция извлекает сведения, связанные с glFeedbackBuffer:

glGet с аргументом GL_RENDER_MODE

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Заголовок	Gl.h
Библиотека	Opengl32.lib
DLL	Opengl32.dll

См. также раздел

glBegin
glEnd
glGet
glLineStipple
glPassThrough
glPolygonMode
glRenderMode
glSelectBuffer

Поделиться через