The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

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'