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

NAME

6       GQSGUS  (Inquire  set of segment names in use) - Retrieves what segment
7       names are currently in use.
8

SYNOPSIS

10       CALL GQSGUS(N,ERRIND,OL,SGNA)
11

C-BINDING SYNOPSIS

13       #include <ncarg/gks.h>
14
15       void ginq_set_seg_names(Gint num_elems_appl_list, Gint start_pos,  Gint
16       *err_ind, Gint_list *seg_names, Gint *length_list);
17

DESCRIPTION

19       N           (Integer, Input) - The set member requested.
20
21       ERRIND      (Integer,  Output)  - If the GKS state is WSOP (workstation
22                   open), WSAC (workstation active), or SGOP  (segment  open),
23                   then  ERRIND  is  returned  as  "0";  otherwise  ERRIND  is
24                   returned as "7".
25
26       OL          (Integer, Output) - The number of segment  names  that  are
27                   currently in use.
28
29       SGNA        (Integer,  Output)  - If the GKS state is WSOP (workstation
30                   open), WSAC (workstation active), or SGOP  (segment  open),
31                   and if OL is larger than zero, then SGNA is returned as the
32                   name in the Nth element of the list of segment  names  that
33                   are currently in use; otherwise SGNA is undefined.
34

USAGE

36       For  NCAR  GKS,  segment  names are integers between 0 and 99 inclusive
37       (see the man page for GCRSG).
38
39       If one wants to obtain a list of all segment names that  are  currently
40       in use, then the procedure usually is first to determines the number of
41       segment names currently in use by making an initial call to GQSGUS with
42       first argument of "1".  If ERRIND is returned as "0", then OL will tell
43       you how many segments are currently in use.  Then, to get the  list  of
44       all  segment  names currently in use, call GQSGUS in a loop on N from 1
45       to OL and retrieve the N values of SGNA returned from such calls.
46

ACCESS

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

SEE ALSO

51       Online: gevtm, gactm,  gclsg,  gcrsg,  gcsgwk,  gqopsg,  gdsg,  gssgt.,
52       ginq_set_seg_names
53
54       Hardcopy: "User's Guide for NCAR GKS-0A Graphics"
55

57       Copyright (C) 1987-2009
58       University Corporation for Atmospheric Research
59       The use of this Software is governed by a License Agreement.
60
61
62
63UNIX                              March 1993                    GQSGUS(3NCARG)
Impressum