На главную

On-line справка по OpenGL

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-L-M-N-O-P-R-S-T-U-V-W | Скачать Вниз

glReadPixels



The glReadPixels function reads a block of pixels from the frame buffer.

void glReadPixels(
GLint x,
GLint y,
GLsizei width,
GLsizei height,
GLenum format,
GLenum type,
GLvoid *pixels
);

Parameters

x, y

Specify the window coordinates of the first pixel that is read from the frame buffer. This location is the lower left corner of a rectangular block of pixels.

width, height

Specify the dimensions of the pixel rectangle. The width and height parameters of one correspond to a single pixel.

format

Specifies the format of the pixel data. The following symbolic values are accepted: GL_COLOR_INDEX, GL_STENCIL_INDEX, GL_DEPTH_COMPONENT, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_LUMINANCE, and GL_LUMINANCE_ALPHA.

type

Specifies the data type of the pixel data. Must be one of GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, or GL_FLOAT.

pixels

Returns the pixel data.

Remarks

The glReadPixels function returns pixel data from the frame buffer, starting with the pixel whose lower left corner is at location (
x, y), into client memory starting at location pixels. Several parameters control the processing of the pixel data before it is placed into client memory. These parameters are set with three commands: glPixelStore, glPixelTransfer, and glPixelMap. This topic describes the effects on glReadPixels of most, but not all of the parameters specified by these three commands.

The glReadPixels function returns values from each pixel with lower left-hand corner at (x + i, y + j) for 0Јiheight. This pixel is said to be the ith pixel in the jth row. Pixels are returned in row order from the lowest to the highest row, left to right in each row.
The format parameter specifies the format for the returned pixel values. Accepted values for format are as follows:

GL_COLOR_INDEX

Color indices are read from the color buffer selected by glReadBuffer. Each index is converted to fixed point, shifted left or right depending on the value and sign of GL_INDEX_SHIFT, and added to GL_INDEX_OFFSET. If GL_MAP_COLOR is GL_TRUE, indices are replaced by their mappings in the table GL_PIXEL_MAP_I_TO_I.

GL_STENCIL_INDEX

Stencil values are read from the stencil buffer. Each index is converted to fixed point, shifted left or right depending on the value and sign of GL_INDEX_SHIFT, and added to GL_INDEX_OFFSET. If GL_MAP_STENCIL is GL_TRUE, indices are replaced by their mappings in the table GL_PIXEL_MAP_S_TO_S.

GL_DEPTH_COMPONENT

Depth values are read from the depth buffer. Each component is converted to floating point such that the minimum depth value maps to 0.0 and the maximum value maps to 1.0. Each component is then multiplied by GL_DEPTH_SCALE, added to GL_DEPTH_BIAS, and finally clamped to the range [0,1].

GL_RED
GL_GREEN
GL_BLUE
GL_ALPHA
GL_RGB
GL_RGBA
GL_LUMINANCE
GL_LUMINANCE_ALPHA

Processing differs depending on whether color buffers store color indices or RGBA color components. If color indices are stored, they are read from the color buffer selected by glReadBuffer. Each index is converted to fixed point, shifted left or right depending on the value and sign of GL_INDEX_SHIFT, and added to GL_INDEX_OFFSET. Indices are then replaced by the red, green, blue, and alpha values obtained by indexing the GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B, and GL_PIXEL_MAP_I_TO_A tables.

If RGBA color components are stored in the color buffers, they are read from the color buffer selected by glReadBuffer. Each color component is converted to floating point such that zero intensity maps to 0.0 and full intensity maps to 1.0. Each component is then multiplied by GL_c_SCALE and added to GL_c_BIAS, where c is GL_RED, GL_GREEN, GL_BLUE, and GL_ALPHA. Each component is clamped to the range [0,1]. Finally, if GL_MAP_COLOR is GL_TRUE, each color component c is replaced by its mapping in the table GL_PIXEL_MAP_c_TO_c, where c again is GL_RED, GL_GREEN, GL_BLUE, and GL_ALPHA. Each component is scaled to the size of its corresponding table before the lookup is performed.

Finally, unneeded data is discarded. For example, GL_RED discards the green, blue, and alpha components, while GL_RGB discards only the alpha component. GL_LUMINANCE computes a single component value as the sum of the red, green, and blue components, and GL_LUMINANCE_ALPHA does the same, while keeping alpha as a second value.



The shift, scale, bias, and lookup factors described above are all specified by glPixelTransfer. The lookup table contents themselves are specified by glPixelMap.
The final step involves converting the indices or components to the proper format, as specified by type. If format is GL_COLOR_INDEX or GL_STENCIL_INDEX and type is not GL_FLOAT, each index is masked with the mask value given in the following table. If type is GL_FLOAT, then each integer index is converted to single-precision floating-point format.

If format is GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_LUMINANCE, or GL_LUMINANCE_ALPHA and type is not GL_FLOAT, each component is multiplied by the multiplier shown in the following table. If type is GL_FLOAT, then each component is passed as is (or converted to the clients single-precision floating-point format if it is different from the one used by the GL).

Type Index Mask ComponentConversion
GL_UNSIGNED_BYTE 2^8-1 (2^8-1)c
GL_BYTE 2^7-1 [2^7-1]c-1]/2
GL_BITMAP 1 1
GL_UNSIGNED_SHORT 2^16-1 (2^16-1) c
GL_SHORT 2^15-1 [(2^15-1) c-1] / 2
GL_UNSIGNED_INT 2^32-1 (2^32-1) c
GL_INT 2^31-1 [(2^31-1) c-1] / 2
GL_FLOAT none c


Return values are placed in memory as follows. If format is GL_COLOR_INDEX, GL_STENCIL_INDEX, GL_DEPTH_COMPONENT, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, or GL_LUMINANCE, a single value is returned and the data for the ith pixel in the jth row is placed in location (j) width + i. GL_RGB returns three values, GL_RGBA returns four values, and GL_LUMINANCE_ALPHA returns two values for each pixel, with all values corresponding to a single pixel occupying contiguous space in pixels. Storage parameters set by glPixelStore, such as GL_PACK_SWAP_BYTES and GL_PACK_LSB_FIRST, affect the way that data is written into memory. See glPixelStore for a description.

Values for pixels that lie outside the window connected to the current GL context are undefined.
If an error is generated, no change is made to the contents of pixels.
The following function retrieves information related to the glReadPixels function:
glGet with argument GL_INDEX_MODE


Errors

GL_INVALID_ENUM is generated if format or type is not an accepted value.
GL_INVALID_VALUE is generated if either width or height is negative.
GL_INVALID_OPERATION is generated if format is GL_COLOR_INDEX and the color buffers store RGBA color components.
GL_INVALID_OPERATION is generated if format is GL_STENCIL_INDEX and there is no stencil buffer.
GL_INVALID_OPERATION is generated if format is GL_DEPTH_COMPONENT and there is no depth buffer.

GL_INVALID_OPERATION is generated if glReadPixels is called between a call to glBegin and the corresponding call to glEnd.

See Also

glCopyPixels, glDrawPixels, glPixelMap, glPixelStore, glPixelTransfer, glReadBuffer



Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

glReadPixels



Функция glReadPixels читает блока пикселей из фреймового буфера.

пустота glReadPixels( БЛЕСК x, БЛЕСК y, ширина GLsizei, высота GLsizei, формат GLenum, тип GLenum, GLvoid *пиксели
);

Параметры

x, y

Определите координаты окна первого пикселя, которые прочитаны из фреймового буфера. Эта позиция является более низким левым углом прямоугольного блока пикселей.

ширина, высота

Определите измерения прямоугольника пикселя. Широтные и параметры высоты одного переписываются на единственный пиксель.

формат

Определяет формат данных пикселя. Следующие символические величины приняты: GL_COLOR_INDEX, GL_STENCIL_INDEX, GL_DEPTH_COMPONENT, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_LUMINANCE, и GL_LUMINANCE_ALPHA.

тип

Определяет тип данных данных пикселя. Должно быть одно из GL_UNSIGNED_BYTE, GL_BYTE, GL_BITMAP, GL_UNSIGNED_SHORT, GL_SHORT, GL_UNSIGNED_INT, GL_INT, или GL_FLOAT.

пиксели

Возвращает данные пикселя.

Замечания

Функция glReadPixels возвращает данные пикселя из фреймовый буфер, начинающие с пикселя чье уменьшать оставившее угол - в позиции (
x, y), в память клиента, запускающуюся на пикселях позиции. Несколько параметров управляют обработкой данных пикселя прежде, чем будет установлено в память клиента. Эти параметры установлены тремя командами: glPixelStore, glPixelTransfer, и glPixelMap. Эта тема описывает эффекты на glReadPixels большинство, но не все параметры определялись этими тремя командами.

Функция glReadPixels возвращает величины с каждого пикселя с более низким левым углом в (x + я, y + j) для 0iПараметр формата определяет формат для возвращанных величин пикселя. Допустимые величины для формата - следующим образом:

GL_COLOR_INDEX

Цветные индексы прочитаны из цветного буфера выбранного glReadBuffer. Каждый индекс преобразован на установившее точку, перемещенную левую или правую в зависимости от величины и признака GL_INDEX_SHIFT, и добавленных к GL_INDEX_OFFSET. Если GL_MAP_COLOR - GL_TRUE, индексы заменены их распределениями в таблице GL_PIXEL_MAP_I_TO_I.

GL_STENCIL_INDEX

Величины Шаблона прочитаны из буфера шаблона. Каждый индекс преобразован на установившее точку, перемещенную левую или правую в зависимости от величины и признака GL_INDEX_SHIFT, и добавленных к GL_INDEX_OFFSET. Если GL_MAP_STENCIL - GL_TRUE, индексы заменены их распределениями в таблице GL_PIXEL_MAP_S_TO_S.

GL_DEPTH_COMPONENT

Глубинные величины прочитаны из глубинного буфера. Каждый компонент преобразован на поплававшее точка так что минимальная глубинная величина отображается на 0.0 и максимальные карты величины на 1.0. Каждый компонент - затем умноженное на GL_DEPTH_SCALE, добавленное к GL_DEPTH_BIAS, и наконец скрепленное в дипазон [0,1].

GL_RED GL_GREEN GL_BLUE GL_ALPHA GL_RGB GL_RGBA GL_LUMINANCE GL_LUMINANCE_ALPHA

Обработка отличается или цветная загрузка цветных индексов буферов или цветных компонентов RGBA. Если цветные индексы загружены, они прочитаны из цветного буфера выбранного glReadBuffer. Каждый индекс преобразован на установившее точку, перемещенную левую или правую в зависимости от величины и признака GL_INDEX_SHIFT, и добавленных к GL_INDEX_OFFSET. Индексы - затем замененное красным, зеленым, синим, и буквенные величины получали индексированием GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B, и таблицами GL_PIXEL_MAP_I_TO_A.

Если цветные компоненты RGBA загружены в цветные буферы, они прочитаны из цветного буфера выбранного glReadBuffer. Каждый цветной компонент преобразован на поплававшее точка так что нулевая интенсивность отображается на 0.0 и полные карты интенсивности на 1.0. Каждый компонент - затем умноженное на GL_c_SCALE и добавленное к GL_c_BIAS, где c - GL_RED, GL_GREEN, GL_BLUE, и GL_ALPHA. Каждый компонент скреплен в дипазон [0,1]. Наконец, если GL_MAP_COLOR - GL_TRUE, каждый цветной компонент c заменен своим распределением в таблице GL_PIXEL_MAP_c_TO_c, где c снова - GL_RED, GL_GREEN, GL_BLUE, и GL_ALPHA. Каждый компонент масштабирован по величине с своей соответствующей таблицей прежде, чем поиск будет выполнен.

Наконец, ненужные данные отвергнуты. Например, GL_RED отвергает зеленые, синие, и буквенные компоненты, тогда как GL_RGB отвергает только буквенный компонент. GL_LUMINANCE вычисляет единственную компонентную величину как сумму красных, зеленых, и синих компонентов, и GL_LUMINANCE_ALPHA делает тот же, при хранении альфы как величина секунды.



Сдвиг, шкала, смещение, и показатели поиска описанные выше полностью определены glPixelTransfer. Само табличное содержание поиска определено glPixelMap.
Конечный шаг включает преобразовывая индексы или компоненты в соответствующий формат, как определено типом. Если формат - GL_COLOR_INDEX или GL_STENCIL_INDEX и тип - не GL_FLOAT, каждый индекс замаскирован величиной маски данной в следующей таблице. Если тип - GL_FLOAT, тогда каждый индекс целого преобразован в единственную-плавающую точку прецизионного формата.

Если формат - GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, GL_RGB, GL_RGBA, GL_LUMINANCE, или GL_LUMINANCE_ALPHA и тип - не GL_FLOAT, каждый компонент умножен на множитель показанный в следующей таблице. Если тип - GL_FLOAT, тогда каждый компонент пройден как (или преобразован клиентам единственная-плавающая точка прецизионного формата если он отличается от один использованное GL).

Индексная Маска Типа ComponentConversion GL_UNSIGNED_BYTE 2^8-1 (2^8-1)c GL_BYTE 2^7-1 [2^7-1]c-1]/2 GL_BITMAP 1 1
GL_UNSIGNED_SHORT 2^16-1 (2^16-1) c GL_SHORT 2^15-1 [(2^15-1) c-1] / 2 GL_UNSIGNED_INT 2^32-1 (2^32-1) c GL_INT 2^31-1 [(2^31-1) c-1] / 2 GL_FLOAT никакого c


Обратные величины установлены в памяти следующим образом. Если формат - GL_COLOR_INDEX, GL_STENCIL_INDEX, GL_DEPTH_COMPONENT, GL_RED, GL_GREEN, GL_BLUE, GL_ALPHA, или GL_LUMINANCE, единственная величина возвращана и данные для ith пикселя в jth колонке установлены в позиции (j) ширине + возврат i. GL_RGB три величины, возврат GL_RGBA четыре величины, и возврат GL_LUMINANCE_ALPHA две величины для каждого пикселя, со всеми величинами, соответствуемыми на единственный пиксель, занимающий непрерывное пространство на пикселях. Параметры Памяти были установлены glPixelStore, как например, GL_PACK_SWAP_BYTES и GL_PACK_LSB_FIRST, влиять на путь, который данные записаны в память. Смотри glPixelStore для описания.

Величины для пикселей, которые лежат за пределами окна подключенного к текущему контексту GL неопределенные.
Если ошибка сгенерирована, никакое изменение не сделано на содержание пикселей.
Следующее функции извлекает информацию имело отношение к функции glReadPixels:
glGet С аргументом GL_INDEX_MODE


Ошибки

GL_INVALID_ENUM сгенерирован если формат или тип - не допустимая величина.
GL_INVALID_VALUE сгенерирован если или ширина или высота отрицательное.
GL_INVALID_OPERATION сгенерирован если формат является GL_COLOR_INDEX и цветной загрузкой цветных компонентов буферов RGBA.
GL_INVALID_OPERATION сгенерирован если формат - GL_STENCIL_INDEX и нет буфера шаблона.
GL_INVALID_OPERATION сгенерирован если формат - GL_DEPTH_COMPONENT и нет глубинного буфера.

GL_INVALID_OPERATION сгенерирован если glReadPixels назван между вызовом на glBegin и соответствующий вызов на glEnd.

Смотри Также

glCopyPixels, glDrawPixels, glPixelMap, glPixelStore, glPixelTransfer, glReadBuffer



Вверх Version 1.1, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод Win32 API  Русский перевод OpenGL
 
Hosted by uCoz