NAME

       ginq_set_seg_names - Retrieves what segment names are currently in use

SYNOPSIS

       #include <ncarg/gks.h>

       void ginq_set_seg_names(Gint num_elems_appl_list, Gint start_pos, Gint *err_ind, Gint_list
       *seg_names, Gint *length_list);

DESCRIPTION

       num_elems_appl_list
                   (Input) - The number of elements in the application list you wish to request.

       start_pos   (Input) - The first set member requested.

       err_ind     (Output) - If the GKS state is  WSOP  (workstation  open),  WSAC  (workstation
                   active),  or  SGOP  (segment open), then err_ind is returned as "0"; otherwise
                   err_ind is returned as "7".

       length_list (Output) - The number of segment names that are currently in use.

       seg_names.num_ints
                   (Gint, Output) - The number of segment names returned.

       seg_names.ints
                   (Gint *, Output)  -  If  the  GKS  state  is  WSOP  (workstation  open),  WSAC
                   (workstation  active),  or  SGOP  (segment  open),  and  if  start_pos is non-
                   negative, then seg_names.ints  is  returned  as  the  list  of  segment  names
                   starting  with  element  "start_pos"  and  ending  with  element  "start_pos +
                   num_elems_appl_list - 1" or "start_pos + length_list - 1", whichever is  less;
                   otherwise seg_names.num_ints is undefined.

USAGE

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

ACCESS

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

SEE ALSO

       Online:   geval_tran_matrix(3NCARG),    gaccum_tran_matrix(3NCARG),    gclose_seg(3NCARG),
       gcreate_seg(3NCARG),  gcopy_seg_ws(3NCARG),  ginq_name_open_seg(3NCARG), gdel_seg(3NCARG),
       gset_seg_tran(3NCARG), gks(3NCARG), ncarg_gks_cbind(3NCARG)

       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR Graphics Fundamentals, UNIX Version

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.