Short:      Cybergfx only picture viewer V1.13
Uploader:   al.renard@infoboard.be(Alain Renard)
Author:     al.renard@infoboard.be(Alain Renard)
Type:       gfx/show
Version:    1.13

New in version 1.13
===================
- Added the LIST/K argument in the command line. See Below.

New in version 1.12
===================
- The grayscale images are now loaded/saved as grayscale in TIFF format
- Added Gamma for PNG loading
- More prefs are saved now

New in version 1.11
===================
- Load and save TIFF images.
- Now you can resize the picture freely.
- New menu item: Gamma correction.
- ATTENTION : ixemul.library is now needed!
- ATTENTION : new prefs file format...sorry! :(

In short:
=========
Show is a picture viewer for CyberGraphics systems.
It can decode the next picture formats:
- JPEG,PNG,GIF,TARGA,BMP,PPM,TIFF
and can save in
- JPEG,PNG,TIFF and RAW
It open on a CyberGraphics screen (16/24bits) only.

Invocation (Shell only):
========================
	Show FILES,MODEID/K/N,LOOP/S,NOERROR/S,GETMODEID/S,LIST/K

FILES:
	- Just a filename, eg : RAM:T/mypic.jpg
	- A pattern, eg: RAM:T/#?30#?.tiff
	- A directory, eg: RAM:T/
	  Equivalent to RAM:T/#?
	  (You have to put the '/' at the end to indicate a directory!)

MODEID/K/N:
	The screen mode (in decimal)

LOOP/S:
	If you want endless loop in viewing.

NOERROR/S:
	If you do not want the errors being reported.

GETMODEID/S:
	Force the mode requester to appear before the program starts.

LIST/K:
	Take precedence over the FILES argument.
	When present, Show will read the list file given instead of reading images directly.
	The list file is made of lines of text, each of which is a file name.

	Example:
		Show LIST RAM:mylist

		and the content of the file RAM:mylist is:

		WORK:pics/png/john.png
		WORK:pics/tif/blue_parrot.tif
		DATAS:mypics/eros/Regina.jpg
		...


These options take precedence over the preferences saved.
You can also invoque Show simply by
	Show
and a filerequester will appear for you to choose your files.

Usage:
======
Not much to say, apart for the Compose menu:
Compose allow you to...compose several images in a big one.
To achieve that, you have to 'memorize' the images first.
So say you want to compose image1.jpg, image2.jpg, image3.jpg and image4.jpg:
	- a) load the images (!)
	- b) while each image is displayed, memorize it (menu 'Image/Memory/Memorize Image')
	- c) compose (menu 'Image/Memory/Compose Memorized Images')
Here you can choose the layout and the space between images.
Press 'OK' to save it.
Note: Pressing HELP in the main window help to remember some keyboard shortcuts
while composing or cropping.

XPK:
Files compacted/crypted with XPK are OK.
You can even crypt your images from within the program.

Preferences:
============
The preferences are saved in ENVARC:Show.prefs and ENV:Show.prefs.
'Preserve Files Dates' allow you to save over a file, while retaining
it's date stamp.
Files Comment are always preserved.

You can customize the keyboard as you like.

Versions:
=========
There are 2 versions, one for 68000 and the other for 68040 *AND* a FPU.

And...This program is TOTALLY FREE ;)


Notes:
======

a) I'm NOT a programmer, so please forgive me if you find bugs!
   Anyway, your comments are always welcome; PLEASE email me
   if you have bugs reports, comments, encouragements, etc...

b) Yes, this program still lacks many things!
   I would like to have datatypes support, but I dont have a
   clue how to gain control over the image datas in this case.
   (If YOU know how to do this, let me know...)

c) Compiled with gcc-2.7.2.1.
   It is slow and (IMHO) buggy, but it's free!

END.