Gnome::Sound - Perl extension for libgnome/gnome-sound (GNOME 1.x)
use Gnome::Sound; use Gnome; Gnome->init($PACKAGE, $VERSION); Gnome::Sound::init($hostname); $sample_id = Gnome::Sound::sample_load($sample_name, $filename); Gnome::Sound::play($filename); Gnome::Sound::shutdown();
This module is a Perl interface to gnome-sound, which provides sound playing routines for GNOME applications (http://www.gnome.org). These routines make use of the esd sound daemon.
It is important to note that Gnome->init( ) must be called before using these functions.
This initializes a connection to the esd sound server on HOSTNAME. This function must be called before using any other functions from this module. HOSTNAME is a string, or scalar containing a string, and will usually be 'localhost'.
Shuts down the connection to the sound server. This function must be called before the end of your program.
Loads sound file, FILENAME, into an esound sample with the name SAMPLE_NAME. Both SAMPLE_NAME and FILENAME are strings. Returns the esound numeric ID of the sample, or a negative number otherwise.
Plays the sound file FILENAME. This is a convenient wrapper around a number of esd functions, as will probably be the most used function.
Mark A. Stratman <email@example.com>
Copyright (c) 2001, Mark Stratman. All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the same terms as Perl itself.
The GNOME libraries (libgnome) are released under the LGPL (Library General Public License). Visit http://www.gnu.org for more details.