NAME¶

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

SYNOPSIS¶

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

C-BINDING 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¶

WKID

(Integer, Input) - Gives a workstation identifier as was set in a previous call to GOPWK.

CI

(Integer, Input) - A color index.

TYPE

(Integer, Input) - Specifies whether the returned color values are the ones that were specified by a call to GSCR 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).

ERRIND

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

CR

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

CG

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

CB

(Real, 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 GSCR.

ACCESS¶

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

SEE ALSO¶

Online: gscr, gsplci, gsmkci, gstxci, gsfaci, ginq_colr_rep

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.