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.