|
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! |
|
|
glPixelStoref, glPixelStorei
The glPixelStoref and glPixelStorei functions set pixel storage modes.
void glPixelStoref( GLenum pname, GLfloat param ); void glPixelStorei( GLenum pname, GLint param );
Parameters
pname
Specifies the symbolic name of the parameter to be set. Six values affect the packing of pixel data into memory: GL_PACK_SWAP_BYTES, GL_PACK_LSB_FIRST, GL_PACK_ROW_LENGTH, GL_PACK_SKIP_PIXELS, GL_PACK_SKIP_ROWS, and GL_PACK_ALIGNMENT. Six more affect the unpacking of pixel data from memory: GL_UNPACK_SWAP_BYTES, GL_UNPACK_LSB_FIRST, GL_UNPACK_ROW_LENGTH, GL_UNPACK_SKIP_PIXELS, GL_UNPACK_SKIP_ROWS, and GL_UNPACK_ALIGNMENT.
param
Specifies the value that pname is set to.
Remarks
The glPixelStore function sets pixel storage modes that affect the operation of subsequent glDrawPixels and glReadPixels as well as the unpacking of polygon stipple patterns (see glPolygonStipple), bitmaps (see glBitmap), and texture patterns (see glTexImage1D and glTexImage2D). The pname parameter is a symbolic constant indicating the parameter to be set, and param is the new value. Six of the twelve storage parameters affect how pixel data is returned to client memory, and are therefore significant only for glReadPixels commands. They are as follows:
GL_PACK_SWAP_BYTES
If true, byte ordering for multibyte color components, depth components, color indices, or stencil indices is reversed. That is, if a four-byte component is made up of bytes b (0) , b (1) , b (2) , b (3) , it is stored in memory as b (3) , b (2) , b (1) , b (0) if GL_PACK_SWAP_BYTES is true. GL_PACK_SWAP_BYTES has no effect on the memory order of components within a pixel, only on the order of bytes within components or indices. For example, the three components of a GL_RGB format pixel are always stored with red first, green second, and blue third, regardless of the value of GL_PACK_SWAP_BYTES.
GL_PACK_LSB_FIRST
If true, bits are ordered within a byte from least significant to most significant; otherwise, the first bit in each byte is the most significant one. This parameter is significant for bitmap data only.
GL_PACK_ROW_LENGTH
If greater than zero, GL_PACK_ROW_LENGTH defines the number of pixels in a row. If the first pixel of a row is placed at location p in memory, then the location of the first pixel of the next row is obtained by skipping
components or indices, where n is the number of components or indices in a pixel, l is the number of pixels in a row ( GL_PACK_ROW_LENGTH if it is greater than zero, the width argument to the pixel routine otherwise), a is the value of GL_PACK_ALIGNMENT, and s is the size, in bytes, of a single component (if a < s, then it is as if a = s). In the case of 1-bit values, the location of the next row is obtained by skipping
components or indices. The word component in this description refers to the nonindex values red, green, blue, alpha, and depth. Storage format GL_RGB, for example, has three components per pixel: first red, then green, and finally blue.
GL_PACK_SKIP_PIXELS and GL_PACK_SKIP_ROWS
These values are provided as a convenience to the programmer; they provide no functionality that cannot be duplicated simply by incrementing the pointer passed to glReadPixels. Setting GL_PACK_SKIP_PIXELS to i is equivalent to incrementing the pointer by i n components or indices, where n is the number of components or indices in each pixel. Setting GL_PACK_SKIP_ROWS to j is equivalent to incrementing the pointer by j k components or indices, where k is the number of components or indices per row, as computed above in the GL_PACK_ROW_LENGTH section.
GL_PACK_ALIGNMENT
Specifies the alignment requirements for the start of each pixel row in memory. The allowable values are 1 (byte-alignment), 2 (rows aligned to even-numbered bytes), 4 (word alignment), and 8 (rows start on double-word boundaries).
The other six of the twelve storage parameters affect how pixel data is read from client memory. These values are significant for glDrawPixels, glTexImage1D, glTexImage2D, glBitmap, and glPolygonStipple. They are as follows:
GL_UNPACK_SWAP_BYTES
If true, byte ordering for multibyte color components, depth components, color indices, or stencil indices is reversed. That is, if a four-byte component is made up of bytes b (0) , b (1) , b (2) , b (3) , it is taken from memory as b (3) , b (2) , b (1) , b (0) if GL_UNPACK_SWAP_BYTES is true. GL_UNPACK_SWAP_BYTES has no effect on the memory order of components within a pixel, only on the order of bytes within components or indices. For example, the three components of a GL_RGB format pixel are always stored with red first, green second, and blue third, regardless of the value of GL_UNPACK_SWAP_BYTES.
GL_UNPACK_LSB_FIRST
If true, bits are ordered within a byte from least significant to most significant; otherwise, the first bit in each byte is the most significant one. This is significant for bitmap data only.
GL_UNPACK_ROW_LENGTH
If greater than zero, GL_UNPACK_ROW_LENGTH defines the number of pixels in a row. If the first pixel of a row is placed at location p in memory, then the location of the first pixel of the next row is obtained by skipping
components or indices, where n is the number of components or indices in a pixel, l is the number of pixels in a row ( GL_UNPACK_ROW_LENGTH if it is greater than zero, the width argument to the pixel routine otherwise), a is the value of GL_UNPACK_ALIGNMENT, and s is the size, in bytes, of a single component (if a < s, then it is as if a = s). In the case of 1-bit values, the location of the next row is obtained by skipping
components or indices. The word component in this description refers to the nonindex values red, green, blue, alpha, and depth. Storage format GL_RGB, for example, has three components per pixel: first red, then green, and finally blue.
GL_UNPACK_SKIP_PIXELS and GL_UNPACK_SKIP_ROWS
These values are provided as a convenience to the programmer; they provide no functionality that cannot be duplicated simply by incrementing the pointer passed to glDrawPixels, glTexImage1D, glTexImage2D, glBitmap, or glPolygonStipple. Setting GL_UNPACK_SKIP_PIXELS to i is equivalent to incrementing the pointer by i n components or indices, where n is the number of components or indices in each pixel. Setting GL_UNPACK_SKIP_ROWS to j is equivalent to incrementing the pointer by j k components or indices, where k is the number of components or indices per row, as computed above in the GL_UNPACK_ROW_LENGTH section.
GL_UNPACK_ALIGNMENT
Specifies the alignment requirements for the start of each pixel row in memory. The allowable values are 1 (byte-alignment), 2 (rows aligned to even-numbered bytes), 4 (word alignment), and 8 (rows start on double-word boundaries).
The following table gives the type, initial value, and range of valid values for each of the storage parameters that can be set with glPixelStore.
Pname Type InitialValue Valid Range GL_PACK_SWAP_BYTES Boolean false true or false GL_PACK_SWAP_BYTES Boolean false true or false GL_PACK_ROW_LENGTH integer 0 [0,oo) GL_PACK_SKIP_ROWS integer 0 [0,oo) GL_PACK_SKIP_PIXELS integer 0 [0,oo) GL_PACK_ALIGNMENT integer 4 1, 2, 4, or 8 _ GL_UNPACK_SWAP_BYTES Boolean false true or false GL_UNPACK_LSB_FIRST Boolean false true or false GL_UNPACK_ROW_LENGTH integer 0 [0,oo) GL_UNPACK_SKIP_ROWS integer 0 [0,oo) GL_UNPACK_SKIP_PIXELS integer 0 [0,oo) GL_UNPACK_ALIGNMENT integer 4 1, 2, 4, or 8
The glPixelStoref function can be used to set any pixel store parameter. If the parameter type is Boolean, and if param is 0.0, the parameter is false; otherwise it is set to true. If pname is an integer type parameter, param is rounded to the nearest integer. Likewise, the glPixelStorei function can also be used to set any of the pixel store parameters. Boolean parameters are set to false if param is 0 and true otherwise. param is converted to floating point before being assigned to real-valued parameters.
The pixel storage modes in effect when glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glBitmap, or glPolygonStipple is placed in a display list control the interpretation of memory data. The pixel storage modes in effect when a display list is executed are not significant. The following functions retrieve information related to the glPixelStore function: glGet with argument GL_PACK_SWAP_BYTES
glGet with argument GL_PACK_LSB_FIRST glGet with argument GL_PACK_ROW_LENGTH glGet with argument GL_PACK_SKIP_ROWS glGet with argument GL_PACK_SKIP_PIXELS glGet with argument GL_PACK_ALIGNMENT glGet with argument GL_UNPACK_SWAP_BYTES glGet with argument GL_UNPACK_LSB_FIRST glGet with argument GL_UNPACK_ROW_LENGTH glGet with argument GL_UNPACK_SKIP_ROWS
glGet with argument GL_UNPACK_SKIP_PIXELS glGet with argument GL_UNPACK_ALIGNMENT
Errors
GL_INVALID_ENUM is generated if pname is not an accepted value. GL_INVALID_VALUE is generated if a negative row length, pixel skip, or row skip value is specified, or if alignment is specified as other than 1, 2, 4, or 8. GL_INVALID_OPERATION is generated if glPixelStore is called between a call to glBegin and the corresponding call to glEnd.
See Also
glBitmap, glDrawPixels, glPixelMap, glPixelTransfer, glPixelZoom, glPolygonStipple, glReadPixels, glTexImage1D, glTexImage2D
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
| Пригласи друзей и счет твоего мобильника всегда будет положительным! |
glPixelStoref, glPixelStorei
glPixelStoref И функции glPixelStorei были установлены способы хранения пикселя.
пустота glPixelStoref( GLenum pname, GLfloat param ); пустота glPixelStorei( GLenum pname, БЛЕСК param );
Параметры
pname
Определяет символическое имя параметра, который нужно быть установлен. Шесть величин влияют на упаковку данных пикселя в память: GL_PACK_SWAP_BYTES, GL_PACK_LSB_FIRST, GL_PACK_ROW_LENGTH, GL_PACK_SKIP_PIXELS, GL_PACK_SKIP_ROWS, и GL_PACK_ALIGNMENT. Шесть более влияют на распаковку данных пикселя из памяти: GL_UNPACK_SWAP_BYTES, GL_UNPACK_LSB_FIRST, GL_UNPACK_ROW_LENGTH, GL_UNPACK_SKIP_PIXELS, GL_UNPACK_SKIP_ROWS, и GL_UNPACK_ALIGNMENT.
param
Определяет величину, что pname установлен, чтобы.
Замечания
Функция glPixelStore устанавливает режимы памяти пикселя на которые влияют операцию последующих glDrawPixels и glReadPixels, а также распаковка многоугольника изображает пунктиром образцы (смотри glPolygonStipple), побитовые отображения (смотри glBitmap), и образцы текстуры (смотри glTexImage1D и glTexImage2D). Параметр pname является символической константой, указывающей параметр, который нужно быть установлен, и param - новая величина. Шесть из двенадцати параметров памяти влияют на как данные пикселя возвращан в память клиента, и следовательно значимый только для команд glReadPixels. Они - следующим образом:
GL_PACK_SWAP_BYTES
Если истина, байт, заказывающиеся для многобайтовых цветных компонентов, глубинных компонентов, цветных индексов, или индексы шаблона возобновлены. То есть, если четырех байтовый компонент состоит из байтов b (0) , b (1) , b (2) , b (3) , он загружен в память как b (3) , b (2) , b (1) , b (0) если GL_PACK_SWAP_BYTES - истина. GL_PACK_SWAP_BYTES не имеет эффект в порядке памяти компонентов в пределах пикселя, только в порядке байтов в пределах компонентов или индексов. Например, три компонента пикселя формата GL_RGB всегда загружены красной первой, зеленой секундой, и синей третьей, независимо от величины GL_PACK_SWAP_BYTES.
GL_PACK_LSB_FIRST
Если истина, биты заказаны в пределах байта из наименее значимый, чтобы наиболее значимый; в противном случае, первый бит в каждом байте - наиболее значимый. Этот параметр значимый для данных побитового отображения только.
GL_PACK_ROW_LENGTH
Если больше, чем нуль, GL_PACK_ROW_LENGTH определяет количество пикселей подряд. Если сначала пиксель колонки установлен в позиции p в памяти, затем позиция первого пикселя следующей колонки получена пропуском
компоненты или индексы, где n - количество компонентов или индексов на пикселе, l - количество пикселей в колонке ( GL_PACK_ROW_LENGTH если это больше, чем нуль, широтный аргумент в программу пикселя в противном случае), - величина GL_PACK_ALIGNMENT, и s - размер, в байтах, единственного компонента (если < s, тогда это - как будто = s). В случае 1- битовых величин, позиция следующей колонки получена пропуском
компоненты или индексы. Текстовый компонент в этом описании имеет отношение к величинам nonindex красным, зеленым, синим, буквенным, и глубинным. Формат Памяти GL_RGB, например, имеет три компонента за пиксель: сначала красный, затем зеленый, и наконец синий.
GL_PACK_SKIP_PIXELS и GL_PACK_SKIP_ROWS
Эти величины предусмотрены как удобство программисту; они не обеспечивают никакое функциональное назначение, которое не может дублироваться просто увеличивая указатель проходил на glReadPixels. Установка GL_PACK_SKIP_PIXELS на i - эквивалент приращению указателя n компонентами i или индексы, где n - количество компонентов или индексов на каждом пикселе. Установка GL_PACK_SKIP_ROWS на j - эквивалент приращению указателя k компонентами j или индексы, где k - количество компонентов или индексов за колонку, как вычислено выше в секции GL_PACK_ROW_LENGTH.
GL_PACK_ALIGNMENT
Определяет требования выравнивания для начала каждой колонки пикселя в памяти. Допустимые величины - 1 (байтовое-выравнивание), 2 (колонки выравнивались на даже-перечислившее байты), 4 (текстовое выравнивание), и 8 (начало колонок на двойных-текстовых границах).
Другие шесть из двенадцати параметров памяти влияют на как данные пикселя прочитан из памяти клиента. Эти величины значимые для glDrawPixels, glTexImage1D, glTexImage2D, glBitmap, и glPolygonStipple. Они - следующим образом:
GL_UNPACK_SWAP_BYTES
Если истина, байт, заказывающиеся для многобайтовых цветных компонентов, глубинных компонентов, цветных индексов, или индексы шаблона возобновлены. То есть, если четырех байтовый компонент состоит из байтов b (0) , b (1) , b (2) , b (3) , он взят из памяти как b (3) , b (2) , b (1) , b (0) если GL_UNPACK_SWAP_BYTES - истина. GL_UNPACK_SWAP_BYTES не имеет эффект в порядке памяти компонентов в пределах пикселя, только в порядке байтов в пределах компонентов или индексов. Например, три компонента пикселя формата GL_RGB всегда загружены красной первой, зеленой секундой, и синей третьей, независимо от величины GL_UNPACK_SWAP_BYTES.
GL_UNPACK_LSB_FIRST
Если истина, биты заказаны в пределах байта из наименее значимый, чтобы наиболее значимый; в противном случае, первый бит в каждом байте - наиболее значимый. Это значимое для данных побитового отображения только.
GL_UNPACK_ROW_LENGTH
Если больше, чем нуль, GL_UNPACK_ROW_LENGTH определяет количество пикселей подряд. Если сначала пиксель колонки установлен в позиции p в памяти, затем позиция первого пикселя следующей колонки получена пропуском
компоненты или индексы, где n - количество компонентов или индексов на пикселе, l - количество пикселей в колонке ( GL_UNPACK_ROW_LENGTH если это больше, чем нуль, широтный аргумент в программу пикселя в противном случае), - величина GL_UNPACK_ALIGNMENT, и s - размер, в байтах, единственного компонента (если < s, тогда это - как будто = s). В случае 1- битовых величин, позиция следующей колонки получена пропуском
компоненты или индексы. Текстовый компонент в этом описании имеет отношение к величинам nonindex красным, зеленым, синим, буквенным, и глубинным. Формат Памяти GL_RGB, например, имеет три компонента за пиксель: сначала красный, затем зеленый, и наконец синий.
GL_UNPACK_SKIP_PIXELS и GL_UNPACK_SKIP_ROWS
Эти величины предусмотрены как удобство программисту; они не обеспечивают никакое функциональное назначение, которое не может дублироваться просто увеличивая указатель проходил на glDrawPixels, glTexImage1D, glTexImage2D, glBitmap, или glPolygonStipple. Установка GL_UNPACK_SKIP_PIXELS на i - эквивалент приращению указателя n компонентами i или индексы, где n - количество компонентов или индексов на каждом пикселе. Установка GL_UNPACK_SKIP_ROWS на j - эквивалент приращению указателя k компонентами j или индексы, где k - количество компонентов или индексов за колонку, как вычислено выше в секции GL_UNPACK_ROW_LENGTH.
GL_UNPACK_ALIGNMENT
Определяет требования выравнивания для начала каждой колонки пикселя в памяти. Допустимые величины - 1 (байтовое-выравнивание), 2 (колонки выравнивались на даже-перечислившее байты), 4 (текстовое выравнивание), и 8 (начало колонок на двойных-текстовых границах).
Следующая таблица дает тип, начальную величину, и дипазон правильных величин для каждых параметров памяти, которые могут быть установлены glPixelStore.
Тип Pname Правильного Дипазона InitialValue Логической ложной истины GL_PACK_SWAP_BYTES или Логической ложной истины лжи GL_PACK_SWAP_BYTES или ложного целого GL_PACK_ROW_LENGTH 0 [0,oo) целое GL_PACK_SKIP_ROWS 0 [0,oo) целое GL_PACK_SKIP_PIXELS 0 [0,oo) целое GL_PACK_ALIGNMENT 4 1, 2, 4, или 8 _ Логическая ложная истина GL_UNPACK_SWAP_BYTES или Логическая ложная истина лжи GL_UNPACK_LSB_FIRST или ложного целого GL_UNPACK_ROW_LENGTH 0 [0,oo) целое GL_UNPACK_SKIP_ROWS 0 [0,oo) целое GL_UNPACK_SKIP_PIXELS 0 [0,oo) целое GL_UNPACK_ALIGNMENT 4 1, 2, 4, или 8
Функция glPixelStoref может быть использована, чтобы устанавливать любой параметр загрузки пикселя. Если тип параметра - Логический, и если param - 0.0, параметр ложный; в противном случае установлено в истину. Если pname - параметр типа целого, param округлен в ближайшее целое. Подобно, функция glPixelStorei может также использована, чтобы устанавливать любой из параметров загрузки пикселя. Логические параметры установлены в ложь если param - 0 и истина otherwise. param преобразована на поплававшее точка прежде, чем назначенное в реальный ценные параметры.
Режимы памяти пикселя в силе когда glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glBitmap, или glPolygonStipple установлен на дисплейном управлении списка интерпретация данных памяти. Режимы памяти пикселя в силе когда дисплейный список выполнен, не значимые. Следующее функций извлекает информацию имело отношение к функции glPixelStore: glGet С аргументом GL_PACK_SWAP_BYTES
glGet С аргументом GL_PACK_LSB_FIRST glGet с аргументом GL_PACK_ROW_LENGTH glGet с аргументом GL_PACK_SKIP_ROWS glGet с аргументом GL_PACK_SKIP_PIXELS glGet с аргументом GL_PACK_ALIGNMENT glGet с аргументом GL_UNPACK_SWAP_BYTES glGet с аргументом GL_UNPACK_LSB_FIRST glGet с аргументом GL_UNPACK_ROW_LENGTH glGet с аргументом GL_UNPACK_SKIP_ROWS
glGet С аргументом GL_UNPACK_SKIP_PIXELS glGet с аргументом GL_UNPACK_ALIGNMENT
Ошибки
GL_INVALID_ENUM сгенерирован если pname - не допустимая величина. GL_INVALID_VALUE сгенерирован если отрицательная длина колонки, пропуск пикселя, или величина пропуска колонки определена, или если выравнивание определено как кроме 1, 2, 4, или 8. GL_INVALID_OPERATION сгенерирован если glPixelStore назван между вызовом на glBegin и соответствующий вызов на glEnd.
Смотри Также
glBitmap, glDrawPixels, glPixelMap, glPixelTransfer, glPixelZoom, glPolygonStipple, glReadPixels, glTexImage1D, glTexImage2D
| |
|
|
| |