NAME

POE::Component::CD::Detect - Detects CD insertions and provides TOC

SYNOPSIS

use POE qw(Component::CD::Detect); POE::Component::CD::Detect->new(); POE::Kernel->run();

DESCRIPTION

This POE component detects the insertion of a CD into a given drive and issues a callback to the caller with the disc's table of contents.

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 are posted. Default: main.

delay

Indicates how often the drive is checked for the presence of a disc.

dev

Specifies the device to use. If not provided, the module will make various assumptions about the device's name, depending on the operating system and platform.

CALLBACKS

Callbacks are made to the session indicated in the new() method. The names of the functions called back may also be set via the aforementioned method.

inserted

Fired whenever a disc is detected in the drive. The following parameters are passed to this event: ARG0 = the disc id, ARG1 = an array-reference to the TOC (table of contents).

error

Fired on the event of an error.

AUTHOR

Erick Calder <ecalder@cpan.org>

My gratitude to Rocco Caputo and Matt Cashner whose suggestions have allowed me to put this together.

DATE

$Date: 2002/09/14 22:42:20 $

VERSION

$Revision: 1.1 $

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.