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

NAME

6       ginq_colr_rep  (Inquire  color  representation)  -  retrieves the color
7       value associated with a color index on a particular workstation.
8

SYNOPSIS

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

DESCRIPTION

16       ws_id       (Input)  -  Gives  a workstation identifier as was set in a
17                   previous call to gopen_ws.
18
19       colr_ind    (Input) - A color index.
20
21       type        (Input) - Specifies whether the returned color  values  are
22                   the  ones that were specified by a call to gset_colr_rep or
23                   whether they are the color values that are  actually  being
24                   used on the specified workstation (frequently a workstation
25                   will not be able to represent a requested color value  pre‐
26                   cisely).
27
28                   GINQ_SET
29                          Returns  the  color  value  set  for  index colr_ind
30                          either by default or by a call to gset_colr_rep.
31
32                   GINQ_REALIZED
33                          Returns the color value actually used by  the  work‐
34                          station to represent the requested color.
35
36       err_ind     (Output)  -  If the inquired values cannot be returned cor‐
37                   rectly, a non-zero error indicator is returned in  err_ind,
38                   otherwise  a  zero  is returned.  Consult "User's Guide for
39                   NCAR GKS-0A Graphics" for a description of the  meaning  of
40                   the error indicators.
41
42       colr_rep.rgb.red
43                   (Gfloat,  Output)  -  Returns an intensity value for red in
44                   the range 0. to 1. inclusive.
45
46       colr_rep.rgb.green
47                   (Gfloat, Output) - Returns an intensity value for green  in
48                   the range 0. to 1. inclusive.
49
50       colr_rep.rgb.blue
51                   (Gfloat,  Output)  - Returns an intensity value for blue in
52                   the range 0. to 1. inclusive.
53

USAGE

55       For details on setting and using color indices see  the  man  page  for
56       gset_colr_rep.
57

ACCESS

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

SEE ALSO

63       Online:       gset_colr_rep(3NCARG),        gset_line_colr_ind(3NCARG),
64       gset_marker_size(3NCARG),                   gset_text_colr_ind(3NCARG),
65       gset_fill_colr_ind(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)
66
67       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
68       mentals, UNIX Version
69

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