Home » Recent acquisitions » Acorn ADFS disks » adfs_ArchimedesWorld_199403_2.adf » Disk2Mar94 » !AWMar94/Goodies/yass/!Help

!AWMar94/Goodies/yass/!Help

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Recent acquisitions » Acorn ADFS disks » adfs_ArchimedesWorld_199403_2.adf » Disk2Mar94
Filename: !AWMar94/Goodies/yass/!Help
Read OK:
File size: 400B bytes
Load address: 0000
Exec address: 0000
File contents
 ______________________________________________________________________________
|                                        |                                     |
| YY  YY                          2222   |   � Copyright 1993, Ian Palmer.     |
| YY  YY                         22  22  |                                     |
| YY  YY  aaaa    sssss   sssss      22  |   All rights reserved.              |
|  YYYY      aa  ss      ss         22   |�������������������������������������|
|   YY    aaaaa   ssss    ssss     22    | "We must have done something wrong."|
|   YY   aa  aa      ss      ss   22     | "Oook."                             |
|   YY    aaaaa  sssss   sssss   222222  | "Maybe He is out."                  |
|                                        | "Or busy..."                        |
|________________________________________| "Do you think we could give up and  |
|     __          _                      |  go back to bed?"                   |
| by  / _   _    /_) _   / _ _   _       | WHO ARE WE WAITING FOR EXACTLY?     |
|   _/_(_|_| )  /   (_|_(_| ) )_|/_|~    |      -- "Eric" by Terry Pratchett   |
|________________________________________|_____________________________________|


Introduction
------------

Yass 2 is 'Yet Another Screen Saver' designed especially for the users of
Risc-OS 3 (version 3.10 or later). But hold on a mo... Risc-OS 3 users don't
need another screen saver, they have the wonderful ScreenBlanker module.

Well that's just it, the ScreenBlanker module does it's job, but it is rather
dull, to put it mildly. Yass 2 has been designed, not to replace the
ScreenBlanker module, but to augment it.

What Yass 2 offers is an alternative to the ScreenBlanker module whilst using
the desktop, but allows the module to work normally when you are outside the
desktop. Yass 2's alternative is a programmable screen saver which not only
allows you to write your own screen saver displays, but also allows you to have
a selection of screen savers which it will swap between randomly, making sure
that your screen saver does not become dull.

Most screen saver programs available for the Arc have one, or more, of the
following problems :

  � They don't allow other tasks to operate whilst the screen is blanked
    (ie. they don't multitask).

  � They don't work outside the desktop.

  � They have one or two rather dull displays, or even worse just blank the
    screen.

  � If programmable, they tend to only allow one selected display at a time,
    meaning that when you want a change, you have to make the change yourself.

  � They don't handle ALL keys (inc. shift, ctrl, etc.)

  � Some can be fairly large programs.

When using Yass 2 fully, you don't suffer any of the above problems.


How to use Yass 2
-----------------

When you run Yass 2 for the first time you will probably need to set it up for
your own preferences. With Yass 2 loaded, press SELECT over it's iconbar icon.
This will bring up the Yass SetUp window.

This window allows you to set the following :

  � The Yass 2 (Desk Top) blanking time

  � The non desktop (Standard) blanking time

  � The 'Sleep' corner

  � The 'No Sleep' corner

If you have disabled (killed) the ScreenBlanker module then you will be unable
to set the second option. The two blanking times can be altered by using the up
and down arrows, the time can be set in steps of 30 seconds. Either can be
switched off by setting the time to zero (displayed as 'Off'). Holding down
SHIFT when altering the saver times makes the time step in 1 second units,
thus allowing complete control down to the second.

The 'Sleep' corner is a corner of the screen where if the mouse pointer is
moved the screen saver is started instantly (Desktop only). The 'No Sleep'
corner is a corner where the screen saver will never start up (Desktop only).
Either can be set by clicking over the icon for the corner you require (the
current corner is indicated by the raised icon). Pressing SELECT over a corner
will make that corner the selected corner, pressing ADJUST over any of the
corners will make no corner selected).

Once you have selected your blanking times and corner options, you can now
select which screen savers you want Yass 2 to use. This is done by bringing up
the main menu, and then the 'Savers' submenu. This menu lists all the screen
saver modules known to Yass 2. Those with ticks show the currently selected
modules. Holding down SHIFT and selecting one of the savers will make that
saver the only selected saver (ie. will tick that saver and un-tick all the
others).

If only 1 saver module is ticked, that saver will always be used. If none are
ticked then the default saver is used (blank screen). If more than one is
selected then one will be picked at random, that saver will run for a certain
amount of time, and then another one of the selected savers will be picked, and
so on.

Once you have selected the savers you want to use, go back to the main menu,
and bring up the 'Status' submenu. Clicking on the 'Save' entry in this menu
will save you selections.


The Screen Saver in action
--------------------------

When the desired length of keyboard and mouse inactivity has taken place, one
of the selected screen savers will be started. This will run for a period of
time (set by the screen saver itself) and then another of the selected savers
will be started to take over. This ensures that the screen saver doesn't become
too boring.

During screen saving other desktop applications will still multi-task, and thus
the speed of the action of the screen saver will depend upon the number of
applications running.

As soon as you move the mouse, press a mouse button, press any key on the
keyboard or if a window is opened on the screen, the screen saver will stop and
return the desktop to normal.

When running non multi-tasking applications the built in screen saver module
will take over screen saving as normal.

Yass 2 tries to make as little impact on the desktop as it can. When the
screen saver is not active, Yass 2 checks the keyboard and mouse once a second.
When running a screen saver, Yass 2 automatically adjusts the amount of
CPU time it takes according to the general load of the computer, the higher
the load the lower the demands Yass 2 makes (but your display will tend to
grind, but you can't have anything).

You can force Yass 2 to always use small chunks of CPU time when running a
screen saver by selecting the 'Slow' option on the status menu. This will
force Yass2 to run the saver modules VERY slowly.


Creating your own screen saver modules
--------------------------------------

Creating your own display modules for the screen saver is very simple. Anyone
with a fairly good grasp of Basic can do it, and no knowlege of Wimp
programming is required.

All you need to do is create your own Basic program containing three functions.
These functions will be called by Yass 2 when necessary. The three functions
handle initialisation, running the saver, and tidying up.

First you need to pick a name for your saver module (the filename). In the
description below we are creating a saver module called 'Test' which will draw
random lines on the screen.


- Initialisation

During initialization you should do the following :

  Clear the screen (calling PROCclearscreen(-1) )
  Initialize your variables, and claim any memory you need.

Try to use as many LOCAL variables as tou can, and prefix your globals with
your modules name (eg. test_x%).
The initialization function should be given the name of your module followed by
'_start', for example 'FNtest_start' (note the 'test' is all in lower case).

Claiming memory should NOT use the DIM command. Instead you should call a
special function called FNmalloc which takes the number of bytes you require as
it's parameter, for esample "test_b% = FNmalloc(128)" will make test_b% point
to a block of memory 128 bytes long. FNmalloc returns zero if memory is not
available (very unlikely, but you should handle this situation (see below)).

The initialization function should return 0 if it managed to initialize
correcly. If it could not initialize correctly it should first deallocate any
memory it was allocated (pass it to a procedure PROCfree, eg.
PROCfree(test_b%)) and then return TRUE.

If the initialization finction returns the number 1, Yass 2 will ensure that
the desktop is displayed before calling the poll function (see below).
This means that you can write savers that use the desktop as a starting point,
for example melting the desktop, etc.

Please note that your screen saver should be able to run in any mode (it must
under no circumstances change mode itself). However you may wish to write a
module that only works in, say, 16 colour modes. If this is the case then the
initialization code should first check the value of max_c% (which is set up by
Yass 2) which contains the number of colours in the current mode. If this
number is no good for the module, the function should just return TRUE (ie.
signal that initialization has failed).

Now in our example module, initialization is fairly simple :

DEFFNtest_start
PROCclear_screen(-1)
=0


- Running the saver

The next function is called repeatedly, and it should update the display by a
small amount each time (in our example we will draw a single line).

The function should be called the name of your module followed by _poll, eg.
FNtest_poll.

This function should also determin whether or not it ghas run for long enough.
This may be determined by what the module does (ie. the display may have a
defined end), or you may simply set a time limit on the module. TO help with
the latter case, Yass 2 sets a variable now_going% which contains the number of
1/100ths of a second the saver has been running.

The function should normally return 0, but when it decides to stop it should
return TRUE. Ideally each saver should run for somewhere between 2 and 5
minutes. Returning a value of 1 will force the 'poll' routine to be called
less frequently, thus slowing it down. This is useful for saver routines
like the supplied 'time' and 'clock' saver modules, which only act once a
second.

In our case we will volunteer to stop after 2 minutes.

DEFFNtest_poll
PROCset_colour(0,RND(16)-1)
MOVE RND(max_x%)-1,RND(max_y%)-1:DRAW RND(max_x%)-1,RND(max_y%)-1
IF now_going%>12000 THEN =TRUE
=0


- Tidying up

This function is called when your saver module is being stopped. It should thus
deallocate any memory it allocated, and perform any other tidying up operations
necessary.

After tydying the function should return 0.

In our example, the function need do nothing :

DEFFNtest_stop
=0



In each of the above there are several procedures and variables available :

 FNmalloc(size)      -  Returns a pointer to a block of memory at least 'size'
                        bytes long. If it returns 0 the memory was not available
                     
 PROCfree(ptr)       -  Deallocates the memory pointed to by 'ptr'. 'ptr' must
                        be a value returned by FNmalloc.

 PROCset_colour(g,c) -  Sets the current colour to the given Wimp colour (0-15).
                        Parameters as for GCOL.

 PROCclearscreen(r)  -  Clears the screen. 'r' should be -1.

 max_x%              -  Gives the max x coordinate of the screen.

 max_y%              -  Gives the max y coordinate of the screen.

 max_c%              -  Gives the number of colours for the current screen.
                        (ie. 1, 3, 15 or 63)

 now_going%          -  Number of centiseconds the current saver has been
                        running.


A Basic program called 'Shell' is supplied with this application which contains
a developement environment for testing new modules. Add your functions to the
and of the program, which supplies simulated versions of all the above
procedures and variables.

Set the 'module$' variable at the start of this program to contain the name of
the module (ie. "test" in the above).


If your screen saver needs more than one file (for example it has some sprites,
etc.) then you should place any extra files in the 'Resources' directory
(<Yass2$Dir>.Resources). If there is one extra file needed this should be
given the same name as the saver module (to avoid problems later on). If there
are more files needed you should create a directory (name as saver module)
in the resources directory, and place the files in that directory. 


Other Yass functions
--------------------

Yass2 performs several other useful functions. The first of these is the
ability to set the state on of the internal speaker, and it's volume. This
can be done by clicking ADJUST on Yass2's iconbar icon. This brings up a window
which contains 2 sections, the first informs you a bit about Yass 2's state
(number of savers, number currently selected and it's internal free memory),
and to the right of this are the speaker options.

Yass 2 also allows you to have a special window which keeps you informed about
two useful pieces of information. These are the current time and the amount
of free memory currently available on your computer. To get this information
simply bring up Yass2's menu, and then bring up the 'Status' submenu. Finally
select the 'System' option on this menu. When this option is selected a
window appears in the top left of the screen giving the two peices of
information.

This window can contain either a digital clock or an analogue clock, and can
display hours & minutes or hours, minutes and seconds. The setting for these
options can be selected in the 'System' submenu on the 'Status' menu. This 
menu also allows you to limit the display to either just a clock, or
just a free memory indicator.

The status window can be moved anywhere on the screen by simply pressing any
mouse button (and holding it down) when the mouse pointer is over the window,
and dragging the window to where you want it. The window is then 'locked' in
that postion releative to the corner of the screen it is closest to. This
means that when you change mode, it won't matter if the screen is a different 
size, the window will appear in the same position.

You can also get Yass 2 to keep a check on your RMA size, keeping it as low
as it can. To do this select the 'Zap RMA' option on the 'Status' menu.

The final thing Yass 2 allows is the changing of your pinboard backdrop.
There is a menu option of Yass2's main menu called 'Wallpaper'. This leads to
a submenu which contains a list of available 'wallpapers'. This menu works in
much the same way as the 'Savers' menu. Selecting any of the listed items
will simply place (or remove) a tick from beside it, and SHIFT-SELECT will
select that item whilst resetting all others.

What Yass 2 does is when it starts up it looks at the list of ticked items
and selects one at random, placing it on the backdrop. This having only one
selected will make that always the backdrop, whilst having none selected
will stop Yass 2 placing anything on the backdrop. To place any of the items
on the backdrop with immediate effect, simply CTRL-SELECT the relevent item.



Yass 2 startup options
----------------------

Yass 2 supports 3 command line options :

  -left   Makes Yass 2 place it's icon on the left hand side of the iconbar.

  -right  Makes Yass 2 place it's icon on the right hand side of the iconbar.

  -none   Makes Yass 2 place no icon on the iconbar.



If no options are given, then the icon will (by default) be placed on the
right hand side of the iconbar.

NOTE: If you select the '-none' option then you will not be able to bring up
the main menu, nor the blanking times window. Thus this option should only be
used when you do not wish to alter Yass 2's characteristics.

Yass 2 supports the Risc-OS 3 automatic Desktop Boot file creation. Thus if
it is running it will add it's own start up line into a desktop boot file
created from the task managers menu.


Notes:

Yass 2 will support upto 77 saver modules (as many as you can fit in the saver
directory). However the currently defined wimpslot (64k) will not allow all
of these to be selected, as each saver that is run will claim a certain
amount of memory for variables, etc. Thus for the current wimpslot it is
advisable to keep to a maximum of about 20 selected saver modules. If you want
more than this you should increase the wimpslot given to Yass2 in its !Run
file.
00000000  0a 20 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |. ______________|
00000010  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
00000050  0a 7c 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.|              |
00000060  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000070  20 20 20 20 20 20 20 20  20 20 7c 20 20 20 20 20  |          |     |
00000080  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000000a0  7c 0a 7c 20 59 59 20 20  59 59 20 20 20 20 20 20  ||.| YY  YY      |
000000b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000000c0  20 20 20 20 32 32 32 32  20 20 20 7c 20 20 20 a9  |    2222   |   .|
000000d0  20 43 6f 70 79 72 69 67  68 74 20 31 39 39 33 2c  | Copyright 1993,|
000000e0  20 49 61 6e 20 50 61 6c  6d 65 72 2e 20 20 20 20  | Ian Palmer.    |
000000f0  20 7c 0a 7c 20 59 59 20  20 59 59 20 20 20 20 20  | |.| YY  YY     |
00000100  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000110  20 20 20 20 32 32 20 20  32 32 20 20 7c 20 20 20  |    22  22  |   |
00000120  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000140  20 20 7c 0a 7c 20 59 59  20 20 59 59 20 20 61 61  |  |.| YY  YY  aa|
00000150  61 61 20 20 20 20 73 73  73 73 73 20 20 20 73 73  |aa    sssss   ss|
00000160  73 73 73 20 20 20 20 20  20 32 32 20 20 7c 20 20  |sss      22  |  |
00000170  20 41 6c 6c 20 72 69 67  68 74 73 20 72 65 73 65  | All rights rese|
00000180  72 76 65 64 2e 20 20 20  20 20 20 20 20 20 20 20  |rved.           |
00000190  20 20 20 7c 0a 7c 20 20  59 59 59 59 20 20 20 20  |   |.|  YYYY    |
000001a0  20 20 61 61 20 20 73 73  20 20 20 20 20 20 73 73  |  aa  ss      ss|
000001b0  20 20 20 20 20 20 20 20  20 32 32 20 20 20 7c 98  |         22   |.|
000001c0  98 98 98 98 98 98 98 98  98 98 98 98 98 98 98 98  |................|
*
000001e0  98 98 98 98 7c 0a 7c 20  20 20 59 59 20 20 20 20  |....|.|   YY    |
000001f0  61 61 61 61 61 20 20 20  73 73 73 73 20 20 20 20  |aaaaa   ssss    |
00000200  73 73 73 73 20 20 20 20  20 32 32 20 20 20 20 7c  |ssss     22    ||
00000210  20 22 57 65 20 6d 75 73  74 20 68 61 76 65 20 64  | "We must have d|
00000220  6f 6e 65 20 73 6f 6d 65  74 68 69 6e 67 20 77 72  |one something wr|
00000230  6f 6e 67 2e 22 7c 0a 7c  20 20 20 59 59 20 20 20  |ong."|.|   YY   |
00000240  61 61 20 20 61 61 20 20  20 20 20 20 73 73 20 20  |aa  aa      ss  |
00000250  20 20 20 20 73 73 20 20  20 32 32 20 20 20 20 20  |    ss   22     |
00000260  7c 20 22 4f 6f 6f 6b 2e  22 20 20 20 20 20 20 20  || "Oook."       |
00000270  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000280  20 20 20 20 20 20 7c 0a  7c 20 20 20 59 59 20 20  |      |.|   YY  |
00000290  20 20 61 61 61 61 61 20  20 73 73 73 73 73 20 20  |  aaaaa  sssss  |
000002a0  20 73 73 73 73 73 20 20  20 32 32 32 32 32 32 20  | sssss   222222 |
000002b0  20 7c 20 22 4d 61 79 62  65 20 48 65 20 69 73 20  | | "Maybe He is |
000002c0  6f 75 74 2e 22 20 20 20  20 20 20 20 20 20 20 20  |out."           |
000002d0  20 20 20 20 20 20 20 7c  0a 7c 20 20 20 20 20 20  |       |.|      |
000002e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00000300  20 20 7c 20 22 4f 72 20  62 75 73 79 2e 2e 2e 22  |  | "Or busy..."|
00000310  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000320  20 20 20 20 20 20 20 20  7c 0a 7c 5f 5f 5f 5f 5f  |        |.|_____|
00000330  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
00000350  5f 5f 5f 7c 20 22 44 6f  20 79 6f 75 20 74 68 69  |___| "Do you thi|
00000360  6e 6b 20 77 65 20 63 6f  75 6c 64 20 67 69 76 65  |nk we could give|
00000370  20 75 70 20 61 6e 64 20  20 7c 0a 7c 20 20 20 20  | up and  |.|    |
00000380  20 5f 5f 20 20 20 20 20  20 20 20 20 20 5f 20 20  | __          _  |
00000390  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000003a0  20 20 20 20 7c 20 20 67  6f 20 62 61 63 6b 20 74  |    |  go back t|
000003b0  6f 20 62 65 64 3f 22 20  20 20 20 20 20 20 20 20  |o bed?"         |
000003c0  20 20 20 20 20 20 20 20  20 20 7c 0a 7c 20 62 79  |          |.| by|
000003d0  20 20 2f 20 5f 20 20 20  5f 20 20 20 20 2f 5f 29  |  / _   _    /_)|
000003e0  20 5f 20 20 20 2f 20 5f  20 5f 20 20 20 5f 20 20  | _   / _ _   _  |
000003f0  20 20 20 20 20 7c 20 57  48 4f 20 41 52 45 20 57  |     | WHO ARE W|
00000400  45 20 57 41 49 54 49 4e  47 20 46 4f 52 20 45 58  |E WAITING FOR EX|
00000410  41 43 54 4c 59 3f 20 20  20 20 20 7c 0a 7c 20 20  |ACTLY?     |.|  |
00000420  20 5f 2f 5f 28 5f 7c 5f  7c 20 29 20 20 2f 20 20  | _/_(_|_| )  /  |
00000430  20 28 5f 7c 5f 28 5f 7c  20 29 20 29 5f 7c 2f 5f  | (_|_(_| ) )_|/_|
00000440  7c 7e 20 20 20 20 7c 20  20 20 20 20 20 2d 2d 20  ||~    |      -- |
00000450  22 45 72 69 63 22 20 62  79 20 54 65 72 72 79 20  |"Eric" by Terry |
00000460  50 72 61 74 63 68 65 74  74 20 20 20 7c 0a 7c 5f  |Pratchett   |.|_|
00000470  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
00000490  5f 5f 5f 5f 5f 5f 5f 7c  5f 5f 5f 5f 5f 5f 5f 5f  |_______|________|
000004a0  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
000004b0  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 7c 0a 0a  |_____________|..|
000004c0  0a 49 6e 74 72 6f 64 75  63 74 69 6f 6e 0a 2d 2d  |.Introduction.--|
000004d0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 0a 59 61 73 73  |----------..Yass|
000004e0  20 32 20 69 73 20 27 59  65 74 20 41 6e 6f 74 68  | 2 is 'Yet Anoth|
000004f0  65 72 20 53 63 72 65 65  6e 20 53 61 76 65 72 27  |er Screen Saver'|
00000500  20 64 65 73 69 67 6e 65  64 20 65 73 70 65 63 69  | designed especi|
00000510  61 6c 6c 79 20 66 6f 72  20 74 68 65 20 75 73 65  |ally for the use|
00000520  72 73 20 6f 66 0a 52 69  73 63 2d 4f 53 20 33 20  |rs of.Risc-OS 3 |
00000530  28 76 65 72 73 69 6f 6e  20 33 2e 31 30 20 6f 72  |(version 3.10 or|
00000540  20 6c 61 74 65 72 29 2e  20 42 75 74 20 68 6f 6c  | later). But hol|
00000550  64 20 6f 6e 20 61 20 6d  6f 2e 2e 2e 20 52 69 73  |d on a mo... Ris|
00000560  63 2d 4f 53 20 33 20 75  73 65 72 73 20 64 6f 6e  |c-OS 3 users don|
00000570  27 74 0a 6e 65 65 64 20  61 6e 6f 74 68 65 72 20  |'t.need another |
00000580  73 63 72 65 65 6e 20 73  61 76 65 72 2c 20 74 68  |screen saver, th|
00000590  65 79 20 68 61 76 65 20  74 68 65 20 77 6f 6e 64  |ey have the wond|
000005a0  65 72 66 75 6c 20 53 63  72 65 65 6e 42 6c 61 6e  |erful ScreenBlan|
000005b0  6b 65 72 20 6d 6f 64 75  6c 65 2e 0a 0a 57 65 6c  |ker module...Wel|
000005c0  6c 20 74 68 61 74 27 73  20 6a 75 73 74 20 69 74  |l that's just it|
000005d0  2c 20 74 68 65 20 53 63  72 65 65 6e 42 6c 61 6e  |, the ScreenBlan|
000005e0  6b 65 72 20 6d 6f 64 75  6c 65 20 64 6f 65 73 20  |ker module does |
000005f0  69 74 27 73 20 6a 6f 62  2c 20 62 75 74 20 69 74  |it's job, but it|
00000600  20 69 73 20 72 61 74 68  65 72 0a 64 75 6c 6c 2c  | is rather.dull,|
00000610  20 74 6f 20 70 75 74 20  69 74 20 6d 69 6c 64 6c  | to put it mildl|
00000620  79 2e 20 59 61 73 73 20  32 20 68 61 73 20 62 65  |y. Yass 2 has be|
00000630  65 6e 20 64 65 73 69 67  6e 65 64 2c 20 6e 6f 74  |en designed, not|
00000640  20 74 6f 20 72 65 70 6c  61 63 65 20 74 68 65 0a  | to replace the.|
00000650  53 63 72 65 65 6e 42 6c  61 6e 6b 65 72 20 6d 6f  |ScreenBlanker mo|
00000660  64 75 6c 65 2c 20 62 75  74 20 74 6f 20 61 75 67  |dule, but to aug|
00000670  6d 65 6e 74 20 69 74 2e  0a 0a 57 68 61 74 20 59  |ment it...What Y|
00000680  61 73 73 20 32 20 6f 66  66 65 72 73 20 69 73 20  |ass 2 offers is |
00000690  61 6e 20 61 6c 74 65 72  6e 61 74 69 76 65 20 74  |an alternative t|
000006a0  6f 20 74 68 65 20 53 63  72 65 65 6e 42 6c 61 6e  |o the ScreenBlan|
000006b0  6b 65 72 20 6d 6f 64 75  6c 65 20 77 68 69 6c 73  |ker module whils|
000006c0  74 20 75 73 69 6e 67 0a  74 68 65 20 64 65 73 6b  |t using.the desk|
000006d0  74 6f 70 2c 20 62 75 74  20 61 6c 6c 6f 77 73 20  |top, but allows |
000006e0  74 68 65 20 6d 6f 64 75  6c 65 20 74 6f 20 77 6f  |the module to wo|
000006f0  72 6b 20 6e 6f 72 6d 61  6c 6c 79 20 77 68 65 6e  |rk normally when|
00000700  20 79 6f 75 20 61 72 65  20 6f 75 74 73 69 64 65  | you are outside|
00000710  20 74 68 65 0a 64 65 73  6b 74 6f 70 2e 20 59 61  | the.desktop. Ya|
00000720  73 73 20 32 27 73 20 61  6c 74 65 72 6e 61 74 69  |ss 2's alternati|
00000730  76 65 20 69 73 20 61 20  70 72 6f 67 72 61 6d 6d  |ve is a programm|
00000740  61 62 6c 65 20 73 63 72  65 65 6e 20 73 61 76 65  |able screen save|
00000750  72 20 77 68 69 63 68 20  6e 6f 74 20 6f 6e 6c 79  |r which not only|
00000760  0a 61 6c 6c 6f 77 73 20  79 6f 75 20 74 6f 20 77  |.allows you to w|
00000770  72 69 74 65 20 79 6f 75  72 20 6f 77 6e 20 73 63  |rite your own sc|
00000780  72 65 65 6e 20 73 61 76  65 72 20 64 69 73 70 6c  |reen saver displ|
00000790  61 79 73 2c 20 62 75 74  20 61 6c 73 6f 20 61 6c  |ays, but also al|
000007a0  6c 6f 77 73 20 79 6f 75  20 74 6f 20 68 61 76 65  |lows you to have|
000007b0  0a 61 20 73 65 6c 65 63  74 69 6f 6e 20 6f 66 20  |.a selection of |
000007c0  73 63 72 65 65 6e 20 73  61 76 65 72 73 20 77 68  |screen savers wh|
000007d0  69 63 68 20 69 74 20 77  69 6c 6c 20 73 77 61 70  |ich it will swap|
000007e0  20 62 65 74 77 65 65 6e  20 72 61 6e 64 6f 6d 6c  | between randoml|
000007f0  79 2c 20 6d 61 6b 69 6e  67 20 73 75 72 65 0a 74  |y, making sure.t|
00000800  68 61 74 20 79 6f 75 72  20 73 63 72 65 65 6e 20  |hat your screen |
00000810  73 61 76 65 72 20 64 6f  65 73 20 6e 6f 74 20 62  |saver does not b|
00000820  65 63 6f 6d 65 20 64 75  6c 6c 2e 0a 0a 4d 6f 73  |ecome dull...Mos|
00000830  74 20 73 63 72 65 65 6e  20 73 61 76 65 72 20 70  |t screen saver p|
00000840  72 6f 67 72 61 6d 73 20  61 76 61 69 6c 61 62 6c  |rograms availabl|
00000850  65 20 66 6f 72 20 74 68  65 20 41 72 63 20 68 61  |e for the Arc ha|
00000860  76 65 20 6f 6e 65 2c 20  6f 72 20 6d 6f 72 65 2c  |ve one, or more,|
00000870  20 6f 66 20 74 68 65 0a  66 6f 6c 6c 6f 77 69 6e  | of the.followin|
00000880  67 20 70 72 6f 62 6c 65  6d 73 20 3a 0a 0a 20 20  |g problems :..  |
00000890  8f 20 54 68 65 79 20 64  6f 6e 27 74 20 61 6c 6c  |. They don't all|
000008a0  6f 77 20 6f 74 68 65 72  20 74 61 73 6b 73 20 74  |ow other tasks t|
000008b0  6f 20 6f 70 65 72 61 74  65 20 77 68 69 6c 73 74  |o operate whilst|
000008c0  20 74 68 65 20 73 63 72  65 65 6e 20 69 73 20 62  | the screen is b|
000008d0  6c 61 6e 6b 65 64 0a 20  20 20 20 28 69 65 2e 20  |lanked.    (ie. |
000008e0  74 68 65 79 20 64 6f 6e  27 74 20 6d 75 6c 74 69  |they don't multi|
000008f0  74 61 73 6b 29 2e 0a 0a  20 20 8f 20 54 68 65 79  |task)...  . They|
00000900  20 64 6f 6e 27 74 20 77  6f 72 6b 20 6f 75 74 73  | don't work outs|
00000910  69 64 65 20 74 68 65 20  64 65 73 6b 74 6f 70 2e  |ide the desktop.|
00000920  0a 0a 20 20 8f 20 54 68  65 79 20 68 61 76 65 20  |..  . They have |
00000930  6f 6e 65 20 6f 72 20 74  77 6f 20 72 61 74 68 65  |one or two rathe|
00000940  72 20 64 75 6c 6c 20 64  69 73 70 6c 61 79 73 2c  |r dull displays,|
00000950  20 6f 72 20 65 76 65 6e  20 77 6f 72 73 65 20 6a  | or even worse j|
00000960  75 73 74 20 62 6c 61 6e  6b 20 74 68 65 0a 20 20  |ust blank the.  |
00000970  20 20 73 63 72 65 65 6e  2e 0a 0a 20 20 8f 20 49  |  screen...  . I|
00000980  66 20 70 72 6f 67 72 61  6d 6d 61 62 6c 65 2c 20  |f programmable, |
00000990  74 68 65 79 20 74 65 6e  64 20 74 6f 20 6f 6e 6c  |they tend to onl|
000009a0  79 20 61 6c 6c 6f 77 20  6f 6e 65 20 73 65 6c 65  |y allow one sele|
000009b0  63 74 65 64 20 64 69 73  70 6c 61 79 20 61 74 20  |cted display at |
000009c0  61 20 74 69 6d 65 2c 0a  20 20 20 20 6d 65 61 6e  |a time,.    mean|
000009d0  69 6e 67 20 74 68 61 74  20 77 68 65 6e 20 79 6f  |ing that when yo|
000009e0  75 20 77 61 6e 74 20 61  20 63 68 61 6e 67 65 2c  |u want a change,|
000009f0  20 79 6f 75 20 68 61 76  65 20 74 6f 20 6d 61 6b  | you have to mak|
00000a00  65 20 74 68 65 20 63 68  61 6e 67 65 20 79 6f 75  |e the change you|
00000a10  72 73 65 6c 66 2e 0a 0a  20 20 8f 20 54 68 65 79  |rself...  . They|
00000a20  20 64 6f 6e 27 74 20 68  61 6e 64 6c 65 20 41 4c  | don't handle AL|
00000a30  4c 20 6b 65 79 73 20 28  69 6e 63 2e 20 73 68 69  |L keys (inc. shi|
00000a40  66 74 2c 20 63 74 72 6c  2c 20 65 74 63 2e 29 0a  |ft, ctrl, etc.).|
00000a50  0a 20 20 8f 20 53 6f 6d  65 20 63 61 6e 20 62 65  |.  . Some can be|
00000a60  20 66 61 69 72 6c 79 20  6c 61 72 67 65 20 70 72  | fairly large pr|
00000a70  6f 67 72 61 6d 73 2e 0a  0a 57 68 65 6e 20 75 73  |ograms...When us|
00000a80  69 6e 67 20 59 61 73 73  20 32 20 66 75 6c 6c 79  |ing Yass 2 fully|
00000a90  2c 20 79 6f 75 20 64 6f  6e 27 74 20 73 75 66 66  |, you don't suff|
00000aa0  65 72 20 61 6e 79 20 6f  66 20 74 68 65 20 61 62  |er any of the ab|
00000ab0  6f 76 65 20 70 72 6f 62  6c 65 6d 73 2e 0a 0a 0a  |ove problems....|
00000ac0  48 6f 77 20 74 6f 20 75  73 65 20 59 61 73 73 20  |How to use Yass |
00000ad0  32 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |2.--------------|
00000ae0  2d 2d 2d 0a 0a 57 68 65  6e 20 79 6f 75 20 72 75  |---..When you ru|
00000af0  6e 20 59 61 73 73 20 32  20 66 6f 72 20 74 68 65  |n Yass 2 for the|
00000b00  20 66 69 72 73 74 20 74  69 6d 65 20 79 6f 75 20  | first time you |
00000b10  77 69 6c 6c 20 70 72 6f  62 61 62 6c 79 20 6e 65  |will probably ne|
00000b20  65 64 20 74 6f 20 73 65  74 20 69 74 20 75 70 20  |ed to set it up |
00000b30  66 6f 72 0a 79 6f 75 72  20 6f 77 6e 20 70 72 65  |for.your own pre|
00000b40  66 65 72 65 6e 63 65 73  2e 20 57 69 74 68 20 59  |ferences. With Y|
00000b50  61 73 73 20 32 20 6c 6f  61 64 65 64 2c 20 70 72  |ass 2 loaded, pr|
00000b60  65 73 73 20 53 45 4c 45  43 54 20 6f 76 65 72 20  |ess SELECT over |
00000b70  69 74 27 73 20 69 63 6f  6e 62 61 72 20 69 63 6f  |it's iconbar ico|
00000b80  6e 2e 0a 54 68 69 73 20  77 69 6c 6c 20 62 72 69  |n..This will bri|
00000b90  6e 67 20 75 70 20 74 68  65 20 59 61 73 73 20 53  |ng up the Yass S|
00000ba0  65 74 55 70 20 77 69 6e  64 6f 77 2e 0a 0a 54 68  |etUp window...Th|
00000bb0  69 73 20 77 69 6e 64 6f  77 20 61 6c 6c 6f 77 73  |is window allows|
00000bc0  20 79 6f 75 20 74 6f 20  73 65 74 20 74 68 65 20  | you to set the |
00000bd0  66 6f 6c 6c 6f 77 69 6e  67 20 3a 0a 0a 20 20 8f  |following :..  .|
00000be0  20 54 68 65 20 59 61 73  73 20 32 20 28 44 65 73  | The Yass 2 (Des|
00000bf0  6b 20 54 6f 70 29 20 62  6c 61 6e 6b 69 6e 67 20  |k Top) blanking |
00000c00  74 69 6d 65 0a 0a 20 20  8f 20 54 68 65 20 6e 6f  |time..  . The no|
00000c10  6e 20 64 65 73 6b 74 6f  70 20 28 53 74 61 6e 64  |n desktop (Stand|
00000c20  61 72 64 29 20 62 6c 61  6e 6b 69 6e 67 20 74 69  |ard) blanking ti|
00000c30  6d 65 0a 0a 20 20 8f 20  54 68 65 20 27 53 6c 65  |me..  . The 'Sle|
00000c40  65 70 27 20 63 6f 72 6e  65 72 0a 0a 20 20 8f 20  |ep' corner..  . |
00000c50  54 68 65 20 27 4e 6f 20  53 6c 65 65 70 27 20 63  |The 'No Sleep' c|
00000c60  6f 72 6e 65 72 0a 0a 49  66 20 79 6f 75 20 68 61  |orner..If you ha|
00000c70  76 65 20 64 69 73 61 62  6c 65 64 20 28 6b 69 6c  |ve disabled (kil|
00000c80  6c 65 64 29 20 74 68 65  20 53 63 72 65 65 6e 42  |led) the ScreenB|
00000c90  6c 61 6e 6b 65 72 20 6d  6f 64 75 6c 65 20 74 68  |lanker module th|
00000ca0  65 6e 20 79 6f 75 20 77  69 6c 6c 20 62 65 20 75  |en you will be u|
00000cb0  6e 61 62 6c 65 0a 74 6f  20 73 65 74 20 74 68 65  |nable.to set the|
00000cc0  20 73 65 63 6f 6e 64 20  6f 70 74 69 6f 6e 2e 20  | second option. |
00000cd0  54 68 65 20 74 77 6f 20  62 6c 61 6e 6b 69 6e 67  |The two blanking|
00000ce0  20 74 69 6d 65 73 20 63  61 6e 20 62 65 20 61 6c  | times can be al|
00000cf0  74 65 72 65 64 20 62 79  20 75 73 69 6e 67 20 74  |tered by using t|
00000d00  68 65 20 75 70 0a 61 6e  64 20 64 6f 77 6e 20 61  |he up.and down a|
00000d10  72 72 6f 77 73 2c 20 74  68 65 20 74 69 6d 65 20  |rrows, the time |
00000d20  63 61 6e 20 62 65 20 73  65 74 20 69 6e 20 73 74  |can be set in st|
00000d30  65 70 73 20 6f 66 20 33  30 20 73 65 63 6f 6e 64  |eps of 30 second|
00000d40  73 2e 20 45 69 74 68 65  72 20 63 61 6e 20 62 65  |s. Either can be|
00000d50  0a 73 77 69 74 63 68 65  64 20 6f 66 66 20 62 79  |.switched off by|
00000d60  20 73 65 74 74 69 6e 67  20 74 68 65 20 74 69 6d  | setting the tim|
00000d70  65 20 74 6f 20 7a 65 72  6f 20 28 64 69 73 70 6c  |e to zero (displ|
00000d80  61 79 65 64 20 61 73 20  27 4f 66 66 27 29 2e 20  |ayed as 'Off'). |
00000d90  48 6f 6c 64 69 6e 67 20  64 6f 77 6e 0a 53 48 49  |Holding down.SHI|
00000da0  46 54 20 77 68 65 6e 20  61 6c 74 65 72 69 6e 67  |FT when altering|
00000db0  20 74 68 65 20 73 61 76  65 72 20 74 69 6d 65 73  | the saver times|
00000dc0  20 6d 61 6b 65 73 20 74  68 65 20 74 69 6d 65 20  | makes the time |
00000dd0  73 74 65 70 20 69 6e 20  31 20 73 65 63 6f 6e 64  |step in 1 second|
00000de0  20 75 6e 69 74 73 2c 0a  74 68 75 73 20 61 6c 6c  | units,.thus all|
00000df0  6f 77 69 6e 67 20 63 6f  6d 70 6c 65 74 65 20 63  |owing complete c|
00000e00  6f 6e 74 72 6f 6c 20 64  6f 77 6e 20 74 6f 20 74  |ontrol down to t|
00000e10  68 65 20 73 65 63 6f 6e  64 2e 0a 0a 54 68 65 20  |he second...The |
00000e20  27 53 6c 65 65 70 27 20  63 6f 72 6e 65 72 20 69  |'Sleep' corner i|
00000e30  73 20 61 20 63 6f 72 6e  65 72 20 6f 66 20 74 68  |s a corner of th|
00000e40  65 20 73 63 72 65 65 6e  20 77 68 65 72 65 20 69  |e screen where i|
00000e50  66 20 74 68 65 20 6d 6f  75 73 65 20 70 6f 69 6e  |f the mouse poin|
00000e60  74 65 72 20 69 73 0a 6d  6f 76 65 64 20 74 68 65  |ter is.moved the|
00000e70  20 73 63 72 65 65 6e 20  73 61 76 65 72 20 69 73  | screen saver is|
00000e80  20 73 74 61 72 74 65 64  20 69 6e 73 74 61 6e 74  | started instant|
00000e90  6c 79 20 28 44 65 73 6b  74 6f 70 20 6f 6e 6c 79  |ly (Desktop only|
00000ea0  29 2e 20 54 68 65 20 27  4e 6f 20 53 6c 65 65 70  |). The 'No Sleep|
00000eb0  27 0a 63 6f 72 6e 65 72  20 69 73 20 61 20 63 6f  |'.corner is a co|
00000ec0  72 6e 65 72 20 77 68 65  72 65 20 74 68 65 20 73  |rner where the s|
00000ed0  63 72 65 65 6e 20 73 61  76 65 72 20 77 69 6c 6c  |creen saver will|
00000ee0  20 6e 65 76 65 72 20 73  74 61 72 74 20 75 70 20  | never start up |
00000ef0  28 44 65 73 6b 74 6f 70  20 6f 6e 6c 79 29 2e 0a  |(Desktop only)..|
00000f00  45 69 74 68 65 72 20 63  61 6e 20 62 65 20 73 65  |Either can be se|
00000f10  74 20 62 79 20 63 6c 69  63 6b 69 6e 67 20 6f 76  |t by clicking ov|
00000f20  65 72 20 74 68 65 20 69  63 6f 6e 20 66 6f 72 20  |er the icon for |
00000f30  74 68 65 20 63 6f 72 6e  65 72 20 79 6f 75 20 72  |the corner you r|
00000f40  65 71 75 69 72 65 20 28  74 68 65 0a 63 75 72 72  |equire (the.curr|
00000f50  65 6e 74 20 63 6f 72 6e  65 72 20 69 73 20 69 6e  |ent corner is in|
00000f60  64 69 63 61 74 65 64 20  62 79 20 74 68 65 20 72  |dicated by the r|
00000f70  61 69 73 65 64 20 69 63  6f 6e 29 2e 20 50 72 65  |aised icon). Pre|
00000f80  73 73 69 6e 67 20 53 45  4c 45 43 54 20 6f 76 65  |ssing SELECT ove|
00000f90  72 20 61 20 63 6f 72 6e  65 72 0a 77 69 6c 6c 20  |r a corner.will |
00000fa0  6d 61 6b 65 20 74 68 61  74 20 63 6f 72 6e 65 72  |make that corner|
00000fb0  20 74 68 65 20 73 65 6c  65 63 74 65 64 20 63 6f  | the selected co|
00000fc0  72 6e 65 72 2c 20 70 72  65 73 73 69 6e 67 20 41  |rner, pressing A|
00000fd0  44 4a 55 53 54 20 6f 76  65 72 20 61 6e 79 20 6f  |DJUST over any o|
00000fe0  66 20 74 68 65 0a 63 6f  72 6e 65 72 73 20 77 69  |f the.corners wi|
00000ff0  6c 6c 20 6d 61 6b 65 20  6e 6f 20 63 6f 72 6e 65  |ll make no corne|
00001000  72 20 73 65 6c 65 63 74  65 64 29 2e 0a 0a 4f 6e  |r selected)...On|
00001010  63 65 20 79 6f 75 20 68  61 76 65 20 73 65 6c 65  |ce you have sele|
00001020  63 74 65 64 20 79 6f 75  72 20 62 6c 61 6e 6b 69  |cted your blanki|
00001030  6e 67 20 74 69 6d 65 73  20 61 6e 64 20 63 6f 72  |ng times and cor|
00001040  6e 65 72 20 6f 70 74 69  6f 6e 73 2c 20 79 6f 75  |ner options, you|
00001050  20 63 61 6e 20 6e 6f 77  0a 73 65 6c 65 63 74 20  | can now.select |
00001060  77 68 69 63 68 20 73 63  72 65 65 6e 20 73 61 76  |which screen sav|
00001070  65 72 73 20 79 6f 75 20  77 61 6e 74 20 59 61 73  |ers you want Yas|
00001080  73 20 32 20 74 6f 20 75  73 65 2e 20 54 68 69 73  |s 2 to use. This|
00001090  20 69 73 20 64 6f 6e 65  20 62 79 20 62 72 69 6e  | is done by brin|
000010a0  67 69 6e 67 20 75 70 0a  74 68 65 20 6d 61 69 6e  |ging up.the main|
000010b0  20 6d 65 6e 75 2c 20 61  6e 64 20 74 68 65 6e 20  | menu, and then |
000010c0  74 68 65 20 27 53 61 76  65 72 73 27 20 73 75 62  |the 'Savers' sub|
000010d0  6d 65 6e 75 2e 20 54 68  69 73 20 6d 65 6e 75 20  |menu. This menu |
000010e0  6c 69 73 74 73 20 61 6c  6c 20 74 68 65 20 73 63  |lists all the sc|
000010f0  72 65 65 6e 0a 73 61 76  65 72 20 6d 6f 64 75 6c  |reen.saver modul|
00001100  65 73 20 6b 6e 6f 77 6e  20 74 6f 20 59 61 73 73  |es known to Yass|
00001110  20 32 2e 20 54 68 6f 73  65 20 77 69 74 68 20 74  | 2. Those with t|
00001120  69 63 6b 73 20 73 68 6f  77 20 74 68 65 20 63 75  |icks show the cu|
00001130  72 72 65 6e 74 6c 79 20  73 65 6c 65 63 74 65 64  |rrently selected|
00001140  0a 6d 6f 64 75 6c 65 73  2e 20 48 6f 6c 64 69 6e  |.modules. Holdin|
00001150  67 20 64 6f 77 6e 20 53  48 49 46 54 20 61 6e 64  |g down SHIFT and|
00001160  20 73 65 6c 65 63 74 69  6e 67 20 6f 6e 65 20 6f  | selecting one o|
00001170  66 20 74 68 65 20 73 61  76 65 72 73 20 77 69 6c  |f the savers wil|
00001180  6c 20 6d 61 6b 65 20 74  68 61 74 0a 73 61 76 65  |l make that.save|
00001190  72 20 74 68 65 20 6f 6e  6c 79 20 73 65 6c 65 63  |r the only selec|
000011a0  74 65 64 20 73 61 76 65  72 20 28 69 65 2e 20 77  |ted saver (ie. w|
000011b0  69 6c 6c 20 74 69 63 6b  20 74 68 61 74 20 73 61  |ill tick that sa|
000011c0  76 65 72 20 61 6e 64 20  75 6e 2d 74 69 63 6b 20  |ver and un-tick |
000011d0  61 6c 6c 20 74 68 65 0a  6f 74 68 65 72 73 29 2e  |all the.others).|
000011e0  0a 0a 49 66 20 6f 6e 6c  79 20 31 20 73 61 76 65  |..If only 1 save|
000011f0  72 20 6d 6f 64 75 6c 65  20 69 73 20 74 69 63 6b  |r module is tick|
00001200  65 64 2c 20 74 68 61 74  20 73 61 76 65 72 20 77  |ed, that saver w|
00001210  69 6c 6c 20 61 6c 77 61  79 73 20 62 65 20 75 73  |ill always be us|
00001220  65 64 2e 20 49 66 20 6e  6f 6e 65 20 61 72 65 0a  |ed. If none are.|
00001230  74 69 63 6b 65 64 20 74  68 65 6e 20 74 68 65 20  |ticked then the |
00001240  64 65 66 61 75 6c 74 20  73 61 76 65 72 20 69 73  |default saver is|
00001250  20 75 73 65 64 20 28 62  6c 61 6e 6b 20 73 63 72  | used (blank scr|
00001260  65 65 6e 29 2e 20 49 66  20 6d 6f 72 65 20 74 68  |een). If more th|
00001270  61 6e 20 6f 6e 65 20 69  73 0a 73 65 6c 65 63 74  |an one is.select|
00001280  65 64 20 74 68 65 6e 20  6f 6e 65 20 77 69 6c 6c  |ed then one will|
00001290  20 62 65 20 70 69 63 6b  65 64 20 61 74 20 72 61  | be picked at ra|
000012a0  6e 64 6f 6d 2c 20 74 68  61 74 20 73 61 76 65 72  |ndom, that saver|
000012b0  20 77 69 6c 6c 20 72 75  6e 20 66 6f 72 20 61 20  | will run for a |
000012c0  63 65 72 74 61 69 6e 0a  61 6d 6f 75 6e 74 20 6f  |certain.amount o|
000012d0  66 20 74 69 6d 65 2c 20  61 6e 64 20 74 68 65 6e  |f time, and then|
000012e0  20 61 6e 6f 74 68 65 72  20 6f 6e 65 20 6f 66 20  | another one of |
000012f0  74 68 65 20 73 65 6c 65  63 74 65 64 20 73 61 76  |the selected sav|
00001300  65 72 73 20 77 69 6c 6c  20 62 65 20 70 69 63 6b  |ers will be pick|
00001310  65 64 2c 20 61 6e 64 0a  73 6f 20 6f 6e 2e 0a 0a  |ed, and.so on...|
00001320  4f 6e 63 65 20 79 6f 75  20 68 61 76 65 20 73 65  |Once you have se|
00001330  6c 65 63 74 65 64 20 74  68 65 20 73 61 76 65 72  |lected the saver|
00001340  73 20 79 6f 75 20 77 61  6e 74 20 74 6f 20 75 73  |s you want to us|
00001350  65 2c 20 67 6f 20 62 61  63 6b 20 74 6f 20 74 68  |e, go back to th|
00001360  65 20 6d 61 69 6e 20 6d  65 6e 75 2c 0a 61 6e 64  |e main menu,.and|
00001370  20 62 72 69 6e 67 20 75  70 20 74 68 65 20 27 53  | bring up the 'S|
00001380  74 61 74 75 73 27 20 73  75 62 6d 65 6e 75 2e 20  |tatus' submenu. |
00001390  43 6c 69 63 6b 69 6e 67  20 6f 6e 20 74 68 65 20  |Clicking on the |
000013a0  27 53 61 76 65 27 20 65  6e 74 72 79 20 69 6e 20  |'Save' entry in |
000013b0  74 68 69 73 20 6d 65 6e  75 0a 77 69 6c 6c 20 73  |this menu.will s|
000013c0  61 76 65 20 79 6f 75 20  73 65 6c 65 63 74 69 6f  |ave you selectio|
000013d0  6e 73 2e 0a 0a 0a 54 68  65 20 53 63 72 65 65 6e  |ns....The Screen|
000013e0  20 53 61 76 65 72 20 69  6e 20 61 63 74 69 6f 6e  | Saver in action|
000013f0  0a 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |.---------------|
00001400  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 0a 0a 57 68 65  |-----------..Whe|
00001410  6e 20 74 68 65 20 64 65  73 69 72 65 64 20 6c 65  |n the desired le|
00001420  6e 67 74 68 20 6f 66 20  6b 65 79 62 6f 61 72 64  |ngth of keyboard|
00001430  20 61 6e 64 20 6d 6f 75  73 65 20 69 6e 61 63 74  | and mouse inact|
00001440  69 76 69 74 79 20 68 61  73 20 74 61 6b 65 6e 20  |ivity has taken |
00001450  70 6c 61 63 65 2c 20 6f  6e 65 0a 6f 66 20 74 68  |place, one.of th|
00001460  65 20 73 65 6c 65 63 74  65 64 20 73 63 72 65 65  |e selected scree|
00001470  6e 20 73 61 76 65 72 73  20 77 69 6c 6c 20 62 65  |n savers will be|
00001480  20 73 74 61 72 74 65 64  2e 20 54 68 69 73 20 77  | started. This w|
00001490  69 6c 6c 20 72 75 6e 20  66 6f 72 20 61 20 70 65  |ill run for a pe|
000014a0  72 69 6f 64 20 6f 66 0a  74 69 6d 65 20 28 73 65  |riod of.time (se|
000014b0  74 20 62 79 20 74 68 65  20 73 63 72 65 65 6e 20  |t by the screen |
000014c0  73 61 76 65 72 20 69 74  73 65 6c 66 29 20 61 6e  |saver itself) an|
000014d0  64 20 74 68 65 6e 20 61  6e 6f 74 68 65 72 20 6f  |d then another o|
000014e0  66 20 74 68 65 20 73 65  6c 65 63 74 65 64 20 73  |f the selected s|
000014f0  61 76 65 72 73 0a 77 69  6c 6c 20 62 65 20 73 74  |avers.will be st|
00001500  61 72 74 65 64 20 74 6f  20 74 61 6b 65 20 6f 76  |arted to take ov|
00001510  65 72 2e 20 54 68 69 73  20 65 6e 73 75 72 65 73  |er. This ensures|
00001520  20 74 68 61 74 20 74 68  65 20 73 63 72 65 65 6e  | that the screen|
00001530  20 73 61 76 65 72 20 64  6f 65 73 6e 27 74 20 62  | saver doesn't b|
00001540  65 63 6f 6d 65 0a 74 6f  6f 20 62 6f 72 69 6e 67  |ecome.too boring|
00001550  2e 0a 0a 44 75 72 69 6e  67 20 73 63 72 65 65 6e  |...During screen|
00001560  20 73 61 76 69 6e 67 20  6f 74 68 65 72 20 64 65  | saving other de|
00001570  73 6b 74 6f 70 20 61 70  70 6c 69 63 61 74 69 6f  |sktop applicatio|
00001580  6e 73 20 77 69 6c 6c 20  73 74 69 6c 6c 20 6d 75  |ns will still mu|
00001590  6c 74 69 2d 74 61 73 6b  2c 20 61 6e 64 20 74 68  |lti-task, and th|
000015a0  75 73 0a 74 68 65 20 73  70 65 65 64 20 6f 66 20  |us.the speed of |
000015b0  74 68 65 20 61 63 74 69  6f 6e 20 6f 66 20 74 68  |the action of th|
000015c0  65 20 73 63 72 65 65 6e  20 73 61 76 65 72 20 77  |e screen saver w|
000015d0  69 6c 6c 20 64 65 70 65  6e 64 20 75 70 6f 6e 20  |ill depend upon |
000015e0  74 68 65 20 6e 75 6d 62  65 72 20 6f 66 0a 61 70  |the number of.ap|
000015f0  70 6c 69 63 61 74 69 6f  6e 73 20 72 75 6e 6e 69  |plications runni|
00001600  6e 67 2e 0a 0a 41 73 20  73 6f 6f 6e 20 61 73 20  |ng...As soon as |
00001610  79 6f 75 20 6d 6f 76 65  20 74 68 65 20 6d 6f 75  |you move the mou|
00001620  73 65 2c 20 70 72 65 73  73 20 61 20 6d 6f 75 73  |se, press a mous|
00001630  65 20 62 75 74 74 6f 6e  2c 20 70 72 65 73 73 20  |e button, press |
00001640  61 6e 79 20 6b 65 79 20  6f 6e 20 74 68 65 0a 6b  |any key on the.k|
00001650  65 79 62 6f 61 72 64 20  6f 72 20 69 66 20 61 20  |eyboard or if a |
00001660  77 69 6e 64 6f 77 20 69  73 20 6f 70 65 6e 65 64  |window is opened|
00001670  20 6f 6e 20 74 68 65 20  73 63 72 65 65 6e 2c 20  | on the screen, |
00001680  74 68 65 20 73 63 72 65  65 6e 20 73 61 76 65 72  |the screen saver|
00001690  20 77 69 6c 6c 20 73 74  6f 70 20 61 6e 64 0a 72  | will stop and.r|
000016a0  65 74 75 72 6e 20 74 68  65 20 64 65 73 6b 74 6f  |eturn the deskto|
000016b0  70 20 74 6f 20 6e 6f 72  6d 61 6c 2e 0a 0a 57 68  |p to normal...Wh|
000016c0  65 6e 20 72 75 6e 6e 69  6e 67 20 6e 6f 6e 20 6d  |en running non m|
000016d0  75 6c 74 69 2d 74 61 73  6b 69 6e 67 20 61 70 70  |ulti-tasking app|
000016e0  6c 69 63 61 74 69 6f 6e  73 20 74 68 65 20 62 75  |lications the bu|
000016f0  69 6c 74 20 69 6e 20 73  63 72 65 65 6e 20 73 61  |ilt in screen sa|
00001700  76 65 72 20 6d 6f 64 75  6c 65 0a 77 69 6c 6c 20  |ver module.will |
00001710  74 61 6b 65 20 6f 76 65  72 20 73 63 72 65 65 6e  |take over screen|
00001720  20 73 61 76 69 6e 67 20  61 73 20 6e 6f 72 6d 61  | saving as norma|
00001730  6c 2e 0a 0a 59 61 73 73  20 32 20 74 72 69 65 73  |l...Yass 2 tries|
00001740  20 74 6f 20 6d 61 6b 65  20 61 73 20 6c 69 74 74  | to make as litt|
00001750  6c 65 20 69 6d 70 61 63  74 20 6f 6e 20 74 68 65  |le impact on the|
00001760  20 64 65 73 6b 74 6f 70  20 61 73 20 69 74 20 63  | desktop as it c|
00001770  61 6e 2e 20 57 68 65 6e  20 74 68 65 0a 73 63 72  |an. When the.scr|
00001780  65 65 6e 20 73 61 76 65  72 20 69 73 20 6e 6f 74  |een saver is not|
00001790  20 61 63 74 69 76 65 2c  20 59 61 73 73 20 32 20  | active, Yass 2 |
000017a0  63 68 65 63 6b 73 20 74  68 65 20 6b 65 79 62 6f  |checks the keybo|
000017b0  61 72 64 20 61 6e 64 20  6d 6f 75 73 65 20 6f 6e  |ard and mouse on|
000017c0  63 65 20 61 20 73 65 63  6f 6e 64 2e 0a 57 68 65  |ce a second..Whe|
000017d0  6e 20 72 75 6e 6e 69 6e  67 20 61 20 73 63 72 65  |n running a scre|
000017e0  65 6e 20 73 61 76 65 72  2c 20 59 61 73 73 20 32  |en saver, Yass 2|
000017f0  20 61 75 74 6f 6d 61 74  69 63 61 6c 6c 79 20 61  | automatically a|
00001800  64 6a 75 73 74 73 20 74  68 65 20 61 6d 6f 75 6e  |djusts the amoun|
00001810  74 20 6f 66 0a 43 50 55  20 74 69 6d 65 20 69 74  |t of.CPU time it|
00001820  20 74 61 6b 65 73 20 61  63 63 6f 72 64 69 6e 67  | takes according|
00001830  20 74 6f 20 74 68 65 20  67 65 6e 65 72 61 6c 20  | to the general |
00001840  6c 6f 61 64 20 6f 66 20  74 68 65 20 63 6f 6d 70  |load of the comp|
00001850  75 74 65 72 2c 20 74 68  65 20 68 69 67 68 65 72  |uter, the higher|
00001860  0a 74 68 65 20 6c 6f 61  64 20 74 68 65 20 6c 6f  |.the load the lo|
00001870  77 65 72 20 74 68 65 20  64 65 6d 61 6e 64 73 20  |wer the demands |
00001880  59 61 73 73 20 32 20 6d  61 6b 65 73 20 28 62 75  |Yass 2 makes (bu|
00001890  74 20 79 6f 75 72 20 64  69 73 70 6c 61 79 20 77  |t your display w|
000018a0  69 6c 6c 20 74 65 6e 64  20 74 6f 0a 67 72 69 6e  |ill tend to.grin|
000018b0  64 2c 20 62 75 74 20 79  6f 75 20 63 61 6e 27 74  |d, but you can't|
000018c0  20 68 61 76 65 20 61 6e  79 74 68 69 6e 67 29 2e  | have anything).|
000018d0  0a 0a 59 6f 75 20 63 61  6e 20 66 6f 72 63 65 20  |..You can force |
000018e0  59 61 73 73 20 32 20 74  6f 20 61 6c 77 61 79 73  |Yass 2 to always|
000018f0  20 75 73 65 20 73 6d 61  6c 6c 20 63 68 75 6e 6b  | use small chunk|
00001900  73 20 6f 66 20 43 50 55  20 74 69 6d 65 20 77 68  |s of CPU time wh|
00001910  65 6e 20 72 75 6e 6e 69  6e 67 20 61 0a 73 63 72  |en running a.scr|
00001920  65 65 6e 20 73 61 76 65  72 20 62 79 20 73 65 6c  |een saver by sel|
00001930  65 63 74 69 6e 67 20 74  68 65 20 27 53 6c 6f 77  |ecting the 'Slow|
00001940  27 20 6f 70 74 69 6f 6e  20 6f 6e 20 74 68 65 20  |' option on the |
00001950  73 74 61 74 75 73 20 6d  65 6e 75 2e 20 54 68 69  |status menu. Thi|
00001960  73 20 77 69 6c 6c 0a 66  6f 72 63 65 20 59 61 73  |s will.force Yas|
00001970  73 32 20 74 6f 20 72 75  6e 20 74 68 65 20 73 61  |s2 to run the sa|
00001980  76 65 72 20 6d 6f 64 75  6c 65 73 20 56 45 52 59  |ver modules VERY|
00001990  20 73 6c 6f 77 6c 79 2e  0a 0a 0a 43 72 65 61 74  | slowly....Creat|
000019a0  69 6e 67 20 79 6f 75 72  20 6f 77 6e 20 73 63 72  |ing your own scr|
000019b0  65 65 6e 20 73 61 76 65  72 20 6d 6f 64 75 6c 65  |een saver module|
000019c0  73 0a 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |s.--------------|
000019d0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
000019e0  2d 2d 2d 2d 2d 2d 2d 2d  0a 0a 43 72 65 61 74 69  |--------..Creati|
000019f0  6e 67 20 79 6f 75 72 20  6f 77 6e 20 64 69 73 70  |ng your own disp|
00001a00  6c 61 79 20 6d 6f 64 75  6c 65 73 20 66 6f 72 20  |lay modules for |
00001a10  74 68 65 20 73 63 72 65  65 6e 20 73 61 76 65 72  |the screen saver|
00001a20  20 69 73 20 76 65 72 79  20 73 69 6d 70 6c 65 2e  | is very simple.|
00001a30  20 41 6e 79 6f 6e 65 0a  77 69 74 68 20 61 20 66  | Anyone.with a f|
00001a40  61 69 72 6c 79 20 67 6f  6f 64 20 67 72 61 73 70  |airly good grasp|
00001a50  20 6f 66 20 42 61 73 69  63 20 63 61 6e 20 64 6f  | of Basic can do|
00001a60  20 69 74 2c 20 61 6e 64  20 6e 6f 20 6b 6e 6f 77  | it, and no know|
00001a70  6c 65 67 65 20 6f 66 20  57 69 6d 70 0a 70 72 6f  |lege of Wimp.pro|
00001a80  67 72 61 6d 6d 69 6e 67  20 69 73 20 72 65 71 75  |gramming is requ|
00001a90  69 72 65 64 2e 0a 0a 41  6c 6c 20 79 6f 75 20 6e  |ired...All you n|
00001aa0  65 65 64 20 74 6f 20 64  6f 20 69 73 20 63 72 65  |eed to do is cre|
00001ab0  61 74 65 20 79 6f 75 72  20 6f 77 6e 20 42 61 73  |ate your own Bas|
00001ac0  69 63 20 70 72 6f 67 72  61 6d 20 63 6f 6e 74 61  |ic program conta|
00001ad0  69 6e 69 6e 67 20 74 68  72 65 65 20 66 75 6e 63  |ining three func|
00001ae0  74 69 6f 6e 73 2e 0a 54  68 65 73 65 20 66 75 6e  |tions..These fun|
00001af0  63 74 69 6f 6e 73 20 77  69 6c 6c 20 62 65 20 63  |ctions will be c|
00001b00  61 6c 6c 65 64 20 62 79  20 59 61 73 73 20 32 20  |alled by Yass 2 |
00001b10  77 68 65 6e 20 6e 65 63  65 73 73 61 72 79 2e 20  |when necessary. |
00001b20  54 68 65 20 74 68 72 65  65 20 66 75 6e 63 74 69  |The three functi|
00001b30  6f 6e 73 0a 68 61 6e 64  6c 65 20 69 6e 69 74 69  |ons.handle initi|
00001b40  61 6c 69 73 61 74 69 6f  6e 2c 20 72 75 6e 6e 69  |alisation, runni|
00001b50  6e 67 20 74 68 65 20 73  61 76 65 72 2c 20 61 6e  |ng the saver, an|
00001b60  64 20 74 69 64 79 69 6e  67 20 75 70 2e 0a 0a 46  |d tidying up...F|
00001b70  69 72 73 74 20 79 6f 75  20 6e 65 65 64 20 74 6f  |irst you need to|
00001b80  20 70 69 63 6b 20 61 20  6e 61 6d 65 20 66 6f 72  | pick a name for|
00001b90  20 79 6f 75 72 20 73 61  76 65 72 20 6d 6f 64 75  | your saver modu|
00001ba0  6c 65 20 28 74 68 65 20  66 69 6c 65 6e 61 6d 65  |le (the filename|
00001bb0  29 2e 20 49 6e 20 74 68  65 0a 64 65 73 63 72 69  |). In the.descri|
00001bc0  70 74 69 6f 6e 20 62 65  6c 6f 77 20 77 65 20 61  |ption below we a|
00001bd0  72 65 20 63 72 65 61 74  69 6e 67 20 61 20 73 61  |re creating a sa|
00001be0  76 65 72 20 6d 6f 64 75  6c 65 20 63 61 6c 6c 65  |ver module calle|
00001bf0  64 20 27 54 65 73 74 27  20 77 68 69 63 68 20 77  |d 'Test' which w|
00001c00  69 6c 6c 20 64 72 61 77  0a 72 61 6e 64 6f 6d 20  |ill draw.random |
00001c10  6c 69 6e 65 73 20 6f 6e  20 74 68 65 20 73 63 72  |lines on the scr|
00001c20  65 65 6e 2e 0a 0a 0a 2d  20 49 6e 69 74 69 61 6c  |een....- Initial|
00001c30  69 73 61 74 69 6f 6e 0a  0a 44 75 72 69 6e 67 20  |isation..During |
00001c40  69 6e 69 74 69 61 6c 69  7a 61 74 69 6f 6e 20 79  |initialization y|
00001c50  6f 75 20 73 68 6f 75 6c  64 20 64 6f 20 74 68 65  |ou should do the|
00001c60  20 66 6f 6c 6c 6f 77 69  6e 67 20 3a 0a 0a 20 20  | following :..  |
00001c70  43 6c 65 61 72 20 74 68  65 20 73 63 72 65 65 6e  |Clear the screen|
00001c80  20 28 63 61 6c 6c 69 6e  67 20 50 52 4f 43 63 6c  | (calling PROCcl|
00001c90  65 61 72 73 63 72 65 65  6e 28 2d 31 29 20 29 0a  |earscreen(-1) ).|
00001ca0  20 20 49 6e 69 74 69 61  6c 69 7a 65 20 79 6f 75  |  Initialize you|
00001cb0  72 20 76 61 72 69 61 62  6c 65 73 2c 20 61 6e 64  |r variables, and|
00001cc0  20 63 6c 61 69 6d 20 61  6e 79 20 6d 65 6d 6f 72  | claim any memor|
00001cd0  79 20 79 6f 75 20 6e 65  65 64 2e 0a 0a 54 72 79  |y you need...Try|
00001ce0  20 74 6f 20 75 73 65 20  61 73 20 6d 61 6e 79 20  | to use as many |
00001cf0  4c 4f 43 41 4c 20 76 61  72 69 61 62 6c 65 73 20  |LOCAL variables |
00001d00  61 73 20 74 6f 75 20 63  61 6e 2c 20 61 6e 64 20  |as tou can, and |
00001d10  70 72 65 66 69 78 20 79  6f 75 72 20 67 6c 6f 62  |prefix your glob|
00001d20  61 6c 73 20 77 69 74 68  0a 79 6f 75 72 20 6d 6f  |als with.your mo|
00001d30  64 75 6c 65 73 20 6e 61  6d 65 20 28 65 67 2e 20  |dules name (eg. |
00001d40  74 65 73 74 5f 78 25 29  2e 0a 54 68 65 20 69 6e  |test_x%)..The in|
00001d50  69 74 69 61 6c 69 7a 61  74 69 6f 6e 20 66 75 6e  |itialization fun|
00001d60  63 74 69 6f 6e 20 73 68  6f 75 6c 64 20 62 65 20  |ction should be |
00001d70  67 69 76 65 6e 20 74 68  65 20 6e 61 6d 65 20 6f  |given the name o|
00001d80  66 20 79 6f 75 72 20 6d  6f 64 75 6c 65 20 66 6f  |f your module fo|
00001d90  6c 6c 6f 77 65 64 20 62  79 0a 27 5f 73 74 61 72  |llowed by.'_star|
00001da0  74 27 2c 20 66 6f 72 20  65 78 61 6d 70 6c 65 20  |t', for example |
00001db0  27 46 4e 74 65 73 74 5f  73 74 61 72 74 27 20 28  |'FNtest_start' (|
00001dc0  6e 6f 74 65 20 74 68 65  20 27 74 65 73 74 27 20  |note the 'test' |
00001dd0  69 73 20 61 6c 6c 20 69  6e 20 6c 6f 77 65 72 20  |is all in lower |
00001de0  63 61 73 65 29 2e 0a 0a  43 6c 61 69 6d 69 6e 67  |case)...Claiming|
00001df0  20 6d 65 6d 6f 72 79 20  73 68 6f 75 6c 64 20 4e  | memory should N|
00001e00  4f 54 20 75 73 65 20 74  68 65 20 44 49 4d 20 63  |OT use the DIM c|
00001e10  6f 6d 6d 61 6e 64 2e 20  49 6e 73 74 65 61 64 20  |ommand. Instead |
00001e20  79 6f 75 20 73 68 6f 75  6c 64 20 63 61 6c 6c 20  |you should call |
00001e30  61 0a 73 70 65 63 69 61  6c 20 66 75 6e 63 74 69  |a.special functi|
00001e40  6f 6e 20 63 61 6c 6c 65  64 20 46 4e 6d 61 6c 6c  |on called FNmall|
00001e50  6f 63 20 77 68 69 63 68  20 74 61 6b 65 73 20 74  |oc which takes t|
00001e60  68 65 20 6e 75 6d 62 65  72 20 6f 66 20 62 79 74  |he number of byt|
00001e70  65 73 20 79 6f 75 20 72  65 71 75 69 72 65 20 61  |es you require a|
00001e80  73 0a 69 74 27 73 20 70  61 72 61 6d 65 74 65 72  |s.it's parameter|
00001e90  2c 20 66 6f 72 20 65 73  61 6d 70 6c 65 20 22 74  |, for esample "t|
00001ea0  65 73 74 5f 62 25 20 3d  20 46 4e 6d 61 6c 6c 6f  |est_b% = FNmallo|
00001eb0  63 28 31 32 38 29 22 20  77 69 6c 6c 20 6d 61 6b  |c(128)" will mak|
00001ec0  65 20 74 65 73 74 5f 62  25 20 70 6f 69 6e 74 0a  |e test_b% point.|
00001ed0  74 6f 20 61 20 62 6c 6f  63 6b 20 6f 66 20 6d 65  |to a block of me|
00001ee0  6d 6f 72 79 20 31 32 38  20 62 79 74 65 73 20 6c  |mory 128 bytes l|
00001ef0  6f 6e 67 2e 20 46 4e 6d  61 6c 6c 6f 63 20 72 65  |ong. FNmalloc re|
00001f00  74 75 72 6e 73 20 7a 65  72 6f 20 69 66 20 6d 65  |turns zero if me|
00001f10  6d 6f 72 79 20 69 73 20  6e 6f 74 0a 61 76 61 69  |mory is not.avai|
00001f20  6c 61 62 6c 65 20 28 76  65 72 79 20 75 6e 6c 69  |lable (very unli|
00001f30  6b 65 6c 79 2c 20 62 75  74 20 79 6f 75 20 73 68  |kely, but you sh|
00001f40  6f 75 6c 64 20 68 61 6e  64 6c 65 20 74 68 69 73  |ould handle this|
00001f50  20 73 69 74 75 61 74 69  6f 6e 20 28 73 65 65 20  | situation (see |
00001f60  62 65 6c 6f 77 29 29 2e  0a 0a 54 68 65 20 69 6e  |below))...The in|
00001f70  69 74 69 61 6c 69 7a 61  74 69 6f 6e 20 66 75 6e  |itialization fun|
00001f80  63 74 69 6f 6e 20 73 68  6f 75 6c 64 20 72 65 74  |ction should ret|
00001f90  75 72 6e 20 30 20 69 66  20 69 74 20 6d 61 6e 61  |urn 0 if it mana|
00001fa0  67 65 64 20 74 6f 20 69  6e 69 74 69 61 6c 69 7a  |ged to initializ|
00001fb0  65 0a 63 6f 72 72 65 63  6c 79 2e 20 49 66 20 69  |e.correcly. If i|
00001fc0  74 20 63 6f 75 6c 64 20  6e 6f 74 20 69 6e 69 74  |t could not init|
00001fd0  69 61 6c 69 7a 65 20 63  6f 72 72 65 63 74 6c 79  |ialize correctly|
00001fe0  20 69 74 20 73 68 6f 75  6c 64 20 66 69 72 73 74  | it should first|
00001ff0  20 64 65 61 6c 6c 6f 63  61 74 65 20 61 6e 79 0a  | deallocate any.|
00002000  6d 65 6d 6f 72 79 20 69  74 20 77 61 73 20 61 6c  |memory it was al|
00002010  6c 6f 63 61 74 65 64 20  28 70 61 73 73 20 69 74  |located (pass it|
00002020  20 74 6f 20 61 20 70 72  6f 63 65 64 75 72 65 20  | to a procedure |
00002030  50 52 4f 43 66 72 65 65  2c 20 65 67 2e 0a 50 52  |PROCfree, eg..PR|
00002040  4f 43 66 72 65 65 28 74  65 73 74 5f 62 25 29 29  |OCfree(test_b%))|
00002050  20 61 6e 64 20 74 68 65  6e 20 72 65 74 75 72 6e  | and then return|
00002060  20 54 52 55 45 2e 0a 0a  49 66 20 74 68 65 20 69  | TRUE...If the i|
00002070  6e 69 74 69 61 6c 69 7a  61 74 69 6f 6e 20 66 69  |nitialization fi|
00002080  6e 63 74 69 6f 6e 20 72  65 74 75 72 6e 73 20 74  |nction returns t|
00002090  68 65 20 6e 75 6d 62 65  72 20 31 2c 20 59 61 73  |he number 1, Yas|
000020a0  73 20 32 20 77 69 6c 6c  20 65 6e 73 75 72 65 20  |s 2 will ensure |
000020b0  74 68 61 74 0a 74 68 65  20 64 65 73 6b 74 6f 70  |that.the desktop|
000020c0  20 69 73 20 64 69 73 70  6c 61 79 65 64 20 62 65  | is displayed be|
000020d0  66 6f 72 65 20 63 61 6c  6c 69 6e 67 20 74 68 65  |fore calling the|
000020e0  20 70 6f 6c 6c 20 66 75  6e 63 74 69 6f 6e 20 28  | poll function (|
000020f0  73 65 65 20 62 65 6c 6f  77 29 2e 0a 54 68 69 73  |see below)..This|
00002100  20 6d 65 61 6e 73 20 74  68 61 74 20 79 6f 75 20  | means that you |
00002110  63 61 6e 20 77 72 69 74  65 20 73 61 76 65 72 73  |can write savers|
00002120  20 74 68 61 74 20 75 73  65 20 74 68 65 20 64 65  | that use the de|
00002130  73 6b 74 6f 70 20 61 73  20 61 20 73 74 61 72 74  |sktop as a start|
00002140  69 6e 67 20 70 6f 69 6e  74 2c 0a 66 6f 72 20 65  |ing point,.for e|
00002150  78 61 6d 70 6c 65 20 6d  65 6c 74 69 6e 67 20 74  |xample melting t|
00002160  68 65 20 64 65 73 6b 74  6f 70 2c 20 65 74 63 2e  |he desktop, etc.|
00002170  0a 0a 50 6c 65 61 73 65  20 6e 6f 74 65 20 74 68  |..Please note th|
00002180  61 74 20 79 6f 75 72 20  73 63 72 65 65 6e 20 73  |at your screen s|
00002190  61 76 65 72 20 73 68 6f  75 6c 64 20 62 65 20 61  |aver should be a|
000021a0  62 6c 65 20 74 6f 20 72  75 6e 20 69 6e 20 61 6e  |ble to run in an|
000021b0  79 20 6d 6f 64 65 20 28  69 74 20 6d 75 73 74 0a  |y mode (it must.|
000021c0  75 6e 64 65 72 20 6e 6f  20 63 69 72 63 75 6d 73  |under no circums|
000021d0  74 61 6e 63 65 73 20 63  68 61 6e 67 65 20 6d 6f  |tances change mo|
000021e0  64 65 20 69 74 73 65 6c  66 29 2e 20 48 6f 77 65  |de itself). Howe|
000021f0  76 65 72 20 79 6f 75 20  6d 61 79 20 77 69 73 68  |ver you may wish|
00002200  20 74 6f 20 77 72 69 74  65 20 61 0a 6d 6f 64 75  | to write a.modu|
00002210  6c 65 20 74 68 61 74 20  6f 6e 6c 79 20 77 6f 72  |le that only wor|
00002220  6b 73 20 69 6e 2c 20 73  61 79 2c 20 31 36 20 63  |ks in, say, 16 c|
00002230  6f 6c 6f 75 72 20 6d 6f  64 65 73 2e 20 49 66 20  |olour modes. If |
00002240  74 68 69 73 20 69 73 20  74 68 65 20 63 61 73 65  |this is the case|
00002250  20 74 68 65 6e 20 74 68  65 0a 69 6e 69 74 69 61  | then the.initia|
00002260  6c 69 7a 61 74 69 6f 6e  20 63 6f 64 65 20 73 68  |lization code sh|
00002270  6f 75 6c 64 20 66 69 72  73 74 20 63 68 65 63 6b  |ould first check|
00002280  20 74 68 65 20 76 61 6c  75 65 20 6f 66 20 6d 61  | the value of ma|
00002290  78 5f 63 25 20 28 77 68  69 63 68 20 69 73 20 73  |x_c% (which is s|
000022a0  65 74 20 75 70 20 62 79  0a 59 61 73 73 20 32 29  |et up by.Yass 2)|
000022b0  20 77 68 69 63 68 20 63  6f 6e 74 61 69 6e 73 20  | which contains |
000022c0  74 68 65 20 6e 75 6d 62  65 72 20 6f 66 20 63 6f  |the number of co|
000022d0  6c 6f 75 72 73 20 69 6e  20 74 68 65 20 63 75 72  |lours in the cur|
000022e0  72 65 6e 74 20 6d 6f 64  65 2e 20 49 66 20 74 68  |rent mode. If th|
000022f0  69 73 0a 6e 75 6d 62 65  72 20 69 73 20 6e 6f 20  |is.number is no |
00002300  67 6f 6f 64 20 66 6f 72  20 74 68 65 20 6d 6f 64  |good for the mod|
00002310  75 6c 65 2c 20 74 68 65  20 66 75 6e 63 74 69 6f  |ule, the functio|
00002320  6e 20 73 68 6f 75 6c 64  20 6a 75 73 74 20 72 65  |n should just re|
00002330  74 75 72 6e 20 54 52 55  45 20 28 69 65 2e 0a 73  |turn TRUE (ie..s|
00002340  69 67 6e 61 6c 20 74 68  61 74 20 69 6e 69 74 69  |ignal that initi|
00002350  61 6c 69 7a 61 74 69 6f  6e 20 68 61 73 20 66 61  |alization has fa|
00002360  69 6c 65 64 29 2e 0a 0a  4e 6f 77 20 69 6e 20 6f  |iled)...Now in o|
00002370  75 72 20 65 78 61 6d 70  6c 65 20 6d 6f 64 75 6c  |ur example modul|
00002380  65 2c 20 69 6e 69 74 69  61 6c 69 7a 61 74 69 6f  |e, initializatio|
00002390  6e 20 69 73 20 66 61 69  72 6c 79 20 73 69 6d 70  |n is fairly simp|
000023a0  6c 65 20 3a 0a 0a 44 45  46 46 4e 74 65 73 74 5f  |le :..DEFFNtest_|
000023b0  73 74 61 72 74 0a 50 52  4f 43 63 6c 65 61 72 5f  |start.PROCclear_|
000023c0  73 63 72 65 65 6e 28 2d  31 29 0a 3d 30 0a 0a 0a  |screen(-1).=0...|
000023d0  2d 20 52 75 6e 6e 69 6e  67 20 74 68 65 20 73 61  |- Running the sa|
000023e0  76 65 72 0a 0a 54 68 65  20 6e 65 78 74 20 66 75  |ver..The next fu|
000023f0  6e 63 74 69 6f 6e 20 69  73 20 63 61 6c 6c 65 64  |nction is called|
00002400  20 72 65 70 65 61 74 65  64 6c 79 2c 20 61 6e 64  | repeatedly, and|
00002410  20 69 74 20 73 68 6f 75  6c 64 20 75 70 64 61 74  | it should updat|
00002420  65 20 74 68 65 20 64 69  73 70 6c 61 79 20 62 79  |e the display by|
00002430  20 61 0a 73 6d 61 6c 6c  20 61 6d 6f 75 6e 74 20  | a.small amount |
00002440  65 61 63 68 20 74 69 6d  65 20 28 69 6e 20 6f 75  |each time (in ou|
00002450  72 20 65 78 61 6d 70 6c  65 20 77 65 20 77 69 6c  |r example we wil|
00002460  6c 20 64 72 61 77 20 61  20 73 69 6e 67 6c 65 20  |l draw a single |
00002470  6c 69 6e 65 29 2e 0a 0a  54 68 65 20 66 75 6e 63  |line)...The func|
00002480  74 69 6f 6e 20 73 68 6f  75 6c 64 20 62 65 20 63  |tion should be c|
00002490  61 6c 6c 65 64 20 74 68  65 20 6e 61 6d 65 20 6f  |alled the name o|
000024a0  66 20 79 6f 75 72 20 6d  6f 64 75 6c 65 20 66 6f  |f your module fo|
000024b0  6c 6c 6f 77 65 64 20 62  79 20 5f 70 6f 6c 6c 2c  |llowed by _poll,|
000024c0  20 65 67 2e 0a 46 4e 74  65 73 74 5f 70 6f 6c 6c  | eg..FNtest_poll|
000024d0  2e 0a 0a 54 68 69 73 20  66 75 6e 63 74 69 6f 6e  |...This function|
000024e0  20 73 68 6f 75 6c 64 20  61 6c 73 6f 20 64 65 74  | should also det|
000024f0  65 72 6d 69 6e 20 77 68  65 74 68 65 72 20 6f 72  |ermin whether or|
00002500  20 6e 6f 74 20 69 74 20  67 68 61 73 20 72 75 6e  | not it ghas run|
00002510  20 66 6f 72 20 6c 6f 6e  67 20 65 6e 6f 75 67 68  | for long enough|
00002520  2e 0a 54 68 69 73 20 6d  61 79 20 62 65 20 64 65  |..This may be de|
00002530  74 65 72 6d 69 6e 65 64  20 62 79 20 77 68 61 74  |termined by what|
00002540  20 74 68 65 20 6d 6f 64  75 6c 65 20 64 6f 65 73  | the module does|
00002550  20 28 69 65 2e 20 74 68  65 20 64 69 73 70 6c 61  | (ie. the displa|
00002560  79 20 6d 61 79 20 68 61  76 65 20 61 0a 64 65 66  |y may have a.def|
00002570  69 6e 65 64 20 65 6e 64  29 2c 20 6f 72 20 79 6f  |ined end), or yo|
00002580  75 20 6d 61 79 20 73 69  6d 70 6c 79 20 73 65 74  |u may simply set|
00002590  20 61 20 74 69 6d 65 20  6c 69 6d 69 74 20 6f 6e  | a time limit on|
000025a0  20 74 68 65 20 6d 6f 64  75 6c 65 2e 20 54 4f 20  | the module. TO |
000025b0  68 65 6c 70 20 77 69 74  68 0a 74 68 65 20 6c 61  |help with.the la|
000025c0  74 74 65 72 20 63 61 73  65 2c 20 59 61 73 73 20  |tter case, Yass |
000025d0  32 20 73 65 74 73 20 61  20 76 61 72 69 61 62 6c  |2 sets a variabl|
000025e0  65 20 6e 6f 77 5f 67 6f  69 6e 67 25 20 77 68 69  |e now_going% whi|
000025f0  63 68 20 63 6f 6e 74 61  69 6e 73 20 74 68 65 20  |ch contains the |
00002600  6e 75 6d 62 65 72 20 6f  66 0a 31 2f 31 30 30 74  |number of.1/100t|
00002610  68 73 20 6f 66 20 61 20  73 65 63 6f 6e 64 20 74  |hs of a second t|
00002620  68 65 20 73 61 76 65 72  20 68 61 73 20 62 65 65  |he saver has bee|
00002630  6e 20 72 75 6e 6e 69 6e  67 2e 0a 0a 54 68 65 20  |n running...The |
00002640  66 75 6e 63 74 69 6f 6e  20 73 68 6f 75 6c 64 20  |function should |
00002650  6e 6f 72 6d 61 6c 6c 79  20 72 65 74 75 72 6e 20  |normally return |
00002660  30 2c 20 62 75 74 20 77  68 65 6e 20 69 74 20 64  |0, but when it d|
00002670  65 63 69 64 65 73 20 74  6f 20 73 74 6f 70 20 69  |ecides to stop i|
00002680  74 20 73 68 6f 75 6c 64  0a 72 65 74 75 72 6e 20  |t should.return |
00002690  54 52 55 45 2e 20 49 64  65 61 6c 6c 79 20 65 61  |TRUE. Ideally ea|
000026a0  63 68 20 73 61 76 65 72  20 73 68 6f 75 6c 64 20  |ch saver should |
000026b0  72 75 6e 20 66 6f 72 20  73 6f 6d 65 77 68 65 72  |run for somewher|
000026c0  65 20 62 65 74 77 65 65  6e 20 32 20 61 6e 64 20  |e between 2 and |
000026d0  35 0a 6d 69 6e 75 74 65  73 2e 20 52 65 74 75 72  |5.minutes. Retur|
000026e0  6e 69 6e 67 20 61 20 76  61 6c 75 65 20 6f 66 20  |ning a value of |
000026f0  31 20 77 69 6c 6c 20 66  6f 72 63 65 20 74 68 65  |1 will force the|
00002700  20 27 70 6f 6c 6c 27 20  72 6f 75 74 69 6e 65 20  | 'poll' routine |
00002710  74 6f 20 62 65 20 63 61  6c 6c 65 64 0a 6c 65 73  |to be called.les|
00002720  73 20 66 72 65 71 75 65  6e 74 6c 79 2c 20 74 68  |s frequently, th|
00002730  75 73 20 73 6c 6f 77 69  6e 67 20 69 74 20 64 6f  |us slowing it do|
00002740  77 6e 2e 20 54 68 69 73  20 69 73 20 75 73 65 66  |wn. This is usef|
00002750  75 6c 20 66 6f 72 20 73  61 76 65 72 20 72 6f 75  |ul for saver rou|
00002760  74 69 6e 65 73 0a 6c 69  6b 65 20 74 68 65 20 73  |tines.like the s|
00002770  75 70 70 6c 69 65 64 20  27 74 69 6d 65 27 20 61  |upplied 'time' a|
00002780  6e 64 20 27 63 6c 6f 63  6b 27 20 73 61 76 65 72  |nd 'clock' saver|
00002790  20 6d 6f 64 75 6c 65 73  2c 20 77 68 69 63 68 20  | modules, which |
000027a0  6f 6e 6c 79 20 61 63 74  20 6f 6e 63 65 20 61 0a  |only act once a.|
000027b0  73 65 63 6f 6e 64 2e 0a  0a 49 6e 20 6f 75 72 20  |second...In our |
000027c0  63 61 73 65 20 77 65 20  77 69 6c 6c 20 76 6f 6c  |case we will vol|
000027d0  75 6e 74 65 65 72 20 74  6f 20 73 74 6f 70 20 61  |unteer to stop a|
000027e0  66 74 65 72 20 32 20 6d  69 6e 75 74 65 73 2e 0a  |fter 2 minutes..|
000027f0  0a 44 45 46 46 4e 74 65  73 74 5f 70 6f 6c 6c 0a  |.DEFFNtest_poll.|
00002800  50 52 4f 43 73 65 74 5f  63 6f 6c 6f 75 72 28 30  |PROCset_colour(0|
00002810  2c 52 4e 44 28 31 36 29  2d 31 29 0a 4d 4f 56 45  |,RND(16)-1).MOVE|
00002820  20 52 4e 44 28 6d 61 78  5f 78 25 29 2d 31 2c 52  | RND(max_x%)-1,R|
00002830  4e 44 28 6d 61 78 5f 79  25 29 2d 31 3a 44 52 41  |ND(max_y%)-1:DRA|
00002840  57 20 52 4e 44 28 6d 61  78 5f 78 25 29 2d 31 2c  |W RND(max_x%)-1,|
00002850  52 4e 44 28 6d 61 78 5f  79 25 29 2d 31 0a 49 46  |RND(max_y%)-1.IF|
00002860  20 6e 6f 77 5f 67 6f 69  6e 67 25 3e 31 32 30 30  | now_going%>1200|
00002870  30 20 54 48 45 4e 20 3d  54 52 55 45 0a 3d 30 0a  |0 THEN =TRUE.=0.|
00002880  0a 0a 2d 20 54 69 64 79  69 6e 67 20 75 70 0a 0a  |..- Tidying up..|
00002890  54 68 69 73 20 66 75 6e  63 74 69 6f 6e 20 69 73  |This function is|
000028a0  20 63 61 6c 6c 65 64 20  77 68 65 6e 20 79 6f 75  | called when you|
000028b0  72 20 73 61 76 65 72 20  6d 6f 64 75 6c 65 20 69  |r saver module i|
000028c0  73 20 62 65 69 6e 67 20  73 74 6f 70 70 65 64 2e  |s being stopped.|
000028d0  20 49 74 20 73 68 6f 75  6c 64 20 74 68 75 73 0a  | It should thus.|
000028e0  64 65 61 6c 6c 6f 63 61  74 65 20 61 6e 79 20 6d  |deallocate any m|
000028f0  65 6d 6f 72 79 20 69 74  20 61 6c 6c 6f 63 61 74  |emory it allocat|
00002900  65 64 2c 20 61 6e 64 20  70 65 72 66 6f 72 6d 20  |ed, and perform |
00002910  61 6e 79 20 6f 74 68 65  72 20 74 69 64 79 69 6e  |any other tidyin|
00002920  67 20 75 70 20 6f 70 65  72 61 74 69 6f 6e 73 0a  |g up operations.|
00002930  6e 65 63 65 73 73 61 72  79 2e 0a 0a 41 66 74 65  |necessary...Afte|
00002940  72 20 74 79 64 79 69 6e  67 20 74 68 65 20 66 75  |r tydying the fu|
00002950  6e 63 74 69 6f 6e 20 73  68 6f 75 6c 64 20 72 65  |nction should re|
00002960  74 75 72 6e 20 30 2e 0a  0a 49 6e 20 6f 75 72 20  |turn 0...In our |
00002970  65 78 61 6d 70 6c 65 2c  20 74 68 65 20 66 75 6e  |example, the fun|
00002980  63 74 69 6f 6e 20 6e 65  65 64 20 64 6f 20 6e 6f  |ction need do no|
00002990  74 68 69 6e 67 20 3a 0a  0a 44 45 46 46 4e 74 65  |thing :..DEFFNte|
000029a0  73 74 5f 73 74 6f 70 0a  3d 30 0a 0a 0a 0a 49 6e  |st_stop.=0....In|
000029b0  20 65 61 63 68 20 6f 66  20 74 68 65 20 61 62 6f  | each of the abo|
000029c0  76 65 20 74 68 65 72 65  20 61 72 65 20 73 65 76  |ve there are sev|
000029d0  65 72 61 6c 20 70 72 6f  63 65 64 75 72 65 73 20  |eral procedures |
000029e0  61 6e 64 20 76 61 72 69  61 62 6c 65 73 20 61 76  |and variables av|
000029f0  61 69 6c 61 62 6c 65 20  3a 0a 0a 20 46 4e 6d 61  |ailable :.. FNma|
00002a00  6c 6c 6f 63 28 73 69 7a  65 29 20 20 20 20 20 20  |lloc(size)      |
00002a10  2d 20 20 52 65 74 75 72  6e 73 20 61 20 70 6f 69  |-  Returns a poi|
00002a20  6e 74 65 72 20 74 6f 20  61 20 62 6c 6f 63 6b 20  |nter to a block |
00002a30  6f 66 20 6d 65 6d 6f 72  79 20 61 74 20 6c 65 61  |of memory at lea|
00002a40  73 74 20 27 73 69 7a 65  27 0a 20 20 20 20 20 20  |st 'size'.      |
00002a50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002a60  20 20 62 79 74 65 73 20  6c 6f 6e 67 2e 20 49 66  |  bytes long. If|
00002a70  20 69 74 20 72 65 74 75  72 6e 73 20 30 20 74 68  | it returns 0 th|
00002a80  65 20 6d 65 6d 6f 72 79  20 77 61 73 20 6e 6f 74  |e memory was not|
00002a90  20 61 76 61 69 6c 61 62  6c 65 0a 20 20 20 20 20  | available.     |
00002aa0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002ab0  0a 20 50 52 4f 43 66 72  65 65 28 70 74 72 29 20  |. PROCfree(ptr) |
00002ac0  20 20 20 20 20 20 2d 20  20 44 65 61 6c 6c 6f 63  |      -  Dealloc|
00002ad0  61 74 65 73 20 74 68 65  20 6d 65 6d 6f 72 79 20  |ates the memory |
00002ae0  70 6f 69 6e 74 65 64 20  74 6f 20 62 79 20 27 70  |pointed to by 'p|
00002af0  74 72 27 2e 20 27 70 74  72 27 20 6d 75 73 74 0a  |tr'. 'ptr' must.|
00002b00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002b10  20 20 20 20 20 20 20 20  62 65 20 61 20 76 61 6c  |        be a val|
00002b20  75 65 20 72 65 74 75 72  6e 65 64 20 62 79 20 46  |ue returned by F|
00002b30  4e 6d 61 6c 6c 6f 63 2e  0a 0a 20 50 52 4f 43 73  |Nmalloc... PROCs|
00002b40  65 74 5f 63 6f 6c 6f 75  72 28 67 2c 63 29 20 2d  |et_colour(g,c) -|
00002b50  20 20 53 65 74 73 20 74  68 65 20 63 75 72 72 65  |  Sets the curre|
00002b60  6e 74 20 63 6f 6c 6f 75  72 20 74 6f 20 74 68 65  |nt colour to the|
00002b70  20 67 69 76 65 6e 20 57  69 6d 70 20 63 6f 6c 6f  | given Wimp colo|
00002b80  75 72 20 28 30 2d 31 35  29 2e 0a 20 20 20 20 20  |ur (0-15)..     |
00002b90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002ba0  20 20 20 50 61 72 61 6d  65 74 65 72 73 20 61 73  |   Parameters as|
00002bb0  20 66 6f 72 20 47 43 4f  4c 2e 0a 0a 20 50 52 4f  | for GCOL... PRO|
00002bc0  43 63 6c 65 61 72 73 63  72 65 65 6e 28 72 29 20  |Cclearscreen(r) |
00002bd0  20 2d 20 20 43 6c 65 61  72 73 20 74 68 65 20 73  | -  Clears the s|
00002be0  63 72 65 65 6e 2e 20 27  72 27 20 73 68 6f 75 6c  |creen. 'r' shoul|
00002bf0  64 20 62 65 20 2d 31 2e  0a 0a 20 6d 61 78 5f 78  |d be -1... max_x|
00002c00  25 20 20 20 20 20 20 20  20 20 20 20 20 20 20 2d  |%              -|
00002c10  20 20 47 69 76 65 73 20  74 68 65 20 6d 61 78 20  |  Gives the max |
00002c20  78 20 63 6f 6f 72 64 69  6e 61 74 65 20 6f 66 20  |x coordinate of |
00002c30  74 68 65 20 73 63 72 65  65 6e 2e 0a 0a 20 6d 61  |the screen... ma|
00002c40  78 5f 79 25 20 20 20 20  20 20 20 20 20 20 20 20  |x_y%            |
00002c50  20 20 2d 20 20 47 69 76  65 73 20 74 68 65 20 6d  |  -  Gives the m|
00002c60  61 78 20 79 20 63 6f 6f  72 64 69 6e 61 74 65 20  |ax y coordinate |
00002c70  6f 66 20 74 68 65 20 73  63 72 65 65 6e 2e 0a 0a  |of the screen...|
00002c80  20 6d 61 78 5f 63 25 20  20 20 20 20 20 20 20 20  | max_c%         |
00002c90  20 20 20 20 20 2d 20 20  47 69 76 65 73 20 74 68  |     -  Gives th|
00002ca0  65 20 6e 75 6d 62 65 72  20 6f 66 20 63 6f 6c 6f  |e number of colo|
00002cb0  75 72 73 20 66 6f 72 20  74 68 65 20 63 75 72 72  |urs for the curr|
00002cc0  65 6e 74 20 73 63 72 65  65 6e 2e 0a 20 20 20 20  |ent screen..    |
00002cd0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002ce0  20 20 20 20 28 69 65 2e  20 31 2c 20 33 2c 20 31  |    (ie. 1, 3, 1|
00002cf0  35 20 6f 72 20 36 33 29  0a 0a 20 6e 6f 77 5f 67  |5 or 63).. now_g|
00002d00  6f 69 6e 67 25 20 20 20  20 20 20 20 20 20 20 2d  |oing%          -|
00002d10  20 20 4e 75 6d 62 65 72  20 6f 66 20 63 65 6e 74  |  Number of cent|
00002d20  69 73 65 63 6f 6e 64 73  20 74 68 65 20 63 75 72  |iseconds the cur|
00002d30  72 65 6e 74 20 73 61 76  65 72 20 68 61 73 20 62  |rent saver has b|
00002d40  65 65 6e 0a 20 20 20 20  20 20 20 20 20 20 20 20  |een.            |
00002d50  20 20 20 20 20 20 20 20  20 20 20 20 72 75 6e 6e  |            runn|
00002d60  69 6e 67 2e 0a 0a 0a 41  20 42 61 73 69 63 20 70  |ing....A Basic p|
00002d70  72 6f 67 72 61 6d 20 63  61 6c 6c 65 64 20 27 53  |rogram called 'S|
00002d80  68 65 6c 6c 27 20 69 73  20 73 75 70 70 6c 69 65  |hell' is supplie|
00002d90  64 20 77 69 74 68 20 74  68 69 73 20 61 70 70 6c  |d with this appl|
00002da0  69 63 61 74 69 6f 6e 20  77 68 69 63 68 20 63 6f  |ication which co|
00002db0  6e 74 61 69 6e 73 0a 61  20 64 65 76 65 6c 6f 70  |ntains.a develop|
00002dc0  65 6d 65 6e 74 20 65 6e  76 69 72 6f 6e 6d 65 6e  |ement environmen|
00002dd0  74 20 66 6f 72 20 74 65  73 74 69 6e 67 20 6e 65  |t for testing ne|
00002de0  77 20 6d 6f 64 75 6c 65  73 2e 20 41 64 64 20 79  |w modules. Add y|
00002df0  6f 75 72 20 66 75 6e 63  74 69 6f 6e 73 20 74 6f  |our functions to|
00002e00  20 74 68 65 0a 61 6e 64  20 6f 66 20 74 68 65 20  | the.and of the |
00002e10  70 72 6f 67 72 61 6d 2c  20 77 68 69 63 68 20 73  |program, which s|
00002e20  75 70 70 6c 69 65 73 20  73 69 6d 75 6c 61 74 65  |upplies simulate|
00002e30  64 20 76 65 72 73 69 6f  6e 73 20 6f 66 20 61 6c  |d versions of al|
00002e40  6c 20 74 68 65 20 61 62  6f 76 65 0a 70 72 6f 63  |l the above.proc|
00002e50  65 64 75 72 65 73 20 61  6e 64 20 76 61 72 69 61  |edures and varia|
00002e60  62 6c 65 73 2e 0a 0a 53  65 74 20 74 68 65 20 27  |bles...Set the '|
00002e70  6d 6f 64 75 6c 65 24 27  20 76 61 72 69 61 62 6c  |module$' variabl|
00002e80  65 20 61 74 20 74 68 65  20 73 74 61 72 74 20 6f  |e at the start o|
00002e90  66 20 74 68 69 73 20 70  72 6f 67 72 61 6d 20 74  |f this program t|
00002ea0  6f 20 63 6f 6e 74 61 69  6e 20 74 68 65 20 6e 61  |o contain the na|
00002eb0  6d 65 20 6f 66 0a 74 68  65 20 6d 6f 64 75 6c 65  |me of.the module|
00002ec0  20 28 69 65 2e 20 22 74  65 73 74 22 20 69 6e 20  | (ie. "test" in |
00002ed0  74 68 65 20 61 62 6f 76  65 29 2e 0a 0a 0a 49 66  |the above)....If|
00002ee0  20 79 6f 75 72 20 73 63  72 65 65 6e 20 73 61 76  | your screen sav|
00002ef0  65 72 20 6e 65 65 64 73  20 6d 6f 72 65 20 74 68  |er needs more th|
00002f00  61 6e 20 6f 6e 65 20 66  69 6c 65 20 28 66 6f 72  |an one file (for|
00002f10  20 65 78 61 6d 70 6c 65  20 69 74 20 68 61 73 20  | example it has |
00002f20  73 6f 6d 65 20 73 70 72  69 74 65 73 2c 0a 65 74  |some sprites,.et|
00002f30  63 2e 29 20 74 68 65 6e  20 79 6f 75 20 73 68 6f  |c.) then you sho|
00002f40  75 6c 64 20 70 6c 61 63  65 20 61 6e 79 20 65 78  |uld place any ex|
00002f50  74 72 61 20 66 69 6c 65  73 20 69 6e 20 74 68 65  |tra files in the|
00002f60  20 27 52 65 73 6f 75 72  63 65 73 27 20 64 69 72  | 'Resources' dir|
00002f70  65 63 74 6f 72 79 0a 28  3c 59 61 73 73 32 24 44  |ectory.(<Yass2$D|
00002f80  69 72 3e 2e 52 65 73 6f  75 72 63 65 73 29 2e 20  |ir>.Resources). |
00002f90  49 66 20 74 68 65 72 65  20 69 73 20 6f 6e 65 20  |If there is one |
00002fa0  65 78 74 72 61 20 66 69  6c 65 20 6e 65 65 64 65  |extra file neede|
00002fb0  64 20 74 68 69 73 20 73  68 6f 75 6c 64 20 62 65  |d this should be|
00002fc0  0a 67 69 76 65 6e 20 74  68 65 20 73 61 6d 65 20  |.given the same |
00002fd0  6e 61 6d 65 20 61 73 20  74 68 65 20 73 61 76 65  |name as the save|
00002fe0  72 20 6d 6f 64 75 6c 65  20 28 74 6f 20 61 76 6f  |r module (to avo|
00002ff0  69 64 20 70 72 6f 62 6c  65 6d 73 20 6c 61 74 65  |id problems late|
00003000  72 20 6f 6e 29 2e 20 49  66 20 74 68 65 72 65 0a  |r on). If there.|
00003010  61 72 65 20 6d 6f 72 65  20 66 69 6c 65 73 20 6e  |are more files n|
00003020  65 65 64 65 64 20 79 6f  75 20 73 68 6f 75 6c 64  |eeded you should|
00003030  20 63 72 65 61 74 65 20  61 20 64 69 72 65 63 74  | create a direct|
00003040  6f 72 79 20 28 6e 61 6d  65 20 61 73 20 73 61 76  |ory (name as sav|
00003050  65 72 20 6d 6f 64 75 6c  65 29 0a 69 6e 20 74 68  |er module).in th|
00003060  65 20 72 65 73 6f 75 72  63 65 73 20 64 69 72 65  |e resources dire|
00003070  63 74 6f 72 79 2c 20 61  6e 64 20 70 6c 61 63 65  |ctory, and place|
00003080  20 74 68 65 20 66 69 6c  65 73 20 69 6e 20 74 68  | the files in th|
00003090  61 74 20 64 69 72 65 63  74 6f 72 79 2e 20 0a 0a  |at directory. ..|
000030a0  0a 4f 74 68 65 72 20 59  61 73 73 20 66 75 6e 63  |.Other Yass func|
000030b0  74 69 6f 6e 73 0a 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |tions.----------|
000030c0  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 0a 0a 59 61 73 73  |----------..Yass|
000030d0  32 20 70 65 72 66 6f 72  6d 73 20 73 65 76 65 72  |2 performs sever|
000030e0  61 6c 20 6f 74 68 65 72  20 75 73 65 66 75 6c 20  |al other useful |
000030f0  66 75 6e 63 74 69 6f 6e  73 2e 20 54 68 65 20 66  |functions. The f|
00003100  69 72 73 74 20 6f 66 20  74 68 65 73 65 20 69 73  |irst of these is|
00003110  20 74 68 65 0a 61 62 69  6c 69 74 79 20 74 6f 20  | the.ability to |
00003120  73 65 74 20 74 68 65 20  73 74 61 74 65 20 6f 6e  |set the state on|
00003130  20 6f 66 20 74 68 65 20  69 6e 74 65 72 6e 61 6c  | of the internal|
00003140  20 73 70 65 61 6b 65 72  2c 20 61 6e 64 20 69 74  | speaker, and it|
00003150  27 73 20 76 6f 6c 75 6d  65 2e 20 54 68 69 73 0a  |'s volume. This.|
00003160  63 61 6e 20 62 65 20 64  6f 6e 65 20 62 79 20 63  |can be done by c|
00003170  6c 69 63 6b 69 6e 67 20  41 44 4a 55 53 54 20 6f  |licking ADJUST o|
00003180  6e 20 59 61 73 73 32 27  73 20 69 63 6f 6e 62 61  |n Yass2's iconba|
00003190  72 20 69 63 6f 6e 2e 20  54 68 69 73 20 62 72 69  |r icon. This bri|
000031a0  6e 67 73 20 75 70 20 61  20 77 69 6e 64 6f 77 0a  |ngs up a window.|
000031b0  77 68 69 63 68 20 63 6f  6e 74 61 69 6e 73 20 32  |which contains 2|
000031c0  20 73 65 63 74 69 6f 6e  73 2c 20 74 68 65 20 66  | sections, the f|
000031d0  69 72 73 74 20 69 6e 66  6f 72 6d 73 20 79 6f 75  |irst informs you|
000031e0  20 61 20 62 69 74 20 61  62 6f 75 74 20 59 61 73  | a bit about Yas|
000031f0  73 20 32 27 73 20 73 74  61 74 65 0a 28 6e 75 6d  |s 2's state.(num|
00003200  62 65 72 20 6f 66 20 73  61 76 65 72 73 2c 20 6e  |ber of savers, n|
00003210  75 6d 62 65 72 20 63 75  72 72 65 6e 74 6c 79 20  |umber currently |
00003220  73 65 6c 65 63 74 65 64  20 61 6e 64 20 69 74 27  |selected and it'|
00003230  73 20 69 6e 74 65 72 6e  61 6c 20 66 72 65 65 20  |s internal free |
00003240  6d 65 6d 6f 72 79 29 2c  0a 61 6e 64 20 74 6f 20  |memory),.and to |
00003250  74 68 65 20 72 69 67 68  74 20 6f 66 20 74 68 69  |the right of thi|
00003260  73 20 61 72 65 20 74 68  65 20 73 70 65 61 6b 65  |s are the speake|
00003270  72 20 6f 70 74 69 6f 6e  73 2e 0a 0a 59 61 73 73  |r options...Yass|
00003280  20 32 20 61 6c 73 6f 20  61 6c 6c 6f 77 73 20 79  | 2 also allows y|
00003290  6f 75 20 74 6f 20 68 61  76 65 20 61 20 73 70 65  |ou to have a spe|
000032a0  63 69 61 6c 20 77 69 6e  64 6f 77 20 77 68 69 63  |cial window whic|
000032b0  68 20 6b 65 65 70 73 20  79 6f 75 20 69 6e 66 6f  |h keeps you info|
000032c0  72 6d 65 64 20 61 62 6f  75 74 0a 74 77 6f 20 75  |rmed about.two u|
000032d0  73 65 66 75 6c 20 70 69  65 63 65 73 20 6f 66 20  |seful pieces of |
000032e0  69 6e 66 6f 72 6d 61 74  69 6f 6e 2e 20 54 68 65  |information. The|
000032f0  73 65 20 61 72 65 20 74  68 65 20 63 75 72 72 65  |se are the curre|
00003300  6e 74 20 74 69 6d 65 20  61 6e 64 20 74 68 65 20  |nt time and the |
00003310  61 6d 6f 75 6e 74 0a 6f  66 20 66 72 65 65 20 6d  |amount.of free m|
00003320  65 6d 6f 72 79 20 63 75  72 72 65 6e 74 6c 79 20  |emory currently |
00003330  61 76 61 69 6c 61 62 6c  65 20 6f 6e 20 79 6f 75  |available on you|
00003340  72 20 63 6f 6d 70 75 74  65 72 2e 20 54 6f 20 67  |r computer. To g|
00003350  65 74 20 74 68 69 73 20  69 6e 66 6f 72 6d 61 74  |et this informat|
00003360  69 6f 6e 0a 73 69 6d 70  6c 79 20 62 72 69 6e 67  |ion.simply bring|
00003370  20 75 70 20 59 61 73 73  32 27 73 20 6d 65 6e 75  | up Yass2's menu|
00003380  2c 20 61 6e 64 20 74 68  65 6e 20 62 72 69 6e 67  |, and then bring|
00003390  20 75 70 20 74 68 65 20  27 53 74 61 74 75 73 27  | up the 'Status'|
000033a0  20 73 75 62 6d 65 6e 75  2e 20 46 69 6e 61 6c 6c  | submenu. Finall|
000033b0  79 0a 73 65 6c 65 63 74  20 74 68 65 20 27 53 79  |y.select the 'Sy|
000033c0  73 74 65 6d 27 20 6f 70  74 69 6f 6e 20 6f 6e 20  |stem' option on |
000033d0  74 68 69 73 20 6d 65 6e  75 2e 20 57 68 65 6e 20  |this menu. When |
000033e0  74 68 69 73 20 6f 70 74  69 6f 6e 20 69 73 20 73  |this option is s|
000033f0  65 6c 65 63 74 65 64 20  61 0a 77 69 6e 64 6f 77  |elected a.window|
00003400  20 61 70 70 65 61 72 73  20 69 6e 20 74 68 65 20  | appears in the |
00003410  74 6f 70 20 6c 65 66 74  20 6f 66 20 74 68 65 20  |top left of the |
00003420  73 63 72 65 65 6e 20 67  69 76 69 6e 67 20 74 68  |screen giving th|
00003430  65 20 74 77 6f 20 70 65  69 63 65 73 20 6f 66 0a  |e two peices of.|
00003440  69 6e 66 6f 72 6d 61 74  69 6f 6e 2e 0a 0a 54 68  |information...Th|
00003450  69 73 20 77 69 6e 64 6f  77 20 63 61 6e 20 63 6f  |is window can co|
00003460  6e 74 61 69 6e 20 65 69  74 68 65 72 20 61 20 64  |ntain either a d|
00003470  69 67 69 74 61 6c 20 63  6c 6f 63 6b 20 6f 72 20  |igital clock or |
00003480  61 6e 20 61 6e 61 6c 6f  67 75 65 20 63 6c 6f 63  |an analogue cloc|
00003490  6b 2c 20 61 6e 64 20 63  61 6e 0a 64 69 73 70 6c  |k, and can.displ|
000034a0  61 79 20 68 6f 75 72 73  20 26 20 6d 69 6e 75 74  |ay hours & minut|
000034b0  65 73 20 6f 72 20 68 6f  75 72 73 2c 20 6d 69 6e  |es or hours, min|
000034c0  75 74 65 73 20 61 6e 64  20 73 65 63 6f 6e 64 73  |utes and seconds|
000034d0  2e 20 54 68 65 20 73 65  74 74 69 6e 67 20 66 6f  |. The setting fo|
000034e0  72 20 74 68 65 73 65 0a  6f 70 74 69 6f 6e 73 20  |r these.options |
000034f0  63 61 6e 20 62 65 20 73  65 6c 65 63 74 65 64 20  |can be selected |
00003500  69 6e 20 74 68 65 20 27  53 79 73 74 65 6d 27 20  |in the 'System' |
00003510  73 75 62 6d 65 6e 75 20  6f 6e 20 74 68 65 20 27  |submenu on the '|
00003520  53 74 61 74 75 73 27 20  6d 65 6e 75 2e 20 54 68  |Status' menu. Th|
00003530  69 73 20 0a 6d 65 6e 75  20 61 6c 73 6f 20 61 6c  |is .menu also al|
00003540  6c 6f 77 73 20 79 6f 75  20 74 6f 20 6c 69 6d 69  |lows you to limi|
00003550  74 20 74 68 65 20 64 69  73 70 6c 61 79 20 74 6f  |t the display to|
00003560  20 65 69 74 68 65 72 20  6a 75 73 74 20 61 20 63  | either just a c|
00003570  6c 6f 63 6b 2c 20 6f 72  0a 6a 75 73 74 20 61 20  |lock, or.just a |
00003580  66 72 65 65 20 6d 65 6d  6f 72 79 20 69 6e 64 69  |free memory indi|
00003590  63 61 74 6f 72 2e 0a 0a  54 68 65 20 73 74 61 74  |cator...The stat|
000035a0  75 73 20 77 69 6e 64 6f  77 20 63 61 6e 20 62 65  |us window can be|
000035b0  20 6d 6f 76 65 64 20 61  6e 79 77 68 65 72 65 20  | moved anywhere |
000035c0  6f 6e 20 74 68 65 20 73  63 72 65 65 6e 20 62 79  |on the screen by|
000035d0  20 73 69 6d 70 6c 79 20  70 72 65 73 73 69 6e 67  | simply pressing|
000035e0  20 61 6e 79 0a 6d 6f 75  73 65 20 62 75 74 74 6f  | any.mouse butto|
000035f0  6e 20 28 61 6e 64 20 68  6f 6c 64 69 6e 67 20 69  |n (and holding i|
00003600  74 20 64 6f 77 6e 29 20  77 68 65 6e 20 74 68 65  |t down) when the|
00003610  20 6d 6f 75 73 65 20 70  6f 69 6e 74 65 72 20 69  | mouse pointer i|
00003620  73 20 6f 76 65 72 20 74  68 65 20 77 69 6e 64 6f  |s over the windo|
00003630  77 2c 0a 61 6e 64 20 64  72 61 67 67 69 6e 67 20  |w,.and dragging |
00003640  74 68 65 20 77 69 6e 64  6f 77 20 74 6f 20 77 68  |the window to wh|
00003650  65 72 65 20 79 6f 75 20  77 61 6e 74 20 69 74 2e  |ere you want it.|
00003660  20 54 68 65 20 77 69 6e  64 6f 77 20 69 73 20 74  | The window is t|
00003670  68 65 6e 20 27 6c 6f 63  6b 65 64 27 20 69 6e 0a  |hen 'locked' in.|
00003680  74 68 61 74 20 70 6f 73  74 69 6f 6e 20 72 65 6c  |that postion rel|
00003690  65 61 74 69 76 65 20 74  6f 20 74 68 65 20 63 6f  |eative to the co|
000036a0  72 6e 65 72 20 6f 66 20  74 68 65 20 73 63 72 65  |rner of the scre|
000036b0  65 6e 20 69 74 20 69 73  20 63 6c 6f 73 65 73 74  |en it is closest|
000036c0  20 74 6f 2e 20 54 68 69  73 0a 6d 65 61 6e 73 20  | to. This.means |
000036d0  74 68 61 74 20 77 68 65  6e 20 79 6f 75 20 63 68  |that when you ch|
000036e0  61 6e 67 65 20 6d 6f 64  65 2c 20 69 74 20 77 6f  |ange mode, it wo|
000036f0  6e 27 74 20 6d 61 74 74  65 72 20 69 66 20 74 68  |n't matter if th|
00003700  65 20 73 63 72 65 65 6e  20 69 73 20 61 20 64 69  |e screen is a di|
00003710  66 66 65 72 65 6e 74 20  0a 73 69 7a 65 2c 20 74  |fferent .size, t|
00003720  68 65 20 77 69 6e 64 6f  77 20 77 69 6c 6c 20 61  |he window will a|
00003730  70 70 65 61 72 20 69 6e  20 74 68 65 20 73 61 6d  |ppear in the sam|
00003740  65 20 70 6f 73 69 74 69  6f 6e 2e 0a 0a 59 6f 75  |e position...You|
00003750  20 63 61 6e 20 61 6c 73  6f 20 67 65 74 20 59 61  | can also get Ya|
00003760  73 73 20 32 20 74 6f 20  6b 65 65 70 20 61 20 63  |ss 2 to keep a c|
00003770  68 65 63 6b 20 6f 6e 20  79 6f 75 72 20 52 4d 41  |heck on your RMA|
00003780  20 73 69 7a 65 2c 20 6b  65 65 70 69 6e 67 20 69  | size, keeping i|
00003790  74 20 61 73 20 6c 6f 77  0a 61 73 20 69 74 20 63  |t as low.as it c|
000037a0  61 6e 2e 20 54 6f 20 64  6f 20 74 68 69 73 20 73  |an. To do this s|
000037b0  65 6c 65 63 74 20 74 68  65 20 27 5a 61 70 20 52  |elect the 'Zap R|
000037c0  4d 41 27 20 6f 70 74 69  6f 6e 20 6f 6e 20 74 68  |MA' option on th|
000037d0  65 20 27 53 74 61 74 75  73 27 20 6d 65 6e 75 2e  |e 'Status' menu.|
000037e0  0a 0a 54 68 65 20 66 69  6e 61 6c 20 74 68 69 6e  |..The final thin|
000037f0  67 20 59 61 73 73 20 32  20 61 6c 6c 6f 77 73 20  |g Yass 2 allows |
00003800  69 73 20 74 68 65 20 63  68 61 6e 67 69 6e 67 20  |is the changing |
00003810  6f 66 20 79 6f 75 72 20  70 69 6e 62 6f 61 72 64  |of your pinboard|
00003820  20 62 61 63 6b 64 72 6f  70 2e 0a 54 68 65 72 65  | backdrop..There|
00003830  20 69 73 20 61 20 6d 65  6e 75 20 6f 70 74 69 6f  | is a menu optio|
00003840  6e 20 6f 66 20 59 61 73  73 32 27 73 20 6d 61 69  |n of Yass2's mai|
00003850  6e 20 6d 65 6e 75 20 63  61 6c 6c 65 64 20 27 57  |n menu called 'W|
00003860  61 6c 6c 70 61 70 65 72  27 2e 20 54 68 69 73 20  |allpaper'. This |
00003870  6c 65 61 64 73 20 74 6f  0a 61 20 73 75 62 6d 65  |leads to.a subme|
00003880  6e 75 20 77 68 69 63 68  20 63 6f 6e 74 61 69 6e  |nu which contain|
00003890  73 20 61 20 6c 69 73 74  20 6f 66 20 61 76 61 69  |s a list of avai|
000038a0  6c 61 62 6c 65 20 27 77  61 6c 6c 70 61 70 65 72  |lable 'wallpaper|
000038b0  73 27 2e 20 54 68 69 73  20 6d 65 6e 75 20 77 6f  |s'. This menu wo|
000038c0  72 6b 73 20 69 6e 0a 6d  75 63 68 20 74 68 65 20  |rks in.much the |
000038d0  73 61 6d 65 20 77 61 79  20 61 73 20 74 68 65 20  |same way as the |
000038e0  27 53 61 76 65 72 73 27  20 6d 65 6e 75 2e 20 53  |'Savers' menu. S|
000038f0  65 6c 65 63 74 69 6e 67  20 61 6e 79 20 6f 66 20  |electing any of |
00003900  74 68 65 20 6c 69 73 74  65 64 20 69 74 65 6d 73  |the listed items|
00003910  0a 77 69 6c 6c 20 73 69  6d 70 6c 79 20 70 6c 61  |.will simply pla|
00003920  63 65 20 28 6f 72 20 72  65 6d 6f 76 65 29 20 61  |ce (or remove) a|
00003930  20 74 69 63 6b 20 66 72  6f 6d 20 62 65 73 69 64  | tick from besid|
00003940  65 20 69 74 2c 20 61 6e  64 20 53 48 49 46 54 2d  |e it, and SHIFT-|
00003950  53 45 4c 45 43 54 20 77  69 6c 6c 0a 73 65 6c 65  |SELECT will.sele|
00003960  63 74 20 74 68 61 74 20  69 74 65 6d 20 77 68 69  |ct that item whi|
00003970  6c 73 74 20 72 65 73 65  74 74 69 6e 67 20 61 6c  |lst resetting al|
00003980  6c 20 6f 74 68 65 72 73  2e 0a 0a 57 68 61 74 20  |l others...What |
00003990  59 61 73 73 20 32 20 64  6f 65 73 20 69 73 20 77  |Yass 2 does is w|
000039a0  68 65 6e 20 69 74 20 73  74 61 72 74 73 20 75 70  |hen it starts up|
000039b0  20 69 74 20 6c 6f 6f 6b  73 20 61 74 20 74 68 65  | it looks at the|
000039c0  20 6c 69 73 74 20 6f 66  20 74 69 63 6b 65 64 20  | list of ticked |
000039d0  69 74 65 6d 73 0a 61 6e  64 20 73 65 6c 65 63 74  |items.and select|
000039e0  73 20 6f 6e 65 20 61 74  20 72 61 6e 64 6f 6d 2c  |s one at random,|
000039f0  20 70 6c 61 63 69 6e 67  20 69 74 20 6f 6e 20 74  | placing it on t|
00003a00  68 65 20 62 61 63 6b 64  72 6f 70 2e 20 54 68 69  |he backdrop. Thi|
00003a10  73 20 68 61 76 69 6e 67  20 6f 6e 6c 79 20 6f 6e  |s having only on|
00003a20  65 0a 73 65 6c 65 63 74  65 64 20 77 69 6c 6c 20  |e.selected will |
00003a30  6d 61 6b 65 20 74 68 61  74 20 61 6c 77 61 79 73  |make that always|
00003a40  20 74 68 65 20 62 61 63  6b 64 72 6f 70 2c 20 77  | the backdrop, w|
00003a50  68 69 6c 73 74 20 68 61  76 69 6e 67 20 6e 6f 6e  |hilst having non|
00003a60  65 20 73 65 6c 65 63 74  65 64 0a 77 69 6c 6c 20  |e selected.will |
00003a70  73 74 6f 70 20 59 61 73  73 20 32 20 70 6c 61 63  |stop Yass 2 plac|
00003a80  69 6e 67 20 61 6e 79 74  68 69 6e 67 20 6f 6e 20  |ing anything on |
00003a90  74 68 65 20 62 61 63 6b  64 72 6f 70 2e 20 54 6f  |the backdrop. To|
00003aa0  20 70 6c 61 63 65 20 61  6e 79 20 6f 66 20 74 68  | place any of th|
00003ab0  65 20 69 74 65 6d 73 0a  6f 6e 20 74 68 65 20 62  |e items.on the b|
00003ac0  61 63 6b 64 72 6f 70 20  77 69 74 68 20 69 6d 6d  |ackdrop with imm|
00003ad0  65 64 69 61 74 65 20 65  66 66 65 63 74 2c 20 73  |ediate effect, s|
00003ae0  69 6d 70 6c 79 20 43 54  52 4c 2d 53 45 4c 45 43  |imply CTRL-SELEC|
00003af0  54 20 74 68 65 20 72 65  6c 65 76 65 6e 74 20 69  |T the relevent i|
00003b00  74 65 6d 2e 0a 0a 0a 0a  59 61 73 73 20 32 20 73  |tem.....Yass 2 s|
00003b10  74 61 72 74 75 70 20 6f  70 74 69 6f 6e 73 0a 2d  |tartup options.-|
00003b20  2d 2d 2d 2d 2d 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |----------------|
00003b30  2d 2d 2d 2d 2d 0a 0a 59  61 73 73 20 32 20 73 75  |-----..Yass 2 su|
00003b40  70 70 6f 72 74 73 20 33  20 63 6f 6d 6d 61 6e 64  |pports 3 command|
00003b50  20 6c 69 6e 65 20 6f 70  74 69 6f 6e 73 20 3a 0a  | line options :.|
00003b60  0a 20 20 2d 6c 65 66 74  20 20 20 4d 61 6b 65 73  |.  -left   Makes|
00003b70  20 59 61 73 73 20 32 20  70 6c 61 63 65 20 69 74  | Yass 2 place it|
00003b80  27 73 20 69 63 6f 6e 20  6f 6e 20 74 68 65 20 6c  |'s icon on the l|
00003b90  65 66 74 20 68 61 6e 64  20 73 69 64 65 20 6f 66  |eft hand side of|
00003ba0  20 74 68 65 20 69 63 6f  6e 62 61 72 2e 0a 0a 20  | the iconbar... |
00003bb0  20 2d 72 69 67 68 74 20  20 4d 61 6b 65 73 20 59  | -right  Makes Y|
00003bc0  61 73 73 20 32 20 70 6c  61 63 65 20 69 74 27 73  |ass 2 place it's|
00003bd0  20 69 63 6f 6e 20 6f 6e  20 74 68 65 20 72 69 67  | icon on the rig|
00003be0  68 74 20 68 61 6e 64 20  73 69 64 65 20 6f 66 20  |ht hand side of |
00003bf0  74 68 65 20 69 63 6f 6e  62 61 72 2e 0a 0a 20 20  |the iconbar...  |
00003c00  2d 6e 6f 6e 65 20 20 20  4d 61 6b 65 73 20 59 61  |-none   Makes Ya|
00003c10  73 73 20 32 20 70 6c 61  63 65 20 6e 6f 20 69 63  |ss 2 place no ic|
00003c20  6f 6e 20 6f 6e 20 74 68  65 20 69 63 6f 6e 62 61  |on on the iconba|
00003c30  72 2e 0a 0a 0a 0a 49 66  20 6e 6f 20 6f 70 74 69  |r.....If no opti|
00003c40  6f 6e 73 20 61 72 65 20  67 69 76 65 6e 2c 20 74  |ons are given, t|
00003c50  68 65 6e 20 74 68 65 20  69 63 6f 6e 20 77 69 6c  |hen the icon wil|
00003c60  6c 20 28 62 79 20 64 65  66 61 75 6c 74 29 20 62  |l (by default) b|
00003c70  65 20 70 6c 61 63 65 64  20 6f 6e 20 74 68 65 0a  |e placed on the.|
00003c80  72 69 67 68 74 20 68 61  6e 64 20 73 69 64 65 20  |right hand side |
00003c90  6f 66 20 74 68 65 20 69  63 6f 6e 62 61 72 2e 0a  |of the iconbar..|
00003ca0  0a 4e 4f 54 45 3a 20 49  66 20 79 6f 75 20 73 65  |.NOTE: If you se|
00003cb0  6c 65 63 74 20 74 68 65  20 27 2d 6e 6f 6e 65 27  |lect the '-none'|
00003cc0  20 6f 70 74 69 6f 6e 20  74 68 65 6e 20 79 6f 75  | option then you|
00003cd0  20 77 69 6c 6c 20 6e 6f  74 20 62 65 20 61 62 6c  | will not be abl|
00003ce0  65 20 74 6f 20 62 72 69  6e 67 20 75 70 0a 74 68  |e to bring up.th|
00003cf0  65 20 6d 61 69 6e 20 6d  65 6e 75 2c 20 6e 6f 72  |e main menu, nor|
00003d00  20 74 68 65 20 62 6c 61  6e 6b 69 6e 67 20 74 69  | the blanking ti|
00003d10  6d 65 73 20 77 69 6e 64  6f 77 2e 20 54 68 75 73  |mes window. Thus|
00003d20  20 74 68 69 73 20 6f 70  74 69 6f 6e 20 73 68 6f  | this option sho|
00003d30  75 6c 64 20 6f 6e 6c 79  20 62 65 0a 75 73 65 64  |uld only be.used|
00003d40  20 77 68 65 6e 20 79 6f  75 20 64 6f 20 6e 6f 74  | when you do not|
00003d50  20 77 69 73 68 20 74 6f  20 61 6c 74 65 72 20 59  | wish to alter Y|
00003d60  61 73 73 20 32 27 73 20  63 68 61 72 61 63 74 65  |ass 2's characte|
00003d70  72 69 73 74 69 63 73 2e  0a 0a 59 61 73 73 20 32  |ristics...Yass 2|
00003d80  20 73 75 70 70 6f 72 74  73 20 74 68 65 20 52 69  | supports the Ri|
00003d90  73 63 2d 4f 53 20 33 20  61 75 74 6f 6d 61 74 69  |sc-OS 3 automati|
00003da0  63 20 44 65 73 6b 74 6f  70 20 42 6f 6f 74 20 66  |c Desktop Boot f|
00003db0  69 6c 65 20 63 72 65 61  74 69 6f 6e 2e 20 54 68  |ile creation. Th|
00003dc0  75 73 20 69 66 0a 69 74  20 69 73 20 72 75 6e 6e  |us if.it is runn|
00003dd0  69 6e 67 20 69 74 20 77  69 6c 6c 20 61 64 64 20  |ing it will add |
00003de0  69 74 27 73 20 6f 77 6e  20 73 74 61 72 74 20 75  |it's own start u|
00003df0  70 20 6c 69 6e 65 20 69  6e 74 6f 20 61 20 64 65  |p line into a de|
00003e00  73 6b 74 6f 70 20 62 6f  6f 74 20 66 69 6c 65 0a  |sktop boot file.|
00003e10  63 72 65 61 74 65 64 20  66 72 6f 6d 20 74 68 65  |created from the|
00003e20  20 74 61 73 6b 20 6d 61  6e 61 67 65 72 73 20 6d  | task managers m|
00003e30  65 6e 75 2e 0a 0a 0a 4e  6f 74 65 73 3a 0a 0a 59  |enu....Notes:..Y|
00003e40  61 73 73 20 32 20 77 69  6c 6c 20 73 75 70 70 6f  |ass 2 will suppo|
00003e50  72 74 20 75 70 74 6f 20  37 37 20 73 61 76 65 72  |rt upto 77 saver|
00003e60  20 6d 6f 64 75 6c 65 73  20 28 61 73 20 6d 61 6e  | modules (as man|
00003e70  79 20 61 73 20 79 6f 75  20 63 61 6e 20 66 69 74  |y as you can fit|
00003e80  20 69 6e 20 74 68 65 20  73 61 76 65 72 0a 64 69  | in the saver.di|
00003e90  72 65 63 74 6f 72 79 29  2e 20 48 6f 77 65 76 65  |rectory). Howeve|
00003ea0  72 20 74 68 65 20 63 75  72 72 65 6e 74 6c 79 20  |r the currently |
00003eb0  64 65 66 69 6e 65 64 20  77 69 6d 70 73 6c 6f 74  |defined wimpslot|
00003ec0  20 28 36 34 6b 29 20 77  69 6c 6c 20 6e 6f 74 20  | (64k) will not |
00003ed0  61 6c 6c 6f 77 20 61 6c  6c 0a 6f 66 20 74 68 65  |allow all.of the|
00003ee0  73 65 20 74 6f 20 62 65  20 73 65 6c 65 63 74 65  |se to be selecte|
00003ef0  64 2c 20 61 73 20 65 61  63 68 20 73 61 76 65 72  |d, as each saver|
00003f00  20 74 68 61 74 20 69 73  20 72 75 6e 20 77 69 6c  | that is run wil|
00003f10  6c 20 63 6c 61 69 6d 20  61 20 63 65 72 74 61 69  |l claim a certai|
00003f20  6e 0a 61 6d 6f 75 6e 74  20 6f 66 20 6d 65 6d 6f  |n.amount of memo|
00003f30  72 79 20 66 6f 72 20 76  61 72 69 61 62 6c 65 73  |ry for variables|
00003f40  2c 20 65 74 63 2e 20 54  68 75 73 20 66 6f 72 20  |, etc. Thus for |
00003f50  74 68 65 20 63 75 72 72  65 6e 74 20 77 69 6d 70  |the current wimp|
00003f60  73 6c 6f 74 20 69 74 20  69 73 0a 61 64 76 69 73  |slot it is.advis|
00003f70  61 62 6c 65 20 74 6f 20  6b 65 65 70 20 74 6f 20  |able to keep to |
00003f80  61 20 6d 61 78 69 6d 75  6d 20 6f 66 20 61 62 6f  |a maximum of abo|
00003f90  75 74 20 32 30 20 73 65  6c 65 63 74 65 64 20 73  |ut 20 selected s|
00003fa0  61 76 65 72 20 6d 6f 64  75 6c 65 73 2e 20 49 66  |aver modules. If|
00003fb0  20 79 6f 75 20 77 61 6e  74 0a 6d 6f 72 65 20 74  | you want.more t|
00003fc0  68 61 6e 20 74 68 69 73  20 79 6f 75 20 73 68 6f  |han this you sho|
00003fd0  75 6c 64 20 69 6e 63 72  65 61 73 65 20 74 68 65  |uld increase the|
00003fe0  20 77 69 6d 70 73 6c 6f  74 20 67 69 76 65 6e 20  | wimpslot given |
00003ff0  74 6f 20 59 61 73 73 32  20 69 6e 20 69 74 73 20  |to Yass2 in its |
00004000  21 52 75 6e 0a 66 69 6c  65 2e 0a                 |!Run.file..|
0000400b