McIDAS User's Guide
Version 2019.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

 

(DESC)

band use description from SATBAND file

 

(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)

text description in SATANNOT file for the image's sensor source number, 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

 

(DAYJ)

day + Julian day, dd mon 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:

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]