chiark - git - mdw - ssr/blob - StraySrc/Libraries/Sapphire/sh/repeater

   1 ;
   2 ; repeater.sh
   3 ;
   4 ; Handles things that should auto-repeat
   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 ;  repeater
  32 ;  rpt_end
  33
  34                 [       :LNOT::DEF:repeater__dfn
  35                 GBLL    repeater__dfn
  36
  37 ; --- repeater ---
  38 ;
  39 ; On entry:     R0 == pointer to routine to call
  40 ;               R1 == R10 value to pass to routine
  41 ;               R2 == R12 value to pass to routine
  42 ;
  43 ; On exit:      --
  44 ;
  45 ; Use:          Calls a routine (a) immediately, (b) after the configured
  46 ;               keyboard delay rate and (c) repeatedly after the configured
  47 ;               keyboard repeat rate.  Calls stop when the user stops
  48 ;               pressing the mouse button.
  49 ;
  50 ;               The routine is called with R0 containing either the number
  51 ;               of missed calls since the last one (normally this is 1) --
  52 ;               this is intended to be used to implement a kind of buffering
  53 ;               of repeats if the operation being performed is a lengthy one
  54 ;               -- and with 0 to indicate that the operation is now
  55 ;               completed.
  56
  57                 IMPORT  repeater
  58
  59 ; --- rpt_end ---
  60 ;
  61 ; On entry:     --
  62 ;
  63 ; On exit:      --
  64 ;
  65 ; Use:          Ends a repeater before the drag is released. No final
  66 ;               0 is sent to the handler.
  67
  68                 IMPORT  rpt_end
  69
  70                 ]
  71
  72 ;----- That's all, folks ----------------------------------------------------
  73
  74                 END