POE::Framework::MIDI 

SYNOPSIS

A framework for algorithmic MIDI composition using POE

DESCRIPTION

POE::Framework::MIDI is a suite of modules which aim to provide a generalized
framework for writing programs to algorithmically generate MIDI music using Perl 
and POE

The Conductor object creates Musician objects which generate MIDI event streams
and run them through rules and transformations.  The Conductor then renders the
events down to perl code that MIDI::Simple can handle, and then runs that code
to write a .mid file

REQUIREMENTS

POE
Midi::Simple

USAGE

use POE::Framework::MIDI::POEMusician; 

# ... include your musician objects here ...
# see the example scripts for more info

POE::Framework::MIDI::POEConductor->spawn(
{
	bars => 30,
	verbose => 1,
	debug => 1,
	filename => 'test_output.mid',
	musicians =>
  [
	{
	name => 'frank',
	
	# specify which module you want to have "play" this track. 
	# 
	# the only real requirement for a musician object is
	# that it define a 'make_bar' method.  ideally that should
	# return (at least) POE::Framework::MIDI::Bar( { number => $barnum } );
	# or a ::Phrase( { number => $barnum } );  See the example scripts
	# for more info.
	
	# set the package you want to generate events on this channel
	package => 'POE::Framework::MIDI::Musician::Your::Musicians::GuitarFreak',
	
	# which MIDI channel should these events end up on?	
	channel => 1,
	
	# which MIDI patch should we use?  frank likes the jazz guitar sound.
	patch => '27',
	},

	{
	name => 'ike',
	package => 'POE::Framework::MIDI::Musician::Your::Musicians::MyOrganPlayer',
	channel => 2,
	patch => '60',
	},
	{
	name => 'terry',
	package => 'POE::Framework::MIDI::Musician::Your::Musicians::MyFunkyDrummer',
	channel => 9, # drum channel - zero based
	patch => '58',
	},
  ],
}); 

$poe_kernel->run; # this is exported by POE. 

BUGS

Probably lots.  Since Gene and I are the only ones who've used the code, it might
not work so well across different platforms.  who knows :)  Give it a shot and
tell us what happens. 

EXAMPLES

You can find some other example code for musician objects at 
http://justsomeguy.com/code/POE/POE-Framework-MIDI/examples/


SUPPORT

comments/questions/queries: steve@justsomeguy.com

AUTHORS

Steve McNabb
CPAN ID: SMCNABB 
steve@justsomeguy.com
http://justsomeguy.com

Gene Boggs - ology@ology.net
http://ology.net
CPAN ID: GENE

Thanks:

Rocco Caputo
Gene Boggs
Sean Burke
Phillip Gwynn
Artur Bergman

rhizomatic #perl, #poe  and #tempura kooks one and all

COPYRIGHT

Copyright (c) 2003 Steve McNabb and Gene Boggs.  All rights reserved.
This program is free software; you can redistribute
it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the
LICENSE file included with this module.

SEE ALSO

perl(1). POE, MIDI-Perl

1;




