Mouse V1.0 November 20, 1995 Turn your Newton into a Drawing Tablet for your computer ! This is "Mouse", a serial mouse emulator for MicroSloth PC's and Amiga's, and if the drivers are available, UNIX/LINUX machines with serial mouse capability. It is a really GREAT example of HOW NOT TO program the Newton. Inspired by NewtTablet, which turns the Newton into a Mac Mouse (only works on some Macs). You should be able to read this file okay, MOUSE.ZIP was put on a PC before archival. Source code is available for NTK 1.5, DOS, Amiga or Mac disk format. Semi Legal Junk : Except for the mouse drivers, which are freely redistributable, everything in this archive is copyrighted by ME, the author. You may freely distribute it, and may NOT sell it. You MAY use it for educational purposes and fun, you MAY NOT use it to conquer the world or other nefarious schemes. It is provided "As Is" with no warranty, use at your own risk, read the bug report below before using. Back up your Newton before using. WARNING : This is my first effort at programming the Newton, I've tested it to the best of my ability. Distribution MUST include all files listed below. If this distribution is incomplete please delete it and email me for a complete copy : Paul Cimino, cimino@mdso.vf.ge.com What's here : Mouse.pkg Newton Serial Mouse emulation package README.TXT This file AMIGA.UTL A directory containing Amiga files : mouse drivers which allow the Amiga to use a serial mouse, some with source code IBMPC.UTL A directory with PC mouse driver Getting Started : Load the Mouse.pkg as you normally would, with the Connection Kit, or (I highly recommend) YAPI, by Scott Herndon SHern@eworld.com (see History, below). Once loaded, connect the Newton via NULL modem cable. Find an Apple modem cable (8 pin DIN to 25 D-Sub connector). You may need a NULL modem adapter, a gender changer and possibly a 25-Pin to 9-Pin adapter. Any and all of these things are available (expensively) from CompUSA or similar. You can get them cheap mail order. I believe the cable that comes with PC Connection Kit will work as is, a 25 pin to 9 pin adapter is included. Or you can order a cable from me, which will work with YAPI. (See CABLES, Below) Now load the driver on the computer and start "Mouse". Hit the "Connect" button and you're ready to go. Use : First thing you may want to do is press the "Cal" (Calibrate) button. This should move the pointer on your computer screen to the Upper Left Hand corner. You may may notice a mark in the upper left corner of the box of the Newton "Mouse" screen. Draw a line in the Mouse box and watch your screen. Mouse draws a line following your movements and puts a mark where you left the pointer. You do not have to put your pen down where you stopped, Mouse remembers (sort of, see the bug report) where you left off. Notice the faster you move your pen, the faster the mouse moves (see bug report) The Calibrate button I already mentioned. Connect/Disconnect hooks you up with your computer. The Erase button wipes the Screen clean, but leaves the marker in the last position. Manual/Automatic Button toggles drawing behavior. Manual let's you do the "Erase" while Automatic keeps the screen uncluttered. The "Right" and "Left" buttons correspond to tapping the mouse right or left button (sorry, no middle key). Similarly, the "Hold" buttons hold down the listed key, so you can do things like move down a menu, drag and drop, etc. About the screen size : Originally, I intended to use a scaling factor so one screen width on the Newton but you would lose resolution (Each Newt pixel = n CRT pixels). So the Label Picker for screen modes DOES NOT DO ANYTHING YET ! I hope to add capability to this program to scroll the screen around as you move the pen closer to the edge. In the mean time, you can draw horizontal lines or vertical until the mouse moves to where you want, the screen Newton screen won't look pretty, but oh well. Hopefully I can fix this little problem. At the time of this writing, I would like to add : New Auto mode, which only draws lines when one of the keys is held down, and a scrolling drawing area, since the Newt drawing area is much smaller than any PC screen, and scaling would result in lost resolution. Bugs: I still need to learn more about communication endpoints and exception handling. As a result, Mouse works fine when you connect it, but after you disconnect, you can not reconnect, you have to exit Mouse and restart. For some reason, if you draw on the Newton screen too fast, it messes up the last end point for the line. I've noticed similar bugs in programs using the Newton's drawing routines. History : I think the Newton is great, but I really love my Amiga (I won't bore you with how great it is, ahead of it's time, still pretty impressive for a PC, or even compared to some work stations, yadda yadda yaddda) One of my biggest complaints about Apple is their overwhelming desire to make every aspect of their machine proprietary. There are always good reasons to make your own design, but anything that communicates with the outside world should be as flexible and open as possible (i.e. the Serial Port and any communication protocals being used) unless you are actually adding value, and not just trying to lock up your market in a strangle hold. This is why I like YAPI so much, it allows package installation from any computer with XModem and the proper cable (see below). I am working on a program which makes Newton books on the Amiga/Unix platforms, similar to Paperback (another excellent program) which is available for Macs and IBM. I would also like to figure out the Newton protocal, allowing package installation onto the Newton without YAPI. I have finally received my Apple License package which includes info on the Newton package formats. So hopefully I'll be able to find time to put into these efforts. A compiler would be nice. I know of one person working on a Gnu compiler for the Newton : Ross Sponholtz, ross@wwa.com, http://miso.wwa.com/~ross CABLES : To use Mouse, you need a Null modem cable with an 8 Pin DIN for the Newton, and the appropriate connector on the other end. Sparc (I'd like to see a serial mouse on a Sparc ! :-) ) users just need the standard Apple cable, 8 Pin DIN on both ends. Most PC users can buy an Apple Modem cable, which has a DB 25 connector on one end, then buy a Null Modem adapter, a Gender Changer, and if needed, a 25 to 9 pin adapter. If you own the PC Connection Kit, you're all set. However, these cables will not work with YAPI because you must have the proper wiring for the Hardware Handshake. PCs mostly use software error checking, so the cables usually lack the right wire. Rumor has it you can get a Mac<=>Modem cable WITH the correct wiring, I haven't seen it myself. If you'd like to order a cable from me, I will provide a NULL Modem cable which will work with YAPI, and have a DB25 FEMALE or DB9 FEMALE connector on one end, and an Apple 8 pin DIN on the other. Price is $20 prepaid, includes S&H in the continental US. I probably won't be making any money at that price, and you can probably get it cheaper if you can find someone who sells the correct cable. Source code is also available for "Mouse", send $10 US (domestic mail only, $20 foreign delivery US funds) to me, specify Amiga, PC or Mac disk. I can be contacted at : Paul Cimino 564 Worthington Rd Chester Springs, PA 19425 cimino@mdso.vf.ge.com OR on CompuServe 73677,1761 If you try to reach me via CompuServe, I may be slow getting back to you. Semi Legal Junk : Amiga is a registered trade mark of Escom Gmb MacIntosh, NTK, Newton, and NewtonScript are registered trade marks of Apple. RunNewt is copyrighted by Steve Weyer (weyer@netaxs.com) Paperback is by David Fedor