home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 86 / af086sub.adf / PHOTOGMODS / PGMODS.lzx / UniversalGIO / UniversalGIO.readme < prev   
Encoding:
Text File  |  1996-04-29  |  15.7 KB  |  343 lines
  1. HHsFastUniversalGioModules 3.6
  2. ==============================
  3.  
  4. +++ including fast PhotoCD loading support (correct orientation) and support
  5.     for over 20 other file formats and additionally DataTypes! +++
  6. +++ including TrueColor animation creation support (see below) +++
  7.  
  8. -> new: now with optional downscaled loading option... gets your "too large"
  9.    pictures into Photogenics in reduced size... <-
  10.  
  11. -> new: create your own animations with Photogenics e.g. for CyberGraphX,
  12.    EGS or OS3.x-Amigas with the included HHsYUVSq sequence saver module; see
  13.    below for details!! <-
  14.  
  15. Warning: I am aware that illegal/modified keyfiles of this module may exist.
  16. !Use of such keyfiles ("hhsgiokey.library") is strictly prohibited and
  17. !can lead to undefined results and problems! For a program which you use
  18. !you should also be willing to pay the shareware fee. Only if enough users
  19. !register I will be able to do further improvements or create other graphic
  20. !applications. You can also help me by sending me illegal keyfiles of
  21. !this product which you find somewhere.
  22.  
  23. The fast universal loader module can be used with Photogenics (I have tried
  24. it with Photogenics V1.2; it should also be usable partially with older
  25. versions; it will probably NOT be usable with Photogenics Lite or Demo
  26. versions, so better get the full version of Photogenics...; DataTypes option
  27. and downscaled loading option are only usable with Photogenics V1.2 or higher).
  28. It is shareware; without a keyfile which you get after registration,
  29. it will load all pictures in greyscale, regardless if they are color or not,
  30. but the speed and format support is the same, so that you can try if
  31. the module fits your needs.
  32.  
  33. The loader module currently supports the following file formats:
  34.  
  35. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  36. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  37. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  38. * QRT (also known as dump format by PD raytracers as POV-Ray)
  39. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  40. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  41. * MacPaint (b&w compressed 1Bit format; datafork only)
  42. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  43. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  44. * EGS7.x window iconification file format
  45. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  46. * RGB formats (RGB8, RGBN, RGB5)
  47. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  48. * FBM formats (8Bit grey/color and 24Bit)
  49. * IFF-PBM (DPII) format
  50. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  51. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  52. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  53. * HHsYUVSq sequence format (sequential or random access)
  54. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  55. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  56. * TBCPlus frames&fields
  57.  
  58. * DataType (incl. first frame of animations with Anim-Datatypes)
  59.   DataTypes are only used as option (if selected in the "Prefs" for
  60.   the module; see below for details)
  61.  
  62. To install the modules, just copy the file ending with ".gio" to your
  63. Photogenics:Data/Gio directory or use the install script.
  64.  
  65. The name of the loader .gio module starts with a "-" so that it appears
  66. first in the list of loader modules (and usually will be tried first
  67. for automatic format detection). This makes sure that the fast module
  68. is used automatically instead of other modules if it can load a format.
  69. This should make your loading of many formats much faster!
  70.  
  71. Preferences: Select Prefs button when the loader is selected in the loader
  72.          list; Preferences for GIO modules are only available with
  73.          Photogenics V1.2 and higher!
  74. a) Datatype support: Select "On" if you want Datatypes to be used if the
  75.  internal file formats of UniversalGIO fail; Please note that if this
  76.  option is selected all files which are not supported internally by
  77.  UniversalGIO will be tried by Datatypes which can take some additional
  78.  time or lead to unwanted results (if you have a bad Datatype which
  79.  then loads a picture instead of one of the original Photogenics GIOs).
  80. b) Downscaling factor: Select a downscaling factor (greater 1) in the
  81.  range 1..16 if you want to get pictures into Photogenics in downscaled
  82.  form; useful if memory is insufficient to load big pictures in full size.
  83.  Please note that some of the file formats (which can not be loaded line
  84.  by line) may still need full memory during loading; most formats will
  85.  only need memory for reduced size. Some file formats may also support
  86.  only certain downscale factors. In this case the next higher available
  87.  downscaling factor will be used.
  88.  
  89. About:    Select About button when the loader is selected in the loader
  90.     list to get information about your keyfile (registered users)
  91.     and the supported file formats; About for GIO modules is only
  92.     availabe with Photogenics V1.2 and higher!
  93.  
  94. Example loading speed advantages on my configuration (see below):
  95.  
  96. ACBM: upto 2 times faster
  97. BMP:  upto 2.3 times faster (in addition some OS2-styles supported)
  98. DEEP: upto 1.3 times faster (in addition compressed images are supported)
  99. IFF-EHB: upto 2.5 times faster
  100. HAM6: upto 1.5 times faster (in addition colors can be better)
  101. HAM8: upto 1.7 times faster (in addition colors at left border should be correct)
  102. IFF-24Bit: upto 2.4 times faster
  103. IFF-8Bit: upto 2.2 times faster
  104. PPM-P6: upto 2.3 times faster
  105. PPM-P5: upto 3.1 times faster
  106. PCX: upto 3.8 times faster (in addition special EGA/VGA styles supported)
  107. PhotoCD: upto 3 times faster (in addition horizontal images are usually
  108.                 loaded in correct orientation)
  109. QRT: upto 1.3 times faster
  110. Targa: upto 1.7 times faster (this test in RAM: due to loading problems with
  111.     original loader from harddrive; in addition compressed images and other
  112.     depths supported)
  113. TIF: upto 3.3 times faster
  114. (GIF: upto 2 times faster with DataType-Loading and a fast GIF datatype)
  115.  
  116. (only loading times compared, not displaying; my configuration: Amiga 3000;
  117.  68030/25MHz;PiccoloSD64;Photogenics 1.2;loading from Quantum harddrive; PhotoCD
  118.  loading from NEC2x; Please note that loading times can differ much on other
  119.  configurations)
  120.  
  121. In addition to the speed advantages, many new formats are supported as
  122. well (see above).
  123.  
  124. The fast loading functions have all been written by me in assembler and
  125. optimized for fastest speed. I did this for my famous shareware programs
  126. CyberShow, EGSPhotoAlbum and EGS-TV. When new formats are implemented
  127. for my other programs (or the speed is improved further), I will usually
  128. also update the modules, which registered user can then use due to the
  129. keyfile concept.
  130.  
  131.  
  132. HHsYUVSq sequence/animation saver GIO module
  133. ============================================
  134.  
  135. In addition to the universal loader now an animation saver module
  136. is part of this package...
  137.  
  138. The HHsYUVSq.gio module can be used to create animations with Photogenics
  139. in the famous HHsYUVSq sequence format. For playback of such animations
  140. you can use:
  141.  
  142.  a) CyberTVPlayer (Freeware) (available e.g. on Aminet gfx/board)
  143.  
  144.   Can play such animations in HiColor/TrueColor like quality on CyberGraphX
  145.   HiColor/TrueColor Workbench.
  146.   Can play such animations in reduced color (2 to 256) on any Amiga Workbench
  147.   if at least OS3.0 is available.
  148.   CyberTVPlayer plays animations direct from disk and can thus be used
  149.   to play animations of any size! For faster speed you could copy small
  150.   sequences to RAM: before playing them.
  151.  
  152.  b) EGSTVPlayer (Freeware) (available e.g. on Aminet gfx/board)
  153.  
  154.   Can play such animations on EGSDefault Screen in conjunction with the
  155.   EGS graphic environment (TrueColor/HighColor or reduced color).
  156.   EGSTVPlayer plays animations direct from disk and can thus be used
  157.   to play animations of any size! For faster speed you could copy small
  158.   sequences to RAM: before playing them.
  159.  
  160.  c) EGS-TV Professional (Shareware) (available e.g. on Aminet gfx/board)
  161.  
  162.   Can edit and play such animations (insert frames, append frames, delete
  163.   frames; special effects "Blue Screen Keying" etc).
  164.  
  165. In demo version the module will create sequences only in greyscales,
  166. so please support shareware and register for my UniversalGIO module now...
  167.  
  168. By the way: Similair modules are available for ImageFX (FastIFXModules)
  169. and XiPaint (XiPaintModule) as well. Both now also include HHsYUVSq animation
  170. creation and feature ARexx scripts for automatic conversions!
  171. I hope that ARexx scripts are possible with future Photogenics versions
  172. as well.
  173.  
  174. TrueColor animation creation with HHsYUVSq GIO module
  175. ----------------------------
  176.  
  177. Using the animation saver module:
  178.  
  179.  a) Create a new sequence
  180.  
  181.   Just save the picture which you want to become the first frame of your
  182.   animation with the HHsYUVSq.gio saver. In the file requester you should
  183.   select a new filename. The GIO module will then try to create a sequence
  184.   with this name.
  185.  
  186.   Important: Image dimensions are limited! Only even wide images can be
  187.   used to create a sequence; the image wide must be in the range 80..360.
  188.   The image height must be in the range 64..310!
  189.  
  190.   If you have a collection of much bigger images you can use the new
  191.   downscaled loading option of my UniversalGIO loader module to get the
  192.   images in downscaled form into Photogenics quickly...
  193.  
  194.  b) Append a frame to a sequence
  195.  
  196.   Just save the picture which you want to append to an animation with the
  197.   HHsYUVSq.gio saver. In the file requester you should select the filename
  198.   of the animation to which the frame should be appended.
  199.  
  200.   New: If you have at least Photogenics V1.2 you can select "Prefs" options
  201.   for the saver: an option allows to make file name selection permanent; if
  202.   this is selected, the file name of the sequence will only be requested
  203.   once (as long as the saver module is not flushed out of memory), enabling
  204.   you to simply append frames by calling the saver. If you want to change
  205.   the file name later, you first have to deselect this Prefs option. This
  206.   option should be esp. useful if a future version of Photogenics becomes
  207.   available with ARexx support, so that automatic appending of multiple
  208.   frames becomes possible (this is already possible with ImageFX and
  209.   XiPaint for which I have created similair modules).
  210.  
  211.   Important: You can only append images of the correct size to a sequence.
  212.   Differently sized images can not be saved in one sequence. Please scale or
  213.   crop the images to the size of the first frame in the sequence.
  214.  
  215. Special note for EGS-TV users: You can load and edit sequences created with
  216.  this module with EGS-TV as well. In the other way this is only possible if
  217.  the sequence is of the right kind (color,sequential mode,half frame/LoRes).
  218.  
  219. Registration of UniversalGIO Modules
  220. ====================================
  221.  
  222. You can register for the modules at the small add-on price of only 8US$ or
  223. 10DM if you order it together with one of my other shareware programs,
  224. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  225. with at least OS3.0 (loading the same formats as the UniversalGIO and
  226. additionally JPeg) or EGSPhotoAlbum or EGS-TV. Please use the registration
  227. forms of thoose programs and specify your add-on module order there and
  228. include the extra amount.
  229.  
  230. Otherwise you should use the supplied registration form to register.
  231.  
  232. If you only want to register for the modules, the registration fee is
  233. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  234. versions of my other programs. Additional modules (XiPaintModule for
  235. XiPaint or FastIFXModules for ImageFX) can be ordered at the lower
  236. add-on price.
  237.  
  238. If you are already a registered user of one of my programs and now want to
  239. register for the modules, the registration fee is 13US$ outside europe or
  240. 15DM (in europe). Additional modules (e.g. XiPaintModule for XiPaint or
  241. FastIFXModules for ImageFX) can be ordered at the lower add-on price.
  242.  
  243. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  244.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  245.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  246.  Als Verwendungszweck geben Sie bitte "UniGIO für ...." an, wobei Sie
  247.  das Programm was Sie schon haben und die Registriernummer angeben.
  248.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  249.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  250.  (No bank transfers from outside germany!)
  251.  
  252. Send your filled in registration form together with cheque, international
  253. postal money order or banknotes to:
  254.  
  255.     Helmut Hoffmann
  256.     Rubensstrasse 4
  257.     D-41063 Moenchengladbach
  258.     Germany
  259.  
  260. Special Thanks
  261. ==============
  262.  
  263. My special thanks go to Mr. J. Ralph and Almathera for their kind support.
  264.  
  265. Disclaimer
  266. ----------
  267.  
  268. This software (program and documentation) is provided "as is" and
  269. comes with no warranty, either expressed or implied.
  270. The author is in no way responsible for any damage or loss that may
  271. occur due to direct or indirect usage of this software. You use
  272. this software entirely at your own risk.
  273.  
  274. Copyright and Distribution
  275. --------------------------
  276.  
  277. HHsFastUniversalGioModules (modules and documentation) is
  278. copyright by
  279.  
  280.     Helmut Hoffmann
  281.     Rubensstrasse 4
  282.     D-41063 Moenchengladbach
  283.     Germany
  284.  
  285. The demo version may be freely distributed and used as
  286. long as the following conditions are met:
  287.  
  288. 1) All files have to be kept together
  289.  
  290. 2) No file may be modified or crunched/packed.
  291.  
  292.    The only official way to distribute the demo packed is the
  293.    original universalgio.lha archive.
  294.    The modules may not be disassembled or analysed. The limitations
  295.    integrated in the demo version may under no circumstance be removed
  296.    or bypassed.
  297.  
  298. 3) Distributors may only charge for the duplication process (including media)
  299.    and not for the software. Theese charges may not exceed the following
  300.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  301.               postage&packing (in Germany: 10DM)
  302.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  303.               postage&packing (in Germany: 60DM)
  304.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  305.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  306.               for downloading
  307.    Anyway, it must be made explictly clear to the buyer, that he does not
  308.    pay for the modules (demo) itself but only for the duplication service.
  309.  
  310. 4) It is not allowed to distribute this demo with any commercial product
  311.    without a written permission by me. One exception is the distribution of
  312.    the demo version with products not exceeding the above price limits (e.g.
  313.    a cover-disk magazine for 7$ or less).
  314.  
  315.    The following companies have my explicit permission to distribute the
  316.    demo with their products: Almathera, Ingenieurbüro Helfrich, MacroSystem.
  317.  
  318. 5) The registered version may not be redistributed. It may only run on one
  319.    machine per registration. It is allowed to make a backup copy of the
  320.    original disk.
  321.  
  322. Version history
  323. ---------------
  324.  
  325. V1.0 (5th aug. 95): Initial release supporting 20 file formats and DataTypes
  326. V1.1 (21th aug. 95): First full version release (incl. revised documentation)
  327. V2.0 (29th aug. 95): Support new file formats: binary-EPS bitmaps (RGB,CMYK)
  328.             and TBCPlus frames/fields
  329. V2.1 (20th sep. 95): Show Datatype specific ID string during Datatype loading
  330. V3.0 (27th sep. 95): Support downscaled loading as option
  331.              Included GIO saver module to create HHsYUVSq animations
  332.             (for playback you can use CyberTVPlayer or EGSTVPlayer)
  333. V3.1 (28th sep. 95): HHsYUVSq animation saver extended by Prefs option to
  334.             make sequence file selection permanent
  335. V3.2/a (9th oct. 95): Extended TIF loader to support "Intel" byte order files
  336.             and more variants
  337. V3.3 (15th nov. 95): Extended IFF loader to support 0-length chunks
  338.              Added support to load partially defective files
  339. V3.4 (20th feb. 96): Extended IFF loader to accept unusual sized color maps
  340. V3.5 (24th march 96): Changed PCX loading for more compatibility
  341. V3.6 (29th april 96): Extended PCX loading for even more compatibility
  342.  
  343.