Home » Archimedes archive » Acorn User » Acorn User - Shareware Collection (1993).adf » PtrWrap » !PtrWrap/!Help

!PtrWrap/!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 » Archimedes archive » Acorn User » Acorn User - Shareware Collection (1993).adf » PtrWrap
Filename: !PtrWrap/!Help
Read OK:
File size: 08AE bytes
Load address: 0000
Exec address: 0000
File contents
� !PtrWrap
� version 1.01 (29-May-92)
� by Dave Thomas, � 1992

 Purpose ___________________________________________________________________

 I have just heard about an application called '!Wrapper' it 'wraps' the
pointer around the screen, so when you move the pointer onto a screen
boundary it disappears and reappears on the other side of the screen. After
hearing about this I thought 'That's a bit simple' and since I didn't have a
copy of !Wrapper, I wrote this.

 Usage _____________________________________________________________________

 After you have loaded !PtrWrap it's icon will appear on the icon bar. As
soon as it is loaded !PtrWrap is in operation moving the pointer to the edge
of the screen will cause it to vanish and appear on the other side of the
screen.
 Selecting 'Edges' off the menu or clicking Select or Adjust on the icon bar
icon will cause a window to appear. This window controls how far away from
the edge of the screen (in OS-units) the pointer has to be before it will
wrap around. This window is necessary because some modes cause the bits of
the screen that !PtrWrap uses, to be inaccessable to the pointer. A value of
zero in the writeable icon will cause wraping to be disabled.

 Copyright _________________________________________________________________

 This software is supplied "as is", using it is entirely at your own risk. 
You are free to distribute this application to anyone you please via any
medium, provided it is delivered with *all* the supplied files, *unaltered*.
You are not allowed to sell this software and I do not want to see it
supplied as a 'freebie' with any commercial packages, although I welcome
invitations to discuss any details should you want to do so. I (the author)
retain copyright over all of this application apart from the Interface
Manager Module, to which I make no claims.

 If you want a disc packed with all the very latest versions of my apps and
utils, then please send me �3 at the address below.
 If you have any comments, bug reports, suggestions for future versions or
anything else to offer me (oo-er!) don't hesitate to write to -

  Dave Thomas
   20 Rosebery Avenue
     Waterloo
       Liverpool
                 L22 2BH
00000000  0a 8f 20 21 50 74 72 57  72 61 70 0a 8f 20 76 65  |.. !PtrWrap.. ve|
00000010  72 73 69 6f 6e 20 31 2e  30 31 20 28 32 39 2d 4d  |rsion 1.01 (29-M|
00000020  61 79 2d 39 32 29 0a 8f  20 62 79 20 44 61 76 65  |ay-92).. by Dave|
00000030  20 54 68 6f 6d 61 73 2c  20 a9 20 31 39 39 32 0a  | Thomas, . 1992.|
00000040  0a 20 50 75 72 70 6f 73  65 20 5f 5f 5f 5f 5f 5f  |. Purpose ______|
00000050  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
00000080  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 0a 0a 20  |_____________.. |
00000090  49 20 68 61 76 65 20 6a  75 73 74 20 68 65 61 72  |I have just hear|
000000a0  64 20 61 62 6f 75 74 20  61 6e 20 61 70 70 6c 69  |d about an appli|
000000b0  63 61 74 69 6f 6e 20 63  61 6c 6c 65 64 20 27 21  |cation called '!|
000000c0  57 72 61 70 70 65 72 27  20 69 74 20 27 77 72 61  |Wrapper' it 'wra|
000000d0  70 73 27 20 74 68 65 0a  70 6f 69 6e 74 65 72 20  |ps' the.pointer |
000000e0  61 72 6f 75 6e 64 20 74  68 65 20 73 63 72 65 65  |around the scree|
000000f0  6e 2c 20 73 6f 20 77 68  65 6e 20 79 6f 75 20 6d  |n, so when you m|
00000100  6f 76 65 20 74 68 65 20  70 6f 69 6e 74 65 72 20  |ove the pointer |
00000110  6f 6e 74 6f 20 61 20 73  63 72 65 65 6e 0a 62 6f  |onto a screen.bo|
00000120  75 6e 64 61 72 79 20 69  74 20 64 69 73 61 70 70  |undary it disapp|
00000130  65 61 72 73 20 61 6e 64  20 72 65 61 70 70 65 61  |ears and reappea|
00000140  72 73 20 6f 6e 20 74 68  65 20 6f 74 68 65 72 20  |rs on the other |
00000150  73 69 64 65 20 6f 66 20  74 68 65 20 73 63 72 65  |side of the scre|
00000160  65 6e 2e 20 41 66 74 65  72 0a 68 65 61 72 69 6e  |en. After.hearin|
00000170  67 20 61 62 6f 75 74 20  74 68 69 73 20 49 20 74  |g about this I t|
00000180  68 6f 75 67 68 74 20 27  54 68 61 74 27 73 20 61  |hought 'That's a|
00000190  20 62 69 74 20 73 69 6d  70 6c 65 27 20 61 6e 64  | bit simple' and|
000001a0  20 73 69 6e 63 65 20 49  20 64 69 64 6e 27 74 20  | since I didn't |
000001b0  68 61 76 65 20 61 0a 63  6f 70 79 20 6f 66 20 21  |have a.copy of !|
000001c0  57 72 61 70 70 65 72 2c  20 49 20 77 72 6f 74 65  |Wrapper, I wrote|
000001d0  20 74 68 69 73 2e 0a 0a  20 55 73 61 67 65 20 5f  | this... Usage _|
000001e0  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
00000220  5f 5f 5f 5f 0a 0a 20 41  66 74 65 72 20 79 6f 75  |____.. After you|
00000230  20 68 61 76 65 20 6c 6f  61 64 65 64 20 21 50 74  | have loaded !Pt|
00000240  72 57 72 61 70 20 69 74  27 73 20 69 63 6f 6e 20  |rWrap it's icon |
00000250  77 69 6c 6c 20 61 70 70  65 61 72 20 6f 6e 20 74  |will appear on t|
00000260  68 65 20 69 63 6f 6e 20  62 61 72 2e 20 41 73 0a  |he icon bar. As.|
00000270  73 6f 6f 6e 20 61 73 20  69 74 20 69 73 20 6c 6f  |soon as it is lo|
00000280  61 64 65 64 20 21 50 74  72 57 72 61 70 20 69 73  |aded !PtrWrap is|
00000290  20 69 6e 20 6f 70 65 72  61 74 69 6f 6e 20 6d 6f  | in operation mo|
000002a0  76 69 6e 67 20 74 68 65  20 70 6f 69 6e 74 65 72  |ving the pointer|
000002b0  20 74 6f 20 74 68 65 20  65 64 67 65 0a 6f 66 20  | to the edge.of |
000002c0  74 68 65 20 73 63 72 65  65 6e 20 77 69 6c 6c 20  |the screen will |
000002d0  63 61 75 73 65 20 69 74  20 74 6f 20 76 61 6e 69  |cause it to vani|
000002e0  73 68 20 61 6e 64 20 61  70 70 65 61 72 20 6f 6e  |sh and appear on|
000002f0  20 74 68 65 20 6f 74 68  65 72 20 73 69 64 65 20  | the other side |
00000300  6f 66 20 74 68 65 0a 73  63 72 65 65 6e 2e 0a 20  |of the.screen.. |
00000310  53 65 6c 65 63 74 69 6e  67 20 27 45 64 67 65 73  |Selecting 'Edges|
00000320  27 20 6f 66 66 20 74 68  65 20 6d 65 6e 75 20 6f  |' off the menu o|
00000330  72 20 63 6c 69 63 6b 69  6e 67 20 53 65 6c 65 63  |r clicking Selec|
00000340  74 20 6f 72 20 41 64 6a  75 73 74 20 6f 6e 20 74  |t or Adjust on t|
00000350  68 65 20 69 63 6f 6e 20  62 61 72 0a 69 63 6f 6e  |he icon bar.icon|
00000360  20 77 69 6c 6c 20 63 61  75 73 65 20 61 20 77 69  | will cause a wi|
00000370  6e 64 6f 77 20 74 6f 20  61 70 70 65 61 72 2e 20  |ndow to appear. |
00000380  54 68 69 73 20 77 69 6e  64 6f 77 20 63 6f 6e 74  |This window cont|
00000390  72 6f 6c 73 20 68 6f 77  20 66 61 72 20 61 77 61  |rols how far awa|
000003a0  79 20 66 72 6f 6d 0a 74  68 65 20 65 64 67 65 20  |y from.the edge |
000003b0  6f 66 20 74 68 65 20 73  63 72 65 65 6e 20 28 69  |of the screen (i|
000003c0  6e 20 4f 53 2d 75 6e 69  74 73 29 20 74 68 65 20  |n OS-units) the |
000003d0  70 6f 69 6e 74 65 72 20  68 61 73 20 74 6f 20 62  |pointer has to b|
000003e0  65 20 62 65 66 6f 72 65  20 69 74 20 77 69 6c 6c  |e before it will|
000003f0  0a 77 72 61 70 20 61 72  6f 75 6e 64 2e 20 54 68  |.wrap around. Th|
00000400  69 73 20 77 69 6e 64 6f  77 20 69 73 20 6e 65 63  |is window is nec|
00000410  65 73 73 61 72 79 20 62  65 63 61 75 73 65 20 73  |essary because s|
00000420  6f 6d 65 20 6d 6f 64 65  73 20 63 61 75 73 65 20  |ome modes cause |
00000430  74 68 65 20 62 69 74 73  20 6f 66 0a 74 68 65 20  |the bits of.the |
00000440  73 63 72 65 65 6e 20 74  68 61 74 20 21 50 74 72  |screen that !Ptr|
00000450  57 72 61 70 20 75 73 65  73 2c 20 74 6f 20 62 65  |Wrap uses, to be|
00000460  20 69 6e 61 63 63 65 73  73 61 62 6c 65 20 74 6f  | inaccessable to|
00000470  20 74 68 65 20 70 6f 69  6e 74 65 72 2e 20 41 20  | the pointer. A |
00000480  76 61 6c 75 65 20 6f 66  0a 7a 65 72 6f 20 69 6e  |value of.zero in|
00000490  20 74 68 65 20 77 72 69  74 65 61 62 6c 65 20 69  | the writeable i|
000004a0  63 6f 6e 20 77 69 6c 6c  20 63 61 75 73 65 20 77  |con will cause w|
000004b0  72 61 70 69 6e 67 20 74  6f 20 62 65 20 64 69 73  |raping to be dis|
000004c0  61 62 6c 65 64 2e 0a 0a  20 43 6f 70 79 72 69 67  |abled... Copyrig|
000004d0  68 74 20 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |ht _____________|
000004e0  5f 5f 5f 5f 5f 5f 5f 5f  5f 5f 5f 5f 5f 5f 5f 5f  |________________|
*
00000510  5f 5f 5f 5f 0a 0a 20 54  68 69 73 20 73 6f 66 74  |____.. This soft|
00000520  77 61 72 65 20 69 73 20  73 75 70 70 6c 69 65 64  |ware is supplied|
00000530  20 22 61 73 20 69 73 22  2c 20 75 73 69 6e 67 20  | "as is", using |
00000540  69 74 20 69 73 20 65 6e  74 69 72 65 6c 79 20 61  |it is entirely a|
00000550  74 20 79 6f 75 72 20 6f  77 6e 20 72 69 73 6b 2e  |t your own risk.|
00000560  20 0a 59 6f 75 20 61 72  65 20 66 72 65 65 20 74  | .You are free t|
00000570  6f 20 64 69 73 74 72 69  62 75 74 65 20 74 68 69  |o distribute thi|
00000580  73 20 61 70 70 6c 69 63  61 74 69 6f 6e 20 74 6f  |s application to|
00000590  20 61 6e 79 6f 6e 65 20  79 6f 75 20 70 6c 65 61  | anyone you plea|
000005a0  73 65 20 76 69 61 20 61  6e 79 0a 6d 65 64 69 75  |se via any.mediu|
000005b0  6d 2c 20 70 72 6f 76 69  64 65 64 20 69 74 20 69  |m, provided it i|
000005c0  73 20 64 65 6c 69 76 65  72 65 64 20 77 69 74 68  |s delivered with|
000005d0  20 2a 61 6c 6c 2a 20 74  68 65 20 73 75 70 70 6c  | *all* the suppl|
000005e0  69 65 64 20 66 69 6c 65  73 2c 20 2a 75 6e 61 6c  |ied files, *unal|
000005f0  74 65 72 65 64 2a 2e 0a  59 6f 75 20 61 72 65 20  |tered*..You are |
00000600  6e 6f 74 20 61 6c 6c 6f  77 65 64 20 74 6f 20 73  |not allowed to s|
00000610  65 6c 6c 20 74 68 69 73  20 73 6f 66 74 77 61 72  |ell this softwar|
00000620  65 20 61 6e 64 20 49 20  64 6f 20 6e 6f 74 20 77  |e and I do not w|
00000630  61 6e 74 20 74 6f 20 73  65 65 20 69 74 0a 73 75  |ant to see it.su|
00000640  70 70 6c 69 65 64 20 61  73 20 61 20 27 66 72 65  |pplied as a 'fre|
00000650  65 62 69 65 27 20 77 69  74 68 20 61 6e 79 20 63  |ebie' with any c|
00000660  6f 6d 6d 65 72 63 69 61  6c 20 70 61 63 6b 61 67  |ommercial packag|
00000670  65 73 2c 20 61 6c 74 68  6f 75 67 68 20 49 20 77  |es, although I w|
00000680  65 6c 63 6f 6d 65 0a 69  6e 76 69 74 61 74 69 6f  |elcome.invitatio|
00000690  6e 73 20 74 6f 20 64 69  73 63 75 73 73 20 61 6e  |ns to discuss an|
000006a0  79 20 64 65 74 61 69 6c  73 20 73 68 6f 75 6c 64  |y details should|
000006b0  20 79 6f 75 20 77 61 6e  74 20 74 6f 20 64 6f 20  | you want to do |
000006c0  73 6f 2e 20 49 20 28 74  68 65 20 61 75 74 68 6f  |so. I (the autho|
000006d0  72 29 0a 72 65 74 61 69  6e 20 63 6f 70 79 72 69  |r).retain copyri|
000006e0  67 68 74 20 6f 76 65 72  20 61 6c 6c 20 6f 66 20  |ght over all of |
000006f0  74 68 69 73 20 61 70 70  6c 69 63 61 74 69 6f 6e  |this application|
00000700  20 61 70 61 72 74 20 66  72 6f 6d 20 74 68 65 20  | apart from the |
00000710  49 6e 74 65 72 66 61 63  65 0a 4d 61 6e 61 67 65  |Interface.Manage|
00000720  72 20 4d 6f 64 75 6c 65  2c 20 74 6f 20 77 68 69  |r Module, to whi|
00000730  63 68 20 49 20 6d 61 6b  65 20 6e 6f 20 63 6c 61  |ch I make no cla|
00000740  69 6d 73 2e 0a 0a 20 49  66 20 79 6f 75 20 77 61  |ims... If you wa|
00000750  6e 74 20 61 20 64 69 73  63 20 70 61 63 6b 65 64  |nt a disc packed|
00000760  20 77 69 74 68 20 61 6c  6c 20 74 68 65 20 76 65  | with all the ve|
00000770  72 79 20 6c 61 74 65 73  74 20 76 65 72 73 69 6f  |ry latest versio|
00000780  6e 73 20 6f 66 20 6d 79  20 61 70 70 73 20 61 6e  |ns of my apps an|
00000790  64 0a 75 74 69 6c 73 2c  20 74 68 65 6e 20 70 6c  |d.utils, then pl|
000007a0  65 61 73 65 20 73 65 6e  64 20 6d 65 20 a3 33 20  |ease send me .3 |
000007b0  61 74 20 74 68 65 20 61  64 64 72 65 73 73 20 62  |at the address b|
000007c0  65 6c 6f 77 2e 0a 20 49  66 20 79 6f 75 20 68 61  |elow.. If you ha|
000007d0  76 65 20 61 6e 79 20 63  6f 6d 6d 65 6e 74 73 2c  |ve any comments,|
000007e0  20 62 75 67 20 72 65 70  6f 72 74 73 2c 20 73 75  | bug reports, su|
000007f0  67 67 65 73 74 69 6f 6e  73 20 66 6f 72 20 66 75  |ggestions for fu|
00000800  74 75 72 65 20 76 65 72  73 69 6f 6e 73 20 6f 72  |ture versions or|
00000810  0a 61 6e 79 74 68 69 6e  67 20 65 6c 73 65 20 74  |.anything else t|
00000820  6f 20 6f 66 66 65 72 20  6d 65 20 28 6f 6f 2d 65  |o offer me (oo-e|
00000830  72 21 29 20 64 6f 6e 27  74 20 68 65 73 69 74 61  |r!) don't hesita|
00000840  74 65 20 74 6f 20 77 72  69 74 65 20 74 6f 20 2d  |te to write to -|
00000850  0a 0a 20 20 44 61 76 65  20 54 68 6f 6d 61 73 0a  |..  Dave Thomas.|
00000860  20 20 20 32 30 20 52 6f  73 65 62 65 72 79 20 41  |   20 Rosebery A|
00000870  76 65 6e 75 65 0a 20 20  20 20 20 57 61 74 65 72  |venue.     Water|
00000880  6c 6f 6f 0a 20 20 20 20  20 20 20 4c 69 76 65 72  |loo.       Liver|
00000890  70 6f 6f 6c 0a 20 20 20  20 20 20 20 20 20 20 20  |pool.           |
000008a0  20 20 20 20 20 20 4c 32  32 20 32 42 48 0a        |      L22 2BH.|
000008ae