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

NAME

6       GQCR (Inquire color representation) - retrieves the color value associ‐
7       ated with a color index on a particular workstation.
8

SYNOPSIS

10       CALL GQCR (WKID, CI, TYPE, ERRIND, CR, CG, CB)
11

C-BINDING SYNOPSIS

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

DESCRIPTION

19       WKID        (Integer,  Input)  -  Gives a workstation identifier as was
20                   set in a previous call to GOPWK.
21
22       CI          (Integer, Input) - A color index.
23
24       TYPE        (Integer, Input) - Specifies  whether  the  returned  color
25                   values  are  the ones that were specified by a call to GSCR
26                   or whether they are the  color  values  that  are  actually
27                   being used on the specified workstation (frequently a work‐
28                   station will not be able to  represent  a  requested  color
29                   value precisely).
30
31                   0      Returns  the  color value set for index CI either by
32                          default or by a call to GSCR.
33
34                   1      Returns the color value actually used by  the  work‐
35                          station to represent the requested color.
36
37       ERRIND      (Integer,  Output)  -  If  the  inquired  values  cannot be
38                   returned correctly, a non-zero error indicator is  returned
39                   in  ERRIND,  otherwise a zero is returned.  Consult "User's
40                   Guide for NCAR GKS-0A Graphics" for a  description  of  the
41                   meaning of the error indicators.
42
43       CR          (Real,  Output) - Returns an intensity value for red in the
44                   range 0. to 1. inclusive.
45
46       CG          (Real, Output) - Returns an intensity value  for  green  in
47                   the range 0. to 1. inclusive.
48
49       CB          (Real, Output) - Returns an intensity value for blue in the
50                   range 0. to 1. inclusive.
51

USAGE

53       For details on setting and using color indices see  the  man  page  for
54       GSCR.
55

ACCESS

57       To use GKS routines, load the NCAR GKS-0A library ncarg_gks.
58

SEE ALSO

60       Online: gscr, gsplci, gsmkci, gstxci, gsfaci, ginq_colr_rep
61
62       Hardcopy:  User's  Guide for NCAR GKS-0A Graphics; NCAR Graphics Funda‐
63       mentals, UNIX Version
64

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