Home » Archimedes archive » Micro User » MU 1991-04.adf » PD-Stuff » interface/demo/h/Interface

interface/demo/h/Interface

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Micro User » MU 1991-04.adf » PD-Stuff
Filename: interface/demo/h/Interface
Read OK:
File size: 19A2 bytes
Load address: 0000
Exec address: 0000
File contents
/*
 *
 *       Title                  : ADFS::$.h.interface
 *       System                 : Risc-OS library
 *       Version                : 1.25
 *       Copyright              : � Software Interrupt
 *       Date                   : 25nd September, 1990
 *       Author                 : Simon Huntington
 *
 *       Function               : Headers for Interface functions
 *
 */

#include "wimpt.h"
#include "wimp.h"
#include "os.h"






/* 
 *============================================================================
 *
 * Hash defines the swi numbers
 * 
 *============================================================================
 */

#define  wimp_borderi             0x81680
#define  wimp_borderw             0x81681
#define  wimp_claim               0x81682
#define  wimp_release             0x81683
#define  wimp_setworkpointer      0x81684
#define  wimp_relworkpointer      0x81685
#define  wimp_pollpoint           0x81686
#define  wimp_help                0x81687





/* 
 *============================================================================
 *
 * Define the structure for a pointer
 * 
 *============================================================================
 */

typedef struct
{
     int   window_handle,
           x0,
           y0,
           x1,
           y1;                  
     char  ptr_validation [24];
} wimp_pointer;





/* 
 *============================================================================
 *
 * Function to border an icon
 *
 *    Parameters :     mouse - mouse string containg icon, window, buttons
 *
 *    Returns :        An error is not successful
 *  
 *============================================================================
 */

os_error *wimp_bordericon (mouse)
     
     wimp_mousestr mouse;
          
     {
          os_regset regs;
          os_error  *error;

          regs.r[1] = (int) &mouse;
          error = os_swix (wimp_borderi, &regs);

          return error;
     }





/* 
 *============================================================================
 *
 * Function to border a window
 *
 *    Parameters :     redraw_box - a redraw box as returned from wimp_EREDRAW
 *                                  poll code
 *
 *    Returns :        An error is not successful
 *  
 *============================================================================
 */

os_error *wimp_borderwindow (redraw_box)
     
     wimp_redrawstr redraw_box;
          
     {
          os_regset regs;
          os_error  *error;


          regs.r[1] = (int) &redraw_box;
          error = os_swix (wimp_borderw, &regs);

          return error;
     }





/* 
 *============================================================================
 *
 * Function to allow application to use Interface pointers
 *
 *    Parameters :     None
 *
 *    Returns :        An error is not successful
 *  
 *============================================================================
 */

os_error *wimp_claiminterface (void)              
     {
          os_regset regs;
          os_error  *error;

          regs.r[0] = (int) wimpt_task ();
          error = os_swix (wimp_claim, &regs);

          return error;
     }





/* 
 *============================================================================
 *
 * Function to stop the application using pointers and remove any workspace
 * used by the application
 *
 *    Parameters :     None
 *
 *    Returns :        An error is not successful
 *  
 *============================================================================
 */

os_error *wimp_releaseinterface (void)              
     {
          os_regset regs;
          os_error  *error;

          regs.r[0] = (int) wimpt_task ();
          error = os_swix (wimp_release, &regs);

          return error;
     }





/* 
 *============================================================================
 *
 * Function to set a workarea pointer
 *
 *    Parameters :     pointer - a pointer block as described at the start
 *                               of this header
 *
 *    Returns :        An error is not successful
 *  
 *============================================================================
 */

os_error *wimp_setworkareapointer (pointer)
     
     wimp_pointer pointer;
          
     {
          os_regset regs;
          os_error  *error;

          regs.r[1] = (int) &pointer;
          error = os_swix (wimp_setworkpointer, &regs);

          return error;
     }





/* 
 *============================================================================
 *
 * Function to release a workarea pointer
 *
 *    Parameters :     pointer - a pointer block as described at the start
 *                               of this header
 *
 *    Returns :        An error is not successful
 *  
 *============================================================================
 */

os_error *wimp_releaseworkareapointer (pointer)
     
     wimp_pointer pointer;
          
     {
          os_regset regs;
          os_error  *error;

          regs.r[0] = (int) wimpt_task ();
          regs.r[1] = (int) &pointer;
          error = os_swix (wimp_relworkpointer, &regs);

          return error;
     }                              





/* 
 *============================================================================
 *
 * Function to swap pointers when over an icon or the appropriate workarea
 *
 *    Parameters :     poll - the wimp poll reason code
 *
 *    Returns :        An error is not successful
 *  
 *============================================================================
 */

os_error *wimp_pollpointer (poll)
     
     int poll;
          
     {
          os_regset regs;
          os_error  *error;

          regs.r[0] = (int) poll;
          regs.r[2] = (int) wimpt_task ();
          error = os_swix (wimp_pollpoint, &regs);

          return error;
     }





/* 
 *============================================================================
 *
 * Function to send help to the help application
 *
 *    Parameters :     message_block - the message block from the help 
 *                                     application
 *
 *    Returns :        An error is not successful
 *  
 *============================================================================
 */

os_error *wimp_sendhelp (message_block) 

     wimp_msghdr *message_block;

     {
          os_regset regs;
          os_error  *error;
          
          regs.r[1] = (int) message_block;
          error = os_swix (wimp_help, &regs);

          return error;
     }

00000000  2f 2a 0a 20 2a 0a 20 2a  20 20 20 20 20 20 20 54  |/*. *. *       T|
00000010  69 74 6c 65 20 20 20 20  20 20 20 20 20 20 20 20  |itle            |
00000020  20 20 20 20 20 20 3a 20  41 44 46 53 3a 3a 24 2e  |      : ADFS::$.|
00000030  68 2e 69 6e 74 65 72 66  61 63 65 0a 20 2a 20 20  |h.interface. *  |
00000040  20 20 20 20 20 53 79 73  74 65 6d 20 20 20 20 20  |     System     |
00000050  20 20 20 20 20 20 20 20  20 20 20 20 3a 20 52 69  |            : Ri|
00000060  73 63 2d 4f 53 20 6c 69  62 72 61 72 79 0a 20 2a  |sc-OS library. *|
00000070  20 20 20 20 20 20 20 56  65 72 73 69 6f 6e 20 20  |       Version  |
00000080  20 20 20 20 20 20 20 20  20 20 20 20 20 20 3a 20  |              : |
00000090  31 2e 32 35 0a 20 2a 20  20 20 20 20 20 20 43 6f  |1.25. *       Co|
000000a0  70 79 72 69 67 68 74 20  20 20 20 20 20 20 20 20  |pyright         |
000000b0  20 20 20 20 20 3a 20 a9  20 53 6f 66 74 77 61 72  |     : . Softwar|
000000c0  65 20 49 6e 74 65 72 72  75 70 74 0a 20 2a 20 20  |e Interrupt. *  |
000000d0  20 20 20 20 20 44 61 74  65 20 20 20 20 20 20 20  |     Date       |
000000e0  20 20 20 20 20 20 20 20  20 20 20 20 3a 20 32 35  |            : 25|
000000f0  6e 64 20 53 65 70 74 65  6d 62 65 72 2c 20 31 39  |nd September, 19|
00000100  39 30 0a 20 2a 20 20 20  20 20 20 20 41 75 74 68  |90. *       Auth|
00000110  6f 72 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |or              |
00000120  20 20 20 3a 20 53 69 6d  6f 6e 20 48 75 6e 74 69  |   : Simon Hunti|
00000130  6e 67 74 6f 6e 0a 20 2a  0a 20 2a 20 20 20 20 20  |ngton. *. *     |
00000140  20 20 46 75 6e 63 74 69  6f 6e 20 20 20 20 20 20  |  Function      |
00000150  20 20 20 20 20 20 20 20  20 3a 20 48 65 61 64 65  |         : Heade|
00000160  72 73 20 66 6f 72 20 49  6e 74 65 72 66 61 63 65  |rs for Interface|
00000170  20 66 75 6e 63 74 69 6f  6e 73 0a 20 2a 0a 20 2a  | functions. *. *|
00000180  2f 0a 0a 23 69 6e 63 6c  75 64 65 20 22 77 69 6d  |/..#include "wim|
00000190  70 74 2e 68 22 0a 23 69  6e 63 6c 75 64 65 20 22  |pt.h".#include "|
000001a0  77 69 6d 70 2e 68 22 0a  23 69 6e 63 6c 75 64 65  |wimp.h".#include|
000001b0  20 22 6f 73 2e 68 22 0a  0a 0a 0a 0a 0a 0a 2f 2a  | "os.h"......./*|
000001c0  20 0a 20 2a 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  | . *============|
000001d0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000210  0a 20 2a 0a 20 2a 20 48  61 73 68 20 64 65 66 69  |. *. * Hash defi|
00000220  6e 65 73 20 74 68 65 20  73 77 69 20 6e 75 6d 62  |nes the swi numb|
00000230  65 72 73 0a 20 2a 20 0a  20 2a 3d 3d 3d 3d 3d 3d  |ers. * . *======|
00000240  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000280  3d 3d 3d 3d 3d 3d 0a 20  2a 2f 0a 0a 23 64 65 66  |======. */..#def|
00000290  69 6e 65 20 20 77 69 6d  70 5f 62 6f 72 64 65 72  |ine  wimp_border|
000002a0  69 20 20 20 20 20 20 20  20 20 20 20 20 20 30 78  |i             0x|
000002b0  38 31 36 38 30 0a 23 64  65 66 69 6e 65 20 20 77  |81680.#define  w|
000002c0  69 6d 70 5f 62 6f 72 64  65 72 77 20 20 20 20 20  |imp_borderw     |
000002d0  20 20 20 20 20 20 20 20  30 78 38 31 36 38 31 0a  |        0x81681.|
000002e0  23 64 65 66 69 6e 65 20  20 77 69 6d 70 5f 63 6c  |#define  wimp_cl|
000002f0  61 69 6d 20 20 20 20 20  20 20 20 20 20 20 20 20  |aim             |
00000300  20 20 30 78 38 31 36 38  32 0a 23 64 65 66 69 6e  |  0x81682.#defin|
00000310  65 20 20 77 69 6d 70 5f  72 65 6c 65 61 73 65 20  |e  wimp_release |
00000320  20 20 20 20 20 20 20 20  20 20 20 20 30 78 38 31  |            0x81|
00000330  36 38 33 0a 23 64 65 66  69 6e 65 20 20 77 69 6d  |683.#define  wim|
00000340  70 5f 73 65 74 77 6f 72  6b 70 6f 69 6e 74 65 72  |p_setworkpointer|
00000350  20 20 20 20 20 20 30 78  38 31 36 38 34 0a 23 64  |      0x81684.#d|
00000360  65 66 69 6e 65 20 20 77  69 6d 70 5f 72 65 6c 77  |efine  wimp_relw|
00000370  6f 72 6b 70 6f 69 6e 74  65 72 20 20 20 20 20 20  |orkpointer      |
00000380  30 78 38 31 36 38 35 0a  23 64 65 66 69 6e 65 20  |0x81685.#define |
00000390  20 77 69 6d 70 5f 70 6f  6c 6c 70 6f 69 6e 74 20  | wimp_pollpoint |
000003a0  20 20 20 20 20 20 20 20  20 20 30 78 38 31 36 38  |          0x8168|
000003b0  36 0a 23 64 65 66 69 6e  65 20 20 77 69 6d 70 5f  |6.#define  wimp_|
000003c0  68 65 6c 70 20 20 20 20  20 20 20 20 20 20 20 20  |help            |
000003d0  20 20 20 20 30 78 38 31  36 38 37 0a 0a 0a 0a 0a  |    0x81687.....|
000003e0  0a 2f 2a 20 0a 20 2a 3d  3d 3d 3d 3d 3d 3d 3d 3d  |./* . *=========|
000003f0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000430  3d 3d 3d 0a 20 2a 0a 20  2a 20 44 65 66 69 6e 65  |===. *. * Define|
00000440  20 74 68 65 20 73 74 72  75 63 74 75 72 65 20 66  | the structure f|
00000450  6f 72 20 61 20 70 6f 69  6e 74 65 72 0a 20 2a 20  |or a pointer. * |
00000460  0a 20 2a 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |. *=============|
00000470  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000004a0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 0a  |===============.|
000004b0  20 2a 2f 0a 0a 74 79 70  65 64 65 66 20 73 74 72  | */..typedef str|
000004c0  75 63 74 0a 7b 0a 20 20  20 20 20 69 6e 74 20 20  |uct.{.     int  |
000004d0  20 77 69 6e 64 6f 77 5f  68 61 6e 64 6c 65 2c 0a  | window_handle,.|
000004e0  20 20 20 20 20 20 20 20  20 20 20 78 30 2c 0a 20  |           x0,. |
000004f0  20 20 20 20 20 20 20 20  20 20 79 30 2c 0a 20 20  |          y0,.  |
00000500  20 20 20 20 20 20 20 20  20 78 31 2c 0a 20 20 20  |         x1,.   |
00000510  20 20 20 20 20 20 20 20  79 31 3b 20 20 20 20 20  |        y1;     |
00000520  20 20 20 20 20 20 20 20  20 20 20 20 20 0a 20 20  |             .  |
00000530  20 20 20 63 68 61 72 20  20 70 74 72 5f 76 61 6c  |   char  ptr_val|
00000540  69 64 61 74 69 6f 6e 20  5b 32 34 5d 3b 0a 7d 20  |idation [24];.} |
00000550  77 69 6d 70 5f 70 6f 69  6e 74 65 72 3b 0a 0a 0a  |wimp_pointer;...|
00000560  0a 0a 0a 2f 2a 20 0a 20  2a 3d 3d 3d 3d 3d 3d 3d  |.../* . *=======|
00000570  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000005b0  3d 3d 3d 3d 3d 0a 20 2a  0a 20 2a 20 46 75 6e 63  |=====. *. * Func|
000005c0  74 69 6f 6e 20 74 6f 20  62 6f 72 64 65 72 20 61  |tion to border a|
000005d0  6e 20 69 63 6f 6e 0a 20  2a 0a 20 2a 20 20 20 20  |n icon. *. *    |
000005e0  50 61 72 61 6d 65 74 65  72 73 20 3a 20 20 20 20  |Parameters :    |
000005f0  20 6d 6f 75 73 65 20 2d  20 6d 6f 75 73 65 20 73  | mouse - mouse s|
00000600  74 72 69 6e 67 20 63 6f  6e 74 61 69 6e 67 20 69  |tring containg i|
00000610  63 6f 6e 2c 20 77 69 6e  64 6f 77 2c 20 62 75 74  |con, window, but|
00000620  74 6f 6e 73 0a 20 2a 0a  20 2a 20 20 20 20 52 65  |tons. *. *    Re|
00000630  74 75 72 6e 73 20 3a 20  20 20 20 20 20 20 20 41  |turns :        A|
00000640  6e 20 65 72 72 6f 72 20  69 73 20 6e 6f 74 20 73  |n error is not s|
00000650  75 63 63 65 73 73 66 75  6c 0a 20 2a 20 20 0a 20  |uccessful. *  . |
00000660  2a 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |*===============|
00000670  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000006a0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 0a 20 2a  |=============. *|
000006b0  2f 0a 0a 6f 73 5f 65 72  72 6f 72 20 2a 77 69 6d  |/..os_error *wim|
000006c0  70 5f 62 6f 72 64 65 72  69 63 6f 6e 20 28 6d 6f  |p_bordericon (mo|
000006d0  75 73 65 29 0a 20 20 20  20 20 0a 20 20 20 20 20  |use).     .     |
000006e0  77 69 6d 70 5f 6d 6f 75  73 65 73 74 72 20 6d 6f  |wimp_mousestr mo|
000006f0  75 73 65 3b 0a 20 20 20  20 20 20 20 20 20 20 0a  |use;.          .|
00000700  20 20 20 20 20 7b 0a 20  20 20 20 20 20 20 20 20  |     {.         |
00000710  20 6f 73 5f 72 65 67 73  65 74 20 72 65 67 73 3b  | os_regset regs;|
00000720  0a 20 20 20 20 20 20 20  20 20 20 6f 73 5f 65 72  |.          os_er|
00000730  72 6f 72 20 20 2a 65 72  72 6f 72 3b 0a 0a 20 20  |ror  *error;..  |
00000740  20 20 20 20 20 20 20 20  72 65 67 73 2e 72 5b 31  |        regs.r[1|
00000750  5d 20 3d 20 28 69 6e 74  29 20 26 6d 6f 75 73 65  |] = (int) &mouse|
00000760  3b 0a 20 20 20 20 20 20  20 20 20 20 65 72 72 6f  |;.          erro|
00000770  72 20 3d 20 6f 73 5f 73  77 69 78 20 28 77 69 6d  |r = os_swix (wim|
00000780  70 5f 62 6f 72 64 65 72  69 2c 20 26 72 65 67 73  |p_borderi, &regs|
00000790  29 3b 0a 0a 20 20 20 20  20 20 20 20 20 20 72 65  |);..          re|
000007a0  74 75 72 6e 20 65 72 72  6f 72 3b 0a 20 20 20 20  |turn error;.    |
000007b0  20 7d 0a 0a 0a 0a 0a 0a  2f 2a 20 0a 20 2a 3d 3d  | }....../* . *==|
000007c0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000800  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 0a 20 2a 0a 20 2a  |==========. *. *|
00000810  20 46 75 6e 63 74 69 6f  6e 20 74 6f 20 62 6f 72  | Function to bor|
00000820  64 65 72 20 61 20 77 69  6e 64 6f 77 0a 20 2a 0a  |der a window. *.|
00000830  20 2a 20 20 20 20 50 61  72 61 6d 65 74 65 72 73  | *    Parameters|
00000840  20 3a 20 20 20 20 20 72  65 64 72 61 77 5f 62 6f  | :     redraw_bo|
00000850  78 20 2d 20 61 20 72 65  64 72 61 77 20 62 6f 78  |x - a redraw box|
00000860  20 61 73 20 72 65 74 75  72 6e 65 64 20 66 72 6f  | as returned fro|
00000870  6d 20 77 69 6d 70 5f 45  52 45 44 52 41 57 0a 20  |m wimp_EREDRAW. |
00000880  2a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |*               |
00000890  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000008a0  20 20 20 70 6f 6c 6c 20  63 6f 64 65 0a 20 2a 0a  |   poll code. *.|
000008b0  20 2a 20 20 20 20 52 65  74 75 72 6e 73 20 3a 20  | *    Returns : |
000008c0  20 20 20 20 20 20 20 41  6e 20 65 72 72 6f 72 20  |       An error |
000008d0  69 73 20 6e 6f 74 20 73  75 63 63 65 73 73 66 75  |is not successfu|
000008e0  6c 0a 20 2a 20 20 0a 20  2a 3d 3d 3d 3d 3d 3d 3d  |l. *  . *=======|
000008f0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000930  3d 3d 3d 3d 3d 0a 20 2a  2f 0a 0a 6f 73 5f 65 72  |=====. */..os_er|
00000940  72 6f 72 20 2a 77 69 6d  70 5f 62 6f 72 64 65 72  |ror *wimp_border|
00000950  77 69 6e 64 6f 77 20 28  72 65 64 72 61 77 5f 62  |window (redraw_b|
00000960  6f 78 29 0a 20 20 20 20  20 0a 20 20 20 20 20 77  |ox).     .     w|
00000970  69 6d 70 5f 72 65 64 72  61 77 73 74 72 20 72 65  |imp_redrawstr re|
00000980  64 72 61 77 5f 62 6f 78  3b 0a 20 20 20 20 20 20  |draw_box;.      |
00000990  20 20 20 20 0a 20 20 20  20 20 7b 0a 20 20 20 20  |    .     {.    |
000009a0  20 20 20 20 20 20 6f 73  5f 72 65 67 73 65 74 20  |      os_regset |
000009b0  72 65 67 73 3b 0a 20 20  20 20 20 20 20 20 20 20  |regs;.          |
000009c0  6f 73 5f 65 72 72 6f 72  20 20 2a 65 72 72 6f 72  |os_error  *error|
000009d0  3b 0a 0a 0a 20 20 20 20  20 20 20 20 20 20 72 65  |;...          re|
000009e0  67 73 2e 72 5b 31 5d 20  3d 20 28 69 6e 74 29 20  |gs.r[1] = (int) |
000009f0  26 72 65 64 72 61 77 5f  62 6f 78 3b 0a 20 20 20  |&redraw_box;.   |
00000a00  20 20 20 20 20 20 20 65  72 72 6f 72 20 3d 20 6f  |       error = o|
00000a10  73 5f 73 77 69 78 20 28  77 69 6d 70 5f 62 6f 72  |s_swix (wimp_bor|
00000a20  64 65 72 77 2c 20 26 72  65 67 73 29 3b 0a 0a 20  |derw, &regs);.. |
00000a30  20 20 20 20 20 20 20 20  20 72 65 74 75 72 6e 20  |         return |
00000a40  65 72 72 6f 72 3b 0a 20  20 20 20 20 7d 0a 0a 0a  |error;.     }...|
00000a50  0a 0a 0a 2f 2a 20 0a 20  2a 3d 3d 3d 3d 3d 3d 3d  |.../* . *=======|
00000a60  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000aa0  3d 3d 3d 3d 3d 0a 20 2a  0a 20 2a 20 46 75 6e 63  |=====. *. * Func|
00000ab0  74 69 6f 6e 20 74 6f 20  61 6c 6c 6f 77 20 61 70  |tion to allow ap|
00000ac0  70 6c 69 63 61 74 69 6f  6e 20 74 6f 20 75 73 65  |plication to use|
00000ad0  20 49 6e 74 65 72 66 61  63 65 20 70 6f 69 6e 74  | Interface point|
00000ae0  65 72 73 0a 20 2a 0a 20  2a 20 20 20 20 50 61 72  |ers. *. *    Par|
00000af0  61 6d 65 74 65 72 73 20  3a 20 20 20 20 20 4e 6f  |ameters :     No|
00000b00  6e 65 0a 20 2a 0a 20 2a  20 20 20 20 52 65 74 75  |ne. *. *    Retu|
00000b10  72 6e 73 20 3a 20 20 20  20 20 20 20 20 41 6e 20  |rns :        An |
00000b20  65 72 72 6f 72 20 69 73  20 6e 6f 74 20 73 75 63  |error is not suc|
00000b30  63 65 73 73 66 75 6c 0a  20 2a 20 20 0a 20 2a 3d  |cessful. *  . *=|
00000b40  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000b80  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 0a 20 2a 2f 0a  |===========. */.|
00000b90  0a 6f 73 5f 65 72 72 6f  72 20 2a 77 69 6d 70 5f  |.os_error *wimp_|
00000ba0  63 6c 61 69 6d 69 6e 74  65 72 66 61 63 65 20 28  |claiminterface (|
00000bb0  76 6f 69 64 29 20 20 20  20 20 20 20 20 20 20 20  |void)           |
00000bc0  20 20 20 0a 20 20 20 20  20 7b 0a 20 20 20 20 20  |   .     {.     |
00000bd0  20 20 20 20 20 6f 73 5f  72 65 67 73 65 74 20 72  |     os_regset r|
00000be0  65 67 73 3b 0a 20 20 20  20 20 20 20 20 20 20 6f  |egs;.          o|
00000bf0  73 5f 65 72 72 6f 72 20  20 2a 65 72 72 6f 72 3b  |s_error  *error;|
00000c00  0a 0a 20 20 20 20 20 20  20 20 20 20 72 65 67 73  |..          regs|
00000c10  2e 72 5b 30 5d 20 3d 20  28 69 6e 74 29 20 77 69  |.r[0] = (int) wi|
00000c20  6d 70 74 5f 74 61 73 6b  20 28 29 3b 0a 20 20 20  |mpt_task ();.   |
00000c30  20 20 20 20 20 20 20 65  72 72 6f 72 20 3d 20 6f  |       error = o|
00000c40  73 5f 73 77 69 78 20 28  77 69 6d 70 5f 63 6c 61  |s_swix (wimp_cla|
00000c50  69 6d 2c 20 26 72 65 67  73 29 3b 0a 0a 20 20 20  |im, &regs);..   |
00000c60  20 20 20 20 20 20 20 72  65 74 75 72 6e 20 65 72  |       return er|
00000c70  72 6f 72 3b 0a 20 20 20  20 20 7d 0a 0a 0a 0a 0a  |ror;.     }.....|
00000c80  0a 2f 2a 20 0a 20 2a 3d  3d 3d 3d 3d 3d 3d 3d 3d  |./* . *=========|
00000c90  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000cd0  3d 3d 3d 0a 20 2a 0a 20  2a 20 46 75 6e 63 74 69  |===. *. * Functi|
00000ce0  6f 6e 20 74 6f 20 73 74  6f 70 20 74 68 65 20 61  |on to stop the a|
00000cf0  70 70 6c 69 63 61 74 69  6f 6e 20 75 73 69 6e 67  |pplication using|
00000d00  20 70 6f 69 6e 74 65 72  73 20 61 6e 64 20 72 65  | pointers and re|
00000d10  6d 6f 76 65 20 61 6e 79  20 77 6f 72 6b 73 70 61  |move any workspa|
00000d20  63 65 0a 20 2a 20 75 73  65 64 20 62 79 20 74 68  |ce. * used by th|
00000d30  65 20 61 70 70 6c 69 63  61 74 69 6f 6e 0a 20 2a  |e application. *|
00000d40  0a 20 2a 20 20 20 20 50  61 72 61 6d 65 74 65 72  |. *    Parameter|
00000d50  73 20 3a 20 20 20 20 20  4e 6f 6e 65 0a 20 2a 0a  |s :     None. *.|
00000d60  20 2a 20 20 20 20 52 65  74 75 72 6e 73 20 3a 20  | *    Returns : |
00000d70  20 20 20 20 20 20 20 41  6e 20 65 72 72 6f 72 20  |       An error |
00000d80  69 73 20 6e 6f 74 20 73  75 63 63 65 73 73 66 75  |is not successfu|
00000d90  6c 0a 20 2a 20 20 0a 20  2a 3d 3d 3d 3d 3d 3d 3d  |l. *  . *=======|
00000da0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000de0  3d 3d 3d 3d 3d 0a 20 2a  2f 0a 0a 6f 73 5f 65 72  |=====. */..os_er|
00000df0  72 6f 72 20 2a 77 69 6d  70 5f 72 65 6c 65 61 73  |ror *wimp_releas|
00000e00  65 69 6e 74 65 72 66 61  63 65 20 28 76 6f 69 64  |einterface (void|
00000e10  29 20 20 20 20 20 20 20  20 20 20 20 20 20 20 0a  |)              .|
00000e20  20 20 20 20 20 7b 0a 20  20 20 20 20 20 20 20 20  |     {.         |
00000e30  20 6f 73 5f 72 65 67 73  65 74 20 72 65 67 73 3b  | os_regset regs;|
00000e40  0a 20 20 20 20 20 20 20  20 20 20 6f 73 5f 65 72  |.          os_er|
00000e50  72 6f 72 20 20 2a 65 72  72 6f 72 3b 0a 0a 20 20  |ror  *error;..  |
00000e60  20 20 20 20 20 20 20 20  72 65 67 73 2e 72 5b 30  |        regs.r[0|
00000e70  5d 20 3d 20 28 69 6e 74  29 20 77 69 6d 70 74 5f  |] = (int) wimpt_|
00000e80  74 61 73 6b 20 28 29 3b  0a 20 20 20 20 20 20 20  |task ();.       |
00000e90  20 20 20 65 72 72 6f 72  20 3d 20 6f 73 5f 73 77  |   error = os_sw|
00000ea0  69 78 20 28 77 69 6d 70  5f 72 65 6c 65 61 73 65  |ix (wimp_release|
00000eb0  2c 20 26 72 65 67 73 29  3b 0a 0a 20 20 20 20 20  |, &regs);..     |
00000ec0  20 20 20 20 20 72 65 74  75 72 6e 20 65 72 72 6f  |     return erro|
00000ed0  72 3b 0a 20 20 20 20 20  7d 0a 0a 0a 0a 0a 0a 2f  |r;.     }....../|
00000ee0  2a 20 0a 20 2a 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |* . *===========|
00000ef0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00000f30  3d 0a 20 2a 0a 20 2a 20  46 75 6e 63 74 69 6f 6e  |=. *. * Function|
00000f40  20 74 6f 20 73 65 74 20  61 20 77 6f 72 6b 61 72  | to set a workar|
00000f50  65 61 20 70 6f 69 6e 74  65 72 0a 20 2a 0a 20 2a  |ea pointer. *. *|
00000f60  20 20 20 20 50 61 72 61  6d 65 74 65 72 73 20 3a  |    Parameters :|
00000f70  20 20 20 20 20 70 6f 69  6e 74 65 72 20 2d 20 61  |     pointer - a|
00000f80  20 70 6f 69 6e 74 65 72  20 62 6c 6f 63 6b 20 61  | pointer block a|
00000f90  73 20 64 65 73 63 72 69  62 65 64 20 61 74 20 74  |s described at t|
00000fa0  68 65 20 73 74 61 72 74  0a 20 2a 20 20 20 20 20  |he start. *     |
00000fb0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000fc0  20 20 20 20 20 20 20 20  20 20 6f 66 20 74 68 69  |          of thi|
00000fd0  73 20 68 65 61 64 65 72  0a 20 2a 0a 20 2a 20 20  |s header. *. *  |
00000fe0  20 20 52 65 74 75 72 6e  73 20 3a 20 20 20 20 20  |  Returns :     |
00000ff0  20 20 20 41 6e 20 65 72  72 6f 72 20 69 73 20 6e  |   An error is n|
00001000  6f 74 20 73 75 63 63 65  73 73 66 75 6c 0a 20 2a  |ot successful. *|
00001010  20 20 0a 20 2a 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |  . *===========|
00001020  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001060  3d 0a 20 2a 2f 0a 0a 6f  73 5f 65 72 72 6f 72 20  |=. */..os_error |
00001070  2a 77 69 6d 70 5f 73 65  74 77 6f 72 6b 61 72 65  |*wimp_setworkare|
00001080  61 70 6f 69 6e 74 65 72  20 28 70 6f 69 6e 74 65  |apointer (pointe|
00001090  72 29 0a 20 20 20 20 20  0a 20 20 20 20 20 77 69  |r).     .     wi|
000010a0  6d 70 5f 70 6f 69 6e 74  65 72 20 70 6f 69 6e 74  |mp_pointer point|
000010b0  65 72 3b 0a 20 20 20 20  20 20 20 20 20 20 0a 20  |er;.          . |
000010c0  20 20 20 20 7b 0a 20 20  20 20 20 20 20 20 20 20  |    {.          |
000010d0  6f 73 5f 72 65 67 73 65  74 20 72 65 67 73 3b 0a  |os_regset regs;.|
000010e0  20 20 20 20 20 20 20 20  20 20 6f 73 5f 65 72 72  |          os_err|
000010f0  6f 72 20 20 2a 65 72 72  6f 72 3b 0a 0a 20 20 20  |or  *error;..   |
00001100  20 20 20 20 20 20 20 72  65 67 73 2e 72 5b 31 5d  |       regs.r[1]|
00001110  20 3d 20 28 69 6e 74 29  20 26 70 6f 69 6e 74 65  | = (int) &pointe|
00001120  72 3b 0a 20 20 20 20 20  20 20 20 20 20 65 72 72  |r;.          err|
00001130  6f 72 20 3d 20 6f 73 5f  73 77 69 78 20 28 77 69  |or = os_swix (wi|
00001140  6d 70 5f 73 65 74 77 6f  72 6b 70 6f 69 6e 74 65  |mp_setworkpointe|
00001150  72 2c 20 26 72 65 67 73  29 3b 0a 0a 20 20 20 20  |r, &regs);..    |
00001160  20 20 20 20 20 20 72 65  74 75 72 6e 20 65 72 72  |      return err|
00001170  6f 72 3b 0a 20 20 20 20  20 7d 0a 0a 0a 0a 0a 0a  |or;.     }......|
00001180  2f 2a 20 0a 20 2a 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |/* . *==========|
00001190  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000011d0  3d 3d 0a 20 2a 0a 20 2a  20 46 75 6e 63 74 69 6f  |==. *. * Functio|
000011e0  6e 20 74 6f 20 72 65 6c  65 61 73 65 20 61 20 77  |n to release a w|
000011f0  6f 72 6b 61 72 65 61 20  70 6f 69 6e 74 65 72 0a  |orkarea pointer.|
00001200  20 2a 0a 20 2a 20 20 20  20 50 61 72 61 6d 65 74  | *. *    Paramet|
00001210  65 72 73 20 3a 20 20 20  20 20 70 6f 69 6e 74 65  |ers :     pointe|
00001220  72 20 2d 20 61 20 70 6f  69 6e 74 65 72 20 62 6c  |r - a pointer bl|
00001230  6f 63 6b 20 61 73 20 64  65 73 63 72 69 62 65 64  |ock as described|
00001240  20 61 74 20 74 68 65 20  73 74 61 72 74 0a 20 2a  | at the start. *|
00001250  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001260  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 6f  |               o|
00001270  66 20 74 68 69 73 20 68  65 61 64 65 72 0a 20 2a  |f this header. *|
00001280  0a 20 2a 20 20 20 20 52  65 74 75 72 6e 73 20 3a  |. *    Returns :|
00001290  20 20 20 20 20 20 20 20  41 6e 20 65 72 72 6f 72  |        An error|
000012a0  20 69 73 20 6e 6f 74 20  73 75 63 63 65 73 73 66  | is not successf|
000012b0  75 6c 0a 20 2a 20 20 0a  20 2a 3d 3d 3d 3d 3d 3d  |ul. *  . *======|
000012c0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001300  3d 3d 3d 3d 3d 3d 0a 20  2a 2f 0a 0a 6f 73 5f 65  |======. */..os_e|
00001310  72 72 6f 72 20 2a 77 69  6d 70 5f 72 65 6c 65 61  |rror *wimp_relea|
00001320  73 65 77 6f 72 6b 61 72  65 61 70 6f 69 6e 74 65  |seworkareapointe|
00001330  72 20 28 70 6f 69 6e 74  65 72 29 0a 20 20 20 20  |r (pointer).    |
00001340  20 0a 20 20 20 20 20 77  69 6d 70 5f 70 6f 69 6e  | .     wimp_poin|
00001350  74 65 72 20 70 6f 69 6e  74 65 72 3b 0a 20 20 20  |ter pointer;.   |
00001360  20 20 20 20 20 20 20 0a  20 20 20 20 20 7b 0a 20  |       .     {. |
00001370  20 20 20 20 20 20 20 20  20 6f 73 5f 72 65 67 73  |         os_regs|
00001380  65 74 20 72 65 67 73 3b  0a 20 20 20 20 20 20 20  |et regs;.       |
00001390  20 20 20 6f 73 5f 65 72  72 6f 72 20 20 2a 65 72  |   os_error  *er|
000013a0  72 6f 72 3b 0a 0a 20 20  20 20 20 20 20 20 20 20  |ror;..          |
000013b0  72 65 67 73 2e 72 5b 30  5d 20 3d 20 28 69 6e 74  |regs.r[0] = (int|
000013c0  29 20 77 69 6d 70 74 5f  74 61 73 6b 20 28 29 3b  |) wimpt_task ();|
000013d0  0a 20 20 20 20 20 20 20  20 20 20 72 65 67 73 2e  |.          regs.|
000013e0  72 5b 31 5d 20 3d 20 28  69 6e 74 29 20 26 70 6f  |r[1] = (int) &po|
000013f0  69 6e 74 65 72 3b 0a 20  20 20 20 20 20 20 20 20  |inter;.         |
00001400  20 65 72 72 6f 72 20 3d  20 6f 73 5f 73 77 69 78  | error = os_swix|
00001410  20 28 77 69 6d 70 5f 72  65 6c 77 6f 72 6b 70 6f  | (wimp_relworkpo|
00001420  69 6e 74 65 72 2c 20 26  72 65 67 73 29 3b 0a 0a  |inter, &regs);..|
00001430  20 20 20 20 20 20 20 20  20 20 72 65 74 75 72 6e  |          return|
00001440  20 65 72 72 6f 72 3b 0a  20 20 20 20 20 7d 20 20  | error;.     }  |
00001450  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001460  20 20 20 20 20 20 20 20  20 20 20 20 0a 0a 0a 0a  |            ....|
00001470  0a 0a 2f 2a 20 0a 20 2a  3d 3d 3d 3d 3d 3d 3d 3d  |../* . *========|
00001480  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000014c0  3d 3d 3d 3d 0a 20 2a 0a  20 2a 20 46 75 6e 63 74  |====. *. * Funct|
000014d0  69 6f 6e 20 74 6f 20 73  77 61 70 20 70 6f 69 6e  |ion to swap poin|
000014e0  74 65 72 73 20 77 68 65  6e 20 6f 76 65 72 20 61  |ters when over a|
000014f0  6e 20 69 63 6f 6e 20 6f  72 20 74 68 65 20 61 70  |n icon or the ap|
00001500  70 72 6f 70 72 69 61 74  65 20 77 6f 72 6b 61 72  |propriate workar|
00001510  65 61 0a 20 2a 0a 20 2a  20 20 20 20 50 61 72 61  |ea. *. *    Para|
00001520  6d 65 74 65 72 73 20 3a  20 20 20 20 20 70 6f 6c  |meters :     pol|
00001530  6c 20 2d 20 74 68 65 20  77 69 6d 70 20 70 6f 6c  |l - the wimp pol|
00001540  6c 20 72 65 61 73 6f 6e  20 63 6f 64 65 0a 20 2a  |l reason code. *|
00001550  0a 20 2a 20 20 20 20 52  65 74 75 72 6e 73 20 3a  |. *    Returns :|
00001560  20 20 20 20 20 20 20 20  41 6e 20 65 72 72 6f 72  |        An error|
00001570  20 69 73 20 6e 6f 74 20  73 75 63 63 65 73 73 66  | is not successf|
00001580  75 6c 0a 20 2a 20 20 0a  20 2a 3d 3d 3d 3d 3d 3d  |ul. *  . *======|
00001590  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000015d0  3d 3d 3d 3d 3d 3d 0a 20  2a 2f 0a 0a 6f 73 5f 65  |======. */..os_e|
000015e0  72 72 6f 72 20 2a 77 69  6d 70 5f 70 6f 6c 6c 70  |rror *wimp_pollp|
000015f0  6f 69 6e 74 65 72 20 28  70 6f 6c 6c 29 0a 20 20  |ointer (poll).  |
00001600  20 20 20 0a 20 20 20 20  20 69 6e 74 20 70 6f 6c  |   .     int pol|
00001610  6c 3b 0a 20 20 20 20 20  20 20 20 20 20 0a 20 20  |l;.          .  |
00001620  20 20 20 7b 0a 20 20 20  20 20 20 20 20 20 20 6f  |   {.          o|
00001630  73 5f 72 65 67 73 65 74  20 72 65 67 73 3b 0a 20  |s_regset regs;. |
00001640  20 20 20 20 20 20 20 20  20 6f 73 5f 65 72 72 6f  |         os_erro|
00001650  72 20 20 2a 65 72 72 6f  72 3b 0a 0a 20 20 20 20  |r  *error;..    |
00001660  20 20 20 20 20 20 72 65  67 73 2e 72 5b 30 5d 20  |      regs.r[0] |
00001670  3d 20 28 69 6e 74 29 20  70 6f 6c 6c 3b 0a 20 20  |= (int) poll;.  |
00001680  20 20 20 20 20 20 20 20  72 65 67 73 2e 72 5b 32  |        regs.r[2|
00001690  5d 20 3d 20 28 69 6e 74  29 20 77 69 6d 70 74 5f  |] = (int) wimpt_|
000016a0  74 61 73 6b 20 28 29 3b  0a 20 20 20 20 20 20 20  |task ();.       |
000016b0  20 20 20 65 72 72 6f 72  20 3d 20 6f 73 5f 73 77  |   error = os_sw|
000016c0  69 78 20 28 77 69 6d 70  5f 70 6f 6c 6c 70 6f 69  |ix (wimp_pollpoi|
000016d0  6e 74 2c 20 26 72 65 67  73 29 3b 0a 0a 20 20 20  |nt, &regs);..   |
000016e0  20 20 20 20 20 20 20 72  65 74 75 72 6e 20 65 72  |       return er|
000016f0  72 6f 72 3b 0a 20 20 20  20 20 7d 0a 0a 0a 0a 0a  |ror;.     }.....|
00001700  0a 2f 2a 20 0a 20 2a 3d  3d 3d 3d 3d 3d 3d 3d 3d  |./* . *=========|
00001710  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001750  3d 3d 3d 0a 20 2a 0a 20  2a 20 46 75 6e 63 74 69  |===. *. * Functi|
00001760  6f 6e 20 74 6f 20 73 65  6e 64 20 68 65 6c 70 20  |on to send help |
00001770  74 6f 20 74 68 65 20 68  65 6c 70 20 61 70 70 6c  |to the help appl|
00001780  69 63 61 74 69 6f 6e 0a  20 2a 0a 20 2a 20 20 20  |ication. *. *   |
00001790  20 50 61 72 61 6d 65 74  65 72 73 20 3a 20 20 20  | Parameters :   |
000017a0  20 20 6d 65 73 73 61 67  65 5f 62 6c 6f 63 6b 20  |  message_block |
000017b0  2d 20 74 68 65 20 6d 65  73 73 61 67 65 20 62 6c  |- the message bl|
000017c0  6f 63 6b 20 66 72 6f 6d  20 74 68 65 20 68 65 6c  |ock from the hel|
000017d0  70 20 0a 20 2a 20 20 20  20 20 20 20 20 20 20 20  |p . *           |
000017e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000017f0  20 20 20 20 20 20 20 20  20 20 61 70 70 6c 69 63  |          applic|
00001800  61 74 69 6f 6e 0a 20 2a  0a 20 2a 20 20 20 20 52  |ation. *. *    R|
00001810  65 74 75 72 6e 73 20 3a  20 20 20 20 20 20 20 20  |eturns :        |
00001820  41 6e 20 65 72 72 6f 72  20 69 73 20 6e 6f 74 20  |An error is not |
00001830  73 75 63 63 65 73 73 66  75 6c 0a 20 2a 20 20 0a  |successful. *  .|
00001840  20 2a 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  | *==============|
00001850  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001880  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 20  |==============. |
00001890  2a 2f 0a 0a 6f 73 5f 65  72 72 6f 72 20 2a 77 69  |*/..os_error *wi|
000018a0  6d 70 5f 73 65 6e 64 68  65 6c 70 20 28 6d 65 73  |mp_sendhelp (mes|
000018b0  73 61 67 65 5f 62 6c 6f  63 6b 29 20 0a 0a 20 20  |sage_block) ..  |
000018c0  20 20 20 77 69 6d 70 5f  6d 73 67 68 64 72 20 2a  |   wimp_msghdr *|
000018d0  6d 65 73 73 61 67 65 5f  62 6c 6f 63 6b 3b 0a 0a  |message_block;..|
000018e0  20 20 20 20 20 7b 0a 20  20 20 20 20 20 20 20 20  |     {.         |
000018f0  20 6f 73 5f 72 65 67 73  65 74 20 72 65 67 73 3b  | os_regset regs;|
00001900  0a 20 20 20 20 20 20 20  20 20 20 6f 73 5f 65 72  |.          os_er|
00001910  72 6f 72 20 20 2a 65 72  72 6f 72 3b 0a 20 20 20  |ror  *error;.   |
00001920  20 20 20 20 20 20 20 0a  20 20 20 20 20 20 20 20  |       .        |
00001930  20 20 72 65 67 73 2e 72  5b 31 5d 20 3d 20 28 69  |  regs.r[1] = (i|
00001940  6e 74 29 20 6d 65 73 73  61 67 65 5f 62 6c 6f 63  |nt) message_bloc|
00001950  6b 3b 0a 20 20 20 20 20  20 20 20 20 20 65 72 72  |k;.          err|
00001960  6f 72 20 3d 20 6f 73 5f  73 77 69 78 20 28 77 69  |or = os_swix (wi|
00001970  6d 70 5f 68 65 6c 70 2c  20 26 72 65 67 73 29 3b  |mp_help, &regs);|
00001980  0a 0a 20 20 20 20 20 20  20 20 20 20 72 65 74 75  |..          retu|
00001990  72 6e 20 65 72 72 6f 72  3b 0a 20 20 20 20 20 7d  |rn error;.     }|
000019a0  0a 0a                                             |..|
000019a2