home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / webster / !Webster / Docs / gif2spr < prev    next >
Text File  |  1995-07-09  |  6KB  |  136 lines
  1.  
  2. <HTML><HEAD><TITLE>README for gif2spr V1.06</TITLE></HEAD>    <BODY>
  3.  
  4. <!-- $Id: ReadMe 1.1 95/06/29 22:11:51 root Exp $ -->
  5.  
  6. <H2><A NAME="Contents">Contents</A></H2>
  7. <UL>
  8. <LI><A HREF="#gif2spr">gif2spr</A>
  9. <LI><A HREF="#Installation and Usage">Installation and Usage</A>
  10. <LI><A HREF="#Command line Usage">Command line Usage</A>
  11. <LI><A HREF="#Notes">Notes</A>
  12. <LI><A HREF="#History">History</A>
  13. <LI><A HREF="#Contacting me">Contacting me</A>
  14. </UL>
  15. <H2><A NAME="gif2spr">gif2spr Version 1.06</A></H2>
  16.  
  17. A simple program to convert gif87a and gif89a graphic formats to Acorn
  18. Sprite format. Transparency masks for the GIF files are created to
  19. improve the appearance of the sprite. Interlaced images have been catered
  20. for since the 2nd release. Version 1.06 will be the sixth release! Is it
  21. just bad programming or bad testing that caused this?
  22. <P>
  23. I cannot be held responsible for any damage or loss of data as a result of
  24. use or missuse of this program.
  25. <P>
  26. <H2><A NAME="Installation and Usage">Installation and Usage</A></H2>
  27.  
  28. There are currently several other programs that require gif2spr to work correctly
  29. these normally include the latest version as of their release date. If you wish
  30. to update one of those version please check the documentation of those programs
  31. first but it should only require copying the new version of gif2spr to be copied
  32. into the appropriate place.
  33. <P>
  34. Command line installation
  35. <P>
  36. Please ensure that gif2spr is in a directory pointed to by Run$Path, my copy is
  37. saved in the library directory of my harddisc and my Run$Path looks like this.
  38. <P>
  39. Show Run$Path <BR>
  40. Run$Path(Macro) : ,%.,Boot:Library.,ADFS::HardDisc4.$.Library.
  41. <P>
  42. <H2><A NAME="Command line Usage">Command line Usage</A></H2>
  43.  
  44. You can enter the pathname of a gif as the first file argument and
  45. the pathname of the sprite file as the second file argument.
  46. <BR>
  47. <TT>gif2spr [-q] [-v] RAM:$.in RAM:$.out</TT>
  48. <BR>
  49. There are two options that can also be used.
  50. <UL> <LI>-q stops gif2spr generating error messages when things go wrong, useful when
  51.        called by other programs
  52. <LI> -v generates verbose output.
  53. </UL>
  54.  
  55. <H2><A NAME="Notes">Notes</A></H2>
  56.  
  57. Only sprites with square pixel aspect ratios are generated.
  58. <P>
  59. This program appears to be at least twice as fast as ChangeFSI even
  60. though ChangeFSI has hand coded LZW decompression. This made me very
  61. happy when I tested it.
  62. <P>
  63. I've tested the program on 1,2,4,6,7,8 bits per pixel all the routines
  64. have been tested since 3bpp uses the 4bpp routines and 5,6,7bpp uses 8bpp
  65. I've only tested the transparency on 8bpp and 1bpp gifs, but the masking code is
  66. almost identical to the pixel code so should not cause any problems. I
  67. did check that part of the code for typos. The images I have were not
  68. suitable for creating transparency masks as they were scanned in and
  69. did not have large areas of single colour. This program has now been
  70. in use for many months with very few reported errors, if you find any
  71. please send me the report generated by gif2spr when run with the -v
  72. option on the offending GIF file. The GIF file would also be of use.
  73. <P>
  74. The -q and -v options should be seperate and not of the form -qv but this
  75. would not make much sense anyway. This may change in the future as more
  76. options need to be added.
  77. <P>
  78. <H2><A NAME="History">History</A></H2>
  79.  
  80. 1.03 The code to deal with interlaced gif's has been re-coded since version
  81. 2 and is more likely to work correctly. Previously some images had a few
  82. lines in the wrong place making the image look quite odd.
  83. <P>
  84. 1.04 has fixed a rare problem that occured when GIF's with multiple graphic
  85. extensions caused the error message  'liblug: Unkown input file type'
  86. <P>
  87. 1.05 Another Rare error this was created by me several versions ago. It only
  88. happens when an empty transparent index graphic extension occurs in the data
  89. stream and generates the message 'liblug: Unkown input file type'
  90. <P>
  91. 1.06 It appears that there is a program out there on the Mac that generates GIFs
  92. with an extra byte compressed on the end of the image data. The effect was to
  93. overwrite the beginning of another malloc'd block and caused an error when trying
  94. to free that memory. The extra byte only occures when a scan line is a multiple
  95. of 4 pixels. I have 6 examples of this problem.
  96. <P>
  97. Another problem generated by a Mac program (possibly the same) caused the
  98. same error message as above to occur but was because the gif had a strange
  99. definition for it's colour map and caused an unallocated pointer to be freed
  100. (This is partly bad programming but should not have occured if the gif hadh had
  101. it's flags set correctly). As a result of all this gif2spr is now more tollerant
  102. of strange GIF files.
  103. <P>
  104. My Thanks go to the following people (in no particular order)
  105. <UL>
  106. <LI> Peter Burwood
  107. <LI> Andrew Pullan
  108. <LI> Doug Winter
  109. <LI> Ben Schofield
  110. <LI> Philip Banks
  111. <LI> Stewart Brodie
  112. <LI> Mike Cook
  113. <LI> Steve Ellacott
  114. </UL>
  115. <P>
  116. <H2><A NAME="Contacting me">Contacting me</A></H2>
  117.  
  118. This is the Sixth distribution and was made on the 29th June 1995
  119. <P>
  120. Simon Truss <BR>
  121. <A HREF="mailto:simon@bigblue.demon.co.uk"> simon@bigblue.demon.co.uk</A>
  122. <P>
  123. I can be contacted on this address until about september 95 <BR>
  124. <A HREF="mailto:u1smt@csc.liv.ac.uk"> u1smt@csc.liv.ac.uk</A>
  125. <P>
  126. I can be contacted at the following address for a few years yet
  127. (It has to be forwarded on, but it will reach me)
  128. <P>
  129. 23 Charlton Gardens <BR>
  130. Coulsdon <BR>
  131. Surrey <BR>
  132. CR5 1AS <BR>
  133. <HR> <ADDRESS><A HREF="mailto:simon@bigblue.demon.co.uk">Simon Truss</A> <BR>Last Upated "Jun 29 1995"</ADDRESS>
  134. </BODY>    </HTML>
  135.  
  136.