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.