home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga Shareware Floppies / ma01.dms / ma01.adf / wasp / wasp.doc < prev    next >
Encoding:
Text File  |  1991-12-29  |  3.0 KB  |  82 lines
  1. Program: Wasp 1.26
  2. Copyright Steven Reiz 1991, 1992, see the COPYING file for more info.
  3. Purpose: Converts pictures from GIF and IFF format to IFF format.
  4. Usage:   wasp [options] [operations] [parameters] infile|- [outfile|-]
  5.  
  6. Input formats supported:
  7. - GIF (87a)
  8. - IFF hires, lores, HAM, EHB, sliced hires, lores, and HAM, dynamic hires,
  9.   lores and HAM, 24-bits IFF.
  10. - SRGR, a private format, basically uncompressed 12-bits RGB.
  11. - Sun rasterfile, monochrome only
  12. - PPM, P5 (binary 8-bits greyscale) and P6 (binary 24-bits RGB) only.
  13. - HL2, the temporary file format produced by the Hamlab input filters
  14.  
  15. Output formats supported:
  16. - IFF hires, lores, HAM, EHB, sliced hires, lores, and HAM, dynamic hires,
  17.   lores and HAM, 24-bits IFF.
  18. - SRGR
  19. - PPM, P6 (binary 24-bits RGB) only.
  20.  
  21. Main features:
  22. - SPEED! This program has been developed on an unaccelerated A500, on which
  23.   all of the other GIF -> IFF conversion programs ran way too slow.
  24.   Wasp is three times faster than supercon, seven times faster than
  25.   gifmachine, and even faster than TAD, a commercial program!
  26. - Good output quality, generally better than TAD, and much better than most
  27.   other programs.
  28. - Many IFF output formats are supported, including HAM, sliced HAM, dynamic
  29.   HAM and dynamic hires.
  30.  
  31. Operation
  32.  
  33. Wasp reads the input file and tries to recognize it. If this succeeds
  34. it prints some information about the format of the file and the size
  35. of the picture. If the outfile argument was omitted, wasp stops here.
  36. Otherwise it reads the input file, and converts it to the internal
  37. format; 12-bits RGB. It optionally applies operations such as clipping
  38. and scaling to the internal picture, and then converts it to the requested
  39. output format.
  40.  
  41. Reading from stdin/writing to stdout
  42.  
  43. Wasp will try to read the input image from stdin and/or write the
  44. output image to stdout if you specify the filename(s) as '-'.
  45. This only works for images that don't have to be seeked, meaning
  46. nearly all inputfiles, and lots of outputfiles. Some image types
  47. which can always be read from stdin and written to stdout are ppm
  48. and srgr. Problems can occur when reading iff files without a camg
  49. chunk, or when writing iff files.
  50.  
  51. Using the Hamlab input filters with Wasp
  52.  
  53. Hamlab and the demo version of hamlab come with a number of input
  54. filters, readers for the gif, mtv, pnm, qrt, ras, spec and tiff
  55. formats. Some examples of using these filters with Wasp:
  56.  
  57. When using the SKsh shell, which supports pipes:
  58. ( qrt2hl <somepic.qrt ) | wasp -sliced -lace -ham - somepic.sham
  59.  
  60. Using the AmigaDOS shell:
  61. tiff2hl <foobar.tiff >foobar.hl
  62. wasp -dyn -hires -enlarge 640 200 foobar.hl foobar.dynhi
  63.  
  64. Comments
  65.  
  66. Comments, suggestions, bug reports, and dollar bills (uuencoded, of course)
  67. can be sent to sreiz@cs.vu.nl, I would appreciate some feedback, let me
  68. know what you think about wasp!
  69.  
  70. Options
  71.  
  72. If wasp is invoked without options it prints an extensive list of all
  73. the options it understands. When in doubt: Use the Force, Read the Source.
  74.  
  75. Example
  76.  
  77. ``wasp -sliced l.gif l.sham'' converts the GIF file l.gif to sliced HAM.
  78.  
  79. Have fun!
  80.  
  81.     Steven
  82.