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

NAME

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

SYNOPSIS

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

DESCRIPTION

16       ws_id       (Input) - A workstation identifier.  ws_id must be the same
17                   as that used in some previous gopen_ws call.
18
19       colr_ind    (Input) - A color index.
20
21       colr_rep.rgb.red
22                   (Gfloat, Input) - An intensity value for red between 0. and
23                   1. inclusive.
24
25       colr_rep.rgb.green
26                   (Gfloat,  Input)  - An intensity value for green between 0.
27                   and 1. inclusive.
28
29       colr_rep.rgb.blue
30                   (Gfloat, Input) - An intensity value for  blue  between  0.
31                   and 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 gset_colr_rep  is  used
36       to associate a color value with color indices.
37
38       It is recommended that all color indices used in a given job be defined
39       prior to calling any output primitive.  Since the result of  a  dynamic
40       color   change   can   be   ambiguous,  it  is  also  recommended  that
41       gset_colr_rep not be called to change a color value after the  original
42       definitions.
43
44       gset_colr_rep may be called after opening the workstation for which the
45       color indices are to be defined, and not  before  that  workstation  is
46       opened.   Different  color tables can be maintained for different work‐
47       stations.  For example, color index 2 for a CGM file may be  associated
48       with "red" while at the same time it may be associated with "green" for
49       some X workstation.
50
51       It is important to stress that color index  0  defines  the  background
52       color.  If  any  color  indices are defined, then you should define the
53       background color index 0. Otherwise you run the risk of having a  user-
54       defined color match the default background color.
55
56       For all GKS output primitives, color is assigned by an indexing scheme.
57       The indices run from 0 to 255, where 0 is the  background  color  index
58       and 1 is the foreground color index.
59

ACCESS

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

SEE ALSO

65       Online:       ginq_colr_rep(3NCARG),        gset_line_colr_ind(3NCARG),
66       gset_marker_colr_ind(3NCARG),               gset_fill_colr_ind(3NCARG),
67       gset_text_colr_ind(3NCARG),                 ginq_line_colr_ind(3NCARG),
68       ginq_marker_colr_ind(3NCARG),               ginq_fill_colr_ind(3NCARG),
69       ginq_text_colr_ind(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)
70
71       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
72       mentals, UNIX Version
73

75       Copyright (C) 1987-2009
76       University Corporation for Atmospheric Research
77       The use of this Software is governed by a License Agreement.
78
79
80
81UNIX                              March 1993             GSET_COLR_REP(3NCARG)
Impressum