ncl_gset_text_font_prec man page

gset_text_font_prec (Set text font and precision) — sets the text font and precision.

Synopsis

#include <ncarg/gks.h>

void gset_text_font_prec(const Gtext_font_prec *text_font_prec);

Description

text_font_prec.font

(Gint, Input) Specifies the text font to be used in subsequent calls to the gtext output primitive. Options are:

1
ASCII font (default)
-2
Hershey cartographic Roman
-3
Hershey cartographic Greek
-4
Hershey simplex Roman
-5
Hershey simplex Greek
-6
Hershey simplex script
-7
Hershey complex Roman
-8
Hershey complex Greek
-9
Hershey complex script
-10
Hershey complex italic
-11
Hershey complex Cyrillic
-12
Hershey duplex Roman
-13
Hershey triplex Roman
-14
Hershey triplex italic
-15
Hershey Gothic German
-16
Hershey Gothic English
-17
Hershey Gothic Italian
-18
Hershey math symbols
-19
Hershey symbol set 1
-20
Hershey symbol set 2

The Hershey fonts are not standardized by GKS but are locally implemented in NCAR GKS-0A. GKS requires that such locally implemented fonts be assigned negative font numbers. To view the Hershey fonts, look at the plots produced from the PLOTCHAR example (execute "ncargex epltch" to get a metafile) and examine the plot titled "PLCHHQ - FONTCAP DATABASES ADDED 6/90". The font numbers there are the absolute values of the value for text_font_prec.font described here (PLOTCHAR has no need to follow the structures that GKS imposes on font names for gset_text_font_prec).
text_font_prec.prec

(Input) Gives the precision used in subsequent calls to the gtext output primitive for font type text_font_prec.font. Options are:

GPREC_STRING
String precision (good). This is the GKS default.
GPREC_CHAR
Character precision (better).
GPREC_STROKE
Stroke precision (best). This is the default for NCAR GSK-0A.

Usage

If one accesses the Hershey fonts via gset_text_font_prec and gtext, then the characters are not stroked until viewing time. If one accesses the Hershey fonts via PLOTCHAR, then the characters are stroked by PLOTCHAR itself. This can make a significant difference in metafile sizes.

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_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

Info

March 1993 UNIX NCAR GRAPHICS