NAME

       ginq_colr_rep - Inquire GKS color representation

DESCRIPTION

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

SYNOPSIS

       #include <ncarg/gks.h>

       void ginq_colr_rep(Gint ws_id, Gint colr_ind, Ginq_type  type,  Gint  *err_ind,  Gcolr_rep
       *colr_rep);

DESCRIPTION

       ws_id       (Input)  -  Gives  a  workstation  identifier as was set in a previous call to
                   gopen_ws.

       colr_ind    (Input) - A color index.

       type        (Input) - Specifies whether the returned color values are the ones  that  were
                   specified by a call to gset_colr_rep or whether they are the color values that
                   are actually being used on the specified workstation (frequently a workstation
                   will not be able to represent a requested color value precisely).

                   GINQ_SET
                          Returns  the color value set for index colr_ind either by default or by
                          a call to gset_colr_rep.

                   GINQ_REALIZED
                          Returns the color value actually used by the workstation  to  represent
                          the requested color.

       err_ind     (Output)  -  If  the  inquired values cannot be returned correctly, a non-zero
                   error indicator is returned in err_ind, otherwise a zero is returned.  Consult
                   "User's  Guide  for  NCAR GKS-0A Graphics" for a description of the meaning of
                   the error indicators.

       colr_rep.rgb.red
                   (Gfloat, Output) - Returns an intensity value for red in the range  0.  to  1.
                   inclusive.

       colr_rep.rgb.green
                   (Gfloat,  Output) - Returns an intensity value for green in the range 0. to 1.
                   inclusive.

       colr_rep.rgb.blue
                   (Gfloat, Output) - Returns an intensity value for blue in the range 0.  to  1.
                   inclusive.

USAGE

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

ACCESS

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

SEE ALSO

       Online:   gset_colr_rep(3NCARG),   gset_line_colr_ind(3NCARG),   gset_marker_size(3NCARG),
       gset_text_colr_ind(3NCARG),            gset_fill_colr_ind(3NCARG),            gks(3NCARG),
       ncarg_gks_cbind(3NCARG)

       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.