GBChrEd V01.00.00 by TechT
This program is Public Domain
__________________________________________________________________

* What is it?

GBChrEd is a 8x8 character set editor written in Borland Pascal 7 real
mode target for the Nintendo Gameboy which runs on an IBM PC or
compatible with VGA running MS-DOS or PC-DOS.  This program will also
run fine in a DOS window under Windows 95.  Full source code is
included.

* What files are included?

The following files are part of this package:

File		Contents
-----------	-----------------------------------------------------
FILE_ID.DIZ     Archive description for Bulletin Board Systems.
GBCHRED.EXE	The Gameboy character set editor executable file.
GBCHRED.DOC	The Rich Text Format file you are currently reading.
GBCHRED.TXT	Same contents as GBCHRED.DOC but in DOS text format.
GBCHRED.PAS     Borland Pascal source code for the editor.

* How do I use it?

The top of the screen contains an info bar which tells you something
about the last operation performed.  Just below the info bar, there
is a green field which represents the state of the Gameboy character
set  currently being edited.  In this area, there is a red box cursor
which highlits the currently selected character for editing.  Below
and to the left there are four colored areas which show the current
four Gameboy colors.  Underneath these there is a zoom bar which
shows the currently selected character for editing ehich is in the
center, and several adjoining characters which fall to the left and
right of it.  In this bar there is also a small red box cursor which
highlights the currently selected pixel for editing.  The very bottom
of the screen contains the name of the current character file being
edited.  (Note: the bottom line will not appear until a load or save
operation has first been performed.)

The small cursor on the zoom line can be moved with the arrow keys.  If
it is moved off the current character on the zoom line, both the
smaller cursor and the larger cursor in the large green character field
will advance to the next character.  The large cursor can also be
advanced using the shift and arrow keys together.  The 1, 2, 3, and 4
keys located on the top row of the keyboard, or the same keys on the
keypad when the num lock key is enabled, will write the corresponding
Gameboy color to the pixel under the small cursor on the zoom line.
Both the 5 key and the space bar perform an XOR of the current color
under the small zoom cursor with Gameboy color 4.   The N key will
negate or reverse the colors of the currently selected character.  The
delete key will clear the currently selected character.  The C key will
copy the currently selected character to a temporary buffer, and the P
key will paste from the tempoary buffer overwriting the currently
selected character.  The minus key will convert between a signed and
unsigned character set.  There is also an undo of five levels deep
which can be activated by pressing the backspace key.  To save the
current state of the Gameboy character table, press the S key which
will prompt for the file name to save.  To load a previously saved
character table, press the L key then type the file name at the prompt.
The current character set can also be exported to an assembly include
file which is compatible with Table Based Assembler, a shareware cross-
assembler by Speech Technologies, Inc. by pressing the X key and then
typing the file name to export at the prompt.  (Currently, an exported
file can't be loaded back into the editor so remember to save your
creations, not just export them.)  Finally, the ESC key will exit the
editor.

Key		Function
--------	------------------------------------------
1		Place color 1
2		Place color 2
3		Place color 3
4		Place color 4
5		XOR color
Space		XOR color
N		Reverse character colors
Delete	Clear current character
C		Copy current character
P		Paste over current character
-		Signed/unsigned character set conversion
Backspace	Undo
S		Save character set to disk
L		Load character set from disk
X		Export character set to ASM include file
ESC		Exit editor

* How do I contact the author?

I don't currently have an e-mail address.  If you *really must* contact
me, my snail mail address is David Dahl, 66 Hammond Street, Port
Jervis, Ny, 12771, USA.

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

Borland Pascal, IBM PC, MS-DOS, PC-DOS, Windows 95, Nintendo, Gameboy,
Table Based Assembler, Speech Technologies, Inc., and any others I may
have forgotten to include here are trademarks or registered trademarks
of their respective companies.
