GSCR (Set color representation) - associates a color value with a color index.
Contents
Access
To use GKS routines, load the NCAR GKS-0A library ncarg_gks.
C-Binding Synopsis
#include <ncarg/gks.h>
void gset_colr_rep(Gint ws_id, Gint colr_ind, const Gcolr_rep *colr_rep);
Copyright
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.
UNIX March 1993 GSCR(3NCARG)
Description
WKID (Integer, Input) - A workstation identifier. WKID must be the same as that used in some
previous GOPWK call.
CI (Integer, Input) - A color index.
CR (Real, Input) - An intensity value for red between 0. and 1. inclusive.
CG (Real, Input) - An intensity value for green between 0. and 1. inclusive.
CB (Real, Input) - An intensity value for blue between 0. and 1. inclusive.
Name
GSCR (Set color representation) - associates a color value with a color index.
See Also
Online: gqcr, gsplci, gspmci, gsfaci, gstxci, gqplci, gqpmci, gqfaci, gqtxci, gset_colr_rep
Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version
Synopsis
CALL GSCR (WKID, CI, CR, CG, CB)
Usage
Color in GKS is "indexed", i.e. color attributes are assigned to primitives by using a color index. The
GKS function GSCR 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 GSCR
not be called to change a color value after the original definitions.
GSCR 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.
