Home » Recent acquisitions » Acorn ADFS disks » adfs_ArchimedesWorld_199207.adf » !AWJULY92 » !AWJUL92/Goodies/Winsave/!Help

!AWJUL92/Goodies/Winsave/!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_199207.adf » !AWJULY92
Filename: !AWJUL92/Goodies/Winsave/!Help
Read OK:
File size: 076C bytes
Load address: 0000
Exec address: 0000
File contents
!Winsaver Notes
===============

To use this application install it on the iconbar by double clicking over it
in a filer window. Once installed the following are available :-

Select over Icon :      Save contents of all open desktop windows at their
                        current sizes, bringing each window to the "top" so 
                        that it is unobscured when it is saved. The saved
                        sprites will include title & scrollbars etc if
                        present.

Adjust over Icon :      As Select but title & scrollbars are not saved - 
                        just the window contents.

Menu             :      Open iconbar menu with info & quit entries.


Shift & Select   :      As Select but only top window is saved.

Shift & Adjust   :      As Adjust but only top window is saved.


Memory Requirements
-------------------

!Winsaver requires 32k of memory whilst it is installed but not activated.
When saving windows the wimp's next & free slots are used to store the sprite
data PROVIDED that the currently available memory is at least large enough
to hold the entire screen (eg 80k for Mode 12 ). If insuffient memory is
available then the *SCREENSAVE command is used instead, allowing the save to
take place safely. If memory is low then care should be taken to avoid
Insert Disc prompts from ADFS since these can corrupt the saved sprites. 
        

Filing
------

The sprite images of the windows are saved into the SAVED directory within
the !Winsaver application directory ( which can be opened by holding down
shift whilst clicking select over it ). The directory to save to can be
changed by altering the SET Winsprites$Dir command within the !Winsaver !RUN
file or by altering the variable after the !Winsaver icon has appeared on theiconbar. Note that the directory will be created when the icon is clicked if
it does not already exist.
00000000  21 57 69 6e 73 61 76 65  72 20 4e 6f 74 65 73 0a  |!Winsaver Notes.|
00000010  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 0a  |===============.|
00000020  0a 54 6f 20 75 73 65 20  74 68 69 73 20 61 70 70  |.To use this app|
00000030  6c 69 63 61 74 69 6f 6e  20 69 6e 73 74 61 6c 6c  |lication install|
00000040  20 69 74 20 6f 6e 20 74  68 65 20 69 63 6f 6e 62  | it on the iconb|
00000050  61 72 20 62 79 20 64 6f  75 62 6c 65 20 63 6c 69  |ar by double cli|
00000060  63 6b 69 6e 67 20 6f 76  65 72 20 69 74 0a 69 6e  |cking over it.in|
00000070  20 61 20 66 69 6c 65 72  20 77 69 6e 64 6f 77 2e  | a filer window.|
00000080  20 4f 6e 63 65 20 69 6e  73 74 61 6c 6c 65 64 20  | Once installed |
00000090  74 68 65 20 66 6f 6c 6c  6f 77 69 6e 67 20 61 72  |the following ar|
000000a0  65 20 61 76 61 69 6c 61  62 6c 65 20 3a 2d 0a 0a  |e available :-..|
000000b0  53 65 6c 65 63 74 20 6f  76 65 72 20 49 63 6f 6e  |Select over Icon|
000000c0  20 3a 20 20 20 20 20 20  53 61 76 65 20 63 6f 6e  | :      Save con|
000000d0  74 65 6e 74 73 20 6f 66  20 61 6c 6c 20 6f 70 65  |tents of all ope|
000000e0  6e 20 64 65 73 6b 74 6f  70 20 77 69 6e 64 6f 77  |n desktop window|
000000f0  73 20 61 74 20 74 68 65  69 72 0a 20 20 20 20 20  |s at their.     |
00000100  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000110  20 20 20 63 75 72 72 65  6e 74 20 73 69 7a 65 73  |   current sizes|
00000120  2c 20 62 72 69 6e 67 69  6e 67 20 65 61 63 68 20  |, bringing each |
00000130  77 69 6e 64 6f 77 20 74  6f 20 74 68 65 20 22 74  |window to the "t|
00000140  6f 70 22 20 73 6f 20 0a  20 20 20 20 20 20 20 20  |op" so .        |
00000150  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000160  74 68 61 74 20 69 74 20  69 73 20 75 6e 6f 62 73  |that it is unobs|
00000170  63 75 72 65 64 20 77 68  65 6e 20 69 74 20 69 73  |cured when it is|
00000180  20 73 61 76 65 64 2e 20  54 68 65 20 73 61 76 65  | saved. The save|
00000190  64 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |d.              |
000001a0  20 20 20 20 20 20 20 20  20 20 73 70 72 69 74 65  |          sprite|
000001b0  73 20 77 69 6c 6c 20 69  6e 63 6c 75 64 65 20 74  |s will include t|
000001c0  69 74 6c 65 20 26 20 73  63 72 6f 6c 6c 62 61 72  |itle & scrollbar|
000001d0  73 20 65 74 63 20 69 66  0a 20 20 20 20 20 20 20  |s etc if.       |
000001e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000001f0  20 70 72 65 73 65 6e 74  2e 0a 0a 41 64 6a 75 73  | present...Adjus|
00000200  74 20 6f 76 65 72 20 49  63 6f 6e 20 3a 20 20 20  |t over Icon :   |
00000210  20 20 20 41 73 20 53 65  6c 65 63 74 20 62 75 74  |   As Select but|
00000220  20 74 69 74 6c 65 20 26  20 73 63 72 6f 6c 6c 62  | title & scrollb|
00000230  61 72 73 20 61 72 65 20  6e 6f 74 20 73 61 76 65  |ars are not save|
00000240  64 20 2d 20 0a 20 20 20  20 20 20 20 20 20 20 20  |d - .           |
00000250  20 20 20 20 20 20 20 20  20 20 20 20 20 6a 75 73  |             jus|
00000260  74 20 74 68 65 20 77 69  6e 64 6f 77 20 63 6f 6e  |t the window con|
00000270  74 65 6e 74 73 2e 0a 0a  4d 65 6e 75 20 20 20 20  |tents...Menu    |
00000280  20 20 20 20 20 20 20 20  20 3a 20 20 20 20 20 20  |         :      |
00000290  4f 70 65 6e 20 69 63 6f  6e 62 61 72 20 6d 65 6e  |Open iconbar men|
000002a0  75 20 77 69 74 68 20 69  6e 66 6f 20 26 20 71 75  |u with info & qu|
000002b0  69 74 20 65 6e 74 72 69  65 73 2e 0a 0a 0a 53 68  |it entries....Sh|
000002c0  69 66 74 20 26 20 53 65  6c 65 63 74 20 20 20 3a  |ift & Select   :|
000002d0  20 20 20 20 20 20 41 73  20 53 65 6c 65 63 74 20  |      As Select |
000002e0  62 75 74 20 6f 6e 6c 79  20 74 6f 70 20 77 69 6e  |but only top win|
000002f0  64 6f 77 20 69 73 20 73  61 76 65 64 2e 0a 0a 53  |dow is saved...S|
00000300  68 69 66 74 20 26 20 41  64 6a 75 73 74 20 20 20  |hift & Adjust   |
00000310  3a 20 20 20 20 20 20 41  73 20 41 64 6a 75 73 74  |:      As Adjust|
00000320  20 62 75 74 20 6f 6e 6c  79 20 74 6f 70 20 77 69  | but only top wi|
00000330  6e 64 6f 77 20 69 73 20  73 61 76 65 64 2e 0a 0a  |ndow is saved...|
00000340  0a 4d 65 6d 6f 72 79 20  52 65 71 75 69 72 65 6d  |.Memory Requirem|
00000350  65 6e 74 73 0a 2d 2d 2d  2d 2d 2d 2d 2d 2d 2d 2d  |ents.-----------|
00000360  2d 2d 2d 2d 2d 2d 2d 2d  0a 0a 21 57 69 6e 73 61  |--------..!Winsa|
00000370  76 65 72 20 72 65 71 75  69 72 65 73 20 33 32 6b  |ver requires 32k|
00000380  20 6f 66 20 6d 65 6d 6f  72 79 20 77 68 69 6c 73  | of memory whils|
00000390  74 20 69 74 20 69 73 20  69 6e 73 74 61 6c 6c 65  |t it is installe|
000003a0  64 20 62 75 74 20 6e 6f  74 20 61 63 74 69 76 61  |d but not activa|
000003b0  74 65 64 2e 0a 57 68 65  6e 20 73 61 76 69 6e 67  |ted..When saving|
000003c0  20 77 69 6e 64 6f 77 73  20 74 68 65 20 77 69 6d  | windows the wim|
000003d0  70 27 73 20 6e 65 78 74  20 26 20 66 72 65 65 20  |p's next & free |
000003e0  73 6c 6f 74 73 20 61 72  65 20 75 73 65 64 20 74  |slots are used t|
000003f0  6f 20 73 74 6f 72 65 20  74 68 65 20 73 70 72 69  |o store the spri|
00000400  74 65 0a 64 61 74 61 20  50 52 4f 56 49 44 45 44  |te.data PROVIDED|
00000410  20 74 68 61 74 20 74 68  65 20 63 75 72 72 65 6e  | that the curren|
00000420  74 6c 79 20 61 76 61 69  6c 61 62 6c 65 20 6d 65  |tly available me|
00000430  6d 6f 72 79 20 69 73 20  61 74 20 6c 65 61 73 74  |mory is at least|
00000440  20 6c 61 72 67 65 20 65  6e 6f 75 67 68 0a 74 6f  | large enough.to|
00000450  20 68 6f 6c 64 20 74 68  65 20 65 6e 74 69 72 65  | hold the entire|
00000460  20 73 63 72 65 65 6e 20  28 65 67 20 38 30 6b 20  | screen (eg 80k |
00000470  66 6f 72 20 4d 6f 64 65  20 31 32 20 29 2e 20 49  |for Mode 12 ). I|
00000480  66 20 69 6e 73 75 66 66  69 65 6e 74 20 6d 65 6d  |f insuffient mem|
00000490  6f 72 79 20 69 73 0a 61  76 61 69 6c 61 62 6c 65  |ory is.available|
000004a0  20 74 68 65 6e 20 74 68  65 20 2a 53 43 52 45 45  | then the *SCREE|
000004b0  4e 53 41 56 45 20 63 6f  6d 6d 61 6e 64 20 69 73  |NSAVE command is|
000004c0  20 75 73 65 64 20 69 6e  73 74 65 61 64 2c 20 61  | used instead, a|
000004d0  6c 6c 6f 77 69 6e 67 20  74 68 65 20 73 61 76 65  |llowing the save|
000004e0  20 74 6f 0a 74 61 6b 65  20 70 6c 61 63 65 20 73  | to.take place s|
000004f0  61 66 65 6c 79 2e 20 49  66 20 6d 65 6d 6f 72 79  |afely. If memory|
00000500  20 69 73 20 6c 6f 77 20  74 68 65 6e 20 63 61 72  | is low then car|
00000510  65 20 73 68 6f 75 6c 64  20 62 65 20 74 61 6b 65  |e should be take|
00000520  6e 20 74 6f 20 61 76 6f  69 64 0a 49 6e 73 65 72  |n to avoid.Inser|
00000530  74 20 44 69 73 63 20 70  72 6f 6d 70 74 73 20 66  |t Disc prompts f|
00000540  72 6f 6d 20 41 44 46 53  20 73 69 6e 63 65 20 74  |rom ADFS since t|
00000550  68 65 73 65 20 63 61 6e  20 63 6f 72 72 75 70 74  |hese can corrupt|
00000560  20 74 68 65 20 73 61 76  65 64 20 73 70 72 69 74  | the saved sprit|
00000570  65 73 2e 20 0a 20 20 20  20 20 20 20 20 0a 0a 46  |es. .        ..F|
00000580  69 6c 69 6e 67 0a 2d 2d  2d 2d 2d 2d 0a 0a 54 68  |iling.------..Th|
00000590  65 20 73 70 72 69 74 65  20 69 6d 61 67 65 73 20  |e sprite images |
000005a0  6f 66 20 74 68 65 20 77  69 6e 64 6f 77 73 20 61  |of the windows a|
000005b0  72 65 20 73 61 76 65 64  20 69 6e 74 6f 20 74 68  |re saved into th|
000005c0  65 20 53 41 56 45 44 20  64 69 72 65 63 74 6f 72  |e SAVED director|
000005d0  79 20 77 69 74 68 69 6e  0a 74 68 65 20 21 57 69  |y within.the !Wi|
000005e0  6e 73 61 76 65 72 20 61  70 70 6c 69 63 61 74 69  |nsaver applicati|
000005f0  6f 6e 20 64 69 72 65 63  74 6f 72 79 20 28 20 77  |on directory ( w|
00000600  68 69 63 68 20 63 61 6e  20 62 65 20 6f 70 65 6e  |hich can be open|
00000610  65 64 20 62 79 20 68 6f  6c 64 69 6e 67 20 64 6f  |ed by holding do|
00000620  77 6e 0a 73 68 69 66 74  20 77 68 69 6c 73 74 20  |wn.shift whilst |
00000630  63 6c 69 63 6b 69 6e 67  20 73 65 6c 65 63 74 20  |clicking select |
00000640  6f 76 65 72 20 69 74 20  29 2e 20 54 68 65 20 64  |over it ). The d|
00000650  69 72 65 63 74 6f 72 79  20 74 6f 20 73 61 76 65  |irectory to save|
00000660  20 74 6f 20 63 61 6e 20  62 65 0a 63 68 61 6e 67  | to can be.chang|
00000670  65 64 20 62 79 20 61 6c  74 65 72 69 6e 67 20 74  |ed by altering t|
00000680  68 65 20 53 45 54 20 57  69 6e 73 70 72 69 74 65  |he SET Winsprite|
00000690  73 24 44 69 72 20 63 6f  6d 6d 61 6e 64 20 77 69  |s$Dir command wi|
000006a0  74 68 69 6e 20 74 68 65  20 21 57 69 6e 73 61 76  |thin the !Winsav|
000006b0  65 72 20 21 52 55 4e 0a  66 69 6c 65 20 6f 72 20  |er !RUN.file or |
000006c0  62 79 20 61 6c 74 65 72  69 6e 67 20 74 68 65 20  |by altering the |
000006d0  76 61 72 69 61 62 6c 65  20 61 66 74 65 72 20 74  |variable after t|
000006e0  68 65 20 21 57 69 6e 73  61 76 65 72 20 69 63 6f  |he !Winsaver ico|
000006f0  6e 20 68 61 73 20 61 70  70 65 61 72 65 64 20 6f  |n has appeared o|
00000700  6e 20 74 68 65 69 63 6f  6e 62 61 72 2e 20 4e 6f  |n theiconbar. No|
00000710  74 65 20 74 68 61 74 20  74 68 65 20 64 69 72 65  |te that the dire|
00000720  63 74 6f 72 79 20 77 69  6c 6c 20 62 65 20 63 72  |ctory will be cr|
00000730  65 61 74 65 64 20 77 68  65 6e 20 74 68 65 20 69  |eated when the i|
00000740  63 6f 6e 20 69 73 20 63  6c 69 63 6b 65 64 20 69  |con is clicked i|
00000750  66 0a 69 74 20 64 6f 65  73 20 6e 6f 74 20 61 6c  |f.it does not al|
00000760  72 65 61 64 79 20 65 78  69 73 74 2e              |ready exist.|
0000076c