GPMuzic - Public beta 17/06/04
-------------------------------


SETUP.
------

Extract the zip and copy everything to your GP.

This should give you:

GPMuzic.fxe in gp:\gpmm

demo samples in gp:\gpmm\gpmuzic\wavdata

DON01.BNK, TESTBANK.BNK and SPOON1.BNK in gp:\gpmm\gpmuzic\sbanks

DON01.SNG, TESTBANK.SNG and SPOON1.SNG in gp:\gpmm\gpmuzic\songs

There are 3 demo banks each with its own song.  I put the 3 sets together based on some of the samples that donskeeto and spoonbender sent me.  There are a few that are in the wavdata folder and not in any of the demo sample banks. Sorry if you don't like the changes guys!


Quick start
-----------

Once loaded, hit select to enter the main menu.
Select File>Load Sample Bank, then Load Song (or song first then bank, either way).
Then press select to go back to the sequencer.
You now have a blank song to start working on. 

I'm having a go at a demo song using the demo samples but if anyone sends me a .sng file that sounds better than mine, subjectively speaking of course, I'll use it instead. :)


What's it all about?
--------------------

GPMuzic is a 16-step loop sequencer with up to 16 tracks assignable to 16 user loaded samples.  Currently it still uses the official SDK audio functions so expect glitchiness of the highest standards.

I have included support for sample rates from 22.05khz 8-bit mono up to 44.1 16-bit Stereo and multiple cpu speeds selectable within the app.

The demo samples use 22.05khz 16-bit mono at 80Mhz cpu speed. This seems to be a nice setup that gives 2-3 note polyphony without glitching too much.

Please note that this is a beta and as such has lots of things missing or not working. 



New Stuff since 2/06/04 version
--------------------------------

Cursor can move to the next bar or previous bar if it exists.
Load sample function jumps to the first empty sample bank.
Audition sample in load sample menu.
Clear bank in sample bank details menu + new menu option:
Options>Clear Options to clear the song data, all banks or both at once.
Load/Save now 100%(I think ;))* 
Lots of little fixes to stop nasty things happening..
CHN's audio code now included, although not yet used.(getting there ;))

*Just try not to select "." or ".." when loading a sample, you can clear the banks now in the sample details menu but it's still a pain in the arse.  I'm doing everything I can to remove these from the file list :/


New Stuff since 31/05/04 version
--------------------------------

Samples by Donskeeto and SpoonBender now included in the zip :D 
Added cpu rate menu, although you'll find the 22khz 16-bit mono demo samples sound terrible at any speed other than 80Mhz. Answers on a postcard for that one...
Saves sample rate with the sample bank file now.


New Stuff since 30/05/04 version
--------------------------------

I've put a few demo samples in the .zip - just for fun, not a "kit".
They are in 22khz 16 mono - make sure you change the sample rate before you try and play anything, particularly if you're wearing headphones :p
I've put the testbank.bnk for the demo samples in the zip as well too, load this from Load>Sample Bank to load all the samples in in one hit.

You can now use my flakey filename input app when saving songs and sample banks.
You need to create 2 new folders in gp:\gpmm\gpmuzic : \songs\ and \sbanks\
and move your testsong.sng and testbank.bnk to these new folders if you have created them with the last beta.

Crap Note - I have had to limit the size of new file names to 7 characters. Don't ask :/


New Stuff since 29/05/04 version
--------------------------------

You can now save a snapshot of the sample bank which saves having to load each sample one at a time.
Load/save song now works ok too depsite a small bug...



Instructions.
-------------

The sequencer boots up with just a single, empty, track initialised. You can add up to 16 tracks, although only about 13 will fit on the screen right now because I didn't plan ahead very well ;)  

Controls - Sequencer.
---------------------

The select button toggles the sequencer/menu.

I have left the GPSmack controls in place for the time being so, 
Start button toggles play/stop.
A button to turn beats on and off
D-pad to move around the sequencer window.  
Hold B and use UP and DOWN to toggle loop mode.
Hold B and use LEFT and RIGHT to alter tempo. Still not displayed right.
LEFT and RIGHT shoulder buttons to move through bars.
Hold B and use the RIGHT shoulder button to create a new bar - you must be in the last current bar to create a new one.

I'm guessing that everything else still works the same, so refer to the gpsmack doc file if I missed anything important. gbax.com still host GPSmack on the 2003 compo page.


Controls - Menu.
----------------

Use the D-pad and A to navigate the menus.
When a window is opened it can be moved to a different place on the screen by holding B and using the D-pad.
Changes made to the colour scheme in Options>Display Options are saved to config.wub and loaded when the app is next run.


Quick Instructions.
-------------------

Rather than loading a sample directly into a track, I have opted to use a sample bank style system.

From the File menu select Load Sample and the first thing you'll see is the sample bank selection menu. Here you can choose which of the 16 banks you want to load the sample into.
The bank must be empty if you want to select it.  
Once the sample is loaded you'll be back at the menu.
Select Edit>Edit Track, select the track you want to assign the sample to, and from the Track Editor menu you can select the sample bank you just loaded the sample into with the LEFT and RIGHT D-pad buttons.

Now you can return to the sequencer with the SELECT button and the track should be ready to go with the newly loaded sample.


Things that don't work!
-----------------------

Load/Save song - Limited to 7 character filenames, I can fix this but haven't!
		sometimes fails to save if delete has been used to correct a mistake 				when entering a filename	
Wave editor - just a test at the moment, flakey. shoulder buttons with and w/o A to zoom!
Can't delete sample banks yet.
Audio code just as flakey as GPSmack.

and lots, lots more...


thewub@hotmail.com