GPR_$WRITE_PIXELS                 GPR Calls                  GPR_$WRITE_PIXELS


NAME
     gpr_$write_pixels - writes the pixel values from a pixel array into a
     bitmap.

FORMAT
     gpr_$write_pixels (pixel_array, destination_window, status)

DESCRIPTION
     This routine writes the pixel values from a pixel array into a window of
     the current bitmap.

     The pixel values in the pixel array, one in each 4-byte integer, are
     stored in the destination window of the bitmap in row-major order.

     For monochromatic displays, only the low-order bit of each pixel value is
     significant.

     For color displays in 4-bit pixel format, only the four lowest-order bits
     of each pixel value are considered because the bitmaps have four planes.

     gpr_$write_pixels overwrites the old contents of the bitmap.

   Input Parameters
     pixel_array
          An array from which to write pixel values in gpr_$pixel_array_t for-
          mat.  This is an array of 4-byte integers.  You can specify an array
          of up to 131,073 elements.

     destination_window
          Rectangular section of the current bitmap into which to write the
          pixel values, in gpr_$window_t format.  This data type is 8 bytes
          long.

   Output Parameters
     status
          Completion status, in status_$t format.

SEE ALSO
     gpr_$read_pixels.

NOTES
     A program cannot use this routine on a bitmap corresponding to a Display
     Manager frame.