Audio(1.6)

NAME
Audio - the AfterStep Sounds module

SYNOPSIS
Audio is spawned by afterstep, so no command line invocation will work.

From within the autoexec file or as a menu option, Audio is spawned as follows:

	Module	"I"	Audio

or from within an afterstep menu file by 'Audio':

% cat "~/GNUstep/Library/AfterStep/start/Modules/Audio"
	Module "Audio" Audio
	MiniPixmap "mini-as.xpm"

DESCRIPTION
The Audio module communicates with the AfterStep window manager to bind audio sounds to window manager actions. Different audio queues may be assigned to any window manager action. Audio can be used with any independent audio player, and therefore requires no special audio library APIs of its own. Simple in its design, it merely binds the audio filenames to particular actions and forks off the audio player program with the appropriate filename when that action occurs. Audio can also have builtin support for the rplay library.

INITIALIZATION
During initialization, Audio will search for a configuration file which describes the audio player and sound files associated with actions, to use. The configuration file is /usr/local/share/afterstep/audio; but can be overriden by ~/GNUstep/Library/AfterStep/audio .

INVOCATION
Audio can be invoked from the autoexec file or from a menu item as shown in the Synopsis section above. AfterStep will search through the directories specified in the ModulePath configuration in the base.#bpp (where # is your colordepth) to attempt to locate Audio.

CONFIGURATION OPTIONS
Audio reads the audio file when it starts up and looks for its configuration options.

*AudioPath path
    Specifies the path to look for the audio files. This option is ignored when rplay is used.

*AudioPlayCmd player
    This determines the independent audio player program that will actually play the sounds. If the player is set to builtin-rplay then the builtin rplay support will be used.

*AudioDelay seconds
    Specifies that sound events will only be played if they occur at least so many seconds after the previous event. Sound events that occur during the delay period are ignored. This option is useful if you don't want several sounds playing at the same time. The default delay is 0 which disables the audio delay.

*AudioRplayHost hostname
    Specifies what host the sounds will play on. The hostname can also be an environment variable such as $HOSTDISPLAY. This option is only valid with builtin rplay support.

*AudioRplayPriority priority
    Specifies what priority will be assigned to the sounds when they are played. This option is only valid with builtin rplay support.

*AudioRplayVolume level
    Specifies what volume level will be assigned to the sounds when they are played. This option is only valid with builtin rplay support.

*Audio action filename
    Binds the particular window manager action that the sound filename is played for.

    The following actions are available for sounds:

        startup
        shutdown
        unknown
        add_window
        raise_window
        lower_window
        focus_change
        destroy_window
        iconify
        deiconify
        toggle_paging
        new_page
        new_desk
        configure_window
        window_name
        icon_name
        res_class
        res_name
        end_windowlist

AUTHORS
Frank Fejes <frank@ssax.com>
Dan Weeks <dan@mango.sfasu.edu>
Szijarto Szabolcs <saby@sch.bme.hu>
Mark Boyns <boyns@sdsu.edu>
Mark Scott <mscott@mcd.mot.com>
Robert Nation
David Mihm <davemann@ionet.net> [man page]

SEE ALSO
afterstep(1), rplay(1), showaudio(1)