================================
"Sleizsa" - Channel F Sequencer
Version: 0.31 (Plant: BugSprayed)
Date: 02/08/2009
Coder: B00daW
================================

==============
Introduction:
==============

  The Channel F is capable of quite a full range of tones via
modulation of the three stock pulse wavetones it has.  This
sequencer does just that.

========================
Why the name "Sleizsa"?
========================

  The NTSC chip of the latest Fairchild Channel F was "SL31254".
I just de-l33ted it.

=======================================
What's needed and included in Sleizsa?
=======================================

- The "Sleizsa" code
- DASM v2.20.10b
- A Channel F System II compatible version of MESS.

Linux/Mac Users:

I assume you know how to hunt for things. The MESS included may work
with WINE/Parallels, but I've not tested. Also, the upcoming version
of MESS should have fixed audio and Channel F System II support.

====================
How to use Sleizsa?
====================

- Configuration
	Open up "main.asm" in the "src" directory.  Under "Assembly
Configuration" you are able to enable a few assembly options.  For the
most part, these are optional and the default is what is necessary.

- Open up "song.inc" to get started.
	The instructions are included in the "song.inc" and the examples
(in the "examples" directory) should suffice the average user to be able
to create a song.  A copy of the original song.inc is located in examples
as "template.inc".

- Compose your song. (Refer to "song.inc" or "template.inc" in "examples".)

- Sign/Label your song in your "song.inc".

- Assemble and play your song with the batch files.

"!compile" will assemble the song and output whatever errors, if any.
"!compile+run" will assemble and run the song as NTSC System II.
"!compile+run-pal" will assemble and run the song as PAL System II.
"!run" will run the song as NTSC System II.
"!run-pal" will run the song as PAL System II.

Linux/Mac users:

I'm going to assume you can convert the batch files to executable scripts.

========
Thanks!
========

 SeanRiddle, e5frog, Blackbird, Urchlay, Andrew Davie, MESSdev,
and others!

===========
Change Log
===========

v0.31 (Plant: BugSprayed):

- Fix:		Fixed a rather crippling bug that didn't allow for creation
		of longer songs.

v0.3 (Plant):

- Addition:	Added max amount of tuned notes on the scale for both NTSC
		(G3 to A#6) and PAL (A3 to C7).
- Addition:	Added the ability for the user to better control the "noise
		instrument".
- Improvement:	Included more accurate, unofficial version of MESS v0.129.1
		by e5frog.  Should improve sound, large ROM support, visuals
		(when implemented), and be compatible with older versions
		of Windows.
- Improvement:	PAL note table is more accurate. (Thanks e5frog.)
- Improvement:  NTSC note table is more accurate.
- Change:	Removed unnecessary warm up routine and replaced it with a
		clear screen routine via BIOS call.
- Optimization: Cleaned up unnecessary portions of code and made documentation
		hopefully more understable.
- Fix:		Troubleshot and fixed some issues regarding the batch files
		to enable the directory to be dropped and executed anywhere;
		the way it should function.

v0.21 (Sproutinging):

- Addition:	Preliminary noise instrument support.
- Change:	Added some examples to examples directory by b-knox and Warlord.
- Change:	Changed names of some commands.
- Change:	Removed "config.inc" and incorporated it back into main.asm
		and song.inc.  Use song.inc for signature.
- Optimization:	Optimized some old code to shorten cycles and conserve resgisters.
- Optimization:	Removed some unnecessary MESS files.
- Fix:		Fixed some documentation errors.
- Fix:		Fixed binary size calculation.  (Back down to 2Kb per binary.)

v0.2 (Sprouting):

- Addition:	Preliminary PAL support.  (Notes may be detuned.)
- Addition:	"Delay" command to make note sequences faster or slower.
- Addition:	"DecOctv" command to be able to approximately decrease an octave.
- Addition:	Added ability to warm up CPU before playing.
- Fix:		Calibrated NTSC tunings and duration.
- Aesthetic:	Incorporated changelog.txt into bottom of readme.txt.
- Aesthetic:	Incorporated todo.txt into bottom of readme.txt.
- Optimization:	Removed unnecessary code.  (Thanks e5frog.)

v0.1 (Sprout):

- First version.

======]
To do
======

In no particular order:

- Commands for pitch bend and arpeggios.
- Drum machine.
- Visualization and display title/musician.
- "System I-Friendly Mode" mode.