HAM-E DEVELOPERS PACKAGE notes/readme

The files in the archive are all related to the Black Belt Systems
HAM-E device. The '.c' files and 'my.lib' provide all a developer needs
to completely understand how the HAM-E device is handled in either it's
REG mode or it's HAM-E mode. It shows how to use the "magic cookie" and
how to create palettes. It also shows how to handle interlace screens.

The source code here is released to the public domain; we want you to
use any part of it either directly or as an example for generating your
own code. Compile and Link details are in hame.c at the top of the file.

You can even tell if you're generating correctly, for the most part, by
looking at the image on your normal Amiga screen (it will be in hi-res
color). It'll look pretty strange, but that's to be expected. This is
how HAM-E images appear to those who do not have the HAM-E device
attached... we think this will make them insatiably curious. We
certainly hope so.

You'll find the C code commented well enough so that you can follow
most anything in there that is worth following. No fancy techniques
were used so that even beginning programmers would be able to
understand what we are working for.

A forthcoming stand-alone example will show you how to render stunning
fixed-up HAM-E mode images, utilizing all 236 color registers. We're
documenting it now.

Ben Williams, AA7AS - for Black Belt Systems - April 19th, 1990