1GSCR(3NCARG)                     NCAR GRAPHICS                    GSCR(3NCARG)
2
3
4

NAME

6       GSCR (Set color representation) - associates a color value with a color
7       index.
8

SYNOPSIS

10       CALL GSCR (WKID, CI, CR, CG, CB)
11

C-BINDING SYNOPSIS

13       #include <ncarg/gks.h>
14
15       void  gset_colr_rep(Gint  ws_id,   Gint   colr_ind,   const   Gcolr_rep
16       *colr_rep);
17

DESCRIPTION

19       WKID        (Integer,  Input) - A workstation identifier.  WKID must be
20                   the same as that used in some previous GOPWK call.
21
22       CI          (Integer, Input) - A color index.
23
24       CR          (Real, Input) - An intensity value for red between  0.  and
25                   1. inclusive.
26
27       CG          (Real, Input) - An intensity value for green between 0. and
28                   1. inclusive.
29
30       CB          (Real, Input) - An intensity value for blue between 0.  and
31                   1. inclusive.
32

USAGE

34       Color in GKS is "indexed", i.e. color attributes are assigned to primi‐
35       tives by using a color index.  The GKS function GSCR is used  to  asso‐
36       ciate a color value with color indices.
37
38       It  is   recommended  that  all  color  indices  used in a given job be
39       defined prior to calling any output primitive.  Since the result  of  a
40       dynamic color change can be ambiguous, it is also recommended that GSCR
41       not be called to change a color value after the original definitions.
42
43       GSCR may be called after opening the workstation for  which  the  color
44       indices  are  to be defined, and not before that workstation is opened.
45       Different color tables can be maintained  for  different  workstations.
46       For  example, color index 2 for a CGM file may be associated with "red"
47       while at the same time it may be associated with  "green"  for  some  X
48       workstation.
49
50       It  is  important  to  stress that color index 0 defines the background
51       color. If any color indices are defined, then  you  should  define  the
52       background  color index 0. Otherwise you run the risk of having a user-
53       defined color match the default background color.
54
55       For all GKS output primitives, color is assigned by an indexing scheme.
56       The  indices  run  from 0 to 255, where 0 is the background color index
57       and 1 is the foreground color index.
58

ACCESS

60       To use GKS routines, load the NCAR GKS-0A library ncarg_gks.
61

SEE ALSO

63       Online: gqcr, gsplci, gspmci, gsfaci, gstxci, gqplci,  gqpmci,  gqfaci,
64       gqtxci, gset_colr_rep
65
66       Hardcopy:  User's  Guide for NCAR GKS-0A Graphics; NCAR Graphics Funda‐
67       mentals, UNIX Version
68

70       Copyright (C) 1987-2007
71       University Corporation for Atmospheric Research
72
73       This documentation is free software; you  can  redistribute  it  and/or
74       modify  it  under  the  terms of the GNU General Public License as pub‐
75       lished by the  Free  Software  Foundation;  either  version  2  of  the
76       License, or (at your option) any later version.
77
78       This  software  is  distributed in the hope that it will be useful, but
79       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
80       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
81       Public License for more details.
82
83       You should have received a copy of the GNU General Public License along
84       with  this  software;  if  not,  write to the Free Software Foundation,
85       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
86
87
88
89UNIX                              March 1993                      GSCR(3NCARG)
Impressum