NAME
POE::Component::CD::Rip - POE Component for running cdparanoia, a CD ripper.
SYNOPSIS
use POE qw(Component::CD::Rip);
$cd = POE::Component::CD::Rip->new(alias => $alias); $cd->rip(3, "/tmp/03.rip");
$POE::Kernel->run();
DESCRIPTION
This POE component serves to rip tracks from a CD. At present it is merely a wrapper for the cdparanoia program which does the bulk of the work.
METHODS
The module provides an object oriented interface as follows:
new
Used to initialise the system and create a module instance. The following parameters are available:
- alias
-
Indicates the name of a session to which module callbacks will be posted. Default:
main
. - dev
-
Indicates the device to rip from. Default: /dev/cdrom.
rip
Used to request that a track be ripped. The following parameters are required:
- track-number
-
Indicates the number of the track to rip, starting with 1.
- file-name
-
Provides the name of the file where to store the rip.
e.g. C<$cdr->rip(3, "/tmp/tst.rip");>
CALLBACKS
Callbacks are made to the session indicated in the spawn()
method. The names of the functions called back may also be set via the aforementioned method. The following callbacks are issued:
status
Fired during processing. ARG0 is the block number being processed whilst ARG1 represents the percentage of completion expressed as a whole number between 0 and 100.
done
Fired upon completion of a rip. The ARG0 parameter contains the name of the file ripped.
error
Fired on the event of an error.
AUTHOR
Erick Calder <ecalder@cpan.org>
My gratitude to Rocco Caputo and Matt Cashner whose code has helped me put this together.
DATE
$Date: 2002/09/14 22:45:41 $
VERSION
$Revision: 1.2 $
LICENSE AND COPYRIGHT
Copyright (c) 2002 Erick Calder. This product is distributed under the MIT License. A copy of this license was included in a file called LICENSE. If for some reason, this file was not included, please see http://www.opensource.org/licenses/mit-license.html to obtain a copy of this license.
4 POD Errors
The following errors were encountered while parsing the POD:
- Around line 156:
'=item' outside of any '=over'
- Around line 164:
You forgot a '=back' before '=head2'
- Around line 168:
'=item' outside of any '=over'
- Around line 178:
You forgot a '=back' before '=head1'