  	    PICDEX VERSION 1.20 SHAREWARE


1. OVERVIEW

Picdex  was developed using Delphi 3.01. It is a quick image
viewer with a number of useful features and  a powerful 
collage creation capability. One of its strongest features is
the fact that it is a MDI application which allows you to view
and manipulate a number of images in one main window. For a  
quick look at some of the features of Picdex see section 3.

For those of you developing in Delphi who wish to modify this
version of Picdex to suit your own requirements the source code
is available. (See section 9)

2. INSTALLATION

To install simply unzip the PICDEX.ZIP file and double click on
the setup.exe file. The install wizard does most of the hard work 
and once installation is complete you will have the following files
on your system:

    Picdex.exe   (defaults to the C:\Program Files\Picdex directory)
    Nviewlib.dll (defaults to the C:\Program Files\Picdex directory)
    Readme.txt   (defaults to the C:\Program Files\Picdex directory)
    _deisreg.isr (defaults to the C:\Program Files\Picdex directory)
    _isreg32.dll (defaults to the C:\Program Files\Picdex directory)
    Delsl1.isu   (defaults to the C:\Program Files\Picdex directory)
    Picdex.ini   (defaults to the C:\Windows)


Note in total these files take up about 758 KB. You can now delete
all the setup and zip files as they are no longer necessary.

To uninstall simply go to the windows Settings | Control Panel and 
activate the Add/Remove Programs application. Proceed with the
removal of Picdex.

3. FEATURES

Some of the features of Picdex ver 1.01 are briefly summarized
here:

	* MDI application - can load single or multiple images
	* Collage creation - assemble a number of individual 
	  images and save the collage as a single image
	* Clipboard aware
	* Can view a variety of image formats
	* Can playback .AVI video clips
	* Standard set of controls with hot keys - Next, Previous,
          Delete, Close, Close All, Save, Save As, Open and plenty
          more!
	* Auto fit to screen (Automatically sizes image to fit
          screen maintaining aspect ratio)
	* Magnify / Reduce capability (Zoom in and out using linear
          interpolation or QuickZoom)
	* Resize image capability (Enter width and height values)
        * Crop and Paste functionality
        * Slide show - adjustable timer allows auto display of a
          directory of images
        * Windows association of supported image extensions
          (Associate the PicDex application with the image
          extension(s) of your choice in the Explorer and then
          just double click on the file name to activate)
        * Right click menu of popular commands
        * Region of Interest (ROI) aware - using the left mouse
          button demarcate a Region of Interest on the image, any
          further manipulation of the image i.e. Zoom, Copy etc.
          will now effect only the demarcated area.
        * All user settings from the last working session are
          recalled i.e. Directory, Zoom Factor, JPG quality
          factor etc. Most of these can be set from the Settings
          menu item.




4. KEYBOARD COMMANDS

Besides the main menu and the Right Mouse Click PopUp Menu the
following hot keys are available:

        * F1 - Show About Information
        * F2 - Save Image
        * F3 - Load Image(s)
        * F4 - Save Image As
        * F5 - Fit Image to Screen
        * F6 - Crop demarcated area
        * F7 - Restore original Image
        * F8 - Move Image to Home position
        * F9 - Activate Slideshow
        * F11 - Zoom In (Magnify Image)
        * F12 - Zoom Out (Reduce Image)
        * Space bar or  up arrow key - Displays next image
        * BackSpace or down arrow key  Displays previous image
        * Pg Dn | Pg Up | -> | <- - Moves image down,up,right and
          left respectively
        * Cntrl + Tab - Toggle between images
        * Cntrl + Ins - Copy
        * Shift + Ins - Paste
        * Del - Delete Image (NB deletes image does not post to
          Recycle Bin)
        * Ins - Display next image without closing current image
        * Alt + F3 - Close Image
        * Alt + F4 - Exit Application
        * Alt + F5 - Close All Images
        * Cntrl + M - Create Collage Canvas (see section 6)
        * Cntrl + P - Paste to Collage Canvas (see section 6)
        * Cntrl + I - Invert Image
        * Cntrl + R - Rotate Image 90 degrees



5. SYSTEM REQUIREMENTS

Picdex has been tested on both Windows 95 and Windows NT 4.
Although not necessary Picdex works best in a 800x600 graphics
resolution with a Color Palette set at 24 bit True Color.



6. TIPS

When using Picdex one can either load a batch of images at once
and then toggle through the selection using the Cntrl + Tab keys
or select the first image in the directory and hit the space bar
to display the next image. Note pressing the space bar first
closes the active image and then displays the next image. If you
wish to retain the active image press the INS key - this displays
the next image with out closing the current image.

Using the Windows95 explorer I have associated most image
extensions with the Picdex application. This allows one to double
click on an image file name in the Explorer and quickly view the
image using the Picdex application.

ROI - Region Of Interest:

Demarcating a region of interest on an image is undertaken simply
by holding down the left mouse button and dragging the mouse
accordingly. Once you have demarcated an area you can apply one of
the available image processing operations to it for example Zoom
In, Invert , Rotate etc. This will take effect on the demarcated
region. Try the Copy and Paste functions - only the ROI will be
pasted to the New Image.

Collage Creation:

I often come across the situation that I have a number of smaller
images that I would like to arrrange on one canvas and save as a
single  image. For this I have implemented a utility that enables
one to create a collage from a number of individual images. To do
this select the images that you wish to use in your collage comp-
ilation. Then press the Collage Canvas speed button (CC on the
ToolBar or look in the main menu under File) in order to create
a background canvas on which to paste your individual images.(Note
if you go to the settings dialog box you can set the background of
the Collage canvas to your preference.) Now use the Cntrl +Tab
key to switch to the image of your choice, demarcate an area on
this image or just select the whole image and then press the
Collage Paste button (CP on the ToolBar or use the PopUp menu).
The Collage Canvas now appears and you can position your image
anywhere on this canvas by moving the mouse. At the desired
location left click the mouse button and the image will be
anchored at that location. Continue this process until all the
single images have been placed upon the Collage Canvas and then
save the collage as a BMP or JPG. Remember to use the Pg Dn ,
Pg Up , -> , <-  to move an image or even the Collage Canvas itself
if necessary.

7. FUTURE ENHANCEMENTS

A number of enhancements are to be made to this version of Picdex
namely :

        * The collage creation utility will be refined with a lot
          of additional extras i.e. text insertion, borders etc.
        * The playback of video clips will be enhanced - better
          controller
        * More color image processing operations will be included
        * Thumbnail creation
        * Refinement of the slideshow selection
        * Batch delete/move capability
        * Help menu

Any suggestions will be welcome

8. CREDITS

Thanks go to K. Nishita for writing the excellent NviewLib.dll.


9. DEVELOPERS DETAILS

Author of Picdex   - 	 George Vrahimis
Email address      - 	 gvr@msi.imt.za

To register this version of Picdex please mail US$5 to 
the following address. This will entitle you to free
updates and bugfixes as they are developed.

Mail Address       - 	 26 Harry De Stadler Close
			 Fish Hoek
			 7975
			 South Africa



For those of you who are working in Delphi and  wish to adapt
this version of Picdex according to your own requirements the
complete source code is available at a cost of US$5. Note the 
decoding of the image formats is done by the NviewLib.dll.
If there is a demand for a customized version of Picdex please
email me with your request.


