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

NAME

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

SYNOPSIS

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

DESCRIPTION

16       num_elems_appl_list
17                   (Input)  -  The  number of elements in the application list
18                   you wish to request.
19
20       start_pos   (Input) - The first set member requested.
21
22       err_ind     (Output) - If the GKS state  is  WSOP  (workstation  open),
23                   WSAC  (workstation  active),  or  SGOP (segment open), then
24                   err_ind is returned as "0"; otherwise err_ind  is  returned
25                   as "7".
26
27       length_list (Output)  -  The number of segment names that are currently
28                   in use.
29
30       seg_names.num_ints
31                   (Gint, Output) - The number of segment names returned.
32
33       seg_names.ints
34                   (Gint *, Output) - If the GKS state  is  WSOP  (workstation
35                   open),  WSAC  (workstation active), or SGOP (segment open),
36                   and if start_pos is non-negative,  then  seg_names.ints  is
37                   returned as the list of segment names starting with element
38                   "start_pos"  and   ending   with   element   "start_pos   +
39                   num_elems_appl_list  - 1" or "start_pos + length_list - 1",
40                   whichever is less; otherwise  seg_names.num_ints  is  unde‐
41                   fined.
42

USAGE

44       For  NCAR  GKS,  segment  names are integers between 0 and 99 inclusive
45       (see the man page for gcreate_seg(3NCARG)).
46
47

ACCESS

49       To use the GKS C-binding  routines,  load  the  ncarg_gks  and  ncarg_c
50       libraries.
51

SEE ALSO

53       Online:      geval_tran_matrix(3NCARG),     gaccum_tran_matrix(3NCARG),
54       gclose_seg(3NCARG),     gcreate_seg(3NCARG),      gcopy_seg_ws(3NCARG),
55       ginq_name_open_seg(3NCARG),   gdel_seg(3NCARG),  gset_seg_tran(3NCARG),
56       gks(3NCARG), ncarg_gks_cbind(3NCARG)
57
58       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
59       mentals, UNIX Version
60

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