GPR_$PIXEL_BLT                    GPR Calls                     GPR_$PIXEL_BLT


NAME
     gpr_$pixel_blt - performs a pixel BLT from any bitmap to the current bit-
     map.

FORMAT
     gpr_$pixel_blt (source_bitmap_desc, source_window, dest_origin, status)

DESCRIPTION
     This routine performs a pixel BLT from any bitmap to the current bitmap.

     Both the source and destination bitmaps can be in either display memory
     or main memory.  If you specify a 32-plane main memory bitmap as the
     source bitmap and a 24-plane display memory bitmap as the destination,
     then the system will BLT only the first 24 planes of the main memory bit-
     map.

     The source window origin is added to the coordinate origin for the source
     bitmap, and the result is the actual origin of the source rectangle for
     the BLT.  Similarly, the destination origin is added to the coordinate
     origin for the current bitmap, and the result is the actual origin of the
     destination rectangle for the BLT.

   Input Parameters
     source_bitmap_desc
          Descriptor of the source bitmap which contains the source window to
          be transferred, in gpr_$bitmap_desc_t format.  This is a 4-byte
          integer.

     source_window
          Rectangular section of the bitmap from which to transfer pixels, in
          gpr_$window_t format.  This data type is 8 bytes long.

     dest_origin
          Start position (top left coordinate position) of the destination
          rectangle, in gpr_$position_t format.  This data type is 4 bytes
          long.

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

SEE ALSO
     gpr_$set_bitmap.

NOTES
     Use gpr_$set_bitmap to establish the current bitmap for this routine.

     If the source bitmap is a Display Manager frame, the only allowed  raster
     op  codes  are  0, 5, A, and F.  These are the raster operations in which
     the source plays no role.

     If a rectangle is transferred by a BLT to a Display Manager frame and the
     frame is refreshed for any reason, the BLT is re-executed.  Therefore, if
     the information in the source bitmap has changed, the appearance  of  the
     frame changes accordingly.