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