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-2007
58       University Corporation for Atmospheric Research
59
60       This  documentation  is  free  software; you can redistribute it and/or
61       modify it under the terms of the GNU General  Public  License  as  pub‐
62       lished  by  the  Free  Software  Foundation;  either  version  2 of the
63       License, or (at your option) any later version.
64
65       This software is distributed in the hope that it will  be  useful,  but
66       WITHOUT  ANY  WARRANTY;  without  even  the  implied  warranty  of MER‐
67       CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU  General
68       Public License for more details.
69
70       You should have received a copy of the GNU General Public License along
71       with this software; if not, write  to  the  Free  Software  Foundation,
72       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
73
74
75
76UNIX                              March 1993                    GQSGUS(3NCARG)
Impressum