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

   1 ;
   2 ; colSelect.sh
   3 ;
   4 ; The Sapphire Colour Selector dialogue box
   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 ;   colSelect
  32
  33                 [       :LNOT::DEF:colSelect__dfn
  34                 GBLL    colSelect__dfn
  35
  36 ; --- colSelect ---
  37 ;
  38 ; On entry:     R0 == address of a colour block
  39 ;               R1 == pointer to routine to call when done
  40 ;               R2 == R10 to call routine with
  41 ;               R3 == R12 to call routine with
  42 ;
  43 ; On exit:      R0 = colour selector handle
  44 ;               May return an error
  45 ;
  46 ; Use:          Displays a colour selector dialogue box.  It allows the user
  47 ;               to edit a colour (understatement....)
  48
  49                 IMPORT  colSelect
  50
  51 ;----- The colour selector handler ------------------------------------------
  52 ;
  53 ; The routine you pass to colSelect is entered with R0 as a reason code,
  54 ; and other registers containing values which depend on that.  Reason codes
  55 ; defined are:
  56
  57                 ^       0
  58
  59 csEvent_choice  #       1                       ;User has chosen a colour
  60                                                 ;R1 == pointer to colour blk
  61
  62 csEvent_close   #       1
  63
  64 ;----- Data structures ------------------------------------------------------
  65
  66                 ^       0
  67 col_rgb         #       4                       ;RGB palette entry for colour
  68 col_model       #       4                       ;Colour model for colour
  69 col_data        #       4                       ;Colour data for model
  70 col_size        #       0
  71
  72                 ]
  73
  74 ;----- That's all, folks ----------------------------------------------------
  75
  76                 END