home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / colour / modesel_1 / !ModeSel / !Help < prev    next >
Text File  |  1994-06-20  |  7KB  |  168 lines
  1. !ModeSel   v2.00 
  2. ———————— 
  3. ©A Campbell 1994.
  4.  
  5. DESCRIPTION.
  6. ————————————
  7.  
  8. !ModeSel provides a more versatile way of selecting screen modes from
  9. the RISC OS Desktop.  !ModeSel gets all the modes that are suitable for 
  10. the type monitor your machine is set up for, it then groups the modes by 
  11. the number of colours they support, allowing only modes supporting a given 
  12. number of colours to be shown.  !ModeSel displays the modes in a window by 
  13. the number of supported colours, giving the text and graphics resolution of 
  14. the modes and their size. Clicking on the mode will change the desktop to 
  15. that screen mode.
  16.  
  17. Modes can also be selected using a RiscOs 3.5 style mode selector.
  18.  
  19. HOW TO USE IT.
  20. ——————————————
  21.  
  22. When the application is first run it gets all the information on the
  23. available modes.  This is done in the background, so the application
  24. can be put in your !boot file, and not halt the machine for ~15s while 
  25. it gets the info.  The !Modesel icon is a monitor, with the current mode 
  26. number displayed in it.  This mode number is updated whenever you change mode.
  27. The screen of the monitor is blue of you are in rectangular pixel mode, and
  28. green in square pixel modes.
  29.  
  30. Clicking select on the icon brings up a window showing details of modes available 
  31. grouped by the number of colours they support (if mode information is still 
  32. being read then an hourglass is displayed until it is finished).  The details 
  33. shown are, the mode number, dimensions in pixels, and the amount of memory 
  34. required for the mode.  Moving the pointer over the window  highlights a line 
  35. containing mode details.  Clicking on the line  will change the desktop to the 
  36. highlighted mode.  If Select was used the window will be closed, if Adjust
  37. was used the window will remain open.
  38.  
  39. The mode currently selected is shown in red (16 and 256 colour
  40. modes).  Modes that have square pixels, and therefore use the higher
  41. resolution sprite are shown in green.
  42.  
  43. If the ModeSel Icon is clicked on with Adjust button a RISC OS 3.5 mode
  44. selector is given.  This not give as much information as the above mode
  45. selection window but may be preferred.  There are two menus a colour menu
  46. (top menu icon) and a resolution menu (bottom menu icon).  By selecting
  47. the correct colour/resolution combination then clicking on the change 
  48. icon a new mode can be selected.
  49.  
  50. The resolution menu only shows the pixel resolutions available for the
  51. colour selected.  Options set up still stand with this method of mode
  52. selection.  So removed modes are not available for selection, and the 
  53. method of sorting applies the the list of resolutions.  This is important,
  54. if you change the number of colours to be supported the resolution  is
  55. changed automatically to a valid one.  The resolution chosen is always
  56. the bottom option of the resolution menu, ie. the biggest value of the sort.
  57.  
  58. When this mode selection window is opened the details of the current mode
  59. are always displayed.  
  60.  
  61. OPTIONS MENU
  62.  
  63. The options menu is available in two ways by pressing the menu button
  64. over the ModeSel Window, or as a submenu from the icon on the iconbar.
  65.  
  66. Colours     This submenu allows you to change the groups of modes
  67.             that are displayed in the main window. So if you never
  68.             change to 2 colour modes then you can choose not to
  69.             display them.
  70.  
  71. Sort        This submenu allows you to choose the order in which
  72.             modes are shown within each group.  The choices are in
  73.             increasing order of mode number, graphical X resolution,
  74.             graphical y resolution, amount of memory required to
  75.             use the mode, and area.  Area needs a bit of explanation,
  76.             it is how total area of screen appears available. So
  77.             with rectangular pixel modes the Y resolution is doubled.
  78.  
  79. Remove Mode This submenu allows you to remove details of a mode so it
  80.             is never available for selection.  This option allows you 
  81.             to remove modes that you never select or custom modes that 
  82.             may be unuseable with your monitor.
  83.  
  84. Reinit Mode This submenu displays all the modes that have been
  85.             removed, if one of these is chosen from the menu the mode
  86.             is again selectable and is no longer
  87.             removed.
  88.  
  89. Kill Palette If this option is selected then ModeSel will be put a line in 
  90.              !Boot file (when saved from the Task/Switcher menu) to kill the
  91.              palette module.  ModeSel effectively replaces it.
  92.              
  93. ICONBAR MENU
  94.  
  95. Info           Information about ModeSel.
  96.  
  97. Options        This submenu is the options menu as described above.
  98.  
  99. Refresh Modes  This option updates the mode details that are read
  100.                when ModeSel is initially run, this needs to be done
  101.                if a custom modes module is run (such as CC’s
  102.                !NewModes) after ModeSel is run.
  103.  
  104. Save Options   Save the options that have been selected, these are
  105.                removed modes, sort order, and colour groups displayed.
  106.                
  107. Reset Palette  This option runs the palette file  !ModeSel.Palette thus
  108.                resetting the palette to the default.  If your palette
  109.                is different from the standard RISC OS one save it here.
  110.                This option allows you to reset the palette if the palette 
  111.                module has been killed.
  112.                
  113. QUIT           Guess!!!
  114.  
  115.  
  116.  
  117. REASON FOR WRITING !MODESEL
  118. ———————————————————————————
  119. After getting RISCOS 3.11 and a multisync monitor the number of
  120. available modes became so large it became awkward to know which mode
  121. was best at certain times so this application was written.
  122.  
  123.                
  124. KNOWN BUGS
  125. ——————————
  126. • Not serious but can remove modes that are not valid eg. 7 which means
  127.   any following removed modes are ignored.
  128. • Interaction between changing options and updates of the RISC OS 3.5 mode
  129.   selector not quite right.  Will not crash app though. 
  130.  
  131. Tell me if you find anymore
  132.  
  133. HISTORY
  134. ———————
  135.  
  136. 1.0   • Original Version
  137. 1.1   • Bug fixed that stops it running on some machines
  138.       • Now displays mode no in icon on icon bar
  139.       • RiscOs 3.1 3D icons used and colour groups now bordered
  140.       • Gets mode information in background
  141.  
  142. ...   • Rewrite using DeskLib to get access the RISC OS 3 features.
  143.       • Receive mode change message instead of checking on Null event - slowed
  144.         down ARM 2 machines.
  145.       • Reset palette option added
  146.       • Other changes that were forgotten about.
  147.  
  148. 2.0   • Rewrite using OSLib as managed to loose the incomplete source code due
  149.         to a bug with the Zap editor (now fixed).
  150.       • Now puts line in desktop boot file correctly.
  151.       • Uses hiRes sprite on icon bar in HiRes Modes.
  152.       • Reinit menu now stays open if clicked with adjust.
  153.       • Sort on screen area added.
  154.       • Added RISC OS 3.5 style mode selector.  Nearly got app to run in 32K
  155.         but couldn’t quite squeeze it enough so decided might as well add
  156.         extra functionality.  Clicking with Adjust is not exactly style guide
  157.         conformant but easiest way for user to have access to both. Different
  158.         from RISC OS 3.5 as only resolutions for colours chosen are in the
  159.         resolution menu.
  160.         
  161. TO DO
  162. —————
  163. Fix Bugs
  164.  
  165. Tidy up code, its a bit of a mess but I have not got time to tidy it up before I 
  166. release it as I finish university in a couple of days and I want to put it on Hensa.        
  167.       
  168.