home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilst / to24bpp / !To24bpp / !Help next >
Text File  |  1995-02-07  |  8KB  |  182 lines
  1. Help file for To24bpp
  2. ——————————————————————
  3.  
  4. This application is copyright Liam Gretton.
  5.  
  6. This is a simple utility with a cumbersome name for users who
  7. don't have RISC OS 3.5. It requires ChangeFSI 0.95 or greater.
  8. Acorn's Help application is supported.
  9.  
  10. It may run on Risc OS 2 machines... but this hasn't been tested.
  11.  
  12. If you are running this on a Risc PC, then why? Also, if you have
  13. Computer Concepts' graphics filters (currently available for
  14. TIFF, JPEG, PhotoCD and Clear files), then you don't need this
  15. program for those file formats.
  16.  
  17. To24bpp is primarily for users of ArtWorks or Impression Style
  18. or Publisher who wish to convert a 24 bit foreign file format to
  19. one of the new 16 or 24 bit sprite formats. ChangeFSI 0.95 can
  20. do this, but because RISC OS 3.1 doesn't support them,
  21. ChangeFSI falls over if you try to do the conversion in the
  22. desktop. From the command line, though, ChangeFSI will
  23. successfully output a 24 bit sprite, but it's a pain in the neck.
  24. To24bpp is therefore a simple desktop front-end for this
  25. particular feature of ChangeFSI.
  26.  
  27. To use the program, double-click on the !To24bpp icon, and it
  28. will install itself on the iconbar. You must ensure that the
  29. filer has 'seen' ChangeFSI beforehand. The program is controlled
  30. through its menu which looks like this...
  31.  
  32.  +----------+
  33.  | Info     |   Leads to a standard info box.
  34.  |          |
  35.  | Image  > |   Leads to a dialogue box giving some information
  36.  |          |   about the file.
  37.  | Save   > |   Leads to a save box.
  38.  |          |
  39.  | Quit     |   Quits the application.
  40.  +----------+
  41.  
  42. The Image and Save items are greyed out until a file has been
  43. dropped. The save box has four icons allowing you to select
  44. from a 256 grey-level sprite, or a new format 16- or 24-bit
  45. sprite. If you have dropped GIF file onto To24bpp, there is an
  46. option to save a 256 colour sprite which has the same palette as
  47. the original. This obviously uses half the space of a 16-bit
  48. sprite, but with no loss of colour information. This conversion
  49. is not done by ChangeFSI, but by the 'gif2spr' utility, written
  50. by Simon Truss (further thanks to Simon for sending me the
  51. latest version of gif2spr). The file g2sHelp in the To24bpp's
  52. Resources directory gives more information about gif2spr.
  53.  
  54. Dragging the sprite icon to a directory display or another
  55. application starts the conversion and saves the sprite. Filling
  56. in the writable field and clicking on the 'save' button also
  57. starts the process. Clicking on the 'cancel' button closes the
  58. menu and resets To24bpp to its virgin state.
  59.  
  60. For simplicity, none of the more advanced features of ChangeFSI
  61. are supported. However, once you've got your image into ArtWorks
  62. or Impression, you can flip it, rotate it and rescale it to your
  63. heart's content.
  64.  
  65. Only some filetypes are rejected by To24bpp, as ChangeFSI
  66. examines the contents of files if it doesn't recognise them
  67. immediately.
  68.  
  69. Sometimes if you try to save the sprite to an application, the
  70. conversion is carried out ok, but there's not enough memory for
  71. the app to load the sprite afterwards (this is most likely with
  72. JPEGs). You may find your converted sprite in Wimp$Scrap from
  73. where it can be recovered.
  74.  
  75. Not all errors reported are from To24bpp. Any errors from
  76. ChangeFSI are also reported (they're usually due to lack of
  77. memory). gif2spr's output is suppressed, so it will not report
  78. any errors. If it has any problems, you will find that your
  79. sprite is not saved. This does not cause To24bpp to crash
  80. however.
  81.  
  82. Advanced options...
  83. You can alter the !Run file to tweak the program's operation.
  84. There are two variables used by ChangeFSI itself and one used by
  85. To24bpp. These are:
  86.  
  87. ChangeFSI$Cache      Used when converting JPEGs. If this is
  88.                      larger than the JPEG file size, conversion
  89.                      is considerably faster. The default is 128k.
  90.                      In practice, I have found that this must be
  91.                      set to a value large enough to accomodate
  92.                      the file, as ChangeFSI doesn't seem to be
  93.                      able to start up the djpeg routines from
  94.                      within To24bpp.
  95.  
  96. ChangeFSI$PCDIndex   Indicates which PhotoCD file is to be
  97.                      converted from the five versions available.
  98.                      Valid values range from 1 to 5. The default
  99.                      is 3 (base). I haven't been able to test
  100.                      PhotoCD conversion, and it may well fall
  101.                      over unless you have the support module
  102.                      which comes with Acorn's PhotoView.
  103.  
  104. ChangeFSI$Max        The maximum size of the output sprite held
  105.                      in memory before being output to disc. This
  106.                      is useful when very large files are to be
  107.                      converted. The default is 512k.
  108.  
  109. These variables can be changed at any time. For example, if you
  110. find that you don't have enough memory to convert a file, enter
  111. 'Set ChangeFSI$Max 100k' (or similar) at the command line and try
  112. saving again.
  113.  
  114. For more information on ChangeFSI$Cache and ChangeFSI$PCDIndex,
  115. refer to the file 'FSIinfo' in the ChangeFSI directory.
  116. ChangeFSI$Max allows To24bpp to use ChangeFSI's 'max' command.
  117. More details about this are also in the FSIinfo file.
  118.  
  119.  
  120.  
  121. Thanks are due to Jon Ribbens of DoggySoft for his excellent
  122. WimpExt module, Alex Petrov of Moscow for his MenuUtils module
  123. and Simon Truss for his gif2spr utility.  The templates were
  124. created using Dick Alstein’s TemplEd. Oh yeah, and thanks to
  125. whomever wrote ChangeFSI, too.
  126.  
  127. If you find this at all useful, or if you find any bugs, or have
  128. any suggestions for improvement, please let me know!
  129.  
  130. Liam Gretton
  131. ljg2@leicester.ac.uk
  132.  
  133. 62 Berners Street      ...or...   18 Lyndhurst Avenue
  134. Leicester LE2 0AF                 River
  135. (until July 1995)                 Dover
  136.                                   Kent CT17 0LY
  137.  
  138. NOW FOR THE MUNDANE LEGAL BIT
  139. —————————————————————————————
  140.  
  141. To24bpp is FREEWARE and I retain the copyright. It may be freely
  142. copied and distributed provided that all the original files are
  143. left intact. If you think it needs improving, don't distribute
  144. versions with your own adjustments - mail me and I'll fix the
  145. problem. PD libraries may distribute To24bpp for a nominal (ie
  146. minimal) fee to cover costs. I'm fed up with certain magazines
  147. and user groups selling 800k discs full of FREE software for
  148. £2.00 or more. I take no responsibility for any loss of data,
  149. life or sanity as a result of using To24bpp. If To24bpp trashes
  150. your hard disc and blows up your monitor... well, I apologise,
  151. but don't say I didn't warn you.
  152.  
  153. The MenuUtils module is © Alex Petrov:
  154.                                Flat 107, Building 1
  155.                                29 Kavkazsky Boulevard
  156.                                Moscow
  157.                                115541
  158.                                RUSSIA
  159.                                
  160.                                APetrov@misis.msk.su
  161.                                APetrov@arm.msk.su
  162.  
  163. The WimpExt module is © Jon Ribbens of DoggySoft:
  164.                                DoggySoft
  165.                                Furzefield House
  166.                                Furzefield Road
  167.                                Beaconsfield
  168.                                Bucks.
  169.                                HP9 1PQ
  170.                                
  171.                                wxii@doggysft.demon.co.uk
  172.  
  173. The gif2spr utility is © Simon Truss:
  174.                                11 Fairfield Crescent
  175.                                Fairfield
  176.                                Liverpool L6 8PH
  177.  
  178.                                simon@bigblue.demon.co.uk
  179.                                ulsmt@csc.liv.ac.uk
  180.  
  181. The MsgTrans module is presumably © Acorn, and if I shouldn't be
  182. distributing it with this, sorry.