4 ; Handling of the hourglass
6 ; © 1994-1998 Straylight
9 ;----- Licensing note -------------------------------------------------------
11 ; This file is part of Straylight's Sapphire library.
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)
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.
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.
27 ;----- Overview -------------------------------------------------------------
41 [ :LNOT::DEF:hour__dfn
50 ; Use: Initialises the hour system, so it will display an hourglass
53 ; Since this gets called at a random point during the Sapphire
54 ; initialisation, and we can rely on Hourglass keeping its
55 ; own count, the suggested way of handling everything properly
70 ; Use: Turns the Hourglass on only if it isn't on already.
71 ; Otherwise its status is left as it was.
81 ; Use: Turns the Hourglass off if it's only been turned on once.
82 ; If the Hourglass gets turned off, all the information about
83 ; it (percentage and LEDs) get forgotten.
87 ; --- hour_percent ---
89 ; On entry: R0 == percentage value to display, or -1 to remove
93 ; Use: Attaches a percentage display to the Hourglass.
99 ; On entry: R0 == LED mask EOR value
100 ; R1 == LED mask AND value
104 ; Use: Changes the Hourglass LED status.
108 ; --- hour_suspend ---
110 ; On entry: R0 == pointer to 2 word block to save status in
114 ; Use: Saves the Hourglass state in a block you've pointed at,
115 ; and disables the Hourglass. Useful if you want to do some
116 ; user interaction without polling (e.g. an error box).
122 ; On entry: R0 == pointer to 2 word block to save status in
126 ; Use: Saves the current Hourglass status without altering it.
130 ; --- hour_resume, hour_restore ---
132 ; On entry: R0 == pointer to 2 words filled by hour_suspend or hour_save
136 ; Use: Restores the Hourglass state to that saved away by one
137 ; of the previous two calls. This routine has two names.
141 ; --- hour_resume, hour_restore ---
143 ; On entry: R0 == pointer to 2 words filled by hour_suspend or hour_save
147 ; Use: Restores the Hourglass state to that saved away by one
148 ; of the previous two calls. This routine has two names.
155 ;----- That's all, folks ----------------------------------------------------