home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / multimedia / b152_1 / !FSPConv / Help / General < prev    next >
Text File  |  1994-01-15  |  4KB  |  118 lines
  1. Help For FSPConv
  2. ================
  3.  
  4. FSPConv prepares sprite files for use by the module FastSpr.  The FastSpr
  5. module provides high speed sprite plotting with clipping and masking, and
  6. has proven reliable in the commercial field.  FastSpr version 2.00 may be
  7. used with no royalty payments for both commercial and non-commercial
  8. applications.  FastSpr can be obtained from most PD libraries.
  9.  
  10. Using FSPConv
  11. =============
  12.  
  13. FSPConv converts a normal sprite file into a FastSpr file.  A typical FastSprfile would be created like this:
  14.  
  15. • Create a sprite file using paint, with sprites named 0,1,2,3,4,5 etc...
  16. • Drag this file to the FSPConv icon.
  17. • A sprite window and a conversion window should appear.  The conversion
  18.    window has a save destination filename, which by default is the sprite
  19.    filename with FSP inserted before the final name (the 'leafname').
  20. • If you want to, drag the FastSpr file icon to a filer window to change the
  21.    save destination, in the usual way.
  22. • You may now click the 'Convert' button the begin conversion.
  23. • Bazaam!!!  FSPConv should do the business.
  24.  
  25. You may close the conversion window if you want to mess about with your
  26. sprites before converting them.
  27.  
  28. As you might guess, telling FastSpr to plot sprite 0 will plot the sprite
  29. which was originally called '0'.
  30.  
  31. BIG NOTE: FSPConv cannot convert a FastSpr file BACK into a normal sprite
  32. file, so keep a copy of your normal sprite file to edit your sprites.
  33.  
  34. Transparency
  35. ============
  36.  
  37. Sprite masks are ignored, as they double the size of your sprite files.
  38. Instead, one colour, usually colour 0, is taken to be transparent.  This may
  39. be altered on the icon bar menu if you wish.
  40.  
  41. Limitations
  42. ===========
  43.  
  44. Both FSPConv and FastSpr were designed with 256 colour sprites in mind.  They
  45. both 'should' cope with 2,4 and 16 colour modes but the horizontal position
  46. resolution is reduced (FastSpr takes coordinates of the form lines down,
  47. BYTES across).
  48.  
  49. You can’t yet drag a file from a !Paint save window straight to FSPConv.
  50.  
  51. Sprite palletes are ignored.  This makes the 16 colour ones look a bit
  52. bizarre in the sprite window, but the still convert OK.
  53.  
  54. FSPConv will run out of memory if you have sprites numbered over 1000 or so.
  55. The best cure is to have lower sprite numbers as excessively large numbers
  56. waste memory and disc space, but if you must, change the WimpSlot in
  57. FSPConv’s !Run file.
  58.  
  59. The Quick Test
  60. ==============
  61.  
  62. Try this:
  63.  
  64. • Use !Paint to make a sprite file with a sprite named 0 which is, say width
  65.    16, height 16, in mode 13.  Be artistic!
  66. • Save it with the name 'Sprites' in the root directory of your disc (the
  67.    one that opens when you click on the disc icon).
  68. • Drag this file to the FSPConv icon.
  69. • Click convert.
  70. • Double click on the !FastSpr icon.
  71. • Press F12.
  72. • Type 'FastSprLoad FSPSprites' (without the quotes).
  73. • Get an error message?  Type 'Mount' and try again.
  74. • Type 'BASIC'
  75. • Type 'MODE 13' (capitals).
  76. • Type 'SYS "FastSpr_Plot",0,150,150' with all the capitals in the right
  77.    places.
  78.  
  79. If all is well, your sprite should the appear on the screen.
  80.  
  81. Status
  82. ======
  83.  
  84. FSPConv is public domain and may be freely distributed.  The program was
  85. written in C and compiled with Acorn C version 3.00, so it should work with
  86. RISC OS 2 provided you have a copy of the Shared C Library 3.50 or greater
  87. and Colourtrans.
  88.  
  89. Bugs
  90. ====
  91.  
  92. I don’t know of any serious ones, but I’d like to know if you find any.
  93. FastSpr is known to have problems (address exceptions etc) in the following
  94. situations:
  95.  
  96. • If the screen is scrolled.
  97. • If you try to use two screen banks but don’t have sufficient memory
  98.    allocated.
  99. • You use the *Shadow command.
  100. • You use commands like MODE 128+13 (use MODE 15:MODE 13 instead).
  101.  
  102. Please send your bug reports, both for FastSpr and FSPConv, to:
  103.  
  104. Andy Southgate
  105. 14 Madingley Road
  106. Cambridge
  107. CB3 0EE
  108.  
  109. or Email as142@cus.cam.ac.uk
  110.  
  111. If you could send me the sprite file which causes the problem, so much the
  112. better.
  113.  
  114. Good luck!
  115.  
  116. Andy.
  117.  
  118.