Summary:

-Introduction.
-Usage.
-Bugs
-License.
-To contact me.
-Thanks section

This is my first C program, so they may still be some minor bugs.

I wrote this program to learn C, and because I need such a program to some Basic Games I wrote.

Since version 1.1, Mouse is also the kernel of my Basic IDE Bureau 2000 - acronym for Bureau Underwrites Richer Environment And Utilities. :)

History : First Public Version : 13/05/2000 Second Public Version : 25/06/2001

I thought it could also help someone to learn C, that's why I tried to comment it as much as I can.

Some C functions I use come from the excellent Flib of F.Leiber. (francois.leiber@laposte.net)
( You may download latest version of flib at http://leiber.free.fr )
 

Usage:
Allows to make a Windows Interface in a basic program.
New syntaxe (since 1.1 version) :
(différences are in bold)

zzmouse( "picture\name", x position, y position, speed 1, speed 2, speed 3,  exit delay (s.), "remark", grayscale mode, Bitmap mode, "second image");


• Picture name is the pointer name. By default, mouse displays an arrow.
• x position and y position are pointer coordinates.
• Speed 1 is speed using arrows keys. Default is 5 pixels.
• Speed 2 and 3 are speed using respectively arrows + [2nd] and [diamand].
  If you write 0 (also default value), these keys will be considered as commun keys, and pressing them will exit program and return key value.
  
• Exit delay allows you to make event programming, it means to use screensavers , animations , etc... By default, this is desactivated (value 0).
  After Exit Delay seconds of inactivity, the program ends and returns 0 as key value.
  
• Remark : you may display a comment in the status line. By default, there is none (enter "" for none).
• Grayscale mode is 0 or 1. (1 to activate Grayscale mode)
• Bitmap mode is the way the picture should be display.
  The following attributes are supported:

  0 : REVERSE Replace the destination region with the inverse of the source bitmap
  1 : NORMAL OR the source bitmap into the destination region
  2: XOR Exculsive-OR the source bitmap into the destination region
  3 : SHADED Mask the source bitmap so that every other pixel is turned off and replace the destination region with that result (the source region is left unchanged)
  4 : REPLACE Replace the destination region with the source bitmap
  5 : OR OR the source bitmap into the destination region
  6 : AND AND the source bitmap into the destination region
  

• If grayscale mode is activated, screen will be considered as dark gray image, and you may add a second image (in light gray) to obtain a 4 gray levels image.
  

One or more argument may be omitted.

The answer is given in the variable 'ms' as a list.

ms = { x position, y position, key pressed to exit}

Since version 2.2, arrows combinations like left+high,... are also recognized.

Nota: Program is now called zzmouse and not mouse anymore because mouse was a too common name, so if someone else wants to make a game, or I don't know called mouse,... it should stay free. :)
Why zz ? Becaus it is much better for a library to stay at the end of main folder, so as not to perturb your search, when you're searching for something in main :).

Bugs:

I think there shouldn't be any problem.
Nevertheless, it seems there is a strange kind of bug on TI92+ (at least on VTI with a ROM of HW2 2.05)
In fact, it seems that the cursor is moving about 4 times slower on TI92+ than on TI89 !
I really don't know why, because memcpy copies exactly the same number of bytes in both cases, but it seems that the problem don't appear anymore if I remove memcpy line (in that case, it means if I remove memcpy line on both TI89 and TI92+, there is no speed difference !)
Please help me if you know anything more than me, and better a way to solve this problem !
Please also mail me if this don't appear on real TI92+ !
Thanks :)

I would like also to improve the picture display when you choose an other picture, and notably to allow user to use a mask.

License:

Mouse is a library for TI89-Basic programmers.
Copyright (C) 2000-2001 Nicolas POURCELOT

Nicolas POURCELOT
2 imp. du petit bois
87920 Condat/Vienne
http://nicolas.pourcelot.free.fr
nta.pourcelot@libertysurf.fr

This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program;
if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Warning ! If you use parts of this code in your programs, they must be open-source,
as specified in the GNU General Public License.
Thanks. =)

How to contact me:

If you have any question, you may contact me at NTA.Pourcelot@libertysurf.fr
If you find any bug, please contact me at the same address  :)
You may modify and distribute this program under the terms of second version of GNU General Public License.
Nevertheless, please may me if you decide to distribute modify version, because I may be working on it at the same time.

Thanks to:

 Special thanks to:
- Zeljko Jurik for his excellent library. The work he have done is simply wonderful !
- François Leiber who incited me to learn C programming, and who responded all my e-mails, and... ;)
- Vincent Victorix and others to report me bugs, suggestions, etc...
- Aymeric Delbreuil who help me to develop some minor parts of Bureau, but much better stimulate me to advance these projects !
Thank you very much Aymeric :)
- And also all TI community, including Julien Muchembeld, Rusty Wagner, all TIGCC Team, and many others...