home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / graphics / fixagif / fixagif.txt < prev   
Text File  |  1993-01-11  |  12KB  |  267 lines
  1.  
  2. Fix-A-GIF Utility
  3. Copyright 1992 by Lonny L. Pursell and ENCOM
  4. All Rights Reserved.
  5.  
  6. Version 1.00
  7. Released Dec 19, 1992
  8.  
  9.  
  10. Note: Please skip to the end of this file for revision information.
  11.  
  12.  
  13. Purpose
  14. -------
  15.    This utility should fix any GIF file which is properly constructed
  16. as outlined in the GIF specifications.  The term 'fix' is used loosely
  17. and covers several possible situations that most people run into when
  18. downloading GIF files from different sources.  This utility will do
  19. the following:
  20.  
  21. Completely fixes GIFs that have been processed by the PC program GIFLITE.
  22. Convert GIF89a files into GIF87a files and remove extra data.
  23. Split GIFs with multiple images into seperate files.
  24. Analyze GIFs and report version, resolution, colors, status, and the like.
  25. The user can selectively remove the extra data from the GIF file.
  26. The data removed can be output to a file for later inspection.
  27.  
  28.  
  29. What you should have:
  30.     FIXAGIF.PRG  the utility
  31.     FIXAGIF.DOC  the documentation
  32.     STIGR9.GIF   a sample GIF89a file containing 48 images
  33.  
  34. Program Use
  35. -----------
  36. If you want to convert a GIF from GIF87a to GIF89a, simply run the
  37. program and select 'Start' and follow the prompts.  All the options in
  38. the program default to that situation when you first run the program.
  39.  
  40. WARNING: Always keep a backup copy of the image you want to fix if
  41. you are not sure what is going to happen.  The original GIF file is ONLY
  42. read, not modified.  Always play it safe with new or unknown software.
  43. Keep in mind that once you split a multi-image GIF file and remove
  44. any extensions it may have, it can't be put back together the way it was!
  45. So keep the original GIF file unless you know what you are doing.
  46. The program can handle GIF's with a maximum of 999 images.
  47.  
  48. Note: Options are said to be 'On' when they are highlighted.
  49.       The status of the options at run time are said to be the default
  50.       settings.  What are extensions?   These are defined by the GIF89a
  51.       specifications and more often than not cause problems when found
  52.       in GIF files.  If your graphics software refuses to load a GIF
  53.       file, then it more than likely is a GIF89a file with extensions.
  54.       You really don't need to know what is contained in them, just being
  55.       aware of them is enough for time being.
  56.  
  57. Run the program from the GEM Desktop and a few seconds later you'll
  58. see the main dialog, where all the options are located.  The options are
  59. as follows:
  60.  
  61.   Conversion Method: This controls how the GIF file will be converted.
  62.     Clean GIF file: Removes selected extensions and writes the file back
  63.                     to disk. (default)
  64.     Split GIF file: Removes selected extensions and writes each image to
  65.                     a seperate disk file.
  66.  
  67.   Remove Extension: These determine which extension will be removed from
  68.                     the GIF file. (default: all are on)
  69.     Unknown: These are extension not defined by the GIF specifications.
  70.              Descriptions of all the extensions are beyond the scope of
  71.              this program.  These are for advanced users and should be
  72.              left 'On' unless you are familiar with the GIF89a
  73.              specifications.
  74.  
  75.   Options: Some additional controls you might find handy.
  76.     Retain Data: This determines whether or not to retain the data
  77.                  removed during the conversion.  Simply load the data file
  78.                  into a file editor and see just what was removed.
  79.                  (default: off)
  80.     Top/Left Justify: Determines if images will   be top/left justified
  81.                       or left as is.  If you find that your graphics
  82.                       software fails to load your split GIF files then
  83.                       re-split the original GIF file with this option 'On'.
  84.                       (default: off)
  85.  
  86.   Output Version: This determines the version of the output file.
  87.     GIF87a: Outputs a GIF87a file. (default)
  88.     GIF89a: Outputs a GIF89a file.
  89.     Output=Input: Outputs the same version as the input GIF file.
  90.                   This feature is also desinged for advanced users who are
  91.                   familiar with the GIF89a specifications.  It's possible
  92.                   to create an illegal GIF file with this feature!
  93.  
  94.   Analyze GIF: This feature scans a GIF file and reports various things
  95.                such as version, resolution, color, and stuff like that.
  96.                This function scans the entire GIF from start to finish
  97.                and also reports which extensions are present in the file.
  98.                It also reports whether or not a GIF file is structured
  99.                correctly.  It's listed as 'File Status' and reports 'Good'
  100.                or 'Bad' and only filef which return good can be fixed.
  101.                A file selector will appear so you can locate a GIF file. 
  102.                Press any key to return to the main dialog.
  103.  
  104.   Quit: Returns you to the GEM Desktop.
  105.  
  106.   Info: Show credit dialog.  (You might want to read this.)
  107.  
  108.   Help: Show help dialog. (You should read this.)
  109.  
  110.   Start: Starts the conversion with the options you have selected.
  111.  
  112.  
  113. --Online help--
  114. For further details on a specific option, click on the title bar
  115. above it.  If you don't read this doc file at least read the online
  116. help dialogs.
  117.  
  118. --To convert a GIF file--
  119. Selecting all the options from the main dialog, then select 'Start'.
  120. Hint: You might want to analyze the GIF file first with the analyze
  121. feature.  A file selector will then appear, now locate the input GIF file.
  122. After selecting the input GIF file the program will scan the GIF to make
  123. sure it's structured correctly.  If the GIF file is good a second file
  124. selector will appear so you can select the output path.  You only need path
  125. here, not a file name.  After selecting the output path the conversion will
  126. begin.  You can watch it's progress as the program displays a simplified
  127. representation of the GIF files structure as it converts it.  After
  128. it's converted you must press a key to return to the main dialog, where
  129. you can either quit or convert another GIF file.  If the input GIF file
  130. you selected is bad the program will tell you so.  The 'Analyze GIF'
  131. might display a more detail explaination of the problem, but not very
  132. often.
  133.  
  134. --Output details--
  135. My original intent was to write a utility to split GIF files with
  136. multiple images.  As it turns out I managed to follow the GIF87a/89a
  137. specifications so closely that it will clean up any GIF you feed it.
  138. Certain files are automatically named for you, to prevent accidental data
  139. loss.  Here's and example of how the output works... 
  140.  
  141.       You input BIGRIVER.GIF
  142.      It outputs BIGRIFIX.GIF  (if you selected clean)
  143.      It outputs BIGRI001.GIF  (if you selected split... more than 1 image...
  144.                 BIGRI002.GIF   ... 
  145.                 BIGRI003.GIF   and so on...)
  146. It also outputs BIGRIGIF.DAT  (same dir as the output file)
  147.  
  148. Note: Only the first 5 characters of the input file are used for the output
  149.       file name.
  150.  
  151. This utiltiy is very flexible in that you can selectively remove any
  152. extension you like.  Trying to split a GIF file with one image
  153. won't hurt anything, since the utility scans the GIF file before trying.
  154. Trying to clean a GIF file that contains no extensions won't hurt
  155. anything either.
  156.  
  157. You should keep the original GIF in a safe place and use only a backup
  158. copy just in case.  The input GIF file is only read, but should something
  159. go wrong it's best to have a backup copy.  Don't use your hard drive as
  160. the destination path unless you are comfortable with the program.
  161.  
  162. All the extra data removed from the file can be saved to a seperate file.
  163. This way you can read any comments that may of been left by the artist or
  164. package that created the file.  I added this feature to avoid having to
  165. load the GIF files into a disk editor and search high and low for comments.
  166.  
  167. Free disk space is NOT checked on the destination drive.
  168. Should an error be detected, all open files will be closed and the will
  169. return to the main dialog.
  170.  
  171. That's pretty much it.
  172.  
  173. --Some notes--
  174. Should run in any resolution on any ST compatible machine as it doesn't
  175. attempt to display GIF files.  Unlike some GIF conversion/fix utilities
  176. this one requires very little memory as it converts the file in 256 byte
  177. chuncks and only buffers small parts of the original GIF file.  It may
  178. be a bit slower, but you won't get an out of memory message.  Using a
  179. ramdisk is your best bet if you want to speed up the conversion.  It should
  180. be able to convert GIF files that are much larger than your systems free
  181. memory.  Basically, you are limited only by disk space.
  182.  
  183.  
  184. About the program
  185. -----------------
  186.     This program is the result of much fustration on my part due to the
  187. lack of a good GIF viewer that will read any GIF you feed it.  You don't
  188. see to many GIF89a files, but when you do, nothing will load them properly.
  189. On top of that, the ones I've come across contain more than one image, a
  190. comeplete animation infact with comments.  I have one with 32 frames and
  191. another with 48 and nothing that will load any of the images past the first
  192. one.  Other GIF fix prorgams failed to fix the larger of the two, infact
  193. it made it worse.  Most of these utility either completely ignore the
  194. extra images or they interpret the extra images as illegal data in the
  195. file.
  196.  
  197.     This program was written in GFA-Basic v3.6TTe on an Atari TT030.
  198.  
  199.  
  200. Support
  201. -------
  202.     As Sal would say: "Why pay retail?   Botta-Boom!  Botta-Bing!"
  203.  
  204.     This program is FreeWare.  Should you find a GIF file which this
  205. program fails to fix please send me the GIF file.  Please report any
  206. bugs should you find one or any ideas you might have for a feature.
  207. Donations of any kind are welcome, but not required.
  208.  
  209.     I would like to thank those who contacted me.  Thanks!
  210.  
  211. I can be reached via the following methods:
  212.  
  213. U.S. Postal Service...
  214.  
  215.    Lonny L Pursell
  216.    PO Box 145
  217.    Pandora  OH  45877
  218.    USA
  219.  
  220. Voice...
  221.    
  222.    Telephone: (419)-384-3594  after 4:00 PM [est]  most any day
  223.  
  224. Modem...
  225.  
  226.    CodeHead Quarters BBS
  227.    (213)-461-2095 [1200/2400/9600]
  228.    username: Lonny Pursell
  229.  
  230.  
  231. Usual stuff
  232. -----------
  233. Atari, GEM, ST, and TT are registered trademarks of Atari Corp.
  234. GIF, GIF87a, and GIF89a are copyrighted by CompuServe Inc.
  235. GFA-Basic is a registered trademark of GFA Systemtechnik
  236. All other items mentioned are trademarked by their respective owners.
  237.  
  238. There are NO implied warranties on this program, use at your own risk!
  239. The author is NOT responsible (in no way shape or form) for lost data
  240. or damaged hardware due to the use or misuse of this program.
  241. Not for sale!  This progam must remain unmodified along with this
  242. doc file if it is to be distributed via PD libraries or uploaded to
  243. any type of media storage system.
  244.  
  245.  
  246. Revision history
  247. ----------------
  248.     v0.50 [beta]  First release, hopefully bug free.
  249.     v0.51 [beta]  The output file selector only needs the output path,
  250.                   as it uses the input file name automatically.  The
  251.                   fixed GIF file will have a file extension of 'FIX'
  252.                   to reduce the chance of data loss. The status display
  253.                   now shows removed data in reverse video.  Unknown
  254.                   extensions will be removed, that is extensions not
  255.                   defined by the GIF specification.  Several internal
  256.                   changes have been made that will allow selective
  257.                   extension removal in a future version.
  258.     v0.52 [beta]  It was really late, I forgot what I did.  :^)
  259.     v1.00         Added a real GEM interface, added the 'Analyze GIF'
  260.                   feature, added user selectable extension removal,
  261.                   modified the way ouput files are named again, improved
  262.                   error handling.
  263.  
  264.  
  265.                               Atari Rules!
  266. --EOF--
  267.