GINQ_TEXT_PATH(3NCARG)

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.