Player Graphic Creation RAD Tool

=================================



This library 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

Lesser General Public License for more details.



NOTE:  If you're using Mac Classic (OS 9 or below), let me know and

I'll send you a double-clickable version of the application.





Use:

=================================



This app is hopefully incredibly easy to use after you figure out how to

call it from the command line.



Download the .jar file called grpxRad.jar.  From the command line,

provided you have at least Java 1.1 and Swing properly installed on your

machine, type the following line in the same directory where you have

the jar stored (note that Java 1.2 and above have Swing by default):



java -cp grpx.jar frmGrpxRad



Voila.  Each time you even move focus to the eighth checkbox on each

row, a new row will be added.  When you hit "Control-G", the graphics

that represent what you've got in the form will be written to the

console.  That's it.  Nothing fancy.  Alternately, you can select

"Create Graphics" from the menu bar if you're the mousing type.  Or even

alt-A, G if you like typing a lot or your control key is broken.



Note that the output comes with some comments, a fake org address, and

a, well, whatever it is that you call the names that let the app know to

where you'll be JMPing and branching.  You'll want to change the org

address and JMP-name/header.  Here's an example of the output.



;============================

;  Player graphic data

;============================



        org $XX00

player0data

        byte #%11000011

        byte #%00111100

        byte #%00100100

        byte #%00100100

        byte #%00111100

        byte #%11000011

        byte #%00000000

;============================

;  End player graphic data

;============================



I find the easiest way to use the app is to hit tab to move focus one

checkbox to the right/down a row and shift-tab to go left/up a row and

the space bar to toggle the checks.





Saving and opening:

=================================



Saving will save results like the above to a text file.



Opening a file will look for the ASCII character "#" followed by the

character "%", and will then read in the next eight bytes looking for

ASCII "1"'s, which it will turn into checked check boxes.  Any other

byte value will be turned into an unchecked box.  Note that this means

you don't have to just open files created with the app -- any text file

with "#%XXXXXXXX" will do.



Opening from the clipboard is pretty handy.  Copy some graphics in

binary (eg, #11110000) from your favorite text editor and hit

Control-Shift-O and *poof*, it's in the app.





Other Jive:

=================================



Source is also available (LGPL'd cuz I spent so much time on this

incredibly fancy app) if you want it.



Email requests to rufwork@hotmail.com



7/20/2002 -- Version 1.11

	Added ability to open contents of system clipboard into app.



7/18/2002 -- Version 1.1

	Can now save and open files based on (duh)

	what you've got in your GUI

	

7/14/2002 -- Version 1.0

	initial release