Collegial Scatter Release 1.1, March 31, 1994
Copyright (c)1994 by Benedict Brown

Warranty & License:
	The Author provides no warranty, express or implied, as to the fitness of this program for any purpose, the functionality of the program by itself or in relation to any other program.  The Author carries no responsibility for any damages or lost profits caused by the program
	In other words, your using this program at your own risk.  There is no code that will do any damage, except possibly waster paper in your printer if the graphs aren't nice enough, I promise.  If it brings down Windows in flying colors, that's the fault of either Windows, Visual Basic (both of them Microsoft programs by the way), or both.  I wouldn't be surprised if something along those lines does happen, considering that you're working with Windows, BUT DON'T BLAME ME!!!
	Release 1.0 of Collegial Scatter is released into the public domain.  That means you may use it, copy it, give it to friends, whatever for free.  WHEN DISTRIBUTING COLLEGIAL SCATTER, YOU MUST DISTRIBUTE ALL FILES, INCLUDING THIS DOCUMENT.  YOU MAY NOT SELL THIS PROGRAM, OR OTHERWISE CHARGE FOR IT IN ANY WAY WITHOUT EXPRESS WRITTEN PERMISSION OF THE AUTHOR!!!  YOU MAY NOT MODIFY THIS PROGRAM, REVERSE ENGINEER, OR OTHERWISE DO ANYTHING NASTY WITH THE CODE WITHOUT EXPRESS WRITTEN PERMISSION OF THE AUTHOR!!!  (Why you would waste the time reverse engineering the thing, I couldn't say, and the code isn't provided, so that last sentence is fairly pointless, but it looks properly forbidding, so I'm leaving it.)  In case you're interested, costs of disks, shipping, and handling are forbidden as charging for the program.This document is in no particular order, so it is necessary to read it through to the very, very end before sending me any sort of e-mail.  If you ask me any question that is answered in this document, I will, well, I'll do something really bad.  Got it?

Description:
	The purpose of Collegial Scatter is rather limited.  It is designed for college counselors, and nobody else.  It graphs the SAT/ACT (400-1600/1-36) vs GPA (2.0-4.2, with the assumption that people with sub-2.0 GPAs aren't applying to colleges/aren't getting accepted).  The shape of the point indicates whether the applicant attended (a small, solid circle), was accepted but did not attend (a box with a "+" through it), or was rejected (a box with an "x" through it).  Each graph is for a specific college.  In theory, with enough data points, the graph will provide a rough estimate based on test scores and GPA of whether or not somebody will get into the college.
	The program is very easy to use, because it is so primitive.  When you first load it, it will ask you for the name of the college or University whose data you wish to plot.  Then a screen with a list box and a series of buttons will display.  Select add to add a data point.  This will make a new window display.  This window has a series of things to select.  One is the test score.  Click SAT or ACT to select the type of test (default is SAT).  Then click the up and down arrows next to the test scores box to change the score.  Next click the up and down arrows next to the GPA box to change the GPA.  Next click "Rejected," "Accepted" or "Attended" to select whether the applicant was rejected, accepted but did not attend, or attended (default is "Accepted").  Then click OK.  Now the first screen is back, and the data you just entered appears in the list box.  Note to intermediate and advanced users: the arrows for selecting test scores and GPA are actually just very small scroll bars, and behave like them in all respects--I don't have a spin button control.
	Other buttons are as follows: the delete button deletes the currently selected data point, or gives an error if no data point is selected; "Print" prints the graph; and "Quit" quits the program.  There are also two other buttons, namely "Load" and "Save."  "Load" will load data into the program.  If you have data entered, the program will ask if you want to replace it with a loaded file.  IF YOU SAY YES, IT WILL CLEAR ALL DATA.  SELECTING CANCEL WILL NOT GET IT BACK!!!  If you say no, the file load process will be exited.  Next, assuming you continue, you will be presented with an open dialog box.  At the bottom are two buttons: "Ok" and "Cancel."  "Ok" loads the file, "Cancel" cancels.  Remember, however, that all data will still be cleared (the name of the college will not, however).  Select the drive in which the file is loacated from the drive list box, at the lower rigth just above the work "LOAD."  Select the directory in which the file is loacated from the directory list box immediately above the drive list box.  Then type the name of the file name (minus the ".csd") into the text box in the upper left and select "Ok."  Alternatively, you may simply double-click the file name in the file list box (just below the text box).  The file will load.  To save, click save.  The same dialog box will appear with two differences.  First it will say "SAVE" in the lower left corner instead of "LOAD," and second the file name list box will be disabled.  Select the drive and directory as before, and type the file name (minus the ".csd") into the file name into the text box.  Click "Ok."  If there is already a file with that name, you will be asked whether or not to replace it.  You will not be prompted if you are saving it under the same name you loaded it under (but you will always be prompted if you created it instead of loading it).  If you select "Cancel" at any point during the save process, no data will be lost.  Files will automatically have the ".csd" extension added to their name.  Never add the extension yourself--it will only cause trouble.
	The format of the files is no secret.  They are plain ASCII text files, encoded in the following fashion:  The first line is "College: " and the name of the college.  The next line is the number of data entries.  It appears to begin with a space, although I don't know why.  After that, each line is simply a line from the data.  You may load it into any ASCII text editor (such as notepad) and print it, if you want a printout of the list in data form.  You may wish to delete line two.  This is fine, provided you DO NOT save the file when you are done.  This is also a convenient way to change the college name.  All that is necessary is to load the file in Notepad, and fix the name, which is everything after the "College: " on the first line.  BE SURE TO NOT THE SPACE!!!  Actually, it should work fine as long as the name of the college is preceeded by nine characters--it is of no import which.  Note also that you make changes at your own risk--errors may simply cause a minor irritation, or they may destroy your hard drive.  Anything is possible under Windows.

Printing Notes:
	1)It is advised that printing be conducted in landscape mode.  This means that the printer prints on the paper sideways.  To set the printer up this way, double-click "Control Panel" in the "Main" group of the Windows Program Manager.  Double-click "Printers."  Click the "Setup" button at the right side of the window.  Now in the lower left corner of the next window you will see two icons portraying a piece of paper with the letter "A" printed on it.  One paper is vertical, the other is horizontal.  Click the circle to the right of the horizontal paper, then click "OK."  Click "Close" at the right of the "Printers" window, then double-click the hyphen at the upper right corner of the "Control Panel" window.  Your printer will now print sideways.  Be sure to swith back to protrait (vertical) mode when you are done by repeating the above steps, except click the circle next to the vertical piece of paper instead of the horizontal one.
	2)If you use OS/2, be sure that WIN-OS/2 is set to use the print manager.  I don't remember quite how to do this, but one way is to run a WIN-OS/2 full-screen session, and load the print manager.  If a Windows printer driver isn't iinstalled for your printer, install it.  If you don't know how to do this, consult the help in printer setup (which you can get to using the method described above).  Be sure to have your OS/2 master disks handy.  Then just leave print manager running.  Collegial Scatter should also run in a WIN-OS/2 seamless session, as long as it is set to use print manager.  Due to the nature of the Visual Basic printer object, it will not work with OS/2 printer drivers.  If there is a enough demand and/or I figure out how to use gpfREXX, I will create a native OS/2 version.

Bugs...:
	Any problems or suggestions regarding the program should be directed to bbrown@hebron.connected.com, where I can be reached until about mid-summer 1994.  After that you can try, but neither success, nor response are guarenteed.  I'm making the assumption that you will have no questions, because there isn't really anything in the program to question.  Problems will probably occurr with printing, where testing is not very thourough.  The program has been tested using Microsoft Windows 3.1 and IBM OS/2 2.1 and a Canon BJ-10ex printer.  I wouldn't be surprised if it doesn't work very well with other printers, as this one is rather finicky.  The program is designed to print independent of printer or paper size, but that doesn't mean it will work.  Remember also that this program is written primarily for the college & career couseling office at my school, not for the public domain, and is written in my minimal spare time, therefore response, incorporation of suggestions, bug fixes, or any other form of upgrade are none of them guarenteed.

Future Enhancements:
1)Change college name/start a new data set without restarting the program
2)Print graphs to the screen or a file, as well as to the printer
3)Object Linking & Embedding Server
4)Automatically printing in landscape mode, or at least allowing direct entrance to the printer setup program
5)Import & Export ascii database files to allow the use of informtion already entered
6)OS/2 and maybe DOS versions, but NOT Macintosh
If you have other suggestions, e-mail me.  Please keep in mind that I am a novice programmer, and am working with Visual Basic Version 2.0 Standard Edition, i.e. I can't necessarily do much.  Feel free to ask though--you never know.

The following files are required to use Collegial Scatter:
These files are part of the Collegial Scatter program:
 1)scatter.exe, the main program
 2)scatter.txt, this document (and put it into the same directory as scatter.exe--I may be mean and have the program check for this files presence)
The following file is also required for operation of Collegial Scatter:
 1)vbrun200.dll, the Visual Basic 2.0 runtime dll.  Place it in your Windows directory (or wherever you ususally place .dll files if that is somewhere else).

History:
Release 1.1 (3/29/94) - enables save and write!  also fixes some button focus and default problems, and corrects the GPA scale on the printouts
Release 1.0 - initial internal release