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