gpr_$inq_draw_value

GPR_$INQ_DRAW_VALUE               GPR Calls                GPR_$INQ_DRAW_VALUE


NAME
     gpr_$inq_draw_value - returns the color used for drawing lines.

FORMAT
     gpr_$inq_draw_value (color, status)

DESCRIPTION
     This routine returns the color used for drawing lines.  To set a new draw
     value, use gpr_$set_draw_value.

   Output Parameters
     color
          The color used for drawing lines, 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 - 255 An index into an 8-plane color table.

             ⊕  An index into a 12-plane true-color table.

             ⊕  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 specifies that the draw color is
                equal to the bitmap background color.  For borrowed displays
                and memory bitmaps, the fill background is always zero.  For
                Display Manager frames and direct mode windows, this is the
                pixel value in use for the window background.

     status
        Completion status, in status_$t format.
Museum
