Mark McConnell > POE-Wheel-Audio-Mad > POE::Component::Audio::Mad::Handle

Download:
POE-Wheel-Audio-Mad-0.3.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.2   Source  

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.

syntax highlighting: