1GQSGUS(3NCARG) NCAR GRAPHICS GQSGUS(3NCARG)
2
3
4
6 GQSGUS (Inquire set of segment names in use) - Retrieves what segment
7 names are currently in use.
8
10 CALL GQSGUS(N,ERRIND,OL,SGNA)
11
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
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
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
48 To use GKS routines, load the NCAR GKS-0A library ncarg_gks.
49
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)