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-2009
71       University Corporation for Atmospheric Research
72       The use of this Software is governed by a License Agreement.
73
74
75
76UNIX                              March 1993                      GSCR(3NCARG)
Impressum