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