home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilst / winicon / !WinIcon / !Help next >
Text File  |  1994-03-26  |  6KB  |  138 lines
  1.  
  2.                              Help file for WinIcon
  3.                             =======================
  4.  
  5.                            Version 1·00   © JJM 1994
  6.  
  7.  
  8. WinIcon is a conversion tool which allows you to convert icon files intended
  9. for Microsoft Windows 3 into Acorn sprite format.  Icons in Windows format
  10. are available from many PC sources:  some of them are very well-designed and
  11. convert well to sprites.  See the notes later regarding sources and
  12. copyright.
  13.  
  14.  
  15. Using the application
  16. ---------------------
  17.  
  18. WinIcon accepts icon files in standard format, which normally contain a
  19. 16-colour 32x32 pixel image with a mask.  This is converted to a Mode 20
  20. sprite, to take advantage of the higher resolution available.  The results
  21. can be converted to another format using any sprite manipulation tool, if
  22. required.
  23.  
  24. Run WinIcon in the normal way:  an icon will appear on the icon bar.  Icon
  25. files normally have a .ICO extension, which will appear as “/ICO” if the PC
  26. disc is viewed by ADFS.  Drag the icon files to be converted to the WinIcon
  27. icon on the icon bar:  they will be converted, and a window will open
  28. showing the current set of icons.  Further icon files can be dragged to the
  29. icon bar, or into this window, at any time;  they will be added to the set.
  30.  
  31. To save the sprites, use the “Save” option on the icon window menu.  All of
  32. the icons will be saved as a sprite file which can be loaded into Paint or
  33. any other application.
  34.  
  35. The “File” menu option displays a box showing information about the sprite
  36. file.  The “Clear” option removes all of the stored sprites from memory.
  37.  
  38.  
  39. Conversion options
  40. ------------------
  41.  
  42. Two settings are available on the “Options” menu.  If “Include mask” is
  43. ticked, the sprite will be created with a mask.  All Windows icon files
  44. appear to include mask information, although this may cover the full area if
  45. the icon was intended to be square.
  46.  
  47. If “Windows palette” is ticked, the standard Windows palette data will be
  48. included with the sprite.  When it is displayed, its colours will be the
  49. best approximation possible to those intended.  To see these true colours,
  50. it will be necessary to select a 256-colour (or better) desktop mode, or
  51. load the WinIcon palette.
  52.  
  53. Both of these options are set to ‘on’ by default.
  54.  
  55.  
  56. Sources and other possibilities
  57. -------------------------------
  58.  
  59. Icon files are available from many sources, over and above the standard set
  60. which are included in any Windows installation.  Many PC bulletin boards and
  61. magazine discs have a vast selection of icon files, some of which are PD or
  62. freely distributable.  You may be free to convert these files and use them
  63. in any other application, or simply as inspiration.
  64.  
  65. Windows applications such as “IconMaster” (available from PC PD libraries)
  66. are available for creating, editing and managing large collections of icons. 
  67. These can be used to extract icons from applications and executable files,
  68. such as the Program Manager or the extended collection (MORICONS.DLL).
  69.  
  70. The only icon file format currently supported is the standard 16-colour,
  71. 32x32 pixel, EGA/VGA resolution.  A file which is not exactly 766 bytes in
  72. size, therefore which probably contains multiple icons or uses another
  73. resolution/depth, will be rejected.  Sorry about this limitation, but I
  74. don't have any information about the format of .ICO files and had to work
  75. out the details by trial and error.
  76.  
  77. Since the desktop palettes of Windows and RiscOS do not match, the colours
  78. will not turn out as intended in a 16-colour mode or when used as Wimp
  79. icons (notably, there are only 3 grey levels — including black and white! —
  80. and more primary colours are available).  A RiscOS palette file which
  81. approximates the standard Windows palette is supplied within the !WinIcon
  82. application;  this can be loaded if you wish to view the icons as they were
  83. intended.
  84.  
  85.  
  86. Copyright and Disclaimer
  87. ------------------------
  88.  
  89. The WinIcon application is copyright © myself (Jonathan Marten) 1994.
  90.  
  91. The application and documentation is “FreeWare” (not PD).  It may be copied
  92. and freely distributed by anyone, on any medium (including bulletin boards
  93. and PD libraries), as long as no files within the application directory are
  94. altered.  It may not be sold commercially, either alone or as part of
  95. another package or application, without permission from the author.  It may
  96. be used by any person for its intended purpose, or for any other purpose
  97. that it may turn out to be useful for.
  98.  
  99. Bulletin boards, PD libraries and magazines are requested to contact the
  100. author before distributing the application, to ensure that they have the
  101. latest version.
  102.  
  103. WinIcon runs under RiscOS 3 only.  It was developed, and has been tested,
  104. under RiscOS 3·10;  it is believed that it will work under other versions.
  105.  
  106. The application is supplied in good faith, but with no guarantee.  Neither
  107. the author, nor any provider or distributor of the software, can be held
  108. responsible for any damage, loss of data, damage to files, wasted time or
  109. any other adverse effects caused by using the software, or its failure to
  110. perform as expected.  In addition, no responsibility is accepted for the
  111. liability or consequences of any breach of copyright which may result from
  112. the use of this application.  Any user of the application is entirely
  113. responsible for ensuring that the conversion, storage or subsequent use of
  114. any files or images does not infringe any copyright or other claim of their
  115. originator or copyright holder.
  116.  
  117. The “IconMaster” application mentioned above is shareware.  If you use this,
  118. or any other shareware program (on whatever machine), you should register in
  119. accordance with its terms and conditions.
  120.  
  121. The sample icon files supplied in the ‘Examples’ directory were supplied by
  122. PC Magazine.  They are Public Domain, and may be copied and freely
  123. distributed.
  124.  
  125.  
  126.  
  127. Please report any praise, bugs, shortcomings or useful suggestions to me:
  128.  
  129. Jonathan Marten                Post:         11 Carmarthen Close
  130.                                              Farnborough
  131.                                              Hampshire
  132.                                              GU14 8TJ
  133.  
  134. Version 1·00                   E-mail:       jmarten@cix.compulink.co.uk
  135. March 1994                     Arcade:       081-654-2212 user 387
  136.  
  137.  
  138.