| |||
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! | |||
| |||
glPixelTransferf, glPixelTransferiThe glPixelTransferf and glPixelTransferi functions set pixel transfer modes. void glPixelTransferf( GLenum pname, GLfloat param ); void glPixelTransferi( GLenum pname, GLint param ); Parameters pname Specifies the symbolic name of the pixel transfer parameter to be set. Must be one of the following: GL_MAP_COLOR, GL_MAP_STENCIL, GL_INDEX_SHIFT, GL_INDEX_OFFSET, GL_RED_SCALE, GL_RED_BIAS, GL_GREEN_SCALE, GL_GREEN_BIAS, GL_BLUE_SCALE, GL_BLUE_BIAS, GL_ALPHA_SCALE, GL_ALPHA_BIAS, GL_DEPTH_SCALE, or GL_DEPTH_BIAS. param Specifies the value that pname is set to. Remarks The glPixelTransfer function sets pixel transfer modes that affect the operation of subsequent glDrawPixels, glReadPixels, glCopyPixels, glTexImage1D, and glTexImage2D commands. The algorithms that are specified by pixel transfer modes operate on pixels after they are read from the frame buffer (glReadPixels and glCopyPixels) or unpacked from client memory ( glDrawPixels, glTexImage1D, and glTexImage2D). Pixel transfer operations happen in the same order, and in the same manner, regardless of the command that resulted in the pixel operation. Pixel storage modes (glPixelStore) control the unpacking of pixels being read from client memory, and the packing of pixels being written back into client memory. Pixel transfer operations handle four fundamental pixel types: color, color index, depth, and stencil. Color pixels are made up of four floating-point values with unspecified mantissa and exponent sizes, scaled such that 0.0 represents zero intensity and 1.0 represents full intensity. Color indices comprise a single fixed-point value, with unspecified precision to the right of the binary point. Depth pixels comprise a single floating-point value, with unspecified mantissa and exponent sizes, scaled such that 0.0 represents the minimum depth buffer value, and 1.0 represents the maximum depth buffer value. Finally, stencil pixels comprise a single fixed-point value, with unspecified precision to the right of the binary point. The pixel transfer operations performed on the four basic pixel types are as follows: Color Each of the four color components is multiplied by a scale factor, then added to a bias factor. That is, the red component is multiplied by GL_RED_SCALE, then added to GL_RED_BIAS; the green component is multiplied by GL_GREEN_SCALE, then added to GL_GREEN_BIAS; the blue component is multiplied by GL_BLUE_SCALE, then added to GL_BLUE_BIAS; and the alpha component is multiplied by GL_ALPHA_SCALE, then added to GL_ALPHA_BIAS. After all four color components are scaled and biased, each is clamped to the range [0,1]. All color scale and bias values are specified with glPixelTransfer. If GL_MAP_COLOR is true, each color component is scaled by the size of the corresponding color-to-color map, then replaced by the contents of that map indexed by the scaled component. That is, the red component is scaled by GL_PIXEL_MAP_R_TO_R_SIZE, then replaced by the contents of GL_PIXEL_MAP_R_TO_R indexed by itself. The green component is scaled by GL_PIXEL_MAP_G_TO_G_SIZE, then replaced by the contents of GL_PIXEL_MAP_G_TO_G indexed by itself. The blue component is scaled by GL_PIXEL_MAP_B_TO_B_SIZE, then replaced by the contents of GL_PIXEL_MAP_B_TO_B indexed by itself. And the alpha component is scaled by GL_PIXEL_MAP_A_TO_A_SIZE, then replaced by the contents of GL_PIXEL_MAP_A_TO_A indexed by itself. All components taken from the maps are then clamped to the range [0,1]. GL_MAP_COLOR is specified with glPixelTransfer. The contents of the various maps are specified with glPixelMap. Color index Each color index is shifted left by GL_INDEX_SHIFT bits, filling with zeros any bits beyond the number of fraction bits carried by the fixed-point index. If GL_INDEX_SHIFT is negative, the shift is to the right, again zero filled. Then GL_INDEX_OFFSET is added to the index. GL_INDEX_SHIFT and GL_INDEX_OFFSET are specified with glPixelTransfer . From this point, operation diverges depending on the required format of the resulting pixels. If the resulting pixels are to be written to a color index buffer, or if they are being read back to client memory in GL_COLOR_INDEX format, the pixels continue to be treated as indices. If GL_MAP_COLOR is true, each index is masked by 2^n - 1, where n is GL_PIXEL_MAP_I_TO_I_SIZE, then replaced by the contents of GL_PIXEL_MAP_I_TO_I indexed by the masked value. GL_MAP_COLOR is specified with glPixelTransfer. The contents of the index map are specified with glPixelMap. If the resulting pixels are to be written to an RGBA color buffer, or if they are being read back to client memory in a format other than GL_COLOR_INDEX, the pixels are converted from indices to colors by referencing the four maps 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. Before being dereferenced, the index is masked by 2n - 1, where n is GL_PIXEL_MAP_I_TO_R_SIZE for the red map, GL_PIXEL_MAP_I_TO_G_SIZE for the green map, GL_PIXEL_MAP_I_TO_B_SIZE for the blue map, and GL_PIXEL_MAP_I_TO_A_SIZE for the alpha map. All components taken from the maps are then clamped to the range [0,1]. The contents of the four maps are specified with glPixelMap. Depth Each depth value is multiplied by GL_DEPTH_SCALE, added to GL_DEPTH_BIAS, then clamped to the range [0,1]. Stencil Each index is shifted GL_INDEX_SHIFT bits just as a color index is, then added to GL_INDEX_OFFSET. If GL_MAP_STENCIL is true, each index is masked by 2^n - 1, where n is GL_PIXEL_MAP_S_TO_S_SIZE, then replaced by the contents of GL_PIXEL_MAP_S_TO_S indexed by the masked value. The following table gives the type, initial value, and range of valid values for each of the pixel transfer parameters that are set with glPixelTransfer. Pname Type InitialValue Valid Range GL_MAP_COLOR Boolean false true/false GL_MAP_STENCIL Boolean false true/false GL_INDEX_SHIFT integer 0 ( - oo,oo) GL_INDEX_OFFSET integer 0 ( - oo,oo) GL_RED_SCALE float 1.0 ( - oo,oo) GL_GREEN_SCALE float 1.0 ( - oo,oo) GL_BLUE_SCALE float 1.0 ( - oo,oo) GL_ALPHA_SCALE float 1.0 ( - oo,oo) GL_DEPTH_SCALE float 1.0 ( - oo,oo) GL_RED_BIAS float 0.0 ( - oo,oo) GL_GREEN_BIAS float 0.0 ( - oo,oo) GL_BLUE_BIAS float 0.0 ( - oo,oo) GL_ALPHA_BIAS float 0.0 ( - oo,oo) GL_DEPTH_BIAS float 0.0 ( - oo,oo) The glPixelTransferf function can be used to set any pixel transfer parameter. If the parameter type is Boolean, 0.0 implies false and any other value implies true. If pname is an integer parameter, param is rounded to the nearest integer. Likewise, glPixelTransferi can also be used to set any of the pixel transfer 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. If a glDrawPixels, glReadPixels, glCopyPixels, glTexImage1D, or glTexImage2D command is placed in a display list (see glNewList and glCallList), the pixel transfer mode settings in effect when the display list is executed are the ones that are used. They may be different from the settings when the command was compiled into the display list. The following functions retrieve information related to the glPixelTransfer function: glGet with argument GL_MAP_COLOR glGet with argument GL_MAP_STENCIL glGet with argument GL_INDEX_SHIFT glGet with argument GL_INDEX_OFFSET glGet with argument GL_RED_SCALE glGet with argument GL_RED_BIAS glGet with argument GL_GREEN_SCALE glGet with argument GL_GREEN_BIAS glGet with argument GL_BLUE_SCALE glGet with argument GL_BLUE_BIAS glGet with argument GL_ALPHA_SCALE glGet with argument GL_ALPHA_BIAS glGet with argument GL_DEPTH_SCALE glGet with argument GL_DEPTH_BIAS Errors GL_INVALID_ENUM is generated if pname is not an accepted value. GL_INVALID_OPERATION is generated if glPixelTransfer is called between a call to glBegin and the corresponding call to glEnd. See Also glCallList, glCopyPixels, glDrawPixels, glNewList, glPixelMap, glPixelStore, glPixelZoom, glReadPixels, glTexImage1D, glTexImage2D | |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
| |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
glPixelTransferf, glPixelTransferiglPixelTransferf И функции glPixelTransferi были установлены способы передачи пикселя. пустота glPixelTransferf( GLenum pname, GLfloat param ); пустота glPixelTransferi( GLenum pname, БЛЕСК param ); Параметры pname Определяет символическое имя параметра передачи пикселя, который нужно быть установлен. Должно быть одним из следующего: GL_MAP_COLOR, GL_MAP_STENCIL, GL_INDEX_SHIFT, GL_INDEX_OFFSET, GL_RED_SCALE, GL_RED_BIAS, GL_GREEN_SCALE, GL_GREEN_BIAS, GL_BLUE_SCALE, GL_BLUE_BIAS, GL_ALPHA_SCALE, GL_ALPHA_BIAS, GL_DEPTH_SCALE, или GL_DEPTH_BIAS. param Определяет величину, что pname установлен, чтобы. Замечания Функция glPixelTransfer устанавливает способы передачи пикселя на которые влияют действие последующих glDrawPixels, glReadPixels, glCopyPixels, glTexImage1D, и команд glTexImage2D. Алгоритмы, которые определены режимами передачи пикселя действовать на пикселях после того, как они будут прочитаны из фреймового буфера (glReadPixels и glCopyPixels) или распакованное из памяти клиента ( glDrawPixels, glTexImage1D, и glTexImage2D). Операции передачи Пикселя случаются в той же последовательности, и так же, независимо от командовать, что закончиться операцией пикселя. Режимы памяти Пикселя (glPixelStore) управляют распаковкой пикселей, прочитать из памяти клиента, и упаковки пикселей, записыванных снова в память клиента. Операции передачи Пикселя оперируют четыре фундаментальных типа пикселя: цветной, цветной индекс, глубина, и шаблон. Цветные пиксели состоят из четырех плавающих точек величин с неопределенной мантиссой и размерами показателя, масштабированными так что 0.0 представляет нулевую интенсивность и 1.0 представляет полную интенсивность. Цветные индексы включают фиксированную точку единственной величины, с неопределенной точностью вправо от двоичной точки. Глубинные пиксели включают плавающую точку единственной величины, с неопределенной мантиссой и размерами показателя, масштабированными так что 0.0 представляет минимальную глубинную буферную величину, и 1.0 представляет максимальную глубинную буферную величину. Наконец, пиксели шаблона включают фиксированную точку единственной величины, с неопределенной точностью вправо от двоичной точки. Операции передачи пикселя выполненные в четырех основных типах пикселя - следующим образом: Цвет Каждые четыре цветных компонента умножены на коэффициент масштабирования затем добавлены к показателю смещения. То есть, красный компонент умножен на GL_RED_SCALE затем добавлен к GL_RED_BIAS; зеленый компонент умножен на GL_GREEN_SCALE затем добавлен к GL_GREEN_BIAS; синий компонент умножен на GL_BLUE_SCALE затем добавлен к GL_BLUE_BIAS; и буквенный компонент умножен на GL_ALPHA_SCALE затем добавлен к GL_ALPHA_BIAS. В конце концов четыре цветных компонента масштабированы и просклонены, каждый скреплен в дипазон [0,1]. Все окрашивают шкалу и величины смещения определены glPixelTransfer. Если GL_MAP_COLOR - истина, каждый цветной компонент масштабирован размером соответствующей цветной-цветной карты, тогда замененное содержанием этой карты проиндексированной масштабированным компонентом. То есть, красный компонент масштабирован GL_PIXEL_MAP_R_TO_R_SIZE затем заменен содержанием GL_PIXEL_MAP_R_TO_R проиндексированным самостоятельно. Зеленый компонент масштабирован GL_PIXEL_MAP_G_TO_G_SIZE затем заменен содержанием GL_PIXEL_MAP_G_TO_G проиндексированным самостоятельно. Синий компонент масштабирован GL_PIXEL_MAP_B_TO_B_SIZE затем заменен содержанием GL_PIXEL_MAP_B_TO_B проиндексированным самостоятельно. И буквенный компонент масштабирован GL_PIXEL_MAP_A_TO_A_SIZE затем заменен содержанием GL_PIXEL_MAP_A_TO_A проиндексированным самостоятельно. Все компоненты взятые с карт - затем скрепленное в дипазон [0,1]. GL_MAP_COLOR определен glPixelTransfer. Содержание различных карт определено glPixelMap. Цветной индекс Каждый цветной индекс перемещен оставленное битами GL_INDEX_SHIFT, заполняющее нулями любые биты за номером битов доли понесенной фиксированной точкой индекса. Если GL_INDEX_SHIFT - негатив, сдвиг - направо, снова нуль заполнял. Затем GL_INDEX_OFFSET добавлен к индексу. GL_INDEX_SHIFT и GL_INDEX_OFFSET определены glPixelTransfer . Из этой точки, операция отклоняется в зависимости от необходимого формата результирующих пикселей. Если результирующие пиксели должны быть записаны в цветной индексный буфер, или если они прочитанн в память клиента в формате GL_COLOR_INDEX, пиксели остаются рассмотрен как индексы. Если GL_MAP_COLOR - истина, каждый индекс замаскирован 2^n - 1, где n - GL_PIXEL_MAP_I_TO_I_SIZE, тогда замененное содержанием GL_PIXEL_MAP_I_TO_I проиндексированным замаскированной величиной. GL_MAP_COLOR определен glPixelTransfer. Содержание индексной карты определено glPixelMap. Если результирующие пиксели должны быть записаны в цветной буфер RGBA, или если они прочитанн в память клиента в формате кроме GL_COLOR_INDEX, пиксели преобразованы из индексов, чтобы окрашивать ссылавшись на четыре карты GL_PIXEL_MAP_I_TO_R, GL_PIXEL_MAP_I_TO_G, GL_PIXEL_MAP_I_TO_B, и GL_PIXEL_MAP_I_TO_A. Прежде, чем разыменовывавшее, индекс будет замаскирован 2n - 1, где n - GL_PIXEL_MAP_I_TO_R_SIZE для красной карты, GL_PIXEL_MAP_I_TO_G_SIZE для зеленой карты, GL_PIXEL_MAP_I_TO_B_SIZE для синей карты, и GL_PIXEL_MAP_I_TO_A_SIZE для буквенной карты. Все компоненты взятые с карт - затем скрепленное в дипазон [0,1]. Содержание четырех карт определено glPixelMap. Глубина Каждая глубинная величина умножена на GL_DEPTH_SCALE, добавлена к GL_DEPTH_BIAS затем скреплена в дипазон [0,1]. Шаблон Каждый индекс перемещен биты GL_INDEX_SHIFT подобно тому, как цветной индекс затем добавлен к GL_INDEX_OFFSET. Если GL_MAP_STENCIL - истина, каждый индекс замаскирован 2^n - 1, где n - GL_PIXEL_MAP_S_TO_S_SIZE, тогда замененное содержанием GL_PIXEL_MAP_S_TO_S проиндексированным замаскированной величиной. Следующая таблица дает тип, начальную величину, и дипазон правильных величин для каждых параметров передачи пикселя, которые установлены glPixelTransfer. Тип Pname Правильного Дипазона InitialValue Логической ложной истины/лжи GL_MAP_COLOR Логической ложной истины/ложного GL_MAP_STENCIL целого GL_INDEX_SHIFT 0 ( - oo,oo) целое GL_INDEX_OFFSET 0 ( - oo,oo) функция преобразования GL_RED_SCALE 1.0 ( - oo,oo) функция преобразования GL_GREEN_SCALE 1.0 ( - oo,oo) функция преобразования GL_BLUE_SCALE 1.0 ( - oo,oo) функция преобразования GL_ALPHA_SCALE 1.0 ( - oo,oo) функция преобразования GL_DEPTH_SCALE 1.0 ( - oo,oo) функция преобразования GL_RED_BIAS 0.0 ( - oo,oo) функция преобразования GL_GREEN_BIAS 0.0 ( - oo,oo) функция преобразования GL_BLUE_BIAS 0.0 ( - oo,oo) функция преобразования GL_ALPHA_BIAS 0.0 ( - oo,oo) функция преобразования GL_DEPTH_BIAS 0.0 ( - oo,oo) Функция glPixelTransferf может быть использована, чтобы устанавливать любой параметр передачи пикселя. Если тип параметра Логический, 0.0 подразумевает ложь и любая другая величина подразумевает истину. Если pname - параметр целого, param округлен в ближайшее целое. Подобно, glPixelTransferi может также использован, чтобы устанавливать любой из параметров передачи пикселя. Логические параметры установлены в ложь если param - 0 и истина otherwise. param преобразована на поплававшее точка прежде, чем назначенное в реальный ценные параметры. Если glDrawPixels, glReadPixels, glCopyPixels, glTexImage1D, или команда glTexImage2D установлена в дисплейном списке (смотри glNewList и glCallList), установочные параметры режима передачи пикселя в силе когда дисплейный список выполнен, - те, что использованы. Они возможно отличаются от установочных параметров когда команда была компилирована в дисплейный список. Следующее функций извлекает информацию имело отношение к функции glPixelTransfer: glGet С аргументом GL_MAP_COLOR glGet с аргументом GL_MAP_STENCIL glGet с аргументом GL_INDEX_SHIFT glGet с аргументом GL_INDEX_OFFSET glGet с аргументом GL_RED_SCALE glGet с аргументом GL_RED_BIAS glGet с аргументом GL_GREEN_SCALE glGet с аргументом GL_GREEN_BIAS glGet с аргументом GL_BLUE_SCALE glGet с аргументом GL_BLUE_BIAS glGet С аргументом GL_ALPHA_SCALE glGet с аргументом GL_ALPHA_BIAS glGet с аргументом GL_DEPTH_SCALE glGet с аргументом GL_DEPTH_BIAS Ошибки GL_INVALID_ENUM сгенерирован если pname - не допустимая величина. GL_INVALID_OPERATION сгенерирован если glPixelTransfer назван между вызовом на glBegin и соответствующий вызов на glEnd. Смотри Также glCallList, glCopyPixels, glDrawPixels, glNewList, glPixelMap, glPixelStore, glPixelZoom, glReadPixels, glTexImage1D, glTexImage2D | |||
| |||
|
