home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / colour / modewindow_1 / !ReadMe next >
Text File  |  1995-11-22  |  13KB  |  257 lines
  1.                         Mode Window Version 2.20             
  2.                   © Edward Cane & ArmPit Software 1994 
  3.                     
  4. About Mode Window :
  5. -------------------
  6.  Mode Window is designed to provide users of Risc Os 3.1 with a more
  7. attractive method of screen mode selection in a similar style to the Display
  8. Manager supplied in Risc Os 3.5. It is not designed to be identical to the
  9. Display Manager as I've only used a Risc Pc for a few hours. Future PD 
  10. releases of Mode Window will include more advanced options.      
  11.  If Acorn release a version of Risc Os 3.5 for older Arc's, it will eliminate
  12. the need for Mode Window, but until then it will be very useful. 
  13.  
  14. Loading Mode Window:
  15. --------------------
  16.  The simplest way to load Mode Window is to double-click on it from the 
  17. desktop, although you may want to put it into your !Boot sequence:
  18. If you use an Obey file, before the desktop is entered, put in the command:
  19.  *RMLoad System:Modules.ModeWindow  
  20. If you use a Desktop boot file, put in the command: 
  21.  *RMRun System:Modules.ModeWindow 
  22. When the desktop is entered, the palette icon should have been replaced by
  23. the monitor icon.
  24.  
  25. Requirements:
  26. -------------
  27.  This software is intended to be used on a Risc Os 3.1 Archimedes using the
  28. standard VIDC10 without any extra colour graphics enhancers. It will not run
  29. under Risc Os 2. Mode Window does not currently support screen modes which 
  30. have greater than 256 colours, so it will only do half of it's task when used
  31. with graphics enhancer boards. This doesn't really matter because all of 
  32. these cards provide their own advanced mode selection software. 
  33.  Mode Window will not work on Risc OS 3.5 because the Palette Utility does
  34. not exist, but there is no need for Mode Window anyway.
  35.  
  36. -----------------------------------------------------------------------------
  37.  
  38. Using Mode Window :
  39. -------------------
  40.  The Mode Window module patches into the Palette utility, so that when the
  41. palette icon is selected with the left mouse button, the mode window opens. 
  42. Using the right hand mouse button will open the original palette window. Mode
  43. Window will not function if the Palette Utility is not active.
  44.  
  45. Current Directory Changer :
  46. ---------------------------
  47.  To tidy up my !Boot sequence a bit, I've included a Current Directory
  48. changer in the Mode Window module. To use this, drag a file, from the filer
  49. window for the desired directory, onto the palette/monitor icon. If the file
  50. is a palette file, the directory will change and the file will be loaded.
  51.  
  52. The mode window :
  53. -----------------
  54.  When this window is initially opened, it displays details of the current
  55. screen mode. 
  56.  Clicking on the menu buttons to the right of these icons, opens pull down
  57. menus for colours and resolutions. Selecting one of these menu items will
  58. place it into the relevant icon. 
  59.  When you first use Mode Window, the resolution menu, may contain some
  60. unfamiliar resolutions. This is because the module has been configured for
  61. use on a different monitor type. To solve this problem, read the section
  62. below on 'The Default Icon'. 
  63.  When you have chosen the number of colours and resolution, clicking on the
  64. Change icon will change to the desired screen mode. When the Change icon is
  65. selected using the right hand mouse button, the window will remain open after
  66. the mode change. 
  67.  If for any reason, it is not possible to change screen mode, for example
  68. there is no such mode available, Mode Window will make a beep, and the window
  69. will remain open. 
  70.  The Cancel icon will close the window, if you decide not to change screen
  71. mode. If you select items from the pull down menus and then want to 
  72. re-display the details of the current screen mode, select the Cancel icon
  73. using the right hand mouse button. 
  74.  By pressing the middle mouse button, the Mode Window menu will be opened.
  75. This contains, the usual Info and Quit options and Edit which enables you to
  76. alter Mode Window to your own preferences.
  77.  
  78. 16 grey scale screen modes :
  79. ----------------------------
  80.  To increase the number of options in the colours menu, I've added a 16 greys
  81. facility. Risc Os 3.1 does not actually provide 16 grey scale modes, this
  82. works by using a 16 colour mode and programming the palette. When you are
  83. using a 16 greys mode, Mode Window patches the Palette menu so that selecting
  84. default doesn't reload the colour palette.
  85.  Unfortunately, it is hard for Mode Window to keep track of whether it is in
  86. 16 greys or 16 colours mode if the user is loading palette files etc., but
  87. this doesn't occur very often.
  88.  
  89. -----------------------------------------------------------------------------
  90.  
  91. The Setup window :
  92. ------------------
  93.  This window is opened by selecting the Edit option from the Mode Window
  94. menu.  
  95.  Selecting the Apply icon at the bottom of the window will update Mode
  96. Window and close the Setup window. If the right hand mouse button is used on
  97. the Apply icon, the window will be left open.
  98.  When the Cancel icon is selected, the previous choices will be re-displayed
  99. and the Setup window will be closed, unless the right hand mouse button is
  100. used.
  101.  
  102. ---------------------------------- 
  103. | The Resolution definitions box |
  104. ----------------------------------
  105.  Currently, Mode Window requires the resolution menu to be designed manually
  106. using the facilities in the Setup window. In some ways this is good because
  107. if you have previously used the Palette utility to change screen mode, this
  108. will help you to associate resolutions with mode numbers. Future releases of
  109. Mode Window will automatically calculate the modes available on each hardware
  110. combination.
  111.  
  112. The Resolution List :
  113. ---------------------
  114.  The scrollable pane window in the left of the resolution definition box
  115. contains a list of all the resolutions which appear in the resolution menu.
  116. Selecting a resolution will highlight it and display it's mode numbers in the
  117. resolution editor. It is not intended for you to include every mode available
  118. to you in the resolution menu, only the frequently used ones.
  119.  A full list of screen modes can be found on page 221 of the Risc Os 3 user
  120. guide or volume 4 appendix 95 of the Risc Os 3 programmer's reference 
  121. manuals. There is also a small BASIC program, ResList, hopefully supplied 
  122. with this module, which creates a text file containing a table of all your 
  123. modes available. You should use this to select which modes you want to 
  124. include in the resolution menu definition.
  125.  
  126. The Default icon :
  127. ------------------
  128.  When you select this icon, a default set of resolution definitions will be
  129. loaded in corresponding to your configured monitor type. Mode Window supports
  130. all the monitor types known to Risc Os 3.1. For most users, these resolutions
  131. will be adequate, but if you are loading custom mode modules to provide
  132. non-standard resolution modes, you may want to use the resolution editor to
  133. add these to the list.
  134.  
  135. The Resolution Editor :
  136. -----------------------
  137.  The resolution editor enables you to add/modify resolutions in the default
  138. resolution lists or to design your own. When a resolution is selected from
  139. the resolution list window, the four screen modes used for this resolution
  140. are displayed in the four writable icons at the right of the window. A
  141. blank icon indicates that there is not a definition for this combination of
  142. colours and resolution. These mode numbers can be edited by typing in the
  143. desired screen mode number and pressing return. After the number is entered,
  144. Mode Window will check that this mode has the appropriate number of colours
  145. and is the same resolution as others in it's definition. 
  146.  
  147. The Insert icon :
  148. -----------------
  149.  When you select this icon, a new undefined resolution will be inserted AFTER
  150. the currently highlighted resolution. It will be displayed as 'Undefined' in
  151. the resolution list until a valid screen mode number is entered, after which
  152. the resolution will be calculated and displayed. You cannot have more than
  153. one menu item for each resolution, ie. you cannot have two 768 x 288
  154. resolutions. There is a maximum limit of 15 resolutions. 
  155.  
  156. The Delete icon :
  157. ----------------- 
  158.  When this icon is selected, the highlighted resolution definition will be
  159. deleted. If this resolution is followed by a dotted line, then records of
  160. this will also be deleted. There must be a minimum of one resolution. 
  161.  
  162. The Dotted Line icon :
  163. ----------------------
  164.  Items in the resolution menu can be followed by a dotted line. The reason
  165. for this is to separate resolutions which have different eigen factors such
  166. as low, medium and high res modes. This icon is highlighted if the currently
  167. selected resolution is followed by a dotted line. Selecting this icon toggles
  168. it's status. You can only have a maximum of three dotted lines in the
  169. resolution menu, and this cannot include the last item.
  170.  
  171. Any changes made in the resolution definitions box, will not be taken into
  172. account until either the Apply or Save icons are selected.
  173.  
  174. --------------------------------------- 
  175. | The remaining configuration options |
  176. --------------------------------------- 
  177.  
  178. Window title :
  179. --------------
  180.  By altering the text in this icon, the window title of the mode window can
  181. be changed. It is usual to set this to the name of your monitor.
  182.  
  183. Low & High resolution files :
  184. -----------------------------
  185.  If you have a high resolution monitor, and are loading in the high
  186. resolution icons in your !Boot sequence, you may find it irritating that when
  187. you change into a low resolution screen mode, the icons cannot be displayed
  188. correctly. To solve this problem, the Mode Window module will automatically
  189. load different icon sets when you change between high and low resolution
  190. modes. 
  191.  To set this up, simply drag the two sprite files onto these icons in the
  192. Setup window. These files do not have to be sprite files, if they are they
  193. are *Iconsprited, otherwise they will be executed in an equivalent way to
  194. selecting them from the desktop. This is useful because you can build an obey
  195. file containing several *IconSprite commands if your icon sets are spread in
  196. several different sprite files, like the !NewLook icons are. Another useful
  197. application of this facility is when using a desktop font patch module, Mode
  198. Window can execute the program to alter the font handle when changing
  199. resolution. 
  200.  If the files cannot be found/accessed when a resolution change occurs, an
  201. error message will not usually be generated unless a disc name is specified.
  202. The reason for this is to make the module more portable between different
  203. peoples hard discs.
  204.  
  205. Font name :
  206. -----------
  207.  The font which is used throughout Mode Window's windows can be altered by
  208. selecting a font name from this pull down menu.
  209.  If you are using a desktop patch module which forces the use of anti-aliased
  210. text throughout the desktop, in particular the Erwin Gerrits/BAU module, I
  211. strongly advise that you use Mode Window configured to System font and let
  212. the patch module handle anti-aliased text throughout because whilst 
  213. developing this module, it caused a few crashes otherwise.
  214.  
  215. The Save icon:
  216. --------------
  217.  The Mode Window utility is very tidy consisting of only one module. When the
  218. user wants to save his/her configuration settings, the module is recreated
  219. including these settings. It is safe to save the new module over the original
  220. version.
  221.  When the Save icon is selected, a standard save window is opened. If the
  222. Save icon is selected using the right hand mouse button, the Setup window is
  223. left open, otherwise it is closed. The Save icon also causes the settings to
  224. be applied. 
  225.  When Mode Window is stored in a fixed place on a hard disc, and loaded in
  226. the !Boot file, it will remember it's filename after it has been saved once.
  227. This means that for subsequent saves after the computer is re-booted, the
  228. writable icon will already contain the modules filename and to save it, it is
  229. only necessary to click on the OK icon.
  230.  
  231.   
  232. -----------------------------------------------------------------------------
  233.  
  234. Licence :          © Edward Cane, ArmPit Software 1994.
  235. ---------
  236.  
  237.  This version of Mode Window has been released as Shareware. If you want to 
  238. become a registered user and recieve future updates to the software, send £5
  239. to the address below. Mode Window may be distributed freely as PD.
  240.  
  241. Contact :       
  242. ---------   
  243.  If you have any suggestions for Mode Window, or find any bugs, please 
  244. contact me at the address below. ArmPit have also written several PD
  245. utilities and demos which we can supply you with if you send a disc,
  246. preferably with some Pd on it.
  247.     
  248.                 Edward Cane
  249.                  92 Wychwood Avenue
  250.                   Knowle
  251.                    Solihull
  252.                     West Midlands
  253.                      B93 9DQ    
  254.  
  255.                 Tel. (0564) 776092
  256.           email canee@cs.man.ac.uk
  257.