home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / s / smallsave / !SmallSave / Docs / Manual next >
Text File  |  1996-06-25  |  13KB  |  294 lines
  1.  
  2.  ABOUT THIS PROGRAM
  3.  ---------------------------------------------------------------------------
  4.  Name    : SmallSave
  5.  Version : 1.15 (25 Jun 1996)
  6.  Purpose : Small, fast screensaver
  7.  Author  : © Andrew Berry, 1996
  8.  Licence : Freeware. Please see conditions at the end of this file.
  9.  
  10.  SmallSave supports Interactive Help, and is now *nearly* Risc PC
  11.  compatible. See the section ‘Risc PC’ below for details.
  12.  
  13.  
  14.  PURPOSE
  15.  --------------------------------------------------------------------------- 
  16.  This program was written because I have yet to find a screensaver which
  17.  is small AND fast and has the options I want. I was looking for the
  18.  ‘dancing lines’ pattern, but although many screensavers contain this
  19.  pattern is it often too slow, or only in black and white. I decided to
  20.  write my own screensaver to my own specifications and SmallSave is now part
  21.  of my boot sequence.
  22.  
  23.  
  24.  USING
  25.  ---------------------------------------------------------------------------
  26.  SmallSave contains a number of options, and these are set from the Options
  27.  window. This is opened by clicking on the icon bar or selecting
  28.  ‘Options...’ from the icon bar menu.
  29.  
  30.  The top box in the window shows the screensaver which is currently
  31.  selected. This will be used when the screen is blanked, and can be changed
  32.  by clicking in the box with MENU, or on the menu icon to the right. This
  33.  brings up a new window with a list of savers. See the section ‘selecting a
  34.  saver’ for details.
  35.  
  36.  
  37.  SELECTING A SAVER
  38.  ---------------------------------------------------------------------------
  39.  The left hand side of the saver window contains the 5 savers which are
  40.  currently implemented. The sixth option, Random, is explained below.
  41.  
  42.  On the right hand side of the window is an option for Steady or Fading
  43.  colours. All savers except Flashing stars will work in either mode. When
  44.  Steady is selected either one or two colours are used. These are changed
  45.  periodically but the lines do not ‘fade’ between colours. When Steady is
  46.  selected the saver will run in any screen mode.
  47.  
  48.  Selecting Fading causes the lines to constantly change colour. The colour
  49.  at any moment is calculated from the screen coordinates of one of the
  50.  points. This only works in 16 colour modes, so an appropriate mode is
  51.  entered if required, with the original mode being reselected on return to
  52.  the desktop.
  53.   
  54.  The final saver option is Random. This causes a saver to be selected at
  55.  random, and Steady or Fading to also be randomly chosen. As well as this,
  56.  a new random saver will be selected after a period of time which can be set
  57.  from the savers window. 
  58.  
  59.  
  60.  THE SAVERS
  61.  ---------------------------------------------------------------------------
  62.  The following savers are currently implemented.
  63.  
  64.  Lines (1 group)
  65.  ===============
  66.  This is the common ‘dancing lines’ saver and is mode independent, i.e. it
  67.  will run in any mode, taking up the whole screen. It looks best in hi-res
  68.  16 colour modes, but will work in most modes which are likely to be used.
  69.             
  70.  Mirrored lines (1 group)
  71.  ========================
  72.  This is similar to Lines, except a kaleidoscope effect is achieved by
  73.  reflecting the lines in horizontal and vertical axes along the middle of
  74.  the screen. This is also mode independent.
  75.       
  76.  Lines (2 groups)
  77.  ================
  78.  Similar to Lines except 2 groups of lines move independently of each other.
  79.         
  80.  Quadrilateral
  81.  =============
  82.  Four points are joined to form a quadrilateral which constantly changes
  83.  shape as it’s corners move around the screen.
  84.  
  85.  Flashing stars
  86.  ==============
  87.  This is a simple effect with stars which flash on and off at random. An
  88.  appropriate 16-colour mode is entered if necessary.
  89.  
  90.  Random
  91.  ======
  92.  Explained above.
  93.  
  94.  
  95.  OTHER OPTIONS
  96.  ---------------------------------------------------------------------------
  97.  Blank time is fairly self-explanatory, and any time from 1 to 999 seconds
  98.  can be entered. 
  99.  
  100.  If ‘Blank after specified time’ is selected then the screen will be blanked
  101.  after the time which has been entered. You may wish to turn this feature
  102.  off, so that the screen is only blanked when the hotkey is pressed (see
  103.  following paragraph).
  104.  
  105.  If instant blank is selected then pressing Control and Insert together
  106.  will start the screensaver. This has been improved since version 1.13 so
  107.  that the saver only starts when Control and Insert are *released*. In
  108.  previous versions, holding one of the keys down slightly too long caused
  109.  the saver to start and then stop again as it detected the keypress.
  110.  
  111.  If ‘Ctrl-Insert to return from instant’ is selected then ONLY Ctrl-Insert
  112.  will return from a screensaver which has been started using the Instant
  113.  method. In other words, if the saver is started automatically after a
  114.  period of time then any mouse movement or keypress will kill the saver, but
  115.  if Ctrl-Insert was used to start the saver then ONLY Ctrl-Insert will kill
  116.  it. This means that the computer is locked in screensaver mode until Ctrl-
  117.  Insert is pressed again. This feature may be improved in the future to
  118.  support password protection.
  119.  
  120.  If ‘Slow down on Risc PC’ is selected then the savers will be made to
  121.  run more slowly. I have used the utility module version to determine
  122.  whether the program is being used on a Risc PC. As Acorn have said that
  123.  they will not be releasing the ARM 610 or 710 for earlier machines, then
  124.  this shouldn’t cause a problem.
  125.  
  126.  Selecting ‘Hide icon on startup’ in the options window causes SmallSave to
  127.  start up without placing an icon on the icon bar. This only takes effect
  128.  from when the program is next loaded. To hide the icon temporarily the icon
  129.  bar menu should be used. 
  130.  
  131.  Problems can occur if both SmallSave and the standard RISC OS screenblanker
  132.  are active. To overcome this, select ‘Disable standard screenblanker’ which
  133.  will issue the command *BlankTime 0 on startup. This doesn’t affect the
  134.  configuration in any way.
  135.  
  136.  The four icons along the bottom of the window are as follows:
  137.  
  138.         Demo : This will enter screensaver mode with the saver which is
  139.                displayed at the top of the window
  140.             
  141.      Restore : Loads the options file from disc
  142.      
  143.         Save : Saves the new options to disc
  144.      
  145.           OK : Closes the window, remembering any changes.
  146.       
  147.  If any of these four icons are selected while the Savers window is open,
  148.  then it will be closed, with the loss of any changes.
  149.  
  150.  
  151.  THE ICON BAR MENU
  152.  ---------------------------------------------------------------------------
  153.  This contains only 4 items, including Info and Quit. ‘Options...’ opens
  154.  the options window which is described above and ‘Hide Icon’ removes the
  155.  icon from the icon bar without affecting the options settings.
  156.  
  157.  
  158.  HIDING THE ICON
  159.  ---------------------------------------------------------------------------
  160.  If ‘Hide Icon on startup’ is selected from the options window then next
  161.  time the program is loaded no icon will appear, although the program will
  162.  be active. This should be the normal situation once you have set the
  163.  options. If you wish to hide the icon temporarily then the icon bar menu
  164.  should be used. In both cases the icon can be unhidden by pressing
  165.  Ctrl-Home.
  166.  
  167.       
  168.  SETTING UP THE PROGRAM FOR INCLUSION IN A BOOT SEQUENCE
  169.  ---------------------------------------------------------------------------
  170.  Select the saver and blank time required and set any other options. Make
  171.  sure that ‘Hide icon on startup’ is selected and click on Save, followed by
  172.  OK. Insert a line in your boot file such as
  173.  
  174.         Filer_Run ADFS::IDEDisc4.Boot.Apps.!SmallSave
  175.  
  176.  The program will be loaded from the boot file. No icon will appear on the
  177.  icon bar but the program will be running with the options which you saved.
  178.  
  179.  On a Risc PC the SmallSave application should be placed in the Tasks
  180.  directory ($.!Boot.Choices.Boot.Tasks) from where it will load
  181.  automatically on startup.
  182.  
  183.  
  184.  RISC PC
  185.  ---------------------------------------------------------------------------
  186.  SmallSave will run satisfactorily on a Risc PC, but at the moment only the
  187.  old style modes are used. I am in the process of writing some Risc PC
  188.  savers which should be included