Home » Personal collection » Acorn ADFS disks » Electron_User_Group » EUG_35.ADF » P/+SSTXT1

P/+SSTXT1

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 » Personal collection » Acorn ADFS disks » Electron_User_Group » EUG_35.ADF
Filename: P/+SSTXT1
Read OK:
File size: 075D bytes
Load address: FFFFFF47
Exec address: B086
Duplicates

There is 1 duplicate copy of this file in the archive:

File contents
MANUAL FOR SSAVER (6502 machine code)


This file describes the program SSAVER which is an event driven screen saver

for the 8 bit Acorn's using a 6845 cathode ray tube controller.


The manual and software is (C)1997 SPROW


INSTRUCTIONS-

At the command prompt,type *RUN SSAVER


The program will then appear to not have done anything.This is because the 

screen saver has simply been loaded,and not configured yet.

You can configure the screensaver to restore the screen on the occurrence of

any event (see your User guide under *FX14 or *FX13 for details of event nos).


Next,at the BASIC prompt,type CHAIN"SSTEST"


This will run a really simple program that demostrates the use of a new OSWord

call which sets up the saver to your requirements.


The format of the osword has been defined as follows:

Entry A=&E0

      X and Y point to a 10 byte parameter block in memory

      XY+00=Two byte delay in 50ths of a second

      XY+01=1st event number to unblank the screen

        :

      XY+09=8th event number that will unblank the screen

Exit  Parameter block unchanged


The tester program sets event 2 (key pressed event) to restore the screen,but

you may wish to set it to respond to a different event.Note that if you

don't want 8 different events to restore the screen simply pad the other

values with a duplicate of one you've already used.


This is because I couldn't use a padding value since event numbers can be any

value in the range 0-255!


You may reconfigure the screen saver AS MANY TIMES as you want without having

to run it again.Just call the OSWord.


EXIT MESSAGES-

None.


KNOWN PROBLEMS/FUTURE ENHANCEMENTS-

No known problems


HISTORY-

V0.90 Original developement version

V1.00 Released to EUG,having fixed a problem with frame sync on proper

      computer monitors (it was previously only tried on a domestic TV).

00000000  4d 41 4e 55 41 4c 20 46  4f 52 20 53 53 41 56 45  |MANUAL FOR SSAVE|
00000010  52 20 28 36 35 30 32 20  6d 61 63 68 69 6e 65 20  |R (6502 machine |
00000020  63 6f 64 65 29 0a 0d 0a  0d 54 68 69 73 20 66 69  |code)....This fi|
00000030  6c 65 20 64 65 73 63 72  69 62 65 73 20 74 68 65  |le describes the|
00000040  20 70 72 6f 67 72 61 6d  20 53 53 41 56 45 52 20  | program SSAVER |
00000050  77 68 69 63 68 20 69 73  20 61 6e 20 65 76 65 6e  |which is an even|
00000060  74 20 64 72 69 76 65 6e  20 73 63 72 65 65 6e 20  |t driven screen |
00000070  73 61 76 65 72 0a 0d 66  6f 72 20 74 68 65 20 38  |saver..for the 8|
00000080  20 62 69 74 20 41 63 6f  72 6e 27 73 20 75 73 69  | bit Acorn's usi|
00000090  6e 67 20 61 20 36 38 34  35 20 63 61 74 68 6f 64  |ng a 6845 cathod|
000000a0  65 20 72 61 79 20 74 75  62 65 20 63 6f 6e 74 72  |e ray tube contr|
000000b0  6f 6c 6c 65 72 2e 0a 0d  0a 0d 54 68 65 20 6d 61  |oller.....The ma|
000000c0  6e 75 61 6c 20 61 6e 64  20 73 6f 66 74 77 61 72  |nual and softwar|
000000d0  65 20 69 73 20 28 43 29  31 39 39 37 20 53 50 52  |e is (C)1997 SPR|
000000e0  4f 57 0a 0d 0a 0d 49 4e  53 54 52 55 43 54 49 4f  |OW....INSTRUCTIO|
000000f0  4e 53 2d 0a 0d 41 74 20  74 68 65 20 63 6f 6d 6d  |NS-..At the comm|
00000100  61 6e 64 20 70 72 6f 6d  70 74 2c 74 79 70 65 20  |and prompt,type |
00000110  2a 52 55 4e 20 53 53 41  56 45 52 0a 0d 0a 0d 54  |*RUN SSAVER....T|
00000120  68 65 20 70 72 6f 67 72  61 6d 20 77 69 6c 6c 20  |he program will |
00000130  74 68 65 6e 20 61 70 70  65 61 72 20 74 6f 20 6e  |then appear to n|
00000140  6f 74 20 68 61 76 65 20  64 6f 6e 65 20 61 6e 79  |ot have done any|
00000150  74 68 69 6e 67 2e 54 68  69 73 20 69 73 20 62 65  |thing.This is be|
00000160  63 61 75 73 65 20 74 68  65 20 0a 0d 73 63 72 65  |cause the ..scre|
00000170  65 6e 20 73 61 76 65 72  20 68 61 73 20 73 69 6d  |en saver has sim|
00000180  70 6c 79 20 62 65 65 6e  20 6c 6f 61 64 65 64 2c  |ply been loaded,|
00000190  61 6e 64 20 6e 6f 74 20  63 6f 6e 66 69 67 75 72  |and not configur|
000001a0  65 64 20 79 65 74 2e 0a  0d 59 6f 75 20 63 61 6e  |ed yet...You can|
000001b0  20 63 6f 6e 66 69 67 75  72 65 20 74 68 65 20 73  | configure the s|
000001c0  63 72 65 65 6e 73 61 76  65 72 20 74 6f 20 72 65  |creensaver to re|
000001d0  73 74 6f 72 65 20 74 68  65 20 73 63 72 65 65 6e  |store the screen|
000001e0  20 6f 6e 20 74 68 65 20  6f 63 63 75 72 72 65 6e  | on the occurren|
000001f0  63 65 20 6f 66 0a 0d 61  6e 79 20 65 76 65 6e 74  |ce of..any event|
00000200  20 28 73 65 65 20 79 6f  75 72 20 55 73 65 72 20  | (see your User |
00000210  67 75 69 64 65 20 75 6e  64 65 72 20 2a 46 58 31  |guide under *FX1|
00000220  34 20 6f 72 20 2a 46 58  31 33 20 66 6f 72 20 64  |4 or *FX13 for d|
00000230  65 74 61 69 6c 73 20 6f  66 20 65 76 65 6e 74 20  |etails of event |
00000240  6e 6f 73 29 2e 0a 0d 0a  0d 4e 65 78 74 2c 61 74  |nos).....Next,at|
00000250  20 74 68 65 20 42 41 53  49 43 20 70 72 6f 6d 70  | the BASIC promp|
00000260  74 2c 74 79 70 65 20 43  48 41 49 4e 22 53 53 54  |t,type CHAIN"SST|
00000270  45 53 54 22 0a 0d 0a 0d  54 68 69 73 20 77 69 6c  |EST"....This wil|
00000280  6c 20 72 75 6e 20 61 20  72 65 61 6c 6c 79 20 73  |l run a really s|
00000290  69 6d 70 6c 65 20 70 72  6f 67 72 61 6d 20 74 68  |imple program th|
000002a0  61 74 20 64 65 6d 6f 73  74 72 61 74 65 73 20 74  |at demostrates t|
000002b0  68 65 20 75 73 65 20 6f  66 20 61 20 6e 65 77 20  |he use of a new |
000002c0  4f 53 57 6f 72 64 0a 0d  63 61 6c 6c 20 77 68 69  |OSWord..call whi|
000002d0  63 68 20 73 65 74 73 20  75 70 20 74 68 65 20 73  |ch sets up the s|
000002e0  61 76 65 72 20 74 6f 20  79 6f 75 72 20 72 65 71  |aver to your req|
000002f0  75 69 72 65 6d 65 6e 74  73 2e 0a 0d 0a 0d 54 68  |uirements.....Th|
00000300  65 20 66 6f 72 6d 61 74  20 6f 66 20 74 68 65 20  |e format of the |
00000310  6f 73 77 6f 72 64 20 68  61 73 20 62 65 65 6e 20  |osword has been |
00000320  64 65 66 69 6e 65 64 20  61 73 20 66 6f 6c 6c 6f  |defined as follo|
00000330  77 73 3a 0a 0d 45 6e 74  72 79 20 41 3d 26 45 30  |ws:..Entry A=&E0|
00000340  0a 0d 20 20 20 20 20 20  58 20 61 6e 64 20 59 20  |..      X and Y |
00000350  70 6f 69 6e 74 20 74 6f  20 61 20 31 30 20 62 79  |point to a 10 by|
00000360  74 65 20 70 61 72 61 6d  65 74 65 72 20 62 6c 6f  |te parameter blo|
00000370  63 6b 20 69 6e 20 6d 65  6d 6f 72 79 0a 0d 20 20  |ck in memory..  |
00000380  20 20 20 20 58 59 2b 30  30 3d 54 77 6f 20 62 79  |    XY+00=Two by|
00000390  74 65 20 64 65 6c 61 79  20 69 6e 20 35 30 74 68  |te delay in 50th|
000003a0  73 20 6f 66 20 61 20 73  65 63 6f 6e 64 0a 0d 20  |s of a second.. |
000003b0  20 20 20 20 20 58 59 2b  30 31 3d 31 73 74 20 65  |     XY+01=1st e|
000003c0  76 65 6e 74 20 6e 75 6d  62 65 72 20 74 6f 20 75  |vent number to u|
000003d0  6e 62 6c 61 6e 6b 20 74  68 65 20 73 63 72 65 65  |nblank the scree|
000003e0  6e 0a 0d 20 20 20 20 20  20 20 20 3a 0a 0d 20 20  |n..        :..  |
000003f0  20 20 20 20 58 59 2b 30  39 3d 38 74 68 20 65 76  |    XY+09=8th ev|
00000400  65 6e 74 20 6e 75 6d 62  65 72 20 74 68 61 74 20  |ent number that |
00000410  77 69 6c 6c 20 75 6e 62  6c 61 6e 6b 20 74 68 65  |will unblank the|
00000420  20 73 63 72 65 65 6e 0a  0d 45 78 69 74 20 20 50  | screen..Exit  P|
00000430  61 72 61 6d 65 74 65 72  20 62 6c 6f 63 6b 20 75  |arameter block u|
00000440  6e 63 68 61 6e 67 65 64  0a 0d 0a 0d 54 68 65 20  |nchanged....The |
00000450  74 65 73 74 65 72 20 70  72 6f 67 72 61 6d 20 73  |tester program s|
00000460  65 74 73 20 65 76 65 6e  74 20 32 20 28 6b 65 79  |ets event 2 (key|
00000470  20 70 72 65 73 73 65 64  20 65 76 65 6e 74 29 20  | pressed event) |
00000480  74 6f 20 72 65 73 74 6f  72 65 20 74 68 65 20 73  |to restore the s|
00000490  63 72 65 65 6e 2c 62 75  74 0a 0d 79 6f 75 20 6d  |creen,but..you m|
000004a0  61 79 20 77 69 73 68 20  74 6f 20 73 65 74 20 69  |ay wish to set i|
000004b0  74 20 74 6f 20 72 65 73  70 6f 6e 64 20 74 6f 20  |t to respond to |
000004c0  61 20 64 69 66 66 65 72  65 6e 74 20 65 76 65 6e  |a different even|
000004d0  74 2e 4e 6f 74 65 20 74  68 61 74 20 69 66 20 79  |t.Note that if y|
000004e0  6f 75 0a 0d 64 6f 6e 27  74 20 77 61 6e 74 20 38  |ou..don't want 8|
000004f0  20 64 69 66 66 65 72 65  6e 74 20 65 76 65 6e 74  | different event|
00000500  73 20 74 6f 20 72 65 73  74 6f 72 65 20 74 68 65  |s to restore the|
00000510  20 73 63 72 65 65 6e 20  73 69 6d 70 6c 79 20 70  | screen simply p|
00000520  61 64 20 74 68 65 20 6f  74 68 65 72 0a 0d 76 61  |ad the other..va|
00000530  6c 75 65 73 20 77 69 74  68 20 61 20 64 75 70 6c  |lues with a dupl|
00000540  69 63 61 74 65 20 6f 66  20 6f 6e 65 20 79 6f 75  |icate of one you|
00000550  27 76 65 20 61 6c 72 65  61 64 79 20 75 73 65 64  |'ve already used|
00000560  2e 0a 0d 0a 0d 54 68 69  73 20 69 73 20 62 65 63  |.....This is bec|
00000570  61 75 73 65 20 49 20 63  6f 75 6c 64 6e 27 74 20  |ause I couldn't |
00000580  75 73 65 20 61 20 70 61  64 64 69 6e 67 20 76 61  |use a padding va|
00000590  6c 75 65 20 73 69 6e 63  65 20 65 76 65 6e 74 20  |lue since event |
000005a0  6e 75 6d 62 65 72 73 20  63 61 6e 20 62 65 20 61  |numbers can be a|
000005b0  6e 79 0a 0d 76 61 6c 75  65 20 69 6e 20 74 68 65  |ny..value in the|
000005c0  20 72 61 6e 67 65 20 30  2d 32 35 35 21 0a 0d 0a  | range 0-255!...|
000005d0  0d 59 6f 75 20 6d 61 79  20 72 65 63 6f 6e 66 69  |.You may reconfi|
000005e0  67 75 72 65 20 74 68 65  20 73 63 72 65 65 6e 20  |gure the screen |
000005f0  73 61 76 65 72 20 41 53  20 4d 41 4e 59 20 54 49  |saver AS MANY TI|
00000600  4d 45 53 20 61 73 20 79  6f 75 20 77 61 6e 74 20  |MES as you want |
00000610  77 69 74 68 6f 75 74 20  68 61 76 69 6e 67 0a 0d  |without having..|
00000620  74 6f 20 72 75 6e 20 69  74 20 61 67 61 69 6e 2e  |to run it again.|
00000630  4a 75 73 74 20 63 61 6c  6c 20 74 68 65 20 4f 53  |Just call the OS|
00000640  57 6f 72 64 2e 0a 0d 0a  0d 45 58 49 54 20 4d 45  |Word.....EXIT ME|
00000650  53 53 41 47 45 53 2d 0a  0d 4e 6f 6e 65 2e 0a 0d  |SSAGES-..None...|
00000660  0a 0d 4b 4e 4f 57 4e 20  50 52 4f 42 4c 45 4d 53  |..KNOWN PROBLEMS|
00000670  2f 46 55 54 55 52 45 20  45 4e 48 41 4e 43 45 4d  |/FUTURE ENHANCEM|
00000680  45 4e 54 53 2d 0a 0d 4e  6f 20 6b 6e 6f 77 6e 20  |ENTS-..No known |
00000690  70 72 6f 62 6c 65 6d 73  0a 0d 0a 0d 48 49 53 54  |problems....HIST|
000006a0  4f 52 59 2d 0a 0d 56 30  2e 39 30 20 4f 72 69 67  |ORY-..V0.90 Orig|
000006b0  69 6e 61 6c 20 64 65 76  65 6c 6f 70 65 6d 65 6e  |inal developemen|
000006c0  74 20 76 65 72 73 69 6f  6e 0a 0d 56 31 2e 30 30  |t version..V1.00|
000006d0  20 52 65 6c 65 61 73 65  64 20 74 6f 20 45 55 47  | Released to EUG|
000006e0  2c 68 61 76 69 6e 67 20  66 69 78 65 64 20 61 20  |,having fixed a |
000006f0  70 72 6f 62 6c 65 6d 20  77 69 74 68 20 66 72 61  |problem with fra|
00000700  6d 65 20 73 79 6e 63 20  6f 6e 20 70 72 6f 70 65  |me sync on prope|
00000710  72 0a 0d 20 20 20 20 20  20 63 6f 6d 70 75 74 65  |r..      compute|
00000720  72 20 6d 6f 6e 69 74 6f  72 73 20 28 69 74 20 77  |r monitors (it w|
00000730  61 73 20 70 72 65 76 69  6f 75 73 6c 79 20 6f 6e  |as previously on|
00000740  6c 79 20 74 72 69 65 64  20 6f 6e 20 61 20 64 6f  |ly tried on a do|
00000750  6d 65 73 74 69 63 20 54  56 29 2e 0a 0d           |mestic TV)...|
0000075d
P/+SSTXT1.m0
P/+SSTXT1.m1
P/+SSTXT1.m2
P/+SSTXT1.m4
P/+SSTXT1.m5