**** Documentation for TigaShow ***
**** (just a few lines indeed) ****
***********************************
******** this is version 1.5 ******
**** written by Thomas Herlyn *****
***********************************
*********** GiftWare **************
***********************************

Introduction:
-------------
This program displays images on the Commodore A2410/TIGA graphics board.
Currently images stored in the common GIF (Graphic Interchange Format, 
by CompuServe), JPEG (thanks to the independant JPEG group) and PPM
(thanks to people supporting the NETPBM package) are supported.
This is the first PD-program specialized to this board, I think
(Laire, your PostView doesn't work on my board, unfortunately).
It is Giftware in the current development phase. This means you don't have
to pay anything, but if you use it often and / or you love it, please send
me anything you want (mails, presents, programs, ZIP-Rams for A3000 etc.).
The Copyright remains to me.

Requirements:
-------------
- at least Kickstart 1.3
- C= A2410/TIGA graphics board
- A2410.DEVICE in DEVS:
- TIGA initialized by the command LOADTIGA
- IEEE libraries (by C=) in LIBS:
- JPEGTMP: assigned anywhere to your harddisk (or to RAM, if you have 
  lots of it)
- JPEGMEM (an environment variable) set to the amount of ram in KBYTEs you
  think you can afford for viewing JPEGs
- a few images (* grin *)

Installation:
-------------
Copy TigaShow anywhere you want. Assign JPEGTMP: to a place with a lot of 
free RAM (for example to your Harddisk or RAM:), 
example: Assign JPEGTMP: WORK: . Set the environment variable JPEGMEM to the
amount of RAM in KBYTES you think you can afford for viewing JPEGs, example:
SetEnv JPEGMEM 200 (200 KBytes for JPEGs), more memory gets allocated on
JPEGTMP: . SetEnv JPEGMEM 0 will work, too. That's it!

Usage:
------
from CLI: TigaShow <Path and Filename>

from Workbench: Click on TigaShow icon, SHIFT-DoubleClick on the image icon,

then look... 
and be amazed.

for a little diashow:
from CLI: TigaShow <Path1 and Filename1> <Path2 and Filename2> <...>

from Workbench: Click on the TigaShow icon, SHIFT-click the next image icons
                and SHIFT-doubleclick the last image icon,

Features:
---------
- quite fast (especially on GIFs, slower on JPEGs and slow on PPMs, I think)
- centers the picture if it is smaller than the standard TIGA screen
- does (Floyd-Steinberg) dithering on JPEGs and PPMs
- Diashow option
- can be invoked by CLI and WB (look above for USAGE)
- supports GIF, JPEG, PPM
- uses IEEE libraries, so automatically uses math coprocessor if available

SoonToCome (ToDo);
------------------
- scrolling for pictures larger than the TIGA screen.
- IFF support
- File requester
- GrayScale forcing

Hints:
------
You can use TigaShow for looking IFFs, too. You can convert any IFF to a PPM
format first (with ILBMTOPPM) and watch this PPM image with TigaShow. Using 
the NETPBM package you are able to view any type of image format. Get it if 
you want to view a picture whose format is not supported by TigaShow yet, I
can't think of a format not supported by NETPBM.
Unfortunately, piping is not possible anymore due to the automatic picture
type recognition of TigaShow.

Comments:
---------
A2410.DEVICE and LOADTIGA are not included since these are copyrighted
by Commodore, I think. You have to get them elsewhere.
Interlaced GIFs are not supported yet.
If you are interested in a version specialized to 68030/68881 please contact
me (I personally use this version, but have not compared the speed of this
IEEE library version to the 030/881 one yet).

Credits:
--------
The source is loosely based on the source of the JPEG distribution of the 
Independant JPEG Group and and on ppmqvga included in the NETPBM package.
Many thanks to the authors.

                                            Thomas Herlyn

Send Bug reports, gifts, mails etc. to

Thomas Herlyn                EMail: Thomas.Herlyn@Informatik.Uni-Oldenburg.DE
bei Willms                   IRC:   tomh
Rostocker Strasse 29
Germany 26121 Oldenburg