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: