plucky (3) gset_colr_rep.3NCARG.gz

Provided by: libncarg-dev_6.6.2.dfsg.1-10build2_amd64 bug

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 (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.