home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / graphics / spritefix / !SpriteFix / !Help < prev    next >
Encoding:
Text File  |  1993-10-29  |  7.8 KB  |  197 lines
  1.  
  2.                                  SpriteFix
  3.                                 ===========
  4.  
  5. Introduction
  6. ------------
  7.  
  8. Many screen modes for the Archimedes are available as third-party modules,
  9. in addition to those provided as standard in ROM.  If a sprite in a sprite
  10. or drawing file has been created in a screen mode which is not available on
  11. the system trying to display it, various undesirable effects can occur and
  12. the result will not generally be what was intended.
  13.  
  14. For sprites to be portable between different systems, they should ideally be
  15. in a screen mode which is always available (i.e. one of the standard
  16. RiscOS 2 modes).  However, sprites are often created by grabbing them from
  17. the screen, which means that they take on the screen mode that was in use at
  18. the time.  If this is an unusual mode, then if you pass the sprite on to
  19. anyone who does not have that screen mode available then the sprite cannot
  20. be displayed.
  21.  
  22. SpriteFix fixes this problem by automatically changing the screen mode
  23. stored with a sprite into a mode that is available on all systems.  By
  24. selecting a mode which is compatible with the original, the size and
  25. appearance of the sprite does not change.
  26.  
  27.  
  28. Running the application
  29. -----------------------
  30.  
  31. Run SpriteFix in the usual way by double-clicking on its icon.  It will
  32. appear on the icon bar.
  33.  
  34. To convert a file, drag it to the icon bar icon.  It will be scanned for
  35. sprites, and any which have a mode conversion defined will be substituted
  36. with a new screen mode.  When this is complete, a window with a standard
  37. save box will pop up, allowing the new file to be saved.
  38.  
  39. The following types of files can be loaded and converted:
  40.  
  41.   •     Standard Draw or sprite files
  42.   •     Draw files saved from DrawPlus
  43.   •     Vector files, saved from that application
  44.   •     Library files saved from DrawPlus or Vector
  45.   •     Compressed Draw files, saved from Chameleon II or some other 4Mation
  46.         applications
  47.   •     Poster files, saved from that application.
  48.  
  49. The file is always saved back in the same format as it was loaded in.
  50.  
  51. The following types of files cannot be loaded or converted:
  52.  
  53.   •     Impression documents.  Don't blame me, or contact me suggesting that
  54.         I should include support for this format, as it would be a lot of
  55.         hard work and I don't fancy doing all that simply because Computer
  56.         Concepts' programmers were too lazy to put the document in a single
  57.         file like every other decent application...
  58.  
  59.  
  60. Setting up conversions
  61. ----------------------
  62.  
  63. By choosing the "Setup" option from the icon bar menu, a window will open
  64. showing all of the mode conversions currently defined.  This information is
  65. saved within the application directory, and is loaded when SpriteFix starts
  66. up.
  67.  
  68. Each line in this window lists the original screen mode, the bits-per-pixel
  69. and scaling factors for that mode, and the mode that it will be translated
  70. to (which should have the same bits-per-pixel and scaling factors).  This is
  71. the only information that is necessary to identify a suitable new mode
  72. (other mode parameters, such as screen size and VIDC setup, are not relevant
  73. to sprites).
  74.  
  75. Entries in the list can be selected by clicking Select or Adjust on them, in
  76. the standard RiscOS way.  The menu operations will act on the selected
  77. entries.
  78.  
  79. To add a new mode is easy if it is available on the system.  Simply pop up
  80. the menu and enter the mode number in the "New entry" entry box.  The mode
  81. and its parameters will be added to the list, and a suitable standard mode
  82. translation added in the last column (this will be blank if no standard mode
  83. is suitable).
  84.  
  85. If the new mode is not available on your system, then you will have to find
  86. out its parameters in some other way.  When you have these available, then
  87. create the mode as before and then set the bits-per-pixel and scaling
  88. factors using the menu options (described later).  When the parameters have
  89. been set, a mode translation will be added as before.
  90.  
  91.  
  92. Setup menu
  93. ----------
  94.  
  95. The following options appear on the Setup window menu:
  96.  
  97. Mode or Selection
  98.  
  99.    This item depends on how many entries are selected in the window.  If
  100.    none are selected it will read "Mode ''" and be shaded.  If one entry is
  101.    selected it will read "Mode 'number'" and the submenu can be used.  If
  102.    more than one entry is selected it will read "Selection" and only some of
  103.    the submenu options can be used.
  104.  
  105.    Bits per pixel
  106.  
  107.       This sets the number of bits-per-pixel for the selected mode, which in
  108.       turn determines how many colours can be displayed.  The standard four
  109.       options are available.
  110.  
  111.    Pixel scaling
  112.  
  113.       This sets the pixel scaling factor for the selected mode, which
  114.       determines how the true size of a sprite is calculated.  There are two
  115.       numbers, one for horizontal and one for vertical scaling, which are
  116.       the numbers of OS units per sprite pixel.  The three most common
  117.       settings (2x2, e.g. multisync modes such as 20;  2x4, e.g. normal "TV"
  118.       modes such as 12;  and 4x4, e.g. "coarse" modes such as 1) are
  119.       available on this menu;  unusual settings can be entered in the box
  120.       leading off the "Specify" option.
  121.  
  122.    Like mode
  123.  
  124.       This sets the mode that the old, unknown mode will be translated to. 
  125.       Normally, it will not be necessary to enter this explicitly, as it
  126.       will be determined automatically from the bits-per-pixel and scaling
  127.       factors.
  128.  
  129.    Delete
  130.  
  131.       Deletes the selected entries from the setup list.
  132.  
  133. Select all
  134.  
  135.    Selects all of the entries in the setup list.
  136.  
  137. Clear select
  138.  
  139.    Clears the current selection.
  140.  
  141. New entry
  142.  
  143.    Creates a new entry.  Enter the mode number in the entry box leading off
  144.    this option.
  145.  
  146. Auto entry
  147.  
  148.    Automatically add entries for all of the screen mode currently available
  149.    on the system.  An entry will be added for each mode available which does
  150.    not already have an entry, and which does not translate to itself.
  151.  
  152. Save setup
  153.  
  154.    Save the setup list within the application directory;  it will be loaded
  155.    again when the application is next run.
  156.  
  157.  
  158. The boring bits
  159. ---------------
  160.  
  161. SpriteFix copyright © Jonathan Marten 1993.  Certain parts of the code,
  162. namely the compressed file loading/saving routines, were written by
  163. Paul LeBeau and are copyright © 4Mation 1992-1993.
  164.  
  165. The application and documentation is "FreeWare" (not PD).  It may be copied
  166. and freely distributed by anyone, on any medium (including bulletin boards
  167. and PD libraries), as long as no files within the application directory are
  168. altered (except for adding details of new screen modes to the setup data). 
  169. It may not be sold commercially, either alone or as part of another package
  170. or application, without permission from the author.  It may be used by any
  171. person for its intended purpose, or for any other purpose that it may turn
  172. out to be useful for.
  173.  
  174. Bulletin boards, PD libraries and magazines are requested to contact the
  175. author before distributing the application, to ensure that they have the
  176. latest version.
  177.  
  178. SpriteFix runs under RiscOS 3 only.  It was developed, and has been tested,
  179. under RiscOS 3·10;  it is believed that it will work under other versions.
  180.  
  181. The application is supplied in good faith, but with no guarantee.  Neither
  182. the author, nor any provider or distributor of the software, can be held
  183. responsible for any damage, loss of data, damage to files, wasted time or
  184. any other adverse effects caused by using the software, or its failure to
  185. perform as expected.
  186.  
  187.  
  188. Please report any praise, bugs, shortcomings or useful suggestions to me:
  189.  
  190. Jonathan Marten                Post:         11 Carmarthen Close
  191.                                              Farnborough
  192.                                              Hampshire
  193.                                              GU14 8TJ
  194.  
  195. Version 1·00                   E-mail:       jmarten@cix.compulink.co.uk
  196. August 1993                    Arcade:       081-654-2212 user 387
  197.