home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / www / ArcWEB / !WebHelper / AppDir / gif2spr / ReadMe < prev    next >
Text File  |  1995-03-10  |  4KB  |  117 lines
  1. Contents
  2. --------
  3. gif2spr
  4. Installation
  5. Command line Usage
  6. Usage with Webster
  7. Notes
  8. Contacting me
  9.  
  10. gif2spr Version 1.05
  11. --------------------
  12. A simple program to convert gif87a and gif89a graphic formats to Acorn
  13. Sprite format. transparency masks are supported with both input and output.
  14. Interlaced images have been catered for since the 2nd release. This is the
  15. 5th release.
  16.  
  17. I cannot be held responsible for any damage or loss of data as a result of
  18. use or missuse of this program.
  19.  
  20. Installation
  21. ------------
  22. If you are using this as a command line tool please read on. If a program
  23. you are using requires this utility please read the other instructions
  24. before reading these any further. Please ensure that gif2spr is in a
  25. directory pointed to by Run$Path, my copy is saved in the library directory
  26. of my harddisc and my Run$Path looks like this. If you are only going to use
  27. it with Webster read the notes under the heading 'Usage with Webster'
  28.  
  29. show Run$Path
  30. Run$Path(Macro) : ,%.,Boot:Library.,ADFS::HardDisc4.$.Library.
  31.  
  32. Command line Usage
  33. ------------------
  34. You can enter the pathname of a gif as the first file argument and
  35. the pathname of the sprite file as the second file argument.
  36.  
  37. gif2spr [-q] [-v] RAM:$.in RAM:$.out
  38.  
  39. There are two options that can also be used.
  40. -q stops gif2spr generating error messages when things go wrong
  41. -v generates verbose output.
  42.  
  43. Usage with Webster
  44. ------------------
  45. To use gif2spr with webster instead of ChangeFSI load the messages file into
  46. a text editor and change the line (currently the first in the file) that
  47. looks like:
  48.  
  49. GIFVIEWER:<ChangeFSI$Dir>.ChangeFSI %0 %1 %2 -nomode
  50.  
  51. to:
  52.  
  53. GIFVIEWER:gif2spr -q %0 %1
  54.  
  55. If gif2spr has not been placed in a directory pointed to by Run$Path then
  56. you will need the full pathname of the program or if you are only going to
  57. use it with Webster you could copy gif2spr into the webster directory and
  58. set GIFVIEWER to:
  59.  
  60. GIFVIEWER:<Webster$Dir>.gif2spr -q %0 %1
  61.  
  62. Notes
  63. -----
  64. Only sprites with square pixel aspect ratios are generated.
  65.  
  66. This program appears to be at least twice as fast as ChangeFSI even
  67. though ChangeFSI has hand coded LZW decompression. This made me very
  68. happy when I tested it.
  69.  
  70. I've tested the program on 1,2,4,6,7,8 bits per pixel all the routines
  71. have been tested since 3bpp uses the 4bpp routines and 5,6,7bpp uses 8bpp
  72. I've only tested the transparency on 8bpp gifs, but the masking code is
  73. almost identical to the pixel code so should not cause any problems. I
  74. did check that part of the code for typos. The images I have were not
  75. suitable for creating transparency masks as they were scanned in and
  76. did not have large areas of single colour.
  77.  
  78. 1.03 The code to deal with interlaced gif's has been re-coded since version
  79. 2 and is more likely to work correctly. Previously some images had a few
  80. lines in the wrong place making the image look quite odd.
  81.  
  82. 1.04 has fixed a rare problem that occured when GIF's with multiple graphic
  83. extensions caused the error message 
  84. 'liblug: Unkown input file type'
  85.  
  86. 1.05 Another Rare error this was created by me several versions ago. It only happens when an empty transparent index graphic extension occurs in the data stream and generates the message
  87. 'liblug: Unkown input file type'
  88.  
  89. The -q and -v options should be seperate and not of the form -qv but this
  90. would not make much sense anyway. This may change in the future as more
  91. options need to be added.
  92.  
  93. In no particular order my thanks go to:
  94. Peter Burwood
  95. Andrew Pullan
  96. Doug Winter
  97. Ben Schofield
  98. Philip Banks
  99. Stewart Brodie
  100.  
  101. Contacting me
  102. -------------
  103. This is the fifth distribution and was made on Friday 10th of March 1995
  104.  
  105. Simon Truss
  106. simon@bigblue.demon.co.uk
  107.  
  108. I can be contacted on this address until september 95
  109. u1smt@csc.liv.ac.uk
  110.  
  111. I can be contacted here until about May/June 95
  112.  
  113. 11 Fairfield Crescent
  114. Fairfield
  115. Liverpool
  116. L6 8PH
  117.