/ 
POE-Wheel-Audio-Mad-0.3
River stage one • 1 direct dependent • 1 total dependent
/ POE::Component::Audio::Mad::Handle

NAME

POE::Component::Audio::Mad::Handle - A POE Component to facilitate IPC with the POE::Wheel::Audio::Mad mpeg decoder.

SYNOPSIS

use POE;
use POE::Component::Audio::Mad::Handle;

## create an IPC bridge on stdin/stdout
create POE::Component::Audio::Mad::Handle();

## create a custom IPC bridge..
create POE::Component::Audio::Mad::Handle (
	Driver  => POE::Driver::SysRW->new(),
	Filter  => POE::Filter::Audio::Mad->new(),
	
	Handle  => $two_way_handle,
	# -or-
	InputHandle  => $one_way_handle_in,
	OutputHandle => $one_way_handle_out
);

DESCRIPTION

POE::Component::Audio::Mad::Handle is a POE Component to implement 
basic inter-process communication with the POE::Wheel::Audio::Mad 
mpeg decoder and a bi-directional or two unidirectional filehandles.

This Component operates by creating an instance of POE::Wheel::Audio::Mad
and an instance of POE::Wheel::ReadWrite and then facilitates communication
between the two.  All options passed to the create() constructor are
filled in with defaults and then directly passed to POE::Wheel::ReadWrite's
constructor;  see it's documentation for a description of available options.

You may use any options you wish.  Decoder status messages will be sent
through the filter and then delivered to the appropriate filehandle.  
Commands received through the appropriate filehandle will be sent
through the filter and used to affect POE::Wheel::Audio::Mad operations.

DEFAULTS

If some of the options to the create() constructor aren't present,  this
component will fill them in with it's own defualts.
InputHandle and OutputHandle
If a Handle is not specified or an InputHandle and an OutputHandle aren't 
specified,  this module will use STDIN as the default InputHandle and STDOUT 
as the default OutputHandle.
Driver
If unspecified we will use POE::Driver::SysRW.
Filter
If unspecified we will use POE::Filter::Audio::Mad which comes with
this distribution.

SEE ALSO

perl(1)

POE::Wheel::ReadWrite(3)

POE::Filter::Audio::Mad(3) POE::Wheel::Audio::Mad(3)

AUTHOR

Mark McConnell, <mischke@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2003 by Mark McConnell

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself with the exception that you must also feel bad if you don't email me with your opinions of this module.