NAME

       ginq_text_path - retrieves the current text path

SYNOPSIS

       #include <ncarg/gks.h>

       void ginq_text_path(Gint *err_ind, Gtext_path *text_path);

DESCRIPTION

       err_ind     (Output)  -  If  the  inquired  value cannot be returned correctly, a non-zero
                   error indicator is returned in err_ind, otherwise a zero is returned.  Consult
                   "User's  Guide  for  NCAR GKS-0A Graphics" for a description of the meaning of
                   the error indicators.

       text_path   (Output) - Returns the current text path as set by default or  by  a  call  to
                   gset_text_path.  Legal values are:

                   GPATH_RIGHT
                          Draw  successive  characters  in  the  string  such  that character n+l
                          appears to the right of character n. This is text path "right"  and  is
                          the default.

                   GPATH_LEFT
                          Draw  character  n+1  to  the  left  of character n.  This is text path
                          "left".

                   GPATH_UP
                          Draw character n+1 above character n.  This is text path "up".

                   GPATH_DOWN
                          Draw character n+1 below character n.  This is text path "down".

ACCESS

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

SEE ALSO

       Online:       gtext(3NCARG),       gset_text_path(3NCARG),        gset_text_align(3NCARG),
       gset_text_font_prec(3NCARG),         gset_char_ht(3NCARG),        gset_char_space(3NCARG),
       gset_char_up_vec(3NCARG),         gset_char_expan(3NCARG),          gset_colr_rep(3NCARG),
       gset_text_colr_ind(3NCARG),        ginq_text_path(3NCARG),        ginq_text_align(3NCARG),
       ginq_text_font_prec(3NCARG),        ginq_char_ht(3NCARG),         ginq_char_space(3NCARG),
       ginq_char_up_vec(3NCARG),    ginq_char_expan(3NCARG),    plotchar(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.