McIDAS User's Guide
Version 2012.1
[Search Manual]
[Table of Contents]
[Go
to Previous]
[Go
to Next]
ZA
Writes
text and/or symbols on the graphics frame.
Format
ZA color
height justify [keywords] "text
Parameters
color |
graphics
color level; 0 for erase (default=1) |
height |
pixel
height to draw text and symbols (default=10 for text; cursor height for
TCYC keyword symbol) |
justify |
justification
of the text and symbols; specify one of the options below; see the Remarks |
|
LA |
left
justified above the center of the cursor |
|
LC |
left
justified at the center of the cursor |
|
LB |
left
justified below the center of the cursor (default) |
|
CA |
center
justified above the center of the cursor |
|
CC |
center
justified at the center of the cursor |
|
CB |
center
justified below the center of the cursor |
|
RA |
right
justified above the center of the cursor |
|
RC |
right
justified at the center of the cursor |
|
RB |
right
justified below the center of the cursor |
|
M |
mouse
justified; see the Remarks |
|
N |
same
as the CC option, but allows numerous plots of the text or symbols by
pressing mouse buttons; see the Remarks |
|
V |
vertically
aligned; the upper-left corner of the first letter or symbol is placed
at the cursor center; subsequent text and symbols are written below |
"text |
text
to write on the graphics frame; you may use uppercase and/or lowercase
letters; quotes are mandatory and may be substituted with curly brackets
( { } ); see the Remarks for instructions on how to
plot weather symbols and arrows; the following placeholders can be specified
for text substitution of information from the frame, dataset or displayed
image; the output format is indicated in italics, e.g., nnn |
|
(FRAME) |
frame number, nnn |
|
(DATASET) |
ADDE dataset
name, 24 characters maximum |
|
(POS) |
ADDE dataset
position, nnnn |
|
(BAND) |
band number, nn |
|
(WL) |
wavelength, nn.nn unit |
|
(WN) |
wave number, nn.nn unit |
|
(FREQ) |
frequency, nn.nn unit |
|
(ID) |
NEXRAD station
ID, 3 characters |
|
(MEMO) |
memo field,
32 characters maximum |
|
(SS) |
sensor source
number, nnn |
|
(STYPE) |
image type,
12 characters maximum |
|
(ERES) |
element resolution, nn.nn |
|
(LRES) |
line resolution, nn.nn |
|
(RES) |
displayed resolution
of the image, nn.nn |
|
(EGEORES) |
geographical
element resolution in km, n.nn; see the Remarks |
|
(LGEORES) |
geographical
line resolution in km, n.nn; see the Remarks |
|
(GEORES) |
geographical
resolution in km, (n.nn X n.nn KM); see the Remarks |
|
(DAY) |
day, dd mon yy |
|
(MDY) |
day, mon dd yy |
|
(JDAY) |
Julian day, ccyyddd |
|
(TIME) |
image time, hhmmss |
|
(HH) |
image time, hh |
|
(HHMM) |
image time, hh:mm |
|
(HHMMSS) |
image time, hh:mm:ss |
Keywords
Ang= |
angle
to write text; do not use with the FONT command or global keyword, or
keywords ENCL and TCYC |
Encl= |
C |
draws
a circle around the text in the N mode |
|
E |
draws
an ellipse around the text in the N mode |
FULlframe= |
YES |
use
the entire frame for output, regardless of the panel configuration; do
not use FUL=YES with the global keyword PAN |
|
NO |
limit
output to the current panel or the panel specified with the global keyword
PAN (default) |
Gra= |
graphics
frame number (default=current) |
IMA= |
image frame
number to use for determining values of placeholders in the "text parameter
(default=current) |
POS= |
lin
ele |
TV
line and element position to draw text, symbols, or arrows (default=current
cursor position) |
TCYc= |
color
hemi
plots
a hurricane or tropical storm symbol centered on the cursor or the position
specified in the POS keyword; the justify paramater is ignored |
|
|
color |
graphics
color level of the symbol's center |
|
|
|
X |
leave
the center blank |
|
|
hemi |
determines
the direction of spirals |
|
|
|
S |
southern
hemisphere (default) |
|
|
|
N |
northern
hemisphere |
Wid= |
graphics
line width, in pixels; the maximum is 64 (default=current) |
Remarks
Use
the global keyword FONT to change
the font for a single command entry. See Appendix
A, Global Keywords. Use command FONT to change fonts for all graphics
commands.
To write lowercase
letters, toggle the Caps Lock key or press the Shift key
when typing. Press it again before entering the next command, as McIDAS commands
are normally entered in uppercase letters.
In the justify parameter:
- left justified
(LA, LC and LB options) means the text begins at the cursor position and
extends to the right
- right justified
(RA, RC and RB options) means the text ends at the cursor position and extends
to the left
- center
justified (CA, CC, CB and N options) means the text is horizontally centered
at the cursor position so it extends equal distances to the left and right
The (GEORES), (LGEORES) and (EGEORES) placeholders can be
used only if GEORES=YES was specified in the IMGDISP command that displayed
the image. The resolution values, listed as n.nn in the Parameters
section above, are in kilometers and are displayed in the format 0.nn, n.nn, nn.n or nnn (depending
on the magnitude of the resolution). The two resolution values displayed with
the (GEORES) placeholder are the same as (LGEORES) and (EGEORES), in that order.
When you specify
the M option for the justify parameter, the position of the mouse
and the clicking of its buttons control the location of the cursor text. Clicking
the middle mouse button repositions the start of the text at the cursor location.
Clicking the right mouse button repositions the end of the text at the cursor
location. The height is scaled as needed. Using the FONT command or global
keyword with the M option positions the text horizontally at various sizes.
You can't change the angle of the text.
If you specify
the N option for the justify parameter, clicking the middle mouse
button centers the text at the cursor location. Clicking the right mouse button
erases the last drawn text.
To plot weather
symbols and arrows, enter a dollar sign ($) before any of the alphanumeric
characters shown below.
| T
- thunderstorm |
 |
C
- clear |
 |
0
- arrow |
 |
| W
- rain shower |
 |
Q
- partly cloudy |
 |
1
- arrow |
 |
| X
- snow shower |
 |
B
- mostly cloudy |
 |
2
- arrow |
 |
| R
- rain |
 |
O
- overcast |
 |
3
- arrow |
 |
| S
- snow |
 |
D
- drizzle |
 |
4
- arrow |
 |
| Z
- freezing rain |
 |
H
- haze |
 |
5
- arrow |
 |
| |
|
F
- fog |
 |
6
- arrow |
 |
| |
|
$$
- dollar sign |
$ |
7
- arrow |
 |
Tropical storm
and hurricane symbols are plotted at the center of the cursor, regardless of
the justification specified.
The practical
maximum number of characters for keyword ENCL is three.
Examples
ZA "Wisconsin
This entry
writes the word Wisconsin in graphics color level 1 on the current
graphics frame. The letters are 10 pixels high and are left justified below
the center of the cursor.
ZA 3 15 LA "McIDAS
This entry
writes the word McIDAS in graphics color level 3 on the current graphics
frame. The letters are 15 pixels high and are left justified above the center
of the cursor.
ZA 2 20 CC GRA=2 {streamlines}
This entry
writes the word streamlines in lowercase letters in graphics color
level 2 on graphics frame 2. The letters are 20 pixels high and centered on
the cursor. Curly brackets are used instead of the double quote.
ZA 4 7 V FONT=HELBO "Nevada
This entry
writes the word Nevada vertically on the current graphics frame in
graphics color level 4 using the bold, oblique Helvetica font. The upper-left
corner of the N is at the cursor center. The letters are seven pixels high.
ZA 4 20 LC ANG=45 "Green Mountains
This entry
writes Green Mountains at a 45° angle in graphics color level
4. The letters are 20 pixels high and left-justified in relation to the cursor.
ZA 5 12 LB FONT=COUBR "GOES-12 Band (BAND) ((WL)) from (DAY) at (HHMM)
UTC
This entry writes the specified text in graphics color level
5 using a bold Courier font. The characters are 12 pixels high and are left
justified below the center of the cursor. The placeholders (BAND), (WL), (DAY)
and (HHMM) are replaced with the corresponding values from the displayed image.
[Search Manual]
[Table of Contents]
[Go
to Previous]
[Go
to Next]