Initial revision
[ssr] / StraySrc / Libraries / Sapphire / sh / colourBox
1 ;
2 ; colourBox.sh
3 ;
4 ; Gives you a nice box from which the user may choose a WIMP colour
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 ; colourBox
32
33 [ :LNOT::DEF:colourbox__dfn
34 GBLL colourbox__dfn
35
36 ; --- colourBox ---
37 ;
38 ; On entry: R0 == pointer to a title string (message tag)
39 ; R1 == the current colour in bottom byte, and flags:
40 ; bit 8 == allow transparent colour
41 ; R2 == event handler to call
42 ; R3 == R10 value to pass to handler
43 ; R4 == R12 value to pass to handle
44 ;
45 ; On exit: May return an error
46 ;
47 ; Use: Opens a dialogue box which allows the user to choose
48 ; one of the wimp colours. A transparent colour is supported,
49 ; and represented as colour 255.
50
51 IMPORT colourBox
52
53 ]
54
55 ;----- Events --------------------------------------------------------------
56
57 ^ 0
58 cbEvent_select # 1 ;User selected a colour
59 ;R1 == colour selected
60
61 ;----- That's all, folks ----------------------------------------------------
62
63 END