GLPIXELSTORE(3G)                                              GLPIXELSTORE(3G)



NAME
       glPixelStoref,, glPixelStorei - set pixel storage modes


C SPECIFICATION
       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:
              GLPACKSWAPBYTES,    GLPACKLSBFIRST,    GLPACKROWLENGTH,
              GLPACKIMAGEHEIGHT,  GLPACKSKIPIXELS,   GLPACKSKIPROWS,
              GLPACKSKIPIMAGES, and GLPACKALIGNMENT.  Six more affect the
              unpacking  of  pixel  data  from  memory:  GLUNPACKSWAPBYTES,
              GLUNPACKLSBFIRST,                       GLUNPACKROWLENGTH,
              GLUNPACKIMAGEHEIGHT,                   GLUNPACKSKIPIXELS,
              GLUNPACKSKIPROWS,          GLUNPACKSKIPIMAGES,         and
              GLUNPACKALIGNMENT.

       param  Specifies the value that pname is set to.

DESCRIPTION
       glPixelStore sets pixel storage modes that affect the operation of sub-
       sequent glDrawPixels and glReadPixels as well as the unpacking of poly-
       gon stipple patterns (see glPolygonStipple),  bitmaps  (see  glBitmap),
       texture   patterns   (see   glTexImage1D,  glTexImage2D,  glTexImage3D,
       glTexSubImage1D, glTexSubImage2D, glTexSubImage3D).   Additionally,  if
       the  GLARBimaging  extension is supported, pixle storage modes affect
       convlution filters (see  glConvolutionFilter1D,  glConvolutionFilter2D,
       and   glSeparableFilter2D,   color   table   (see   glColorTable,   and
       glColorSubTable, and unpacking histogram (See glHistogram), and  minmax
       (See glinmax) data.

       pname  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.  They are as follows:

       GLPACKSWAPBYTES
                 If  true, byte ordering for multibyte color components, depth
                 components, color indices, or stencil  indices  is  reversed.
                 That  is,  if a four-byte component consists of bytes b0, b1,
                 b2, b2  it  is  stored  in  memory  as  b3,  b2,  b1,  b0  if
                 GLPACKSWAPBYTES is true.  GLPACKSWAPBYTES 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 GLRGB   pixel  are  always  stored
                 with  red  first, green second, and blue third, regardless of
                 the value of GLPACKSWAPBYTES.

       GLPACKLSBFIRST
                 If true, bits are ordered within a byte from  least  signifi-
                 cant  to  most  significant; otherwise, the first bit in each
                 byte is the most significant one.  This parameter is signifi-
                 cant for bitmap data only.

       GLPACKROWLENGTH
                 If  greater  than 0, GLPACKROWLENGTH 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


                             k = nl for s>=a, (a/s)(snl/a) for s=a, (a/s)(snlh/a) for s=a, (a/s)(snl/a) for s=a, (a/s)(snlh/a) for s