ZS.EXE ver 2.0A by Bob Montgomery [CIS 73357,3140] 3-26-88
See revision history for new items.

This is a ZSoft (PC Paintbrush) file viewer for EGA with the following features:
* Very fast ZSoft decoding.
* Menu driven for selecting file(s) to view; returns with cursor at last
position.
* Shows marked files like a slide show, or one at a time.
* /R option allows an application program to show a file and regain control.
* Creates GIF, PC Paint, Dr. Halo, or EGA PAint file from current pic.
* Now allows creation of full size PC Paint, GIF, and EGA Paint files.
* ZS just got smarter; doesn't require # before directory spec.

The commands are:
1. zs [path\]filename[.ext] [/r] to show a single file. The default path is the
current directory, and the default extension is PCX.
The /r option shows the file and then returns to DOS (or a calling appli-
cation program) with the picture still on the screen in EGA mode (mode 16).
It is not necessary to change video mode between viewing each file, but it
is up to the calling program to reset text mode (mode 3) after all viewing
is done.

2. zs [.ext] to get a menu of up to 80 files in current dir with extension ext.
The default extension is PCX. This is handy if you have some pictures that
you don't want to come up in the normal menu; ie, adult and nude pics can
be renamed to ADL extension.

3. zs [path\][filespec] to get a menu of all files in the specified path
meeting filespec (may contain wildcards). The default path is the current
directory, and the default filespec is *.PCX; thus just entering 'zs' will
give a menu of all PCX files in the current directory.

4. zs @[path\]filename[.ext] to do a slide show from commands in filename. The
default path is the current directory, and the default extension is SLD.
The commands are placed on seperate lines, and consist of either a filename
(PCX extension assumed), or a delay (viewing time) spec of the form d n
where n is the desired viewing time in seconds. The default viewing time is
5 seconds if no delay spec is given. Press any key to end the slide show.
Pictures that are 320 or less pixels wide are displayed double size.

5. zs ? gives a help screen.

Commands in menu mode:
1. The up, down, right, and left arrow keys move the cursor around the menu
of files.
2. Pressing the spacebar marks a file for viewing or slides, and moves to the
next file; it will also unmark a previously marked file.
3. Pressing enter will display the marked files in the order they were marked.
If no files were marked, pressing enter displays the file at the cursor.
4. Pressing S will do a slide show of marked files until a key is pressed.
5. Pressing ESCape ends the program and returns to DOS.
6. Pressing Ctrl Break (or Ctrl C) will get you directly to DOS.
7. Pressing I will display the file info on the next to last line.
All other keys are ignored. If errors are encountered, an error message appears
on the next to last line, and disappears when the cursor is moved.
The menu title is the search spec.

Commands while viewing a file (except in slide mode):
1. The up/down arrow keys will scroll the picture if longer than 350 lines.
PgUp and PgDn scroll by 10 lines.
2. If it is 320 or less pixels wide, pressing 2 will give a double size image
(which may be scrollable) and pressing 1 will give the normal size again.
3. Pressing P will create a PC Paint 2.0 file with the same filename
and extension PIC. The file will be a 640x350 paint file of what is
currently on the screen.
4. Pressing G will create a GIF file with the same filename and extension GIF.
If the displayed image is 320x200, the GIF file will be this size,
otherwise it will be 640x350.
5. Pressing I will create a GIF file same as above except interlaced.
6. Pressing R will create a RIX (EGA Paint) file with the same filename and
extension SCR.
7. Pressing H will create a Dr. Halo file with the same filename and eatension
PIC; A PAL file is also createdwith the same filename.
8. Pressing enter will return to menu or DOS, or show next file for marked
menu mode.
9. Pressing ESCape will end the display and return to the menu or DOS.
10. Pressing L before pressing G, P, or R will save the picture to that
file type from the top of the current screen to the end of the
picture. Thus, if viewing a 640x480 pic, and you press LP, you will
create a PC Paint pic file that is a 640x480 image. If you had
scrolled up 10 lines, it would create a 640x470 image, etc. Pressing
S will cancel the L command. The program doesn't revert to the text
mode until the entire picture is processed when L is used, since the
EGA info would be lost. However, the disk light tells you something is
going on.
11. The following keys control the picture tone as follows:
F1 Decrease red content of picture.
F2 Increase red content of picture.
F3 Decrease green content of picture.
F4 Increase green content of picture.
F5 Decrease blue content of picture.
F6 Increase blue content of picture.
F9 'Keep' current palette; replaces original palette.
F10 Restore original (or kept) palette.
V Reverses the current palette; interesting effect especially for
black & white images.
All other keys are ignored. Pressing Ctrl Break (or Ctrl C) will go to DOS.

The program was first written in C, and then the following parts were rewritten
in assembly language (which increased the speed by a factor of 2):
1. ZSoft decoder for speed.
2. Part of GIF encoder for speed.

Small PC Paint files are saved as 640x350 images so that these programs will
not force you to a smaller screen size. They can be saved as clippings, and
then combined to produce a composite picture.
------------------------------------------------------------------------
SHAREWARE

ZS is user supported software. ZS for the IBM PC is made available for a
free ten day trial period. If you find this program useful, you may license
the program for non-commercial use on one machine by sending $10.00 to:

Bob Montgomery
123 Parsons Road
Longwood, Fl 32779

ZS may be licensed for commercial use on up to 10 computers at a single site
or set of contiguous sites for $50.00. A commercial site is defined as a
business or individual seeking to make a profit by selling ZS or incorporating
this program in another program.

Clubs, schools, universities and other organizations may license ZS for
$30.00 per 6 copies.

All other rights are reserved.

ZS may not be changed or modified in any way except by the author. ZS may
be freely distributed for the ten day trial period as long as it remains in its
complete form. Regardless of how the copy is obtained, it is requested that
all users comply with the licensing agreement.

All licensing registrations will be promptly acknowledged. All licensees
will receive prompt notification of product revisions and will be able to
purchase updates at a nominal fee.

All warranties are disclaimed, including damage to hardware and/or
software from use of this product.

Any suggestions or comments can be mailed directly to me, or left on
the following BBS's:
Compuserve
Tsunami BBS, Half Moon Bay, Calif. (415) 726-2726
PC Rockland, S. Nyack, NY (914) 353-2538 [Freeboard] 600+ Meg Online
---------------------------------------------------------------------------
Revision history:
ver 1.0 1-24-88
Original release.

ver 1.1 1-30-88
Added doubesize viewing for images <= 320 pixels wide.
Fixed bug in GIF converter when odd number pixels horizontally.
Did ZSoft decoding in assembly language for speed.
Added instantaneous screen change in slide mode from menu or command
file. Was going to add it in marked viewing (with enter key),
but with the 'save as other file formats' and doublesize options
it got too messy.

ver 1.2 2-12-88
Added the /r option which allows an application program to call ZS
to view a file and then regain control.
Improved the slide mode screen change speed.

ver 2.0 3-26-88
Added the ability to view long ZSoft files ( > 350 lines).
Added the H (Dr. Halo) file creation option while viewing.
Added the L prefix to P, G, and R file creation commands while viewing
to save long pic files. L doesn't work with I or H yet.
Added the Info command from the menu.
Deleted the # requirement to specify a directory from the command
line. ZS now looks for a directory which meets the spec on the
command line. If none is found, it assumes the spec is for a
single file.
Added F1 - F10 palette control keys while viewing a file.

ver 2.0A Fixed decoder so will handle all PCX files.
Eliminated DOS CLS command.