HPlogo MPE/iX Developer's Kit Reference Manual Volume 2: HP 3000 MPE/iX Computer Systems > Chapter 4 CURSES

start_color

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

The start_color routine is used to initialize the use of color.

NOTE: The start_color routine is not implemented at this time.

Syntax

   #include <curses.h>



   int start_color();

Return Values

OK

Successful completion.

ERR

An error occurred.

Description

The start_color() routine initializes the use of color. It must be used if color is to be used in the program. It must be called before any other color routines, ideally right after initscr(). Eight basic colors are initialized (black, red, green, yellow, blue, magenta, cyan, and white) and two global variables (COLORS and COLOR_PAIRS). The COLORS variable specifies the number of colors that the terminal supports, and the COLOR_PAIRS variable specifies the number of color pairs. Colors are always in pairs consisting of a foreground color (for characters) and a background color (for the the rest of the character cell). The start_color() routine also restores the values of the colors to those that the terminal had on startup.

Implementation Considerations

UNIX System V implementation

See Also

can_change_color(), color_content(), has_color(), init_color(), init_pair(), pair_content()

Portability

UNIX System V

Feedback to webmaster