ADDHEAD      BDIF      CGADISP   LOWPASS   PIXX320   PSUM
***





ADDHEAD
Add ImTek header to a pure 8 bit/pixel binary picture file.
USAGE: addhead source,destination,number_of_lines,number_of_pixels/line
->Source is a binary format 8 bit/pixel image file.
->Destination is a new ImTek format file with .pic extension by default.
->Number_of_lines is the number of lines in source picture file.
->Number_of_pixels/line is the number of pixels/line in source picture file.
***





BDIF
Generate a new image file from the difference between two given image files.

USAGE: bdif source1,source2,destination[,scale,offset,difscale]
->Source1 and source2 are two image files (with a .pic extension by default).
->Destination is a new difference file with .pic extension by default.
->Scale (Integer:  1 to 127) is used to multiply difference image. Default
value: 1.
->Offset (Integer: 0 to 255) is added to difference image. Default value: 128.
->Difscale (float:  0. to  1.) is  used to  multiply source2  prior to 
obtaining difference. Default value 1.0.
***







CGADISP
Display a given image file on a color graphics card using pseudocolors to map
four ranges of gray  scales. Various other options are available such as
histogram equalization mapping, pixel gray-scale display, windowing different
areas of the image file to the 256 pixel by 200 line display etc.

USAGE disp,source,low,high[,line_begin,pixel_begin]
->Source is an image file with a .pic extension by default.
->low (integer: 0 to 254) defines begin of gray-level stretch.
->high (integer: 0 to 255) defines end of gray-level stretch.
Note: If both low and high are zero, historgram equalization is performed.
->line_begin (integer: 0 to numlines-200) is starting line of window. Default: 0
->pixel_begin (integer:  0  to  numpixels-256)  is  starting  pixel  of  window.
Default: 0
___
*Options after starting program:
L -> LUT; Do a new gray scale stretch of displayed image.
T -> Threshold; Display image thresholded at entered value.
W -> Window; Select new values for starting line and pixel of displayed window.
G -> Grid on/off at every 16th line and pixel.
F -> Full screen on/off to show help options or display up to 320 pixels/line.
E ->  Equalize; Perform  histogram equalization  on displayed  window.
Different windows of a given image are likely to require different
equalizations for best results.
X -> eXit program.
P -> Plane; Select one of the bit planes of 0 to 7.
S -> Savepix; Save  the contents  of the graphics memory using the current file
name with extension .pix
Q ->  QLUT; Like  LUT but  low defines the upper gray level of the first bin
and high defines  the lower  gray level  of the  fourth bin.  The other  2
bins  are linearly stretched.
I -> Invert displayed image.
C ->  Calibrate x  and y scale factors for dump routine. Distance between
marker and cursor wwill be calculated as a function of these scale factors.
3 ->  Perform 3 level histogram equalization. This option is for high-
resolution graphics applications.
H ->  Same as  option Q  except only  3 gray levels are used. This option is
for high-resolution graphics applications.
___
                    Dump and ROI (Region of Interest) Modes
D -> Dump; Read gray-scale value of selected pixels. Keypad numbers except 0
and 5 steer cursor. Ins toggles increment between 1 and 10.
* -> Save pixel value in file SAMPLE.DAT. Active only during dump.
* ->  Enter line  segment defined  by marker  and cursor  into ROI.  Active
only during ROI.
Del -> Move marker to Cursor position. Active only during dump.
+ ->  Enter ROI  (Region of  Interest) Mode.  Active only  during dump. Left
and right cursor  keys position  cursor, End  & PgDn position marker. Cursor
must be positioned to top of region of interest before entering ROI mode.
Space Bar -> Exit from Dump or ROI mode.
***







LOWPASS
Generate a new image file by convolving a given image with the 3 X 3 kernal
in which each element is 1/9.

USAGE: lowpass Source Destination
->Source is an image file with .pic extension by default.
->Destination is a low-pass filtered version of the source file with .pic
extention by default.
***







PIXX320
Print a  given .PIX file on an Epson or Epson-compatible printer using four
gray levels and up to 320 pixels per line. The .PIX format file is generated
by issueing the save command in the display program. For IBM graphics printers,
set the DOS environment variable PRNTR equal to 1:

SET PRNTR=1

For C Itoh printers, set PRNTR equal to 2:

SET PRNTR=2

USAGE: pixx320 PIX_file
***







PSUM
Generate a new image file from the sum of two given image files.

USAGE: bsum source1,source2,destination[,weight,offset]
->Source1 and source2 are two image files (with a .pic extension by default).
->Destination is a new sum file with .pic extention by default.
->Weight (float: 0 to 1.0) Adjusts proportions of 2 images. For a value of 1,
the destination file will contain only source 1. For a value of 0, the
destination file will contain only source 2. Default value .5.
->Offset (integer: -255 to 255) is added to sum result. Default value 0.
***