setcolor(C)                     19 June 1992                     setcolor(C)


 Name

    setcolor, setcolour - set screen color and other screen attributes

 Syntax

    setcolor - [ knbrgopc ] argument [ argument ]

 Description

    The setcolor command allows the user to set the screen color on a color
    screen.  Both foreground and background colors can be set independently
    in a range of 16 colors.  setcolor can also set the reverse video and
    graphics character colors.  setcolor with no arguments produces a usage
    message that displays all available colors, then resets the screen to its
    previous state.

    For example, the following strings are possible colors.

    blue         magenta         brown         black


    lt_blue      lt_magenta      yellow        gray
    cyan         white           green         red
    lt_cyan      hi_white        lt_green      lt_red


    The following flags are available. In the arguments below, color is taken
    from the above list.

    -n [color [color] ]
                    Reset the screen to default settings, and switch off -k
                    option.  If no arguments are given the screen is set to
                    white characters on a black background; otherwise the
                    specified colors are used.

    color [color]   Set the foreground to the first color. Sets background to
                    second color if a second color choice is specified.

    -b color        Set the background to the specified color.

    -k              Switch on keyclick option.

    -r color [color]
                    Set the foreground reverse video characters to the first
                    color.  Set reverse video characters' background to
                    second color.

    -g color [color]
                    Set the foreground graphics characters to the first
                    color. Set graphics characters' background to second
                    color.

    -o              Set the color of the screen border (overscan region).
                    This only works on CGA adaptors.

    -p pitch duration
                    Set the pitch and duration of the bell.  Pitch is the pe-
                    riod in microseconds, and duration is measured in fifths
                    of a second.  When using this option, a <Ctrl>g (bell)
                    must be echoed to the screen for the command to work.
                    For example:

                       setcolor -p 2500 2
                       echo ^G


    -c first last   Set the first and last scan lines of the cursor.  (For
                    more information see screen(HW).)

 Notes

    The ability of setcolor to set any of these described functions is ulti-
    mately dependent on the ability of devices to support them.  setcolor
    emits an escape sequence that may or may not have an effect on monochrome
    devices.

    Occasionally changing the screen color can help prolong the life of your
    monitor.

 See also

    screen(HW)

 Value added

    setcolor and setcolour are extensions of AT&T System V provided by The
    Santa Cruz Operation, Inc.