home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / t / to24bpp / !To24bpp / Resources / g2sHelp next >
Encoding:
Text File  |  1995-01-13  |  3.0 KB  |  102 lines
  1. Contents
  2. --------
  3. gif2spr
  4. Installation
  5. Command line Usage
  6. Usage with Webster
  7. Notes
  8. Contacting me
  9.  
  10. gif2spr
  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. 3rd release.
  16.  
  17. I cannot be held responsible for an damage as a result of use or missuse of
  18. this program.
  19.  
  20. Installation
  21. ------------
  22. ensure that gif2spr is in a directory pointed to by Run$Path
  23. my copy is saved in the library directory of my harddisc and my
  24. Run$Path looks like this. If you are only going to use it with
  25. Webster read the notes under the heading 'Usage with Webster'
  26.  
  27. show Run$Path
  28. Run$Path(Macro) : ,%.,Boot:Library.,ADFS::HardDisc4.$.Library.
  29.  
  30. Command line Usage
  31. ------------------
  32. for now all you can enter a gif as the first file argument and
  33. the pathname of the sprite file as the second file argument.
  34.  
  35. gif2spr <-q> <-v> RAM:$.in RAM:$.out
  36.  
  37. There are now two options that can be used.
  38. -q stops gif2spr generating error messages when things go wrong
  39. -v generates verbose output.
  40.  
  41. Usage with Webster
  42. ------------------
  43. To use gif2spr with webster instead of ChangeFSI load the messages file into
  44. a text editor and change the line (currently the first in the file) that
  45. looks like:
  46.  
  47. GIFVIEWER:<ChangeFSI$Dir>.ChangeFSI %0 %1 %2 -nomode
  48.  
  49. to:
  50.  
  51. GIFVIEWER:gif2spr -q %0 %1
  52.  
  53. If gif2spr has not been placed in a directory pointed to by Run$Path then
  54. you will need the full pathname of the program or if you are only going to
  55. use it with Webster you could copy gif2spr into the webster directory and
  56. set GIFVIEWER to:
  57.  
  58. GIFVIEWER:<Webster$Dir>.gif2spr -q %0 %1
  59.  
  60. Notes
  61. -----
  62. Only sprites with square pixel aspect ratios are generated.
  63.  
  64. This program appears to be at least twice as fast as ChangeFSI even
  65. though ChangeFSI has hand coded LZW decompression. This made me very
  66. happy when I tested it.
  67.  
  68. I've tested the program on 1,2,4,6,7,8 bits per pixel all the routines
  69. have been tested since 3bpp uses the 4bpp routines and 5,6,7bpp uses 8bpp
  70. I've only tested the transparency on 8bpp gifs, but the masking code is
  71. almost identical to the pixel code so should not cause any problems. I
  72. did check that part of the code for typos. The images I have were not
  73. suitable for creating transparency masks as they were scanned in and
  74. did not have large areas of single colour.
  75.  
  76. The code to deal with interlaced gif's has been re-coded since the last
  77. release and is more likely to work correctly. Previously some images
  78. had a few lines in the wrong place making the image look quite odd.
  79.  
  80. The -q and -v options should be seperate and not of the form -qv but this
  81. would not make much sense anyway. This may change in the future as more
  82. options need to be added.
  83.  
  84. Thanks to:
  85. Andrew Pullan
  86. Doug Winter
  87. Ben Schofield
  88. Philip Banks.
  89.  
  90. Contacting me
  91. -------------
  92. This is the third distribution and was made on Friday 13th of January 1995
  93.  
  94. Simon Truss
  95. simon@bigblue.demon.co.uk
  96. u1smt@csc.liv.ac.uk
  97.  
  98. 11 Fairfield Crescent
  99. Fairfield
  100. Liverpool
  101. L6 8PH
  102.