gpr_set_fill_background_value() — Apollo Domain/OS SR10.3.5

GPR_$SET_FILL_BACKGROUND_VALUE    GPR Calls     GPR_$SET_FILL_BACKGROUND_VALUE


NAME
     gpr_$set_fill_background_value - specifies the color/intensity value for
     tile fill background.

FORMAT
     gpr_$set_fill_background_value (color, status)

DESCRIPTION
     This routine specifies the color/intensity value used for drawing the
     background of tile fills.

     The default fill background value is -2.

     This routine defines the background fill value for 1-bit patterns.
     specifies the color/intensity value used for tile fill.  In all other
     fill patterns, the values set with this routine are ignored.

   Input Parameters
     color
          The color to be used for tile fills, in gpr_$pixel_value_t format.
          This is a 4-byte integer.  Valid values are

             ⊕  0 - 1 For monochromatic displays.

             ⊕  0 - 15 An index into a 4-plane color table.

             ⊕  0 - 25 An index into an 8-plane color table.

             ⊕  0 - 4096 An index into a 12-plane true-color map.

             ⊕  0 - 16,777,215 A color value for a 24-plane true-color pro-
                gram.

             ⊕  -1 For all displays.  This specifies that the background is
                transparent; that is, the old values of the pixels are not
                changed.

             ⊕  -2 For all displays.  This sets the tile file color equal to
                the color of the bitmap background.  For borrowed displays and
                memory bitmaps, the fill background is always zero.  For
                Display Manager frames, this is the pixel value in use for the
                window background.

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

SEE ALSO
     gpr_$inq_fill_background_value.
Museum
