GPR_$SET_FILL_PATTERN             GPR Calls              GPR_$SET_FILL_PATTERN


NAME
     gpr_$set_fill_pattern - specifies the fill pattern used for the current
     bitmap.

FORMAT
     gpr_$set_fill_pattern (pattern, scale, status)

DESCRIPTION
     This routine specifies the fill pattern used for the current bitmap.

     Currently, the tile pattern must be stored in a bitmap that is 32x32 pix-
     els by n planes.  This bitmap is part of the attribute block for the
     current bitmap.  The scale factor must be one.  Any other pattern size or
     scale value results in an error.

     With a one-plane bitmap as the pattern, the pixel values used are those
     set by gpr_$set_fill_value and gpr_$set_fill_background_value Pixels
     corresponding to "1" bits of the pattern are drawn in the fill value:
     pixels corresponding to "0" bits of the pattern are drawn in the fill
     background value.

     With a multiplane bitmap as the pattern, the pixel values used are those
     contained in the pattern bitmap.

   Input Parameters
     pattern
          The descriptor of the bitmap containing the fill pattern, in
          gpr_$bitmap_desc_t format.  This is a 4-byte integer.  This bitmap
          is associated with the current attribute block.

     scale
          The number of times each bit in this pattern is to be replicated
          before proceeding to the next bit in the pattern.  This is a 2-byte
          integer.

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

SEE ALSO
     gpr_$inq_fill_pattern, gpr_$set_fill_value,
     gpr_$set_fill_background_value.

NOTES
     To re-establish solid fills, set the fill pattern descriptor to
     gpr_$nil_bitmap_desc.