chiark / gitweb /
Initial revision
[ssr] / StraySrc / Libraries / Sapphire / sh / ptr
1 ;
2 ; ptr.sh
3 ;
4 ; Pointer changing and caret blinking
5 ;
6 ; © 1994-1998 Straylight
7 ;
8
9 ;----- Licensing note -------------------------------------------------------
10 ;
11 ; This file is part of Straylight's Sapphire library.
12 ;
13 ; Sapphire is free software; you can redistribute it and/or modify
14 ; it under the terms of the GNU General Public License as published by
15 ; the Free Software Foundation; either version 2, or (at your option)
16 ; any later version.
17 ;
18 ; Sapphire is distributed in the hope that it will be useful,
19 ; but WITHOUT ANY WARRANTY; without even the implied warranty of
20 ; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21 ; GNU General Public License for more details.
22 ;
23 ; You should have received a copy of the GNU General Public License
24 ; along with Sapphire.  If not, write to the Free Software Foundation,
25 ; 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
26
27 ;----- Overview -------------------------------------------------------------
28 ;
29 ; Functions provided:
30 ;
31 ;  ptr_setShape
32 ;  ptr_resetShape
33 ;  ptr_blinkOn
34 ;  ptr_blinkOff
35 ;  ptr_init
36
37                 [       :LNOT::DEF:ptr__dfn
38                 GBLL    ptr__dfn
39
40 ; --- ptr_setShape ---
41 ;
42 ; On entry:     R0 == sprite name
43 ;               R1 == x offset of hot spot
44 ;               R2 == y offset of hot spot
45 ;
46 ; On exit:      --
47 ;
48 ; Use:          Set the pointer sprite to the given name. The sprite area
49 ;               used is that returned from resspre_area.
50
51                 IMPORT  ptr_setShape
52
53 ; --- ptr_resetShape ---
54 ;
55 ; On entry:     --
56 ;
57 ; On exit:      --
58 ;
59 ; Use:          Resets the pointer shape to the default.
60
61                 IMPORT  ptr_resetShape
62
63 ; --- ptr_blinkOn ---
64 ;
65 ; On entry:     --
66 ;
67 ; On exit:      --
68 ;
69 ; Use:          Makes the caret blink while it is in a window owned by your
70 ;               application.
71
72                 IMPORT  ptr_blinkOn
73
74 ; --- ptr_blinkOff ---
75 ;
76 ; On entry:     --
77 ;
78 ; On exit:      --
79 ;
80 ; Use:          Turns the caret blinking off.
81
82                 IMPORT  ptr_blinkOff
83
84 ; --- ptr_init ---
85 ;
86 ; On entry:     --
87 ;
88 ; On exit:      --
89 ;
90 ; Use:          Initialises the ptr system.
91
92                 IMPORT  ptr_init
93
94                 ]
95
96 ;----- That's all, folks ----------------------------------------------------
97
98                 END