home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / b / bmpsprite / !BMPSprite / !Help < prev    next >
Text File  |  1996-05-14  |  4KB  |  111 lines
  1. BMPSprite 1.03 (14 May 1996)
  2. —————————
  3.  
  4. Written by Darren Salt
  5. Based on (evolved from) FromBMP and ToBMP by David Thomas for Acorn Computing
  6.  
  7.  
  8. Purpose
  9. ———————
  10.  
  11. BMP is the format mainly used for graphical interchange in the Microsoft
  12. Windows (ie. inferior :-] ) environment for PC-compatible machines. Since
  13. many RISC OS users also use PCs on a regular basis, it's handy to be able to
  14. convert between BMP and the native formats on RISC OS (Sprite and Clear).
  15.  
  16. The BMPSprite application will convert BMP format pictures to Sprites, or
  17. Clear files if the BMP image is 8 or 24 bit colour, and back again.
  18.  
  19. When BMPSprite is run, or the Filer sees it, the 'BMP' and 'Clear' file icons
  20. are loaded; also, if you have RISC OS 3, the DOS file extension '.BMP' will
  21. be mapped to the BMP filetype.
  22.  
  23.  
  24. BMPSprite can convert files much faster than ChangeFSI; however, it is not,
  25. and is not intended to be, anywhere near as flexible.
  26.  
  27.  
  28. Usage
  29. —————
  30.  
  31. • Converting from BMP
  32.  
  33. Drag the source file, which must be of type 'BMP' (&69C) to the BMPSprite
  34. icon on the icon bar. The file will be accessed to determine the number of
  35. colours in the image and an appropriate save box will appear. When you save,
  36. the image will be converted from BMP and written out.
  37.  
  38. The saved file will be in either Sprite or Clear format. Use the icons below
  39. the filename icon to select the file format (the file icon will change
  40. appropriately).
  41.  
  42. - If Sprite is selected:
  43.  
  44.   The sprite is given the file's leafname as its name.
  45.  
  46.   If the input file was 8 bit colour, the resulting sprite will be in the
  47.   RISC OS 3 256-entry format (using mode 28). If you want a standard palette
  48.   version, then you should process the image using Translator or ChangeFSI,
  49.   although this will result in loss of colour resolution.
  50.  
  51.   If the input file was 16 or 24 bit colour, the resulting sprite will only
  52.   be displayable on a Risc PC, or by using software specially written to cope
  53.   with the new format. Again you can put the image through Translator or
  54.   ChangeFSI to turn it into a sprite displayable on all machines.
  55.  
  56. - If Clear is selected:
  57.  
  58.   This will only work for images with 8 or 24 bit colour. Other images can
  59.   only be saved as sprites - if this is the case, the radio icons will be
  60.   greyed out and the icon displayed will be that of a sprite file.
  61.  
  62.   The image is labelled as 'created by BMPSpri 1.03'. If it is 8bpp, then the
  63.   file includes a palette.
  64.  
  65.  
  66. • Converting to BMP
  67.  
  68. Drag the source file, which must be of type 'Sprite' (&FF9) or 'Clear' (&690)
  69. to the BMPSprite icon on the icon bar. If the file is valid (see the next
  70. paragraph), a save box will appear. When you save, the image will be
  71. converted and the BMP file written out. If you want to transfer it to a PC,
  72. you should (if possible) save it on a DOS-format disk, ensuring that it has
  73. the '/BMP' extension (which will, of course, appear on a PC as '.BMP').
  74.  
  75. The BMP format only supports 1, 4, 8, 16 or 24 bit colour files, so the input
  76. files accepted are any RISC OS sprite except for the four colour modes (eg.
  77. mode 8 or mode 26), or any Clear file with 8 or 24 bit colour. The pixel size
  78. is ignored, so mode 12 sprites (for example) will end up half height.
  79.  
  80.  
  81. In all cases, if the image has a palette, it is retained. Old-format
  82. 256-colour palettes (16 entries) are expanded to the full 256 entries; this
  83. *may* cause problems with non-standard palettes.
  84.  
  85.  
  86. Credits
  87. ———————
  88.  
  89. One of the reasons why David Thomas wrote the original converters was that
  90. Translator and ChangeFSI (up to at least v0.90) have problems when reading
  91. certain BMPs, as they incorrectly calculated the word-aligned line lengths.
  92. It isn't as if they're word-aligned or anything...!
  93.  
  94.  
  95. Changes
  96. ———————
  97.  
  98. 1.02 (17/01/96):
  99.     Slight speed improvements; memory allocation bug fix.
  100.  
  101. 1.03 (05/02/96):
  102.     Added new-format sprite support. Also options for output type when
  103.     converting 8 or 24 bpp images from BMP - to sprite or Clear.
  104.  
  105.  
  106. Contact
  107. ———————
  108.  
  109.     arcsalt@spuddy.mew.co.uk
  110.     darren.salt@unn.ac.uk (until July 1996)
  111.