home *** CD-ROM | disk | FTP | other *** search
/ Esprit de Apple Corps / EDAC-2.iso / Graphics / Apps / Programs / GIF.Stripper / GIFSTRIPPER.DOC < prev   
Encoding:
Text File  |  1989-04-07  |  5.0 KB  |  100 lines
  1.  _________________| GIFStripper: Automatic File Header Strip |_________________
  2.                   | v1.1a  Copyright (C) 1989 Joseph Schober |
  3.  
  4. REVISION LOG: 04/07/89 (v1.1a)
  5. ==============================
  6.   o Improved error handling and reporting.
  7.   o Added picture resolution and color statistics during stripping process.
  8.   o Added prompt to auto-delete the original (unstripped) file.
  9.   o Fixed lots of little bugs, including one totally stupid one that prevented
  10.     you from stripping multiple files in a single session.  (The stripping
  11.     APPEARED to go right, but the resulting file was 256 bytes out of sync...
  12.     funny no one pointed this one out to me.)
  13.   o After all this, sliced a block off the program's size!
  14.  
  15. Overview
  16. ========
  17. GIFStripper is a utility to process GIF (Graphic Interchange Format)
  18. pictures downloaded from information services and bulletin boards.  It is
  19. meant to remove filetype-information headers (such as those placed by the
  20. Mac AppleLink - Personal Edition software) and archive headers (such as
  21. those placed by the MacBinary protocol) that interfere with GIF file viewing.
  22. Unlike some other similar processing utilities, GIFStripper will automatically
  23. find the location of the real GIF header, instead of being limited to a
  24. specific header length.  This allows the program to process files with all
  25. types of undesired headers.
  26.  
  27. Equipment
  28. =========
  29. GIFStripper is designed to work on any Apple II series machine running under
  30. ProDOS 8.  It will function properly on even an Apple ][+; however, a lower
  31. case chip or 80 column board will be required to view the program text on
  32. such machines.
  33.  
  34. Operation
  35. =========
  36. GIFStripper's operation is fairly straightforward.  After being launched
  37. (since GIFStripper is a SYStem file, you may use any program launcher to
  38. run it -- ProSEL, the GS Finder, or even BASIC.SYSTEM), the program will
  39. prompt for a SOURCE pathname; that is, the file with the header you wish
  40. to remove.  If you do not enter a complete path (preceded by a "/"), ProDOS
  41. will append the current prefix to your entry.  The source file will then be
  42. scanned for the GIF87a header.  If the GIF87a header is not found at all, or
  43. is found at its proper location (the first byte of the file), you will be
  44. informed of that fact and asked for another source file.  Otherwise,
  45. GIFStripper will tell you where the valid GIF header begins, and ask for a
  46. target pathname.  Again, if you do not enter a complete path, ProDOS will
  47. append the active prefix to your entry.  The stripped GIF file will then be
  48. saved to disk, and you will be prompted for another source file to work with.
  49. To exit GIFStripper, press [RETURN] without inputting anything at the source
  50. pathname prompt.  (This will execute an MLI QUIT call...)  That's all there is
  51. to it!
  52.  
  53. Error Handling
  54. ==============
  55. Any MLI errors will abort the processing in progress, report an MLI error
  56. (including the exact error code that occurred and, usually, a short description
  57. of the error), and return to the source pathname prompt.
  58.  
  59. Known Bugs
  60. ==========
  61.   o GIFStripper will not locate a GIF header unless it's in the first 256 bytes
  62.     of the source file.  This shouldn't be a problem; I haven't seen any
  63.     file-info headers that are more than 128 bytes...
  64.   o GIFStripper occasionally returns an MLI error $50 (File busy) if you try
  65.     to convert a file again after an error on the previous conversion.
  66.  
  67. Enhancements Planned
  68. ====================
  69.   o Ability to scan and automatically correct all files in a sub-directory at
  70.     once, instead of requiring file-by-file processing.
  71.   o COMING SOON (hopefully!): A 16-bit, GS specific version of GIFStripper.
  72.     This will, once complete, have all the features of the current 8-bit
  73.     program, PLUS the ability to view GIF files in _256 and/or 3200 colors_!
  74.  
  75. Distribution and Support
  76. ========================
  77. GIFStripper is FREEWARE -- you may distribute it freely, so long as the program
  78. file and this documentation file remain together and intact.  You are not
  79. obliged to send in money if you use this program; however, if you find yourself
  80. using GIFStripper, a little thanks wouldn't hurt.  (If every person who
  81. downloaded GIFStripper 1.0 sent me a measly ONE DOLLAR, I'd have enough money
  82. to buy a TransWarp GS... :)  You can make checks payable to Joseph Schober.
  83.  
  84. If you have problems with GIFStripper, or would like to make suggestions for
  85. future versions of this utility (or give ideas for other utilities), you can
  86. contact me at any of the following places...
  87.  
  88.   STARPORT BBS: 703/931-0947 (PC Pursuit: DCWAS/24), 3/12/2400 baud, user #1.
  89.   APPLELINK PE: JSchober
  90.   COMPUSERVE..: 72727,2765  (I don't hang around CompuServe all too much, so
  91.                             you'll get a faster response via either of the
  92.                             other two on-line services...)
  93.   SNAILMAIL...: J. Schober
  94.                 3528 Pinetree Terrace
  95.                 Falls Church, VA  22041
  96.  
  97. That's it!  I hope you get some use out of GIFStripper.  See ya' on-line!
  98.  
  99.  ___v1.1a  04/07/89____________________________________________________________
  100.