Helmet Editor for NES Tecmo Super Bowl 
  by Matthew Leverton, 2005. Updated to Allegro 5 in 2012.
-----------------------------------------------------------------------------

https://bitbucket.org/leverton/tsb-nes-helmet-editor

This was meant to just be a temporary debugging tool, but ended up being an
almost full featured helmet editor for the stock NES game. As such, the
source is messy and undocumented. All the implementation notes were written
down in a long, lost notebook.

- HOW TO USE -

Run the program. Select a NES ROM file. (Alternatively, you may pass the
name of the NES file on the command line.)

WARNING! The NES file will automatically be saved after you exit the program.
There is no undo or cancel feature (unless you forcefully terminate the app).
You should keep frequent backups.

Click on the helmet you want to edit.

On the left side is the helmet as it will be seen in the game. On the right
side is a list of available tiles to choose from. Below there are palettes
and three drawing tools.

I am not going to get into the details of how the NES stores the graphics,
but suffice it to say that there are many limitations. The helmet is stored
in two pieces: the helmet itself, and the logo. There are four different
helmet backgrounds. The Rams, for instance, have their own helmet since
their logo takes up the entire screen.

The editor does not expand the built-in limitations. So you are stuck with
four base helmets, and the same set of tiles from which to draw.

There are three tools: [D]raw, [M]ove, [C]lear. Click on the appropriate
letter to select the tool.

To make changes to the helmet while in draw mode, select the color under the
"Helmet" caption and begin drawing. Left mouse button draws. Right mouse
button erases. Similarly, select the "Logo" color to make changes to the
logos. You can even draw on the tiles inside the right box.

Note that tiles may be shared among many helmets. 

To move a tile, select the move tool, and drag and drop it. You can discard
a tile by dragging it from the helmet to the tile box on the right.

The following keys can be used:

* Escape: Exit
* 1, 2, 3, 4: Use Helmet #1, #2, #3, or #4
* F10: Toggle full screen
* F11: Toggle the grid
* F12: Toggle unused tiles
* Page Up / Page Down: Switch the bank of tiles
* Up / Down / Left / Right: Move the entire logo

- COMPILING -

Allegro 5 is required, along with its primitives, font, ttf, and dialog
add-ons. If using gcc, just type make. On Windows, you will need to 
adjust the makefile.

If using MSVC, just create a basic project, including everything from
src and include, and link to the above mentioned Allegro libraries.

Allegro is available at http://www.allegro.cc/files. If using Windows,
the pre-built binaries are highly recommended over trying to build it
from source.