chiark / gitweb /
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