home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / grafix / tools / fastimagefxmodules / fastifxmodules.readme < prev    next >
Encoding:
Text File  |  1995-12-11  |  17.3 KB  |  365 lines
  1. HHsFastImageFXModules 5.0
  2. =========================
  3.  
  4. -> you can order the FastIFXModules at a small add-on price if you also
  5.    order CyberShow (my universal viewer/slideshow program for all Amigas with
  6.    OS3.0), EGSPhotoAlbum or EGS-TV Professional
  7.  
  8. new in V5.0: TrueColor animation saving support in HHsYUVSq animation format
  9.     ->create your own TrueColor animations for playback on CyberGraphX
  10.       with CyberTVPlayer or on EGS with EGSTVPlayer <-
  11.     Including ARexx scripts for automatic conversion of picture
  12.      directories or other animations into HHsYUVSq animation format
  13.     Inclusion of additional IFXAppWindow utility
  14.  
  15. The fast universal loader/saver modules can be used with ImageFX and
  16. ImageFX-EGS. They are shareware; without a keyfile which you get after
  17. registration, they will load and save all pictures or animations in greyscale,
  18. regardless if they are color or not, but the speed and format support is
  19. the same, so that you can try if they fit your needs.
  20.  
  21. The loader module currently supports the following file formats:
  22.  
  23. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  24. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  25. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  26. * QRT (also known as dump format by PD raytracers as POV-Ray)
  27. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  28. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  29. * MacPaint (b&w compressed 1Bit format; datafork only)
  30. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  31. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  32. * EGS7.x window iconification file format
  33. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  34. * RGB formats (RGB8, RGBN, RGB5)
  35. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  36. * FBM formats (8Bit grey/color and 24Bit)
  37. * IFF-PBM (DPII) format
  38. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  39. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  40. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  41. * HHsYUVSq sequence format (sequential or random access; only first frame)
  42. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  43. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  44. * TBCPlus frames/fields
  45.  
  46. * Picture DataTypes (many formats are available as DataTypes for OS3.x users)
  47. * Animation DataTypes (many animation formats are available as DataTypes for
  48.   OS3.1 users; currently only the first frame can be loaded with Animation DataTypes)
  49.  
  50. The saver module currently supports the following file formats:
  51.  
  52. * HHsYUVSq animation format (upto size 360x310); create new animations (by
  53.   specifying a new file) or append frames to an animation (select old file).
  54.   Please note: Image width must be in the range 80 to 360 (even size will
  55.   be generated); Image height must be in the range 64 to 310. To append
  56.   frames to an animation, the image size in ImageFX must match the frame
  57.   size of the file you want to append to. Otherwise (or if you specify
  58.   not a HHsYUVSq anim file) the error "Unrecognized file format" occurs.
  59. * QRT (also known as dump format by PD raytracers as POV-Ray)
  60. * Targa (RLE compr.&uncompr. 24Bit, 8Bit grey, 8Bit color map, 1Bit color map)
  61. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  62.   with optional lossy reduction for TrueColor or greyscale pictures; this new
  63.   file format series has surprisingly good (lossless) compression of raytraced
  64.   24Bit pictures or undithered color mapped pictures with 2 to 256 colors;
  65.   also very usable with ClipArt...; this format can be saved in color
  66.   even in the demo version (to check the good compression), but loading
  67.   will be in greyscales in the demo as well.
  68.  
  69. To install the loader/saver modules, just use the included install script.
  70. This will copy the file named "-HHsFastImageFXLoader-" to your
  71. ImageFX:modules/loaders directory and "-HHsFastImageFXSaver-" to your
  72. ImageFX:modules/savers directory. In addition your keyfile will be
  73. installed to LIBS: if you start the install script from your original
  74. full version disk.
  75.  
  76. If you also want to use the ARexx scripts for easy animation creation
  77. or the IFXAppWindow tool, you have to install them manually by dragging
  78. them whereever you like them to be.
  79.  
  80. The modules should work with standard ImageFX (1.5x, 1.6x, 2.x, ...)
  81. as well as with ImageFX-EGS. I have tried them with both ImageFX-EGS 1.6
  82. and the new ImageFX 2.1 (thanks to NOVA design). The speed advantages
  83. below have been measured with the new ImageFX 2.1. Compared with
  84. ImageFX-EGS 1.6 some of them were even slightly higher (in addition
  85. ImageFX-EGS comes with fewer standard loader modules).
  86.  
  87. The file format is automatically detected for loading except for the DataType
  88. formats. If you want to load a picture with a DataType, you have to use the
  89. "Load As" function from ImageFX and select "-HHsFastImageFXLoader-" manually
  90. as loader module. The name of the loader module begins with a "-" so that it
  91. appears first in the list of loader modules and thus is used before all
  92. other loader modules. The typical speed advantage factors on my configuration
  93. (see below) are:
  94.  
  95. DataTypes: depending on DataType, but usually loading will be significantly
  96.            faster with my DataType support (compared to IFX 2.1 DataType support),
  97.            e.g. about 1.5 for ZGIF DataType or REKO DataType...
  98. IFF-ILBM: upto 4.75 (e.g. IFF 8Bit)
  99. PPM/PBM: upto 7.2 (P6)
  100. QRT: upto 4.4
  101. Targa: upto 8.7 (uncompr.)
  102. PCX: upto 11.2 (planar 4Bit)
  103. BMP: upto 4.6 (24Bit)
  104. TIF: upto 8.5 (packbit compr. 4Bit)
  105. RGB: upto 3.7 (RGB8)
  106. YUV: upto 5.6 (YUV1/4)
  107. IFF-PBM: upto 1.3
  108. SunRaster: upto 4.6 (grey)
  109. MacPaint: upto 1.5
  110. GIF: upto 2.1 (HHsFastIFXModules DataType loading with ZGIF-DataType compared with
  111.                IFX-GIF loader)
  112. PhotoCD: upto 2.0 (compared with PD-PCD loader in base size; in addition my loader
  113.      usually rotates portrait pictures automatically to correct orientation)
  114.  
  115. (only loading times compared, not displaying; my configuration: Amiga 3000;
  116.  68030/25MHz; loading from Quantum harddrive; PhotoCD loading from NEC2x)
  117.  
  118. The loader includes many formats, which the original loaders (I compared with
  119. ImageFX-EGS 1.61) do not support: PhotoCD, IFF-DEEP, IFF-ACBM, FBM, Sun raster,
  120. VLab raw, DataTypes, RGB5, PBM4, TGA1, YUV grey, PCX grey, BMP compressed, EGS icons,
  121. MacPaint (Datafork). Many of them are not supported by ImageFX 2.1 as well.
  122.  
  123. It also loads many formats, which are loaded with wrong colors (or other bugs)
  124. in some original loaders, e.g IFF-ILBM-EHB, BMP1, PBM1, TIF1 grey, TGA grey.
  125. The original PCX loader also had massive problems with loading VGA
  126. pictures from CD-ROMs under the OS3.1 CD-file system. Although this is a bug in
  127. the file system, I could work around this so that my loader should work with
  128. CD-ROMs under the OS3.1 filesystem. Please note that some third party CD-ROM-
  129. file systems can cause massive problems as well, so I recommend to use the
  130. original Commodore OS3.1 filesystem.
  131.  
  132. The saver module can be used as normal (QRT and HHsYUVSqAnimation only for true
  133. color/greyscale buffers; Targa and HHsXRL also usable for rendered images from
  134. 2 to 256 colors). The individual formats and variants are listed at the
  135. beginning of the list of savers in the SaveAs window. The typical speed
  136. advantage for the fast saver module:
  137.  
  138. QRT: upto 3.5
  139. Targa: upto 3.8 (compressed)
  140.  
  141. Beside the speed advantage, the general compression is also better
  142. (compared to ImageFX-EGS 1.61). Targa compression is sometimes 25% better
  143. with my saver than with the original. The Targa saver also supports
  144. the true greyscale format for greyscale pictures and allows compression
  145. of rendered images as well. Rendered 1Bit images will be saved in 1Bit
  146. Targa format. For good compression of e.g. raytracing pictures I recommend
  147. my own file formats "HHsXRL", usable from 1Bit to 24Bit. This format is
  148. also supported by my universal image viewer "CyberShow".
  149.  
  150. The HHsYUVSqAnimation saver can be used to create new animation files
  151. (if you specify a new file) or to append the current picture to an
  152. existing HHsYUVSq animation file which has the same frame size (if
  153. you specify an old HHsYUVSq animation file). The reccomended file
  154. extension for HHsYUVSq animation files is ".seq". To playback the
  155. animations you can use: a) CyberTVPlayer
  156.                 for playback in TrueColor with CyberGraphX
  157.                 or for playback on all Amigas with OS3.x
  158.             b) EGSTVPlayer
  159.                 for playback in TrueColor etc. with EGS
  160. Both CyberTVPlayer and EGSTVPlayer are freeware and should be available
  161. e.g. on Aminet in gfx/board.
  162.  
  163. For easy creation of HHsYUVSq animations two ARexx scripts are included:
  164.   a) MakeAnim.rx will ask for a source directory and a destination file.
  165.      It will then load all pictures in the source directory (in alphabetical
  166.      order) and create/append them into the HHsYUVSq animation. If neccessary,
  167.      downscaling will be applied. Please note that all pictures should have
  168.      the same size!
  169.   b) ConvertAnim.rx will ask for a source animation and a destination file.
  170.      The source animation can be in any animation format which ImageFX
  171.      supports. All frames will be loaded and then saved/appended into the
  172.      HHsYUVSq animation file (downscaled if neccessary).
  173.  
  174. The fast loading/saving functions have all been written by me in assembler and
  175. optimized for fastest speed. I did this for my famous shareware programs
  176. *** CyberShow *** (universal viewer for all Amigas and esp. for Cybergraphics
  177. users), *** EGSPhotoAlbum Professional *** (picture management and presentation
  178. software for EGS) and *** EGS-TV Professional *** (sequence/animation editing,
  179. framegrabber (VLab/IV24) and Blue Screen Keying software for EGS).
  180. When new formats are implemented for my other programs (or the speed is improved
  181. further), I will usually also update the modules, which registered user can then
  182. use due to the keyfile concept.
  183.  
  184. Registration
  185. ============
  186.  
  187. You can register for the modules at the small add-on price of only 8US$ or
  188. 10DM if you order them together with one of my other shareware programs,
  189. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  190. with at least OS3.0 (loading the same formats as the FastIFXModules and
  191. additional JPeg) or EGSPhotoAlbum or EGS-TV. Please use the registration
  192. forms of thoose programs and specify your add-on module order there and
  193. include the extra amount.
  194.  
  195. Otherwise you should use the included registration form to register:
  196.  
  197. If you only want to register for the modules, the registration fee is
  198. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  199. versions of my other programs. Additional modules (e.g. UniversalGIO for
  200. Photogenics or XiPaintModule for XiPaint) can be ordered at the lower
  201. add-on price.
  202.  
  203. If you are already a registered user of one of my programs and now want to
  204. register for the modules, the registration fee is 13US$ outside europe or
  205. 15DM (in europe). This includes the latest versions of my programs as update.
  206. Additional modules (e.g. UniversalGIO for Photogenics or XiPaintModule for
  207. XiPaint) can be ordered at the lower add-on price.
  208.  
  209. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  210.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  211.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  212.  Als Verwendungszweck geben Sie bitte "FastIFX für ...." an, wobei Sie
  213.  das Programm was Sie schon haben und die Registriernummer angeben.
  214.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  215.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  216.  (No bank transfers from outside germany!)
  217.  
  218. Send your filled in registration form together with cheque, international
  219. postal money order or banknotes to:
  220.  
  221.                         Helmut Hoffmann
  222.             Rubensstrasse 4
  223.             D-41063 Mönchengladbach
  224.  
  225.             Germany
  226.  
  227. You can currently also contact me by EMail (e.g. for suggestions):
  228.  
  229.         hhoff@pool.informatik.rwth-aachen.de
  230.  
  231. No registrations by EMail! If you want to register, please write by ordinary mail
  232. to my address above.
  233.  
  234. Special Thanks
  235. ==============
  236.  
  237. My special thanks go to Mr. Kermit Woodall and NOVA design for their kind support
  238. and to all registered HHsFastIFXModule users, esp. thoose who made suggestions...
  239.  
  240. Disclaimer
  241. ----------
  242.  
  243. I tried my best to make the modules error-free. They have been checked
  244. with enforcer and mungwall and work without problems on my configuration.
  245. Nevertheless, as there are so many possible configurations, I can not
  246. guarantee that this software will work on your configuration.
  247.  
  248. This software (program and documentation) is provided "as is" and
  249. comes with no warranty, either expressed or implied.
  250. The author is in no way responsible for any damage or loss that may
  251. occur due to direct or indirect usage of this software. You use
  252. this software entirely at your own risk.
  253.  
  254. Copyright and Distribution
  255. --------------------------
  256.  
  257. HHsFastImageFXModule (modules and documentation) is copyright by
  258.  
  259.                         Helmut Hoffmann
  260.             Rubensstrasse 4
  261.             D-41063 Mönchengladbach
  262.  
  263.             Germany
  264.  
  265. The demo version may be freely distributed and used as
  266. long as the following conditions are met:
  267.  
  268. 1) All files have to be kept together
  269.  
  270. 2) No file may be modified or crunched/packed.
  271.  
  272.    The only official way to distribute the demo packed is the
  273.    original fastifxmodules.lha archive.
  274.    The modules may not be disassembled or analysed. The limitations
  275.    integrated in the demo version may under no circumstance be removed
  276.    or bypassed.
  277.  
  278. 3) Distributors may only charge for the duplication process (including media)
  279.    and not for the software. Theese charges may not exceed the following
  280.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  281.               postage&packing (in Germany: 10DM)
  282.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  283.               postage&packing (in Germany: 60DM)
  284.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  285.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  286.               for downloading
  287.    Anyway, it must be made explictly clear to the buyer, that he does not
  288.    pay for the modules (demo) itself but only for the duplication service.
  289.  
  290. 4) It is not allowed to distribute this demo with any commercial product
  291.    without a written permission by me. One exception is the distribution of
  292.    the demo version with products not exceeding the above price limits (e.g.
  293.    a cover-disk magazine for 7$ or less).
  294.  
  295.    The following companies have my explicit permission to distribute the
  296.    demo with their products: NOVA Design, Ingenieurbüro Helfrich.
  297.  
  298. 5) The registered version may not be redistributed. It may only run on one
  299.    machine per registration. It is allowed to make a backup copy of the
  300.    original disk.
  301.  
  302. Version history
  303. ---------------
  304.  
  305. V1.0 (17th feb. 95): Support for IFF-ILBM,PPM,QRT,Targa,PCX,BMP,TIF,EGS7.x,
  306.             DEEP,RGB,YUV,VLab,HHsYUVSq,DataTypes (picture&animation)
  307.  
  308. V2.0 (25th feb. 95): Added support for FBM (24Bit,8Bit),IFF-ACBM,IFF-PBM(DPII),
  309.             Sun raster (1Bit, 8Bit, 24Bit uncompressed),PBM-P1,
  310.             BMP 4Bit and interleaved Targa formats
  311.              Slight acceleration of some loading functions (esp. ILBM)
  312.              Improved DataType handling
  313.  
  314. V2.5 (1st march 95): Added support for MacPaint (1Bit compressed; datafork only),
  315.             PBM-P4, PCX uncompressed and EGA-grey, Targa 1Bit,
  316.             TIF packbit compressed and grey 1-4Bit
  317.              Many enhancements on various formats for more compatibility
  318.  
  319. V3.0 (14th march 95): Introduction of the fast saver module to supplement the
  320.             fast loader module (QRT, Targa 1Bit/8Bit/24Bit, HHsXRL)
  321.               Added loader support for HHsXRL (1Bit-8Bit, HAM, 24Bit)
  322.               Acceleration of some planar loaders (e.g. ILBM, DataTypes)
  323.               Improved HAM6 loading quality
  324.               Correction of Targa 1Bit loading for compressed pictures
  325.  
  326. V3.1 (07th april 95): Acceleration of RGB8 and RGB5 loader function
  327.  
  328. V4.0 (30th april 95): Added support for PhotoCD (Base size; incl. portrait orientation)
  329.  
  330. V4.1 (09th may 95): Removed inconsistency in DataType-HAM8 handling for more compatibility
  331.             Filtering out of PCD overview files
  332.  
  333. V4.2 (07th july 95): Correction of Sun raster 24Bit loading (wrong colors and
  334.             problems with odd sized images)
  335.              Updated documentation to reflect speed advantage compared
  336.             to ImageFX 2.1 instead of ImageFX-EGS 1.6
  337.  
  338. V4.3 (12th july 95): Changed IFF-ILBM loading to not automatically load brushes
  339.             containing a mask (you can still load them as pictures
  340.             with my module by using the LoadAs function).
  341.             This was neccessary as otherwise brushes could not be
  342.             loaded together with their mask if the FastIFXModules
  343.             were installed (as there is no Brush-LoadAs function).
  344.  
  345. V4.4 (21st july 95): Support for RLE compressed 8Bit and 1Bit BMP files
  346.              Bug fix for loading function which could lead to crashes if
  347.             certain non-picture files where detected as a picture
  348. V4.5 (5th aug. 95): Changed TIF loader for better compatibility with certain pics
  349.             Extended Targa loader by 15Bit and 16Bit HiColor loading
  350. V4.6 (29th aug. 95): Support for new file formats: binary-EPS bitmaps RGB,CMYK
  351.             and TBCPlus frames
  352.              Correction of bug in datatype.library usage (which could
  353.             lead to a crash under OS2.x when no datatype.library was
  354.             present and LoadAs was used)
  355. V4.7 (9th oct. 95): Extended TIF loader to support "Intel" byte order files
  356.             and more variants
  357.  
  358. V5.0 (11th dec. 95): Extended saver module by HHsYUVSq animation saver function;
  359.             included ARexx scripts to automatically create such
  360.             animations from multiple pictures or from other anims.
  361.             Use CyberTVPlayer or EGSTVPlayer to play such animations.
  362.             Extended IFF loader to accept 0-sized chunks
  363.             Included bonus program "IFXAppWindow"
  364.  
  365.