HP 3000 Manuals

has_color, can_change_color, color_content, pair_content [ MPE/iX Developer's Kit Reference Manual Volume II ] MPE/iX 5.0 Documentation


MPE/iX Developer's Kit Reference Manual Volume II

has_color, can_change_color, color_content, pair_content 

The has_color set of routines is used to get information about colors on
terminal.

Syntax 

     #include <curses.h>

     bool has_colors();
     bool can_change_color();

     int pair_content(short pair, short *fg, short *bg);
     int color_content(short color, short *r, short *g, short *b);

Parameters 

color                 The number of the color for which to provide
                      information (0 to COLORS).

pair                  The number of the color pair for which to provide
                      information (1 to COLOR_PAIRS - 1).

r                     A pointer to the RGB value for the amount of red in
                      color.

g                     A pointer to the RGB value for the amount of green
                      in color.

b                     A pointer to the RGB value for the amount of blue
                      in color.

bg                    A pointer to the number of the background color (0
                      to COLORS) in pair.

fg                    A pointer to the number of the foreground color (0
                      to COLORS) in pair.

Return Values 

OK                    Successful completion.

ERR                   An error occurred.

Description 

The has_colors() routine returns TRUE if the terminal supports color.
The can_change_color() routine returns TRUE if the terminal can support
color and the colors can be changed.  These routines are useful when
writing terminal-independent programs; these routines could be used to
determine whether to replace color with another attribute on a particular
terminal.

The color_content() routine provides information on the amount of red,
blue, and green in a particular color.  The intensity of each color is
stored in the addresses pointed to by r, b, and g, respectively.  The
values returned range from 0 (no component of that color) to 1000
(maximum amount of component).

The pair_content() routine provides information on what colors are in the
specified color pair.  The number of the foreground and background colors
are stored in the addresses pointed to by fg and bg, respectively.  The
values stored in fg and bg range from 0 to COLORS. The color pair number,
pair, ranges from 1 to COLOR_PAIRS -1.

Implementation Considerations 

UNIX System V implementation

See Also 

init_color(), init_pair(), start_color()

Portability 

UNIX System V



MPE/iX 5.0 Documentation