Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

GPR_$SET_TEXT_VALUE               GPR Calls                GPR_$SET_TEXT_VALUE


NAME
     gpr_$set_text_value - specifies the color to use for writing text.

FORMAT
     gpr_$set_text_value (color, status)

DESCRIPTION
     This routine specifies the color to use for writing text.

     The default text value is 1 for borrowed displays, memory bitmaps, and
     Display Manager frames on monochromatic displays; 0 for Display Manager
     frames on color displays.

     For monochromatic displays, only the low-order bit of the text value is
     considered because monochromatic displays have only one plane.

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

   Input Parameters
     color
          The color to be used for writing text, in gpr_$pixel_value_t format.
          This is a 4-byte integer. The valid values are listed below:

             ⊕  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.

             ⊕  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.

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

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026