PERIMETER_COLOR(3G)

NAME

perimeter_color − selects the color index or color value for subsequent polygon perimeters.

SYNOPSIS

C SYNTAX

void perimeter_color_index(fildes,index);
int fildes,index;

void perimeter_color(fildes,red,green,blue);
int fildes;
float red,green,blue;

FORTRAN77 SYNTAX

        subroutine perimeter_color_index(fildes,index)
        integer*4 fildes,index

        subroutine perimeter_color(fildes,red,green,blue)
        integer*4 fildes
        real red,green,blue

PASCAL SYNTAX

procedure perimeter_color_index(fildes,index:integer);

procedure perimeter_color(fildes:integer;
red,green,blue:real);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: ANSI Computer Graphics Interface

DESCRIPTION

INPUT PARAMETERS

fildes
is an integer file descriptor returned by gopen when the I/O path to the output graphic device is opened.
index
is an index into the device color table associated with the device specified by the file descriptor. The color value at this location in the table will be used for subsequent polygon perimeters.
red, green, blue
are the color values (in the range of 0.0 to 1.0) to be used for subsequent polygon perimeters. Zero (0.0) indicates no color and one (1.0) indicates full color. Monochrome devices use the equation I=0.30*red+0.59*green+0.11*blue to determine the intensity.

DISCUSSION

Using perimeter_color on a color mapped device requires a search for the closest matching color in the color table. Using perimeter_color_index is more efficient for these devices.

The closest color is the first color table entry closest to the desired color in RGB space at the time this procedure is called. If the color map is changed after this procedure is called, the perimeter color used may not be the original color desired.

If the index is out of range, a warning is generated and a mod function is performed.

DEFAULTS

The default perimeter color is the color defined in the current color table at index 0 (zero).

Museum

Related Articles