Help for TEXTAD
PURPOSE AND OPERATION:
TEXTAD is an application program which allows a user to overwrite
an image with text and/or rectangles.
The section of the input specified in the SIZE parameter is first copied
and then operated on by the program.
COMMAND FORMAT:
TEXTAD INP OUT SIZE PARAMS
where INP, OUT, and SIZE are standard Vicar parameters and PARAMS includes
special parameters for TEXTAD. All parameters are described in their
respective parameter section in TUTOR mode.
Example:
TEXTAD A B SIZE=(1,1,4000,4000) 'LARGE 'WHITE TEXT=(1200,600,1220,607) STRING=("HOW CAN YOU BE IN TWO PLACES AT ONCE", "WHEN YOU ARE REALLY NOWHERE AT ALL")
This will add two lines of text to an output picture. The first
line of text will be located with the upper left corner at pixel
number 1200,600. The second line will be located relative to
1220,607.
RESTRICTIONS:
A maximum of 100 text strings may be specified.
Each string has a maximum of 100 characters.
A maximum of 75 rectangles may be specified.
Line/Sample coordinates entered as parameters are in terms of the
input image.
The characters that TEXTAD recognizes are all the alphabetic and numeric
characters, and most special characters. The special (non-alphanumeric)
characters recognized are:
$ . , < > ( ) + - _ ! ? : ; / * # ' " = & %
All alphabetic characters are written as upper case, regardless of the
case of the input string parameters.
The quote (") and ampersand (&) characters have some special restrictions
due due their syntactic significance for TAE:
To include a quote in a string, the string must be inside quotes and the
quote character to be included must be doubled. E.g.:
string="He said ""Hi""" yields the string: He said "Hi".
To include an ampersand character in a string, the ampersand must be
doubled; the string need not be quoted (unless required because of some
other character). E.g.:
string=&&out or string="&&out" both yield the string: &out.
*************************
WRITTEN BY: M. BLACKSTONE
COGNIZANT PROGRAMMER: C. C. AVIS SEPT. 1984
DOCUMENTATION AUTHOR: SUE LAVOIE
REVISION: 3
PARAMETERS:
INP
input data set
OUT
output data set
SIZE
standard VICAR size field
SL
starting line
SS
starting sample
NL
number of lines
NS
number of samples
LARGE
'LARGE - large characters
DN
The DN used to form characters
Valid: WHITE, BLACK, MODULATE
BACKGRND
Set the text background
to this DN
ADD
add this DN to create the text
AREA
Defines rectangle areas
SL1,SS1,EL1,ES1,
SL2,SS2,EL2,ES2, ...
TEXT
Defines starting coordinates
for strings
SL1,SS1, SL2,SS2, ...
STRING
Character strings to be written
"string1","string2", ...
See Examples:
Cognizant Programmer: