Short:    Univ. loader&anim.saver for XiPaint
Author:   Helmut Hoffmann
Uploader: Helmut Hoffmann
Type:     gfx/misc
Kurz:     XiPaint-Universal-Lader&Animationssp.Modul

HHsFastUniversalXiPaintModule 5.3 (incl. PhotoCD- & TrueColorAnim-support)
=================================

New: Registered module users can now order my new programs "PhotoAlbum"
     or the package of "PhotoAlbum" and "CyberShow Professional" for special
     sidegrade prices! See PhotoAlbum documentation for details...
     Both programs are usable on all Amigas with at least OS3.0.

new in V5.2: Support for 15Bit IFF-ILBM images

new in V5.1: Extended DEEP loading functions (to be compatible with
               new variants as created e.g. by TVPaint 3)

new in V5.0: Loading support for progressive JPeg files
             Documentation in Amiga Guide format
               
new in V4.x: Downscaled loading support: Loading big pictures in downscaled
		form can save much memory and time. Finally a way to get
		your "too big" pictures into XiPaint...
	Included JPeg support (esp. useful e.g. for downscaled loading)
	Automatic installation script added.
new in V3.0: TrueColor animation saving support in HHsYUVSq animation format
	->create your own TrueColor animations for playback on CyberGraphX
	  with CyberTVPlayer or on EGS with EGSTVPlayer <-
	Including ARexx script for automatic conversion of picture
	  directories into HHsYUVSq animation format

This universal module can be used to load images in many file formats
(more than 20 and additionally Datatypes) very fast into XiPaint (including
optional downscaling) and to create TrueColor animations in HHsYUVSq
animation format.

Warning: I am aware that illegal/modified keyfiles of this module may exist.
!Use of such keyfiles ("hhsxipaintmodkey.library") is strictly prohibited and
!can lead to undefined results and problems! For a program which you use
!you should also be willing to pay the shareware fee. Only if enough users
!register I will be able to do further improvements or create other graphic
!applications. You can also help me by sending me illegal keyfiles of
!this product which you find somewhere.

Supported file formats
----------------------

Supported file formats for loading:

* IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 15Bit, 24Bit)
* JPeg (color and greyscale; see notes below)
* PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
* PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
* QRT (also known as dump format by PD raytracers as POV-Ray)
* Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
* PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
* MacPaint (b&w compressed 1Bit format; datafork only)
* BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
* TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
* EGS7.x window iconification file format
* DEEP (compr.&uncompr. 24Bit and 32Bit)
* RGB formats (RGB8, RGBN, RGB5)
* ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
* FBM formats (8Bit grey/color and 24Bit)
* IFF-PBM (DPII) format
* Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
* YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
* VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
* HHsYUVSq sequence format (sequential or random access; only first frame)
* HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
* binary-EPS bitmaps (RGB and CMYK; this function is experimental)
* TBCPlus frames&fields

* DataType (incl. first frame of animations with Anim-Datatypes)

Supported file formats for saving:

* HHsYUVSq animation format

Automatic creation of HHsYUVSq TrueColor animations
---------------------------------------------------

With the script "makeanim.rx" you can automatically convert a directory
of pictures into an HHsYUVSq animation file. Just start the script
from XiPaint as macro or from Workbench or Shell. It should work with
all XiPaint 3.x and up versions. If you start it from XiPaint, you will
probably have to switch to WB screen manually; there you get a requester
asking for the source directory which should contain the pictures
(all of the same size). Then you are asked for the destination animation
file. Then the automatic conversion is started. Pictures are downscaled
if necessary. You can watch the pictures beeing loaded in XiPaint. They
are loaded in alphabetical order (users of old XiPaint versions prior to
V3.2 should NOT play with XiPaint during this process as this can
block the whole system). With newer versions it should be save to
use XiPaint for other things during the process except loading as
this would interact with the frame loading! If the conversion has finished,
the last picture will remain in XiPaint as a project. You can close
this manually.

To play the animations use my freeware player programs
CyberTVPlayer for TrueColor playback on CyberGraphX compatible
boards (incl. Draco) or EGSTVPlayer for TrueColor playback on
EGS compatible boards. CyberTVPlayer can also be used without
CyberGraphX for reduced viewing (upto 256 colors) on all Amigas
with at least OS3.0.

Additional notes: The loading/saving is done with HHsXiPaintMod.xio
only; so you can only load pictures in one of the supported formats
(see above). If you want to make animations from pictures in other formats,
you have to load and save them with the appropriate modules manually.
But anyway, the module now seems to support nearly all formats...

Downscaled loading
------------------

The loader module now supports direct downscaled loading in XiPaint 3.2
and higher; simply select the appropriate loader version in the list.
Currently the loader should appear 3 times: HHsUniversalLoader for full
size, Universal_50%_Size for half size and Universal_25%_Size for quarter
size. For most file formats (e.g. IFF, DEEP, JPeg, PCX, PPM, Targa, ...)
the downscaling is done on a line by line base, so that memory will only
be needed for the reduced size. This should enable you to get big
pictures into XiPaint without memory problems.

General notes
-------------

There are currently no error requesters for loading (if a file can not be
loaded nothing will happen). For saving error requesters are included.

If you register for the XiPaint modules you will receive a
keyfile together with the latest version of the modules. The
keyfile will enable you to use future demo versions as update.

The demo version will load and save all pictures in greyscales, but
usually at the same speed as the full version would do in color.

XiPaintModules need at least OS2.04 (OS3.x for Datatype usage).

All loading functions (except JPeg: This software is based in part on the work
of the independent JPeg Group) have been written in Assembler and optimised for
extremely high speed. An exception to this is the JPeg format, which is
written in C and based on the usual code of the indipendent JPeg group.
I created the fast loading functions mainly for my famous shareware programs
*** CyberShow Professional *** (universal viewer and slideshow program
for all OS3.x Amigas and Dracos and esp. for CyberGraphX users), EGSPhotoAlbum
Prof. and EGS-TV Prof.; When new formats are implemented for my other
programs (or the speed is improved further), I will usually also update
the modules, which registered user can then use due to the keyfile concept.

The JPeg format has been included in this module mainly for the comfort
of the users (as otherwise for JPeg another loader module would have to
be seleted) and to enable JPeg loading in downscaled form, which can be
very useful. Now you can also create animations in HHsYUVSq animation
format from JPeg pictures with the automatic ARexx script. The loading
speed of the JPeg code (for pictures in full size) is unfortunately
currently not very fast. Downscaled loading of JPeg can be much faster.

Registration
------------

You can register for the module at the small add-on price of only 8US$ or
10DM if you order it together with one of my other shareware programs,
e.g. CyberShow, the universal viewer and slideshow program for all Amigas
with at least OS3.0 (loading the same formats as the XiPaintModule)
or EGSPhotoAlbum or EGS-TV. Please use the registration forms of thoose
programs and specify your add-on module order there and include the
extra amount.

Otherwise you should use the included registration form to register:

If you only want to register for the module, the registration fee is
18US$ outside europe or 20DM in europe. You will also get the latest demo
versions of my other programs. Additional modules (e.g. UniversalGIO for
Photogenics or FastIFXModules for ImageFX) can be ordered at the lower
add-on price.

If you are already a registered user of one of my programs and now want to
register for the modules, the registration fee is 13US$ outside europe or
15DM (in europe). Additional modules (e.g. UniversalGIO for Photogenics or
FastIFXModules for ImageFX) can be ordered at the lower add-on price.

(Special note for users in germany only: Wenn Sie schon registrierter Benutzer
 eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
 geändert hat, können Sie die Module direkt per Überweisung bestellen.
 Als Verwendungszweck geben Sie bitte "XiPaintMod für ...." an, wobei Sie
 das Programm was Sie schon haben und die Registriernummer angeben.
 Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
 Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
 (No bank transfers from outside germany!)

Send your filled in registration form together with cheque, international
postal money order or banknotes to:

	Helmut Hoffmann
	Rubensstrasse 4
	D-41063 Moenchengladbach
	Germany


============================= Archive contents =============================

Original  Packed Ratio    Date     Time    Name
-------- ------- ----- --------- --------  -------------
     628     270 57.0% 08-Feb-96 17:12:00  XiPaintModule.info
     884     372 57.9% 11-Dec-95 00:17:48 +hhsxipaintloader.rx
   85900   41089 52.1% 06-Nov-96 12:14:38 +hhsxipaintmod.xio
    1254     465 62.9% 09-Feb-96 00:47:34 +Install
     466     132 71.6% 08-Feb-96 17:11:46 +Install.info
    2168     872 59.7% 08-Feb-96 19:21:04 +makeanim.rx
     461     177 61.6% 08-Feb-96 17:11:46 +makeanim.rx.info
    2454    1112 54.6% 06-Nov-96 12:17:30 +registration.txt
     477     248 48.0% 08-Feb-96 17:11:46 +registration.txt.info
   25256    9750 61.3% 06-Nov-96 12:18:56 +XiPaintModule.guide
     482     256 46.8% 30-May-96 03:46:28 +XiPaintModule.guide.info
-------- ------- ----- --------- --------
  120430   54743 54.5% 08-Nov-96 02:18:22   11 files
