Provided by: mpi-doc_1.2.7-10ubuntu1_all bug

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)