README.TXT for the JIS package v1.1 
===================================

INTRODUCTION:
-------------

This JavaBean library supports saving Java AWT images in the following 
formats: 
  - Macintosh PICT.
  - Windows/0S2 Bitmap BMP.
  - Uncompressed TIFF.
  - TrueVision Targa. 

The library may also be used as a normal class library.

New formats including compressed TIFF, JPEG, PNG, WMF and so on 
will be supported very soon. The JIS package is pure Freeware/Postcardware 
and will so remain for the current formats. New formats will be added 
and distributed in the same way and as shareware for some formats.

You should also take a look at the Java Vector Graphics (JVG) package on 
our Web site. 
It allows you to record, save and replay graphical operations. It also 
includes serialized images, Macintosh PICT import and other interesting 
stuff. 

Faidon is a finnish company, which is the reason for calling the 
packages fi.faidon.*, although our Web site is at 
http://web.avo.fr/faidon . 


MINIMAL CONFIGURATION:
----------------------

Any system that has a Java Virtual Machine. However, the beans have 
only been tested with Sun's Java (1.1.5, 1.1.6) and the Sun BeanBox of 
February 1998. It should work without 
problems with Microsoft JVM, even though the Microsoft JVM is not that 
stable for image displaying... (personal experience).

 
INSTALLATION:
-------------

Unzip the archive where you like on your disk. The included 
fiels are: 

  - JIS.jar: the beans archive.
  - Some .BAT files to launch the example applications on Windows systems.
  - Testimg.gif and Testimg.jpg: two example images. 
  - Image1.jpg and Image2.gif: two example images. 
  - ImageSaveApplication.java and ImageSaveApplication.class: a 
	small, very simple application that uses the image saving beans. 
	It is a kind of mini-graphic-converter, in fact.
  - TestAllFormats.java: Command-line application to convert the given 
    image into all the supported formats.
  - TestPICTSave.java, TestBMPSave.java, TestTIFF.java, TestTarga.java: 
  	Command-line applications that convert the given image into the 
	corresponding format. 
  - The "docs" directory, which contains the documentation of the 
    classes in JIS.jar produced by javadoc.
  - ImageSaver.ser : a small example application made with 
	the BeanBox which shows how to use the beans in a component 
	using application maker. See the methods "setupBeanConnections" 
	and "propertyChange" in "ImageSaveApplication.java" to understand 
	how to connect the components.

"JIS.jar" of course has to be copied into the into the 
"jars" directory of the BeanBox if you want to use it with the 
BeanBox.


USE:
----

Launch "GoImageSaveApplication.bat". You have four buttons: 
  - Open file ... : To open an image.
  - Save TIFF ... : To save the image in TIFF format.
  - Save Targa ... : To save the image in Targa format.
  - Save PICT ... : To save the image in PICT format.
  - Save BMP ... : To save the image in BMP format.
  - Quit : Quits the application.

The other .BAT files are:

  - GoSaveAll.BAT : Converts an image into all the supported formats using the 
                    command line.
  - GoPICTSave.BAT : Converts an image into PICT format using the 
                     command line.
  - GoBMPSave.BAT : Converts an image into BMP format using the 
                    command line.
  - GoTargaSave.BAT : Converts an image into Targa format using the 
                      command line.
  - GoTIFFSave.BAT : Converts an image into TIFF format using the 
                     command line.


HOW TO REGISTER:
----------------

The contents of this package (beans, ...) are Postcard- and E-mailware. 
in their current state. Please inform me if you find these utilities 
useful. Also do it if you find any bugs or if you have suggestions. 

Those who have registered will get a reduction on the future 
shareware version (even though it probably won't be that expensive). 
If you want to get the source code, then contact me. I haven't 
decided what distribution policy to use yet.

Send E-mail messages to: 

	faidon@avo.fr

and postcards to: 

	Faidon Oy-AB
	Kary FRAMLING
	1, Allee de la Louve
	42100 Saint-Etienne
	FRANCE


VERSION HISTORY
---------------

Version 1.0 (April 1998)

	1. Saving as uncompressed TIFF and uncompressed Truevision Targa. 
	2. Example command-line applications. 
	3. Small image converting application. 
	4. Example of Bean use with BeanBox of February 1998. 

Version 1.1(4 June 1998)

	1. New formats : Macintosh PICT and Windows/OS2 bitmap BMP.
	2. Corresponding example programs and a new program that saves an image in all the supported formats.


THE USUAL LEGAL STUFF JUST IN CASE
----------------------------------

Disclaimer of Warranty. 
Software is provided "AS IS," without a warranty of any kind. ALL EXPRESS OR
IMPLIED REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT, ARE
HEREBY EXCLUDED. 

Limitation of Liability. 
The author and Oy Faidon Ab SHALL NOT BE LIABLE FOR ANY DAMAGES
SUFFERED BY LICENSEE OR ANY THIRD PARTY AS A RESULT OF USING OR DISTRIBUTING
SOFTWARE. IN NO EVENT WILL the author or Oy Faidon Ab BE LIABLE FOR ANY LOST REVENUE,
PROFIT OR DATA, OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR
PUNITIVE DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY,
ARISING OUT OF THE USE OF OR INABILITY TO USE SOFTWARE.
