AMX Mouse User Manual
  1. Manuals
  2. Brands
  3. AMX Manuals
  4. Mouse
  5. Mouse
  6. User manual
AMX Mouse User Manual

AMX Mouse User Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Mouse and is the answer not in the manual?

Questions and answers

Related Manuals for AMX Mouse

Summary of Contents for AMX Mouse

  • Page 3 AMX Mouse USER GUIDE For the AMX Mouse & BBC Microcomputer D.S. ELLIOT © 1984 AMS Ltd: and Elliot Software Ltd: ADVANCED MEMORY SYSTEMS LIMITED Green Lane, Appleton, Warrington WA4 5NG Teleph0ne: 0925 62907...

  • Page 5: Table Of Contents

    CONTENTS Page 1 INTRODUCTION ..........The AMX Mouse package ........1.2 Uses of the AMX Mouse ..........2 HOW TO USE THIS GUIDE ......3 SETTING UP ........... 3.1 Fitting the AMX ROM ........... 3.2 Connecting the AMX Mouse ........

  • Page 6: The Amx Mouse Package

    The Mouse comes complete with cable and connector, and is simply plugged into the BBC User port underneath the front of the computer. The Mouse can be set up as described in Chapter 4 using *MCURSOR ON to simulate the cursor keys for use with most normal software, including View and Wordwise, etc.
  • Page 7 Unlike other devices the Mouse does not have the inherant tendency to produce spurious co-ordinates, and by use of the ROM *SENSITIVITY command, can easily be adjusted for response.
  • Page 8 Full details of how to use the Mouse are given in Chapter 4, together with example programs, and a full explanation of the available ROM commands is given in Chapter 5. The use of icons, and the ICON DESIGNER program are detailed in Chapter 6, and AMX...
  • Page 9 The ROM can quickly and simply be fitted using only a screwdriver, but when handling the ROM care must be taken to isolate it from sources of static electricity (e.g: synthetic clothing, carpets etc.). Take care to touch some earthed surface before removing the ROM from its protective anti-static foam, and always handle the chip by holding the ENDS, refrain from touching the pins unnecessarily: The fitting procedure is quite straightforward, but if you are not confident about fitting the ROM then consult your dealer.
  • Page 10 ROM which must not be moved. The other four sockets are for the paged ROMs. The AMX ROM MUST be placed in a high priority socket, (i:e: one to the right) and preferably number 15 (the furthest right). If a ROM expansion board is...

  • Page 11: Connecting The Amx Mouse

    The AMX Mouse is compatible with all other Paged roms tested, as well as with the 6502 2nd processor. Since the Mouse is connected to the only User Port it cannot be used when other devices are plugged into the port. However only 5 bits of the port, and CB1,CB2 are used: This leaves bits 1,3 and 4 available for other uses.
  • Page 12 As the Mouse is moved it generates hardware interrupts. These interrupts are used by the ROM to update various counters. These counters are used in two modes: The counters are used to hold x,y co-ordinates in the range (0-1279,0-1023 which are compatible with the graphics co-ordinate system, i.e. 0,0 is in the bottom left corner.
  • Page 13 This means that the buttons can be programmed to generate key codes in a similar method to the keyboard (see 5.3). The Mouse will also respond to negative inkeys -107,-108,-109 and -129 (which checks all keys on the keyboard): To allow the generation of displays such as fig.3 several commands (such as...
  • Page 14 Icons may be used in either BASIC or Assembly language programs by using the AMX ROM routines. If you wish to display a particular icon, then you simply include *ICON i,x,y in your program: This command displays icon i at TAB(x,y) on the screen. If i is in the range 32-95 then one of the icons in the ROM see 6.3, will be displayed:...
  • Page 15 * HIDEPOINTER and * SHOWPOINTER commands. If you wish to find out the Mouse position, you may use either the OSWORD 64 or * UPDATE commands (see 5:1 and 5:15 later).
  • Page 16 A%=64:CALL &FFF1 This call returns in the 7 bytes pointed to by XY registers, the co-ordinates of the Mouse (in Graphics and Text form), as well as the state of the three Mouse buttons. XY+ 0 LSB of X co-ordinate...
  • Page 17 Mouse position: .forever LDA # 64 LDX # block MOD 256 LDY # block DIV 256 JSR osword / PL0T 69,xcord,ycord LDA # 25 JSR oswrch LDA # 69...
  • Page 18 *BU. 3 *BU. OFF This command controls the action of the Mouse buttons. These three buttons can generate three key codes by varying the number given with the command. If *BUTTONS OFF is used the keys cease to generate the codes. The codes generated depend on the value of n, see below.
  • Page 19 This file is automatically generated by the ICON DESIGNER (see 6:1) which allows the 32 User Icons to be designed using the Mouse. The format of the file is that of 32 icons, each consisting of 32 bytes organised into...
  • Page 20 e.g. *HI. This command is used to remove the pointer from the screen. This is achieved by restoring the screen to its previous contents. These screen contents are stored in the ROM workspace which is reserved by *POINTER ON. The pointer is displayed on the screen by *SHOWPOINTER (see 5.14).

  • Page 21: In Existing Programs

    *MCURSOR OFF. When *MCURSOR ON is used, instead of generating co-ordinates, the ROM converts the Mouse's movement into cursor keys. This mode is therefore intended for use in existing programs such as VIEW, which use the cursor keys for movement.

  • Page 22: Icons

    Whenever the Mouse is to be used several vectors are changed, and interrupts generated. To use programs which are incompatible with the Mouse a *MOUSE OFF command should be used. This command stops the AMX ROM from changing this vector or servicing the interrupts from the User Port.
  • Page 23 e.g. *PO. 80 This command is used to specify which icons are to be used as the pointer: Each pointer consists of two parts. The first icon, i1, is used as the black part of the pointer. The second icon, i2, is used inverted to draw the white mask for the pointer: If icon i2 is not specified then it is assumed that icon number i1+1 is to be used: This method is used to ensure that if the pointer moves over a black area it does not disappear, but a white border can be seen.
  • Page 24 *SE. 2 As the Mouse is moved it generates various interrupts. These interrupts are used to add/subtract numbers (sx,sy) from the current coordinates. The purpose of the *SENSITIVITY command is to set the values of sx and sy: If sy is not used then it is assumed to be the same as sx. The relationship between sx/sy and the number added to the co.ordinate is 2^sx as shown in table 1.

  • Page 25: Pointer

    *UP. This command is used to move the text cursor to the current position of the Mouse (as read by OSWORD 64): The co-ordinates can then be read using POS and VPOS: Since these co-ordinates are in text characters, it is not suitable for graphics: If a window has been defined this command will not return the correct co-ordinates.

  • Page 26: Window

    166 Pointer already hidden 167 BREAK not pressed 168 Illegal mode 169 Pointer switched off 170 Mouse switched off 171 Define file error 254 Bad command The above errors can be trapped in your program by using an ON ERROR GOTO...

  • Page 27: Icon Designer

    The ICON DESIGNER program enables you to define your own icons, which are numbered 0 to 31, and these occupy the 128 character spaces available in the exploded character set (see 5.7). The program is loaded from the MENU program by selecting the appropriate icon and pressing the EXECUTE button followed by a second press when prompted.
  • Page 28 < BREAK> key to reserve ROM workspace, followed by typing 'CHAIN " DESIGN" ' <RETURN> : Incidentally, ICON DESIGNER is a BASIC program which uses the AMX ROM routines and may be listed. On loading you will be presented with the screen shown in figure 4:...
  • Page 29 To alter the icon, simply move the pointer over each enlarged 'dot' and press EXECUTE to invert the colour of the dot. Pressing EXECUTE again will invert the dot back to its original colour. Moving over the window, you may create an icon of your choice. When you are satisfied, simply pick up the icon using the pointer and holding down the MOVE button, 'drag' it to any of the icon positions in the UPPERMOST icon store: On releasing the MOVE button, the icon will be stored in the selected position,...

  • Page 30: Rom Icons

    Fig: 5: The ROM Icons...
  • Page 31 NOTES...
  • Page 32 NOTES...
  • Page 33 NOTES...
  • Page 34 NOTES...

Table of Contents