Audio - the AfterStep Audio module


SYNOPSIS

       Audio  is spawned by afterstep, so no command line invoca-
       tion will work.  From within the .steprc  file,  Audio  is
       spawned as follows:

       Module Audio

       or from within an afterstep pop-up menu:

       Popup "Module-Popup"
            Title     "Modules"
            Module    "Wharf"        Wharf
            Module    "FvwmIdentify" FvwmIdent
            Module    "Audio"        Audio
            Module    "Pager"        Pager 0 3
       EndPopup


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 man-
       ager 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.



CONFIGURATION OPTIONS

       Audio reads the same .steprc file  as  afterstep(1)  reads
       when  it  starts  up,  and looks for certain configuration
       options:


       *AudioPlayCmd /usr/bin/X11/demos/auplay
              This determines the independent audio  player  pro-
              gram  that  will  actually play the sounds.  If the
              play command  is  set  to  builtin-rplay  then  the
              builtin rplay support will be used.  For example:

              *AudioPlayCmd builtin-rplay


       *AudioDir /usr/lib/sounds
              Specifies  the  directory  to  look  for  the audio
              files.  This option is ignored when rplay is  used.

              as  $HOSTDISPLAY.   This  option is only valid with
              builtin rplay support.


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


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


       *Audio window-manager_action audio_filename
              Binds particular window manager  actions  to  sound
              queues.

              *Audio startup TaDa.au
              *Audio shutdown Elvis_Left.au
              *Audio unknown doh.au
              *Audio add_window drip.au
              *Audio raise_window swoosh.au
              *Audio lower_window swoosh.au
              *Audio focus_change boing.au
              *Audio destroy_window explosion.au
              *Audio iconify ploop.au
              *Audio deiconify ploop.au
              *Audio toggle_paging fwop.au
              *Audio new_page beam_trek.au
              *Audio new_desk beam_trek.au
              *Audio configure_window huh.au
              *Audio window_name beep.au
              *Audio icon_name beep.au
              *Audio res_class beep.au
              *Audio res_name beep.au
              *Audio end_windowlist twang.au



INVOCATION

       The  invocation  method was shown in the synopsis section.
       No command line invocation  is  possible.  Audio  must  be
       invoked by the afterstep window manager.



BUGS


COPYRIGHTS

       This module is a port of the FvwmAudio module to AfterStep
       by Frank Fejes. The concept for interfacing this module to
       the Window Manager, is original work by Robert Nation.

Audio                        May 1996                           3