home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / gfx / misc / xipaintmodul30.readme < prev   
Text File  |  1996-01-05  |  15KB  |  319 lines
  1. Short:    Univ. loader&anim.saver for XiPaint
  2. Author:   hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  3. Uploader: hhoff@pool.informatik.rwth-aachen.de (Helmut Hoffmann)
  4. Type:     gfx/misc
  5. Kurz:     XiPaint-Universal-Lader&Animationssp.Modul
  6.  
  7. HHsFastUniversalXiPaintModule 3.0 (incl. PhotoCD- & TrueColorAnim-support)
  8. =================================
  9.  
  10. new in V3.0: TrueColor animation saving support in HHsYUVSq animation format
  11.     ->create your own TrueColor animations for playback on CyberGraphX
  12.       with CyberTVPlayer or on EGS with EGSTVPlayer <-
  13.     Including ARexx script for automatic conversion of picture
  14.      directories into HHsYUVSq animation format
  15. new in V2.x: Direct module support for XiPaint 3.2 and up
  16.  
  17. This universal module can be used to quickly load images in many
  18. file formats (more than 20 and additionally Datatypes) very
  19. into XiPaint and to create TrueColor animations in HHsYUVSq animation
  20. format. The way to use this module depends on your version of XiPaint:
  21.  
  22. 1) XiPaint 3.2 or higher
  23.  
  24. Just copy the module "hhsxipaintmod.xio" (contains both loading and
  25. saving functions) to the XiPaint/Modules directory. The module will
  26. then be detected by XiPaint 3.2
  27.  
  28.   a) as "HHsUniversalLoader" which you can then select in the Settings/Loaders
  29.      list of loader modules. The Loader will be automatically used
  30.      (if selected) for opening of new projects and for loading into
  31.      existing projects.
  32.      The file "hhsxipaintloader.rx" is not needed.
  33.  
  34.   b) as "HHsYUVSqAnimation" which you can then select in the Settings/Savers
  35.      list of saver modules. To create a new animation, select a new filename
  36.      for saving with this format; to append a frame to an existing animation,
  37.      select the existing animation file for saving. XiPaint will warn you
  38.      that the file is overwritten, but the module will only append the frame
  39.      and not delete the old file.
  40.  
  41.      Please note: Image width must be in the range 80 to 360 (even size will
  42.      be generated); Image height must be in the range 64 to 310. To append
  43.      frames to an animation, the image size in XiPaint must match the frame
  44.      size of the file you want to append to. Otherwise (or if you specify
  45.      not a HHsYUVSq anim file) an error will occur.
  46.  
  47.    To automatically create an animation from a directory of pictures you
  48.    can use the included ARexx script "makeanim.rx". Please see notes below.
  49.  
  50. -> XiPaint 3.2-CD: If you have problems with XiPaint 3.2 on CD-ROM,
  51.    you should check your file system; the AmigaOS3.1 file system
  52.    does only use upper case file names; XiPrefs looks only for
  53.    lower case xout-libraries; use another file system or rename
  54.    the libraries to lowercase manually (on your harddisk) like
  55.    rename XiPaint/libs/XOUT_C.LIBRARY "XiPaint/libs/xout_c.library"
  56.    etc... This should solve your problems.
  57.  
  58. 2) XiPaint 3.0/3.1
  59.  
  60. As thoose XiPaint versions have no special support for external modules,
  61. the way of access to the module is a bit inconvenient. It can be used by
  62. ARexx scripts (included) from XiPaints Macro/Execute menu.
  63. First copy the file "hhsxipaintmod.xio" into the main directory of XiPaint.
  64. Then copy the files ending with ".rx" into the XiPaint/Makro directory.
  65. You can then use the module by calling the ARexx scripts from within XiPaint
  66. (menu Macro, subentry Execute). So to load a file with the module into
  67. XiPaint 3.0/3.1 you do not use the usual load function but instead call
  68. the macro.
  69.  
  70.   a) For loading: Execute the "hhsxipaintloader.rx" macro
  71.      It will then switch to the WB screen and display a standard
  72.      file requester. You can then select a file for loading. The
  73.      picture will be loaded if possible and transferred to XiPaint
  74.      as a new project window. Then the WB screen is sent back so
  75.      that XiPaint screen should appear in front again. Some XiPaint
  76.      versions add absolute path names of new project windows to the
  77.      relative standard path. I can't work around this, so such
  78.      pictures will get wrong project names with such versions (Only
  79.      use SaveAs to save such pictures). Please upgrade to XiPaint 3.2
  80.      to get a more convenient access to my module...
  81.  
  82.   b) For TrueColor animation creation: Execute the automatic script
  83.      "makeanim.rx" to create them; see below for details.
  84.  
  85. General notes about the module:
  86.  
  87. There are currently no error requesters for loading (if a file can not be
  88. loaded nothing will happen). For saving error requesters will usually
  89. appear in case of trouble.
  90.  
  91. If you register for the XiPaint modules you will receive a
  92. keyfile together with the latest version of the modules. The
  93. keyfile will enable you to use future demo versions as update.
  94.  
  95. The demo version will load and save all pictures in greyscales, but
  96. usually at the same speed as the full version would do in color.
  97.  
  98. Supported file formats for loading:
  99.  
  100. * IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  101. * PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit colors)
  102. * PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  103. * QRT (also known as dump format by PD raytracers as POV-Ray)
  104. * Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit;incl. interleaved)
  105. * PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  106. * MacPaint (b&w compressed 1Bit format; datafork only)
  107. * BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  108. * TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  109. * EGS7.x window iconification file format
  110. * DEEP (compr.&uncompr. 24Bit and 32Bit)
  111. * RGB formats (RGB8, RGBN, RGB5)
  112. * ACBM formats (1 to 8Bit, incl. HAM6/HAM8)
  113. * FBM formats (8Bit grey/color and 24Bit)
  114. * IFF-PBM (DPII) format
  115. * Sun raster (1Bit, 8Bit grey/color and 24Bit uncompressed)
  116. * YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  117. * VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  118. * HHsYUVSq sequence format (sequential or random access; only first frame)
  119. * HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  120. * binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  121. * TBCPlus frames&fields
  122.  
  123. * DataType (incl. first frame of animations with Anim-Datatypes)
  124.  
  125. Supported file formats for saving:
  126.  
  127. * HHsYUVSq animation format
  128.  
  129. Automatic creation of HHsYUVSq TrueColor animations:
  130.  
  131. With the script "makeanim.rx" you can automatically convert a directory
  132. of pictures into an HHsYUVSq animation file. Just start the script
  133. from XiPaint as macro or from Workbench or Shell. It should work with
  134. all XiPaint 3.x and up versions. If you start it from XiPaint, you will
  135. probably have to switch to WB screen manually; there you get a requester
  136. asking for the source directory which should contain the pictures
  137. (all of the same size). Then you are asked for the destination animation
  138. file. Then the automatic conversion is started. Pictures are downscaled
  139. if necessary. You can watch the pictures beeing loaded in XiPaint. They
  140. are loaded in alphabetical order (users of old XiPaint versions prior to
  141. V3.2 should NOT play with XiPaint during this process as this can
  142. block the whole system). With newer versions it should be save to
  143. use XiPaint for other things during the process. Anyway, make sure
  144. that no project of the same name as the pictures exist, as this can
  145. confuse XiPaint as well. If the conversion has finished, the last
  146. picture will remain in XiPaint as a project. Close it manually before
  147. starting new conversions.
  148.  
  149. Additional notes: The loading/saving is done with HHsXiPaintMod.xio
  150. only; so you can only load pictures in one of the supported formats
  151. (see above). If you want to make animations from pictures in other formats,
  152. you have to load and save them with the appropriate modules manually.
  153.  
  154. The integrated downscaling support of HHsXiPaintMod.xio can currently
  155. only be accessed from scripts (see makeanim.rx for example). If you
  156. want to use downscaling during loading for manual picture loading,
  157. you have to create a suitable script for this.
  158.  
  159. XiPaintModules need at least OS2.04 (OS3.x for Datatype usage).
  160.  
  161. The fast loading functions have all been written by me in assembler and
  162. optimized for fastest speed. I did this for my famous shareware programs
  163. *** CyberShow Professional *** (universal viewer and slideshow program
  164. for all OS3.x Amigas and esp. for Cybergraphics users), EGSPhotoAlbum
  165. Prof. and EGS-TV Prof.; When new formats are implemented for my other
  166. programs (or the speed is improved further), I will usually also update
  167. the modules, which registered user can then use due to the keyfile concept.
  168.  
  169. Registration
  170. ============
  171.  
  172. You can register for the module at the small add-on price of only 8US$ or
  173. 10DM if you order it together with one of my other shareware programs,
  174. e.g. CyberShow, the universal viewer and slideshow program for all Amigas
  175. with at least OS3.0 (loading the same formats as the XiPaintModule and
  176. additional JPeg) or EGSPhotoAlbum or EGS-TV. Please use the registration
  177. forms of thoose programs and specify your add-on module order there and
  178. include the extra amount.
  179.  
  180. Otherwise you should use the included registration form to register:
  181.  
  182. If you only want to register for the module, the registration fee is
  183. 18US$ outside europe or 20DM in europe. You will also get the latest demo
  184. versions of my other programs. Additional modules (e.g. UniversalGIO for
  185. Photogenics or FastIFXModules for ImageFX) can be ordered at the lower
  186. add-on price.
  187.  
  188. If you are already a registered user of one of my programs and now want to
  189. register for the modules, the registration fee is 13US$ outside europe or
  190. 15DM (in europe). This includes the latest versions of my programs as update.
  191. Additional modules (e.g. UniversalGIO for Photogenics or FastIFXModules for
  192. ImageFX) can be ordered at the lower add-on price.
  193.  
  194. (Special note for users in germany only: Wenn Sie schon registrierter Benutzer
  195.  eines meiner Shareware-Programme sind und sich Ihre Anschrift nicht
  196.  geändert hat, können Sie die Module direkt per Überweisung bestellen.
  197.  Als Verwendungszweck geben Sie bitte "XiPaintMod für ...." an, wobei Sie
  198.  das Programm was Sie schon haben und die Registriernummer angeben.
  199.  Zusätzlich möglichst auch noch Name/Anschrift; die Bankverbindung:
  200.  Konto-Nr. 5740147 BLZ 310 500 00 Stadtspark. Mönchengladbach)
  201.  (No bank transfers from outside germany!)
  202.  
  203. Send your filled in registration form together with cheque, international
  204. postal money order or banknotes to:
  205.  
  206.                         Helmut Hoffmann
  207.             Rubensstrasse 4
  208.             D-41063 Mönchengladbach
  209.  
  210.             Germany
  211.  
  212. You can currently also contact me by EMail (e.g. for suggestions):
  213.  
  214.         hhoff@pool.informatik.rwth-aachen.de
  215.  
  216. No registrations by EMail! If you want to register, please write by ordinary mail
  217. to my address above.
  218.  
  219. Special Thanks
  220. ==============
  221.  
  222. My special thanks go to Mr. Thomas Dorn and Ossowski's Schatztruhe for
  223. providing me with XiPaint.
  224.  
  225. Disclaimer
  226. ----------
  227.  
  228. This software (program and documentation) is provided "as is" and
  229. comes with no warranty, either expressed or implied.
  230. The author is in no way responsible for any damage or loss that may
  231. occur due to direct or indirect usage of this software. You use
  232. this software entirely at your own risk.
  233.  
  234. Copyright and Distribution
  235. --------------------------
  236.  
  237. HHsFastUniversalXiPaintModule (module and documentation) is copyright by
  238.  
  239.                         Helmut Hoffmann
  240.             Rubensstrasse 4
  241.             D-41063 Mönchengladbach
  242.  
  243.             Germany
  244.  
  245. The demo version may be freely distributed and used as
  246. long as the following conditions are met:
  247.  
  248. 1) All files have to be kept together
  249.  
  250. 2) No file may be modified or crunched/packed.
  251.  
  252.    The only official way to distribute the demo packed is the
  253.    original xipaintmod.lha archive.
  254.    The modules may not be disassembled or analysed. The limitations
  255.    integrated in the demo version may under no circumstance be removed
  256.    or bypassed.
  257.  
  258. 3) Distributors may only charge for the duplication process (including media)
  259.    and not for the software. Theese charges may not exceed the following
  260.    limits: a) Demo on a PD-disk: 7$ (US-dollar) including
  261.               postage&packing (in Germany: 10DM)
  262.        b) Demo on a PD-CD-ROM: 40$ (US-dollar) including
  263.               postage&packing (in Germany: 60DM)
  264.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  265.               callable system: Maximum charge 3$ (US-dollar) (in Germany: 5DM)
  266.               for downloading
  267.    Anyway, it must be made explictly clear to the buyer, that he does not
  268.    pay for the modules (demo) itself but only for the duplication service.
  269.  
  270. 4) It is not allowed to distribute this demo with any commercial product
  271.    without a written permission by me. One exception is the distribution of
  272.    the demo version with products not exceeding the above price limits (e.g.
  273.    a cover-disk magazine for 7$ or less).
  274.  
  275.    The demo version may be included with XiPaint.
  276.  
  277. 5) The registered version may not be redistributed. It may only run on one
  278.    machine per registration. It is allowed to make a backup copy of the
  279.    original disk.
  280.  
  281. Version history
  282. ---------------
  283.  
  284. V0.1 (7th aug. 95): Prerelease for loading functions
  285. V0.2 (20th aug. 95): Prerelease for loading by ARexx script:
  286.             added Request option and screen switching functions
  287. V1.0 (15th sep. 95): First official release for use by Arexx script (usable
  288.             with XiPaint 3.x)
  289. V2.0 (21st sep. 95): First release with direct loader module support for
  290.             XiPaint 3.2 (just copy the .xio file into the
  291.             XiPaint/Modules directory and configure it as loader)
  292. V2.1 (9th oct. 95): Extended TIF loader to support "Intel" byte order files
  293.             and more variants
  294. V3.0 (11th dec. 95): TrueColor animation saving: extended module to support
  295.             saving in HHsYUVSq animation format;
  296.             included ARexx script to automatically create such
  297.             animations from multiple pictures;
  298.             Use CyberTVPlayer or EGSTVPlayer to play such animations.
  299.              Extended IFF loader to accept 0-sized chunks
  300.              Loader can now load bigger pictures into smaller projects
  301.              Integrated downscaling support (only usable by scripts)
  302.  
  303.  
  304. ============================= Archive contents =============================
  305.  
  306. Original  Packed Ratio    Date     Time    Name
  307. -------- ------- ----- --------- --------  -------------
  308.      628     271 56.8% 11-Dec-95 18:16:22  XiPaintModule.info
  309.      884     372 57.9% 11-Dec-95 00:17:48 +hhsxipaintloader.rx
  310.    13729    5655 58.8% 11-Dec-95 03:35:42 +hhsxipaintmod.readme
  311.      477     248 48.0% 11-Dec-95 00:41:56 +hhsxipaintmod.readme.info
  312.    31264   16217 48.1% 11-Dec-95 00:35:04 +hhsxipaintmod.xio
  313.     2354     875 62.8% 11-Dec-95 18:44:26 +makeanim.rx
  314.      461     175 62.0% 11-Dec-95 00:42:24 +makeanim.rx.info
  315.     2207     957 56.6% 11-Dec-95 00:45:58 +registration.txt
  316.      477     251 47.3% 11-Dec-95 00:43:02 +registration.txt.info
  317. -------- ------- ----- --------- --------
  318.    52481   25021 52.3% 13-Dec-95 01:07:12   9 files
  319.