Short: Univ. loader&anim.saver for XiPaint Author: hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann) Uploader: hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann) Type: gfx/misc Kurz: XiPaint-Universal-Lader&Animationssp.Modul HHsFastUniversalXiPaintModule 3.0 (incl. PhotoCD- & TrueColorAnim-support) ================================= 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 new in V2.x: Direct module support for XiPaint 3.2 and up This universal module can be used to quickly load images in many file formats (more than 20 and additionally Datatypes) very into XiPaint and to create TrueColor animations in HHsYUVSq animation format. The way to use this module depends on your version of XiPaint: 1) XiPaint 3.2 or higher Just copy the module "hhsxipaintmod.xio" (contains both loading and saving functions) to the XiPaint/Modules directory. The module will then be detected by XiPaint 3.2 a) as "HHsUniversalLoader" which you can then select in the Settings/Loaders list of loader modules. The Loader will be automatically used (if selected) for opening of new projects and for loading into existing projects. The file "hhsxipaintloader.rx" is not needed. b) as "HHsYUVSqAnimation" which you can then select in the Settings/Savers list of saver modules. To create a new animation, select a new filename for saving with this format; to append a frame to an existing animation, select the existing animation file for saving. XiPaint will warn you that the file is overwritten, but the module will only append the frame and not delete the old file. Please note: Image width must be in the range 80 to 360 (even size will be generated); Image height must be in the range 64 to 310. To append frames to an animation, the image size in XiPaint must match the frame size of the file you want to append to. Otherwise (or if you specify not a HHsYUVSq anim file) an error will occur. To automatically create an animation from a directory of pictures you can use the included ARexx script "makeanim.rx". Please see notes below. -> XiPaint 3.2-CD: If you have problems with XiPaint 3.2 on CD-ROM, you should check your file system; the AmigaOS3.1 file system does only use upper case file names; XiPrefs looks only for lower case xout-libraries; use another file system or rename the libraries to lowercase manually (on your harddisk) like rename XiPaint/libs/XOUT_C.LIBRARY "XiPaint/libs/xout_c.library" etc... This should solve your problems. 2) XiPaint 3.0/3.1 As thoose XiPaint versions have no special support for external modules, the way of access to the module is a bit inconvenient. It can be used by ARexx scripts (included) from XiPaints Macro/Execute menu. First copy the file "hhsxipaintmod.xio" into the main directory of XiPaint. Then copy the files ending with ".rx" into the XiPaint/Makro directory. You can then use the module by calling the ARexx scripts from within XiPaint (menu Macro, subentry Execute). So to load a file with the module into XiPaint 3.0/3.1 you do not use the usual load function but instead call the macro. a) For loading: Execute the "hhsxipaintloader.rx" macro It will then switch to the WB screen and display a standard file requester. You can then select a file for loading. The picture will be loaded if possible and transferred to XiPaint as a new project window. Then the WB screen is sent back so that XiPaint screen should appear in front again. Some XiPaint versions add absolute path names of new project windows to the relative standard path. I can't work around this, so such pictures will get wrong project names with such versions (Only use SaveAs to save such pictures). Please upgrade to XiPaint 3.2 to get a more convenient access to my module... b) For TrueColor animation creation: Execute the automatic script "makeanim.rx" to create them; see below for details. General notes about the module: There are currently no error requesters for loading (if a file can not be loaded nothing will happen). For saving error requesters will usually appear in case of trouble. 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. Supported file formats for loading: * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit) * 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. Anyway, make sure that no project of the same name as the pictures exist, as this can confuse XiPaint as well. If the conversion has finished, the last picture will remain in XiPaint as a project. Close it manually before starting new conversions. 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. The integrated downscaling support of HHsXiPaintMod.xio can currently only be accessed from scripts (see makeanim.rx for example). If you want to use downscaling during loading for manual picture loading, you have to create a suitable script for this. XiPaintModules need at least OS2.04 (OS3.x for Datatype usage). The fast loading functions have all been written by me in assembler and optimized for fastest speed. I did this for my famous shareware programs *** CyberShow Professional *** (universal viewer and slideshow program for all OS3.x Amigas and esp. for Cybergraphics 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. 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 and additional JPeg) 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). This includes the latest versions of my programs as update. 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 Mönchengladbach Germany You can currently also contact me by EMail (e.g. for suggestions): hhoff@pool.informatik.rwth-aachen.de No registrations by EMail! If you want to register, please write by ordinary mail to my address above. Special Thanks ============== My special thanks go to Mr. Thomas Dorn and Ossowski's Schatztruhe for providing me with XiPaint. Disclaimer ---------- This software (program and documentation) is provided "as is" and comes with no warranty, either expressed or implied. The author is in no way responsible for any damage or loss that may occur due to direct or indirect usage of this software. You use this software entirely at your own risk. Copyright and Distribution -------------------------- HHsFastUniversalXiPaintModule (module and documentation) is copyright by Helmut Hoffmann Rubensstrasse 4 D-41063 Mönchengladbach Germany The demo version may be freely distributed and used as long as the following conditions are met: 1) All files have to be kept together 2) No file may be modified or crunched/packed. The only official way to distribute the demo packed is the original xipaintmod.lha archive. The modules may not be disassembled or analysed. The limitations integrated in the demo version may under no circumstance be removed or bypassed. 3) Distributors may only charge for the duplication process (including media) and not for the software. Theese charges may not exceed the following limits: a) Demo on a PD-disk: 7$ (US-dollar) including postage&packing (in Germany: 10DM) b) Demo on a PD-CD-ROM: 40$ (US-dollar) including postage&packing (in Germany: 60DM) c) Demo on a BBS/Mailbox/ftp-site or other electronically callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM) for downloading Anyway, it must be made explictly clear to the buyer, that he does not pay for the modules (demo) itself but only for the duplication service. 4) It is not allowed to distribute this demo with any commercial product without a written permission by me. One exception is the distribution of the demo version with products not exceeding the above price limits (e.g. a cover-disk magazine for 7$ or less). The demo version may be included with XiPaint. 5) The registered version may not be redistributed. It may only run on one machine per registration. It is allowed to make a backup copy of the original disk. Version history --------------- V0.1 (7th aug. 95): Prerelease for loading functions V0.2 (20th aug. 95): Prerelease for loading by ARexx script: added Request option and screen switching functions V1.0 (15th sep. 95): First official release for use by Arexx script (usable with XiPaint 3.x) V2.0 (21st sep. 95): First release with direct loader module support for XiPaint 3.2 (just copy the .xio file into the XiPaint/Modules directory and configure it as loader) V2.1 (9th oct. 95): Extended TIF loader to support "Intel" byte order files and more variants V3.0 (11th dec. 95): TrueColor animation saving: extended module to support saving in HHsYUVSq animation format; included ARexx script to automatically create such animations from multiple pictures; Use CyberTVPlayer or EGSTVPlayer to play such animations. Extended IFF loader to accept 0-sized chunks Loader can now load bigger pictures into smaller projects Integrated downscaling support (only usable by scripts) ============================= Archive contents ============================= Original Packed Ratio Date Time Name -------- ------- ----- --------- -------- ------------- 628 271 56.8% 11-Dec-95 18:16:22 XiPaintModule.info 884 372 57.9% 11-Dec-95 00:17:48 +hhsxipaintloader.rx 13729 5655 58.8% 11-Dec-95 03:35:42 +hhsxipaintmod.readme 477 248 48.0% 11-Dec-95 00:41:56 +hhsxipaintmod.readme.info 31264 16217 48.1% 11-Dec-95 00:35:04 +hhsxipaintmod.xio 2354 875 62.8% 11-Dec-95 18:44:26 +makeanim.rx 461 175 62.0% 11-Dec-95 00:42:24 +makeanim.rx.info 2207 957 56.6% 11-Dec-95 00:45:58 +registration.txt 477 251 47.3% 11-Dec-95 00:43:02 +registration.txt.info -------- ------- ----- --------- -------- 52481 25021 52.3% 13-Dec-95 01:07:12 9 files