Manual for ShowOnA2024 38.7


ShowOnA2024 (© 1993 Daniel Wicke) is a programm for displaying 
IFF ILBM pictures on a Commodore A2024 grey scale monitor.
Pictures may either be shown in their original resolution, or converted
for the special A2024 high resolution mode. Pictures with more than
8 colors (4 colors for high resolution mode) will be dithered.

The programm requires OS2.0+
A2024 monitor recommended (but not included ;-)

Legal Stuff

This programm is shareware. It is copyrighted.
It may be freely distributed for non-commercial purposes only as
long as the archive remains complete an unchanged.

This programm may not be part of any other software pakage without 
the authors permission.

If anyone uses this programm on a regular basis, she/he shall pay
a fee of 10,-DM /US$ 10 (or whatever is thought to be appropriate)
to the author.

Daniel Wicke               EMail:
Laaken 74                  wicke@wpts0.physik.uni-wuppertal.de
D-42287 Wuppertal


File lengths for version 38.7;

   ShowOnA2024        28744 Bytes
   ShowOnA2024_D.doc   4607 Bytes
   ShowOnA2024_BG.doc  2837 Bytes



Description

 ShowOnA2024 may be started either from Shell or from Workbench. If no options
are given, it is attempted to show the picture in its original screenmode and
depth with an adapted color palatte. If it is not possible to open a screen 
with the required depth, a screen of depth 3 is used and the picture is 
dithered.

Shell-Usage:
   ShowOnA2024 Filename [Dither][Depth n][A2024][Aspect][MaxSize][Border]

Filename: What do you expect?
Dither: forces a picture to be dithered.
      This option is set automatically, if the depth of the picture is greater
      than the hardware allows. (I.e 128 colors on ECS machines or 16 colors
      for A2024 mode)
Depth n:  sets the number of planes for dithering to n (n=1,2,3).
      Depth implies  Dither. Default is 3 (2 for A2024 mode).
A2024: sets screen mode to  A2024_15Hz.
Aspect: turns on the aspect correction for dithered pictures.
      For the moment this works only when A2024 is also set.
MaxSize: causes the picture to be scaled to maximum size. 
      This implies  A2024, Aspect and Dither.
Border: causes the picture to be shown in a window with a border.
      Defaul is a borderless window.


Quitting the programm

You can exit the programm by pressing 'Q', 'ESC' or 'Ctrl-C' even while loading.
Mouse users may use the 'Stop' gadget while loading or an invisible CloseGadget 
in the upper left corner of the pictures window.

Comments or suggestions

If you have comment, suggestions or would like to make a bug report,
please feel free to contact me (EMail preferred). 

Daniel