Name: Paint Studio 83
Author: Brian Koropoff (brianhk@ibm.net)
Version: 0.9
Platform: Ashell83 (and SOS)
Language: TI-83 Basic
Memory: 1788 bytes
Release Date: 8/12/98

Paint Studio 83 is a program designed for people who like
to draw things on their TI-83. It allows fast access to 
multiple tools, each with its own hotkey.  I created this
because I was tired of the inefficient menu system I had to
use to draw anything. It was created with speed and size in
mind, but still features useful tools and an easy-to-use interface.

Disclaimer:  I cannot be held responsible for any damages this
program may cause to you, your calculator, or your grades
(if you use it during class).



How to install:
Upload paint83.83g to your calc.
Reset all the Defaults (I'm not quite sure which settings work). 
Turn Axes Off (otherwise your pictures will have extra lines).
Run paint83 (You can skip my beautiful intro by pressing a key :) )

How to use:

You should now see a dot in the middle of your screen.
You can move the dot around with the arrows. If it's hard to see,
turning up the contrast should help.
Now press 2nd. Your dot just disapeared. This is because you just
used the point change tool, and the cursor is always the invert
of what it is over. Move the cursor away to see dot you just placed.
At this point you know enough to draw a picture, but without the
other features what fun would it be? :)

Press the 2 on the grey number pad. Now place a point somewhere.
Place another point elsewhere.  You now have a line on the screen.

Note: Whenever you place the first point with tools that require multiple
points, you can't cancel and stop drawing what you started. Be sure to
keep track of what you are doing or you might forget and end up drawing
weird crap. I'll probably add a cancel button in the next version.

Summary:
2nd uses current tool, and the number pad selects tools.
The arrows move the cursor around. The cursor is the invert
of what is is over. (The cursor CAN go off the screen)

The next tool is number 3, the rectangle. Place a point for
one corner, and then another for the diaganal opposite.
You should now have a nice rectangle on your screen.

The next tool, number 4, works the same, except it draws a
filled rectangle.

Number 5 is a circle. Put down a point for the middle of the
circle, then a point on the circumference.

Number 6 is the inverted rectangle. You place the corners as
usual, but the rectangle is the invert of what it is over. This
is most useful when used with the text tool, which comes later.

Number 7 draws a line from one point to a point a certain distance
and angle away. Place one point and you will then be prompted for
the length and the angle (in degrees).  Make sure you have your
(theta)min and (theta)max set to the values you want. I always
use 0 and 360.

Number 8 puts text on the screen. Select a point where you
want the text, and you will be prompted to enter a string.
The string entered will be placed so that the upper left
corner of the text is where the point you selected was.
In the next version, I'll make it like the normal text
function that write directly to the graph screen.

Here is the interesting part. The plus and minus keys select color. If
you haven't played with them yet, all of your shapes and things should
have been black. Hit minus and try the line, rectangle, and filled rectangle tools.
The filled rectangle tool makes a good eraser when white. The plus key, of course,
sets it back to black.

Now for the other keys.

Clear clears the screen.
Graph quits.
Y= saves current picture. You will be prompted for a number from 0-9.
  Anything entered outside this range will cancel.
Window loads a picture. Works just like above. Make sure you clear
  the screen first unless you want to superimpose two pictures.
  Also make sure that the picture you try to load exists, or you
  will get an unfriendly error message.

That should be about it.  If you find any bugs, want to make a comment of suggestion,
etc., please do not hesitate to e-mail me. And if you don't like it, it helps
if you tell me why so I can change it in the next version.
I'm also loooking for some help on a filled cirle routine. If you can help
me on this, I would appreciate an e-mail about it.

This program is absolutely free. Give it to all your friends and put it on 
your homepage or archive, if you wish. Feel free to modify it or to pinch a few routines.
Just don't change it and distribute it without giving me credit for
the original.

This is my first public production.  Your comments on my code structure, etc.,
are always welcome, as I am constantly trying to improve my coding skills.

And please never underestimate the power of Basic apps.  This program
proves that Basic is not yet obsolete.  I myself prefer asm games,
but Basic seemed perfectly suited to this type of application.  I
was suprised that this took so little space in memory yet had so many
features.

The version history:


Future versions:
On-screen text entry
Better cursor (maybe)
10*10 stamp tool
Filled circle (If I get a reply to my request)
Whatever people suggest.


Paint Studio 83 V0.9: (This version)
 First public release.
Bugs:
You tell me!
 	
Programming notes: The way I desinged this app makes it very simple to add
new tools. Simply find the statement in PSTOOLS that defines variable T and
add in your own value and key.
Then put an "If T=???:Then:End" in the PSDO program. Now when the key you picked
is pressed, the new tool will be selected, and when you press second, the code within
the "Then" and "End" will be executed. Make sure you reset the cursor state correctly,
or you might leave "mouse droppings" on the screen.

You'll have to examine my other routines to find out what they do. For instance,
PSNPNT changes the point at the cursor (as a temporary marker), saves X and Y to Z and (theta) and gets a new point
from the user. This is used in, among others, the line tool to get the second point
for the line. Maybe with some other versions I'll have a more complete guide
on adding to it.

Thank you for reading through this long document. Since Paint Studio contains
no instructions on calc and relies only on hot-keys, I wanted to make
it clear how to use for people who bother to read the documentation......

....YES! IT WAS BORING FOR ME, TOO! NOW GO TRY IT OUT!!!!!

--End of Document--