NAME
MPE_Add_RGB_color - Adds a color to the colormap given its RGB values
SYNOPSIS
#include "mpe.h"
int MPE_Add_RGB_color( graph, red, green, blue, mapping )
MPE_XGraph graph;
int red, green, blue;
MPE_Color *mapping;
INPUT PARAMETERS
graph - MPE graphics handle
red, green, blue
- color levels from 0 to 65535
OUTPUT PARAMETER
mapping
- index of the new color
RETURN VALUES
-1 - maxcolors too large (equal to numcolors)
MPE_SUCCESS
- successful
mapping
- index of the new color
NOTES
This call adds a color cell to X11’s color table, increments maxcolors
(the index), and writes it to the mapping parameter.
NOTES FOR FORTRAN INTERFACE
The Fortran interface to this routine is different from its C
counterpart and it has an additional argument, ierr, at the end of the
argument list, i.e. the returned function value (the error code) in C
interface is returned as the additional argument in Fortran interface.
The Fortran interface is invoked with the CALL statement.
All MPI and MPE objects, MPI_Comm, MPE_XGraph and MPE_Color, are of
type INTEGER in Fortran.
LOCATION
mpe_graphics.c
12/6/2001 MPE_Add_RGB_color(4)