next up previous contents index
Next: 3.6.2 Pixel Transfer Modes Up: 3.6 Pixel Rectangles Previous: 3.6 Pixel Rectangles

3.6.1 Pixel Storage Modes

 

Pixel storage modes affect the operation of DrawPixels  and ReadPixels  (as well as other commands; see sections 3.5.2, 3.7, and 3.8) when one of these commands is issued. This may differ from the time that the command is executed if the command is placed in a display list (see section 5.4). Pixel storage modes are set with

void PixelStore[if] ( enum pname, T param ) ;

pname is a symbolic constant indicating a parameter to be set, and param is the value to set it to. Table 3.1 summarizes the pixel storage parameters, their types, their initial values, and their allowable ranges. Setting a parameter to a value outside the given range results in the error INVALID_VALUE.

  
Table 3.1: PixelStore  parameters pertaining to DrawPixels .

The version of PixelStore  that takes a floating-point value may be used to set any type of parameter; if the parameter is boolean, then it is set to FALSE if the passed value is and TRUE otherwise, while if the parameter is an integer, then the passed value is rounded to the nearest integer. The integer version of the command may also be used to set any type of parameter; if the parameter is boolean, then it is set to FALSE if the passed value is 0 and TRUE otherwise, while if the parameter is a floating-point value, then the passed value is converted to floating-point.



David Blythe
Sat Mar 29 02:23:21 PST 1997