NAME

       gset_colr_rep (Set color representation) - associates a color value with a color index.

SYNOPSIS

       #include <ncarg/gks.h>

       void gset_colr_rep(Gint ws_id, Gint colr_ind, const Gcolr_rep *colr_rep);

DESCRIPTION

       ws_id       (Input)  -  A  workstation identifier.  ws_id must be the same as that used in
                   some previous gopen_ws call.

       colr_ind    (Input) - A color index.

       colr_rep.rgb.red
                   (Gfloat, Input) - An intensity value for red between 0. and 1. inclusive.

       colr_rep.rgb.green
                   (Gfloat, Input) - An intensity value for green between 0. and 1. inclusive.

       colr_rep.rgb.blue
                   (Gfloat, Input) - An intensity value for blue between 0. and 1. inclusive.

USAGE

       Color in GKS is "indexed", i.e. color attributes are assigned to  primitives  by  using  a
       color index.  The GKS function gset_colr_rep is used to associate a color value with color
       indices.

       It is recommended that all color indices used in a given job be defined prior  to  calling
       any  output primitive.  Since the result of a dynamic color change can be ambiguous, it is
       also recommended that gset_colr_rep not be called  to  change  a  color  value  after  the
       original definitions.

       gset_colr_rep  may be called after opening the workstation for which the color indices are
       to be defined, and not before that workstation is opened.  Different color tables  can  be
       maintained  for  different workstations.  For example, color index 2 for a CGM file may be
       associated with "red" while at the same time it may be associated with "green" for some  X
       workstation.

       It  is  important  to stress that color index 0 defines the background color. If any color
       indices are defined, then you should define the background color index  0.  Otherwise  you
       run the risk of having a user-defined color match the default background color.

       For  all  GKS  output primitives, color is assigned by an indexing scheme. The indices run
       from 0 to 255, where 0 is the background color index and 1 is the foreground color index.

ACCESS

       To use the GKS C-binding routines, load the ncarg_gks and ncarg_c libraries.

SEE ALSO

       Online: ginq_colr_rep(3NCARG),  gset_line_colr_ind(3NCARG),  gset_marker_colr_ind(3NCARG),
       gset_fill_colr_ind(3NCARG),     gset_text_colr_ind(3NCARG),    ginq_line_colr_ind(3NCARG),
       ginq_marker_colr_ind(3NCARG),   ginq_fill_colr_ind(3NCARG),    ginq_text_colr_ind(3NCARG),
       gks(3NCARG), ncarg_gks_cbind(3NCARG)

       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.