home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / m / makepcx / ReadMe < prev   
Encoding:
Text File  |  1991-12-08  |  2.3 KB  |  69 lines
  1. RISC-OS Sprite -> PCX file conversion utility
  2. ---------------------------------------------
  3.  
  4. By: Daniel Pead  (contact TEXDP@uk.ac.nottingham.ccc.vax)
  5.  
  6. This accepts 2,4,16 colour RISC-OS sprites and outputs 16 or 256 colour 
  7. PCX images with run-length compression.
  8.  
  9. 16 colour PCX files include either the palette taken from the sprite,
  10. the appropriate 2,4 or 16 colour Desktop palette or a 2,4 or 8 colour
  11. BBC micro palette (for TTL RGB monitors).
  12.  
  13. All 256 colour PCX files produced contain the Archimedes' fixed 256 colour
  14. palette, regardless of any palette data in the original sprite.
  15.  
  16. Note
  17. ----
  18.  
  19. The popular !Translatr application can't cope with small PCX images (e.g.
  20. converted RISC-OS icons).  I think this is a problem with !Translatr.
  21.  
  22. Versions
  23. --------
  24.  
  25. There are 2 versions of the utility: !MakePCX is a WIMP application,
  26. while makepcx is invoked from the command line.
  27.  
  28. See the help file for !MakePCX for instructions for the desktop
  29. version.
  30.  
  31. The syntax for the command line version is:
  32.  
  33.    makepcx [-s <name | n | *> ]  [-p <palette> | -d <palette> ]
  34.            [-o <path|name>]
  35.            <spritefile>
  36.  
  37.        -s <name>       : Process only sprite called <name> from file
  38.        -s <n>          : Process only <n>th sprite from file (default 1)
  39.        -s *            : Process all sprites in file
  40.        -d <palette>    : Set default palette, where palette is:
  41.                            1           : BBC TTL rgb
  42.                            2           : RISC_OS Desktop (default)
  43.                            <file>      : Read from palette file
  44.                          Only affects sprites without a palette.
  45.        -p <palette>    : Set palette for all sprites.
  46.        -o <path>       : Set output file for single sprite conversions
  47.                          or output path for multiple sprites.  
  48.        <spritefile>    : Source sprite file
  49.  
  50.  
  51. Copying
  52. -------
  53.  
  54. This software may be freely copied.
  55.  
  56. The CLI version incorporates GNU getopt from the Free Software Foundation,
  57. so the standard GNU conditions apply.
  58.  
  59. No Warranty
  60. ===========
  61.  
  62. This software is supplied (free of charge) in the hope that it may prove 
  63. useful.  The author cannot accept liability for any loss or damage 
  64. caused by this software.
  65.  
  66. So if it crashes, blows up, starts World War III or locks you out of your
  67. spaceship, don't call me.
  68.  
  69.