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.