C-PLOT

Scientific Graphics and Data Analysis

pn

Draw annotation text on the plotter

SYNOPSIS

2D mode: pn [h v] [file]

3D mode: pn [x y z] [file]

DESCRIPTION

Annotation text can be entered one line at a time from the keyboard (or from a command file), or can be read directly from a file. In the latter case, the file is specified as an argument.

In 2D mode, the optional arguments h and v indicate the distance from the upper-left corner of the plot window to the lower-left corner of the first character of the annotation text. The default units for h and v are C-PLOT centimeters. However, if the letter u follows either of the values, both values will be interpreted in data units corresponding to the axis numbering.

In 3D mode, annotation text is written in the x-z plane. The arguments x , y and z position the plane and the lower-left corner of the first line of annotation text with respect to the upper right corner of the plane. By default, the arguments are in box units, as set with the bo command. (The default box is one unit long on each side.) If the letter u follows any of the x , y or z values, the position will be taken in data units that correspond to the axis numbering.

If the position arguments are missing, the plotter pen moves to the default or the most recent annotation starting point. If running interactively, you may then reposition the pen using the plotter's control panel. When ready to continue, hit <return>.

The default starting position for annotation text in 2D mode is h = 0.125 x x_length and v = 0.125 x y_length, where x_length and y_length are the dimensions of the plot window. The default starting position for annotation text in 3D mode is x = 0.125, y = 0 and z = 0.125.

When the annotation is drawn based on the last-used starting position, that position is remembered in terms of its actual location in the plot window, not data units.

The starting position is reset to the default if the plotting window is changed using the wi command or if the plot is turned using the tu command.

The drawing position advances a fixed amount of space after each line of input text is displayed. The maximum length of an input line is 256 characters. Input lines can be continued, however, by having a \ as the last character. A ^D at the beginning of a line terminates annotation input. An initial \ is required to enter blank spaces at the start of a line when input is from the keyboard.

Entering \C as the first character on a line of annotation will center that line of text horizontally within the current window.

The set spacing command lets you change the spacing between successive lines of annotation text in units of the character height, as set with the cs command. The default spacing is 1.5.

Changing character size within a line does not change the line spacing. The size and slant of the characters are reset to their initial values after each input line.

SEE ALSO

zn tu tx wi cs se