WavPlayer: Set or Get the System Command for Playing WAV Files

Description

findWavPlayer returns the most common system commands on your OS for playing wav files. WavPlayer returns the command that is currently used by play. setWavPlayer is used to define the command to be used by play.

Usage

findWavPlayer()
WavPlayer()
setWavPlayer(command=NULL)

Arguments

command

a vector of character strings giving the command to be used as "command wavfile.wav". If it contains more than one string, the commands are tested one after the other, and the first one that works properly will be used for future calls of the

Value

WavPlayer returns the wav play command that is currently used, or NULL, if none is selected yet. findWavPlayer returns the default commands for your system, or NULL, if no command is known for your system.

Details

The play command makes a system call of the form "commandwavfile.wav", where 'command' is the string returned by WavPlayer(). The default commands are 'mplay32 /play' (calling the Windows media player) for Win32-systems and 'play' and 'playwave' for Linux systems. Other commands will be added in future versions of this package. While the Windows Media player is included in the standard Windows installation, playwave might have to be installed manually. Under RedHat Linux playwave is part of the SDL_mixer package. To download it, go to http://www.libsdl.org/projects/SDL_mixer. But any other program that provides a system call of the above form to play wav files is also fine. Please report additional play commands to the author (send an email to mail@MatthiasHeymann.de) so that they can be recognized automatically in future versions of this package. setWavPlayer is called directly after loading the package. When setWavPlayer is called, it tries to play an empty wav file, using the new command(s). If it fails, no changes are made.

Examples

Run this code

setWavPlayer("playwave")
# tries to set the command "playwave wavfile.wav" as the 
# preference for playing wav files with the play command.
# If successful,
WavPlayer()
# returns the string "playwave" afterwards.