PSTEXT
Section: Misc. Reference Manual Pages (l)
Updated: DATE
Index
Return to Main Contents
#ifdef SI
#define UNIT cm
#define CLEARENCE 0.15/0.15
#else
#define UNIT inch
#define CLEARENCE 0.05/0.05
#endif
NAME
pstext - To plot textstrings on maps
SYNOPSIS
pstext textfile -Jparameters -Rwest/east/south/north[r]
[ -Btickinfo ] [ -Cdx/dy ] [ -Eazimuth/elevation ]
[ -Gred/green/blue ] [ -H ] [ -K ] [ -L ] [ -N ] [ -O ] [ -P ]
[ -Spen ] [ -U[/dx/dy/][label] ] [ -V ] [ -W[red/green/blue][o] ]
[ -Xx-shift ] [ -Yy-shift ] [ -Zzlevel ] [ -ccopies ] [ -: ]
DESCRIPTION
pstext plots textstrings of variable size, font type, and orientation. Various map projections are
provided, with the option to draw and annotate the map boundaries. PostScript code is written to
standard output. Greek characters, subscript, superscript, and small caps are supported as follows: The sequence @~ toggles
between the selected font and Greek (Symbol). @%no% sets the font to no; @%% resets the
font to the starting font, @- toggles subscripts on/off, @+ toggles
superscript on/off, and @# toggles small caps on/off. @@ prints the @ sign. @e, @o, @a,
@E, @O, @A give the accented Scandinavian characters. Composite characters (overstrike) may be
indicated with the @!<char1><char2> sequence, which will print the two characters on top of
each other. To learn the octal codes for symbols not available on the keyboard and some accented European characters,
see Section 4.15 in the GMT Technical Reference and Cookbook. Note that WANT_EURO_FONT must be set to TRUE in your .gmtdefaults file in order to use the accented characters. Using the -W option, a colored rectangle underlying the text may
be plotted (Does not work for strings with sub/super scripts, symbols, or composite characters).
- textfile
-
This file contains 1 or more records with (x, y, size, angle, fontno, justify, text).
If no file is given, pstext will read standard input.
size is text size in points, angle is measured in degrees counter-clockwise from horizontal,
fontno sets the font type, justify sets the alignment.
If fontno starts with a leading hyphen, then the remainder of fontno is taken to be a textstring with the desired fontname. See the gmtdefaults man page
for names and numbers of avaiable fonts (or run pstext -L). The alignment number refers to the
part of the textstring that will be mapped onto the (x,y) point: 1 = Lower Left corner, 2 = Lower Center,
3 = Lower Right, 5 = Mid Left, 6 = Mid Center, 7 = Mid Right, 9 = Upper Left, 10 = Upper Center,
11 = Upper Right.
#include "explain_-j.txt"
#include "explain_-Jz.txt"
#include "explain_-R.txt"
OPTIONS
No space between the option flag and the associated arguments.
#include "explain_-b.txt"
- -C
-
Sets the clearance (in UNIT) between the text and the surrounding box [CLEARENCE].
Only used if -W is specified.
- -E
-
Sets the viewpoint's azimuth and elevation (for perspective view) [180/90]
- -F
-
Sets the color used for Frame and annotations. [Default is black]
- -G
-
Sets the gray-shade (0-255) or color (r/g/b, each 0-255) used for drawing the text. [Default is black]
#include "explain_-H.txt"
#include "explain_-K.txt"
- -L
-
Lists the font-numbers and font-names available, then exits.
- -N
-
Do NOT clip text at map boundaries [Default will clip].
#include "explain_-O.txt"
#include "explain_-P.txt"
- -S
-
Draw text outline. Append pen attributes.
#include "explain_-U.txt"
#include "explain_-V.txt"
- -W
-
Paint a rectangle beneath the text string. Set color [Default is 255/255/255 (white)]. Append o
to draw rectangle outline.
#include "explain_-XY.txt"
- -Z
-
For 3-D projections: Sets the z-level of the basemap [0].
#include "explain_-t.txt"
#include "explain_-c.txt"
EXAMPLES
To plot the outlines of the textstrings stored in the file text.d on a Mercator plot with
the given specifications, try
pstext text.d -R-30/30/-10/20 -Jm0.1 -P -B5 -S2 > plot.ps
SEE ALSO
gmt, psbasemap
BUGS
The horizontal justification of surrounding rectangles does not work when Greek symbols, sub- and
superscripts, and/or composite characters are imbedded in the textstring.
#include "refs.i"
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- SEE ALSO
-
- BUGS
-
This document was created by
man2html,
using the manual pages.
Time: 07:11:52 GMT, January 07, 2025