gym2mid Version 0.2 by Paul Jensen
------------------------------------


Contents
--------

	1) What is gym2mid?

	2) What's New in this Version?

	3) Features

	4) Future Features

	5) Revision Notes

	6) Port Author Info

	7) MIDI Author Info

	8) Special Thanks

	9) Contact Info


What is gym2mid?
------------------

	gym2mid is a utility for Windows 9x that converts Genecyst's YM2612 log files (.GYM) to MIDI format 0 files (.MID).


Features
--------

	Spiffy GUI
	Note On/Note Off events
	Frequency Changes
	Simple Pitch Bending
	Patch Change Markers (see MIDI Author Info)
	Stereo Sound
	DAC Event Capturing (see MIDI Author Info)


Future Features
---------------

	More Accurate Pitch Bending
	PSG support (Master System-type noises)


Revision Notes
--------------

Version 0.2 (11/5/98):

	Spiffed-up the GUI, cleaned up the code, fixed some bugs, made 	the frequency->MIDI note conversion more accurate, added 	support for DAC events (see MIDI author info), and changed the 	name from GYM-2-MID to gym2mid (what a difference, huh?).

Version 0.1 (10/4/98):

	Initial Release, a few bugs/unhandled errors.


Port Author Info
----------------

(10/4/98):

	The source for gym2mid is written in VB5, but I imagine it could be easily ported to another language.  If you have any specific questions, please feel free to contact me (see Contact Info).

	I haven't added any comments yet, but I will do so if the need arises.

(11/5/98):

	You'll notice that I have added some 'CONST's to the code.  I hope this makes the code appear less confusing.  I've also added a couple of comments, but nothing very verbose.


MIDI Author Info
----------------

(10/4/98):

	When you first open a .MID file created with gym2mid, you'll probably notice a lot of junk mixed in with all of the notes.  This is caused by two simultaneous 'Note-Off' events (I think).  To clean up the notation, all you have to do is select every note (ideally with a 'Select All' command), filter out the ones with a length/duration of 0, and delete them.

	gym2mid creates patch change markers at the points where the YM2612 changes its algorithm (don't worry about what that means).  Simply put, if the YM2612 changes instruments, then a Patch Change event will occur, set to 0 (Acoustic Grand Piano).  You can then modify the patch to whatever instrument you think would sound best.

(11/5/98):

	DAC events are handled as follows: when the DAC is enabled on the YM2612, FM Channel 6 is disabled.  However, certain Genesis games use Channel 6 to control DAC stereo output.  If the DAC is enabled, and a speaker position change occurs on Channel 6, the gym2mid creates a MIDI note 42 (closed high hat) on MIDI channel 10, marking the moment which the sound is supposed to be played.  These notes can then be edited to match the original composition.
	

Special Thanks
--------------

Thanks to Jim at EMU News for all his help.

Thanks to Dave (author of DTMNT) for his help and moral support. 

Thanks to Marat Fayzullin for his document on emulator authoring.

And, of course...

Thanks to Sardu for creating Genecyst (and Callus, and NESticle), the best (IMO) Genesis (and CPS1, and NES) emulator available.


Contact Info
------------

Please feel free to send any questions, comments, or bug reports to me, Paul Jensen ( pejcs@pacbell.net ).

Please *DO NOT* ask me questions about Genecyst (unless it pertains to gym2mid), where to find .GYM files, Genesis ROMs, etc.  Any such requests will be ignored.