ncl_ginq_colr_rep man page

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

Info

March 1993 UNIX NCAR GRAPHICS