<HTML
><HEAD
><TITLE
>Sound Monitor Applet</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.54"></HEAD
><BODY
CLASS="ARTICLE"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="TITLE"
><A
NAME="AEN2"
>Sound Monitor Applet</A
></H1
><P
CLASS="COPYRIGHT"
><A
HREF="ln7.html"
>Copyright</A
> &copy; 2000 by <SPAN
CLASS="HOLDER"
>Dan Mueth</SPAN
></P
><HR
WIDTH="75%"
ALIGN="CENTER"
COLOR="#000000"
SIZE="1"></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
><A
HREF="index.html#SOUNDMONITORAPPLET"
>Sound Monitor Applet</A
></DT
></DL
></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="SOUNDMONITORAPPLET"
>Sound Monitor Applet</A
></H1
><P
>   <TT
CLASS="APPLICATION"
>Sound Monitor</TT
> applet, shown in its
   default theme(appearance) in <A
HREF="index.html#SOUNDMONITORAPPLET-FIG"
>Figure 1</A
>, is a sound volume display and an
   interface for controlling ESD (the Enlightened Sound Daemon). If
   you are not familiar with ESD, it is a program which controls sound
   on your system and allows all of your applications to play sound at
   the same time.  To add this applet to a <SPAN
CLASS="INTERFACE"
>Panel</SPAN
>, 
   right-click on the <SPAN
CLASS="INTERFACE"
>Panel</SPAN
> and choose
   <B
CLASS="GUIMENU"
>Panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Add to panel</B
>-&gt;<B
CLASS="GUISUBMENU"
>Applet</B
>-&gt;<B
CLASS="GUISUBMENU"
>Multimedia</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Sound Monitor</B
>.
  </P
><DIV
CLASS="FIGURE"
><A
NAME="SOUNDMONITORAPPLET-FIG"
></A
><P
><IMG
SRC="soundmonitor_applet.png"></P
><P
><B
>Figure 1. Sound Monitor Applet</B
></P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SOUNDMONITORAPPLET-USAGE"
>Usage</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>Sound Monitor</TT
> always displays the
    volume of sound being produced on your system graphically.
    You may control sound by turning ESD on or off by right-clicking
    on the applet and selecting <B
CLASS="GUIMENUITEM"
>Place Esound in
    standby</B
> or <B
CLASS="GUIMENUITEM"
>Resume Esound</B
>
    respectively, as described below.  
   </P
><P
>    Right-clicking on the applet brings up a menu containing the
    following items:
    <P
></P
><UL
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Manager&#8230;</B
> &#8212; brings
       up the <A
HREF="index.html#SOUNDMONITORAPPLET-MANAGER"
>       <SPAN
CLASS="INTERFACE"
>Sound Monitor Manager</SPAN
></A
> dialog,
       which allows you to view and control current ESD settings.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Place Esound in
       standby</B
>/<B
CLASS="GUIMENUITEM"
>Resume
       Esound</B
>/<B
CLASS="GUIMENUITEM"
>Start
       Esound</B
> &#8212; At any time, you will only
       have one of these three items, depending on whether ESD is
       running and what its status is. The first two menu items
       allow you to
       temporarily place ESD in standby and then resume ESD.
       This is useful if you have a sound application which is
       unable to work with ESD, but needs direct access to the
       sound device. The third allows you to start
       <TT
CLASS="APPLICATION"
>Esound</TT
> if it is not started. 
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
> &#8212;
       opens the <A
HREF="index.html#SOUNDMONITORAPPLET-PREFS"
>       <TT
CLASS="GUILABEL"
><B
>Properties</B
></TT
></A
> dialog.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>Help</B
> &#8212;
       displays this document.
      </P
></LI
><LI
><P
>       <B
CLASS="GUIMENUITEM"
>About&#8230;</B
> &#8212;
       shows basic information about <TT
CLASS="APPLICATION"
>Sound
       Monitor</TT
>, inluding the applet's version and the
       author's name.
      </P
></LI
></UL
>
   </P
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.png"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="CENTER"
><B
>Note About Sound in GNOME</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>     For sound to work in GNOME, you must have sound enabled in the
     <TT
CLASS="APPLICATION"
>Control Center</TT
>.  To configure sound,
     click on the <B
CLASS="GUIBUTTON"
>Main Menu</B
> button (the foot
     icon) and select
     <B
CLASS="GUIMENU"
>Programs</B
>-&gt;<B
CLASS="GUISUBMENU"
>Setting</B
>-&gt;<B
CLASS="GUISUBMENU"
>Multimedia</B
>-&gt;<B
CLASS="GUIMENUITEM"
>Sound</B
>. Make sure both sound options are enabled in the
     <TT
CLASS="GUILABEL"
><B
>General</B
></TT
> tab.  Feel free to configure and
     test things in the <TT
CLASS="GUILABEL"
><B
>Sound Events</B
></TT
> section.
     Note that you may have to exit GNOME and restart for sound to
     work properly after enabling it in the <TT
CLASS="APPLICATION"
>Control
     Center</TT
> for the first time.
    </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SOUNDMONITORAPPLET-PREFS"
>Customization</A
></H2
><P
>      You can customize <TT
CLASS="APPLICATION"
>Sound Monitor</TT
>
      applet by right-clicking on it and choosing
      <B
CLASS="GUIMENUITEM"
>Properties&#8230;</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog(shown in <A
HREF="index.html#SOUNDMONITOR-SETTINGS-FIG"
>Figure 2</A
>), which allows you to
      change various settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="SOUNDMONITOR-SETTINGS-FIG"
></A
><P
><IMG
SRC="soundmonitor_applet_settings.png"></P
><P
><B
>Figure 2. Properties dialog</B
></P
></DIV
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>General</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Peak indicator &#8212; This controls the behavior of the peak
        indicator (the bright line which tracks the peak volume),
        either turning it off (<TT
CLASS="GUILABEL"
><B
>off</B
></TT
>), having it
        follow the peak as if it is floating on top
        (<TT
CLASS="GUILABEL"
><B
>active</B
></TT
>), or having it follow a more
        smooth sense of the peak(<TT
CLASS="GUILABEL"
><B
>smooth</B
></TT
>), which
        may actually lie slightly below the active peak which can
        briefly increase above the smooth peak.
       </P
></LI
><LI
><P
>        Peak indicator falloff speed &#8212; This controls the speed
        the peak indicator falls back to zero volume(for active mode)
        or moves toward the current volume(for smooth mode).
       </P
></LI
><LI
><P
>        Scope (scale 1:X, where X=?) &#8212; This controls the
        horizontal (time) axis scale for <TT
CLASS="APPLICATION"
>Sound
        Monitor</TT
> themes which resemble a scope. (Since
        the default theme is not a scope, this control does not do
        anything until you have modified the theme, as described
        below.) A value of 1 corresponds to having one pixel on the
        display represent one sound sampling, which is taken at 44.1kHz.
       </P
></LI
><LI
><P
>        Connect points in scope &#8212; This determines whether the
        sampled volume points are connected. (For scope themes only.)
       </P
></LI
><LI
><P
>        Screen refresh (frames per second) &#8212; This controls the
        number of times the <TT
CLASS="APPLICATION"
>Sound Monitor</TT
>
        display is updated each second.
       </P
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Theme</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Theme file (directory) &#8212; This is the theme for you
        <TT
CLASS="APPLICATION"
>Sound Monitor</TT
>, which determines the
        overall appearance of the applet.  You can either select a
        theme from the list <TT
CLASS="GUILABEL"
><B
>Themes:</B
></TT
>, or else type
        in the directory and name of another theme if available. Some
        of the standard themes are shown in <A
HREF="index.html#SOUNDMONITORAPPLETTHEMES-FIG"
>Figure 3</A
>. 
 
        <DIV
CLASS="FIGURE"
><A
NAME="SOUNDMONITORAPPLETTHEMES-FIG"
></A
><P
><IMG
SRC="soundmonitor_applet_themes.png"></P
><P
><B
>Figure 3. Example Sound Monitor Themes</B
></P
></DIV
>
       </P
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Advanced</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        ESD host to monitor &#8212; This option allows you to listen
        to sound being played by ESD on another computer. To do so, 
        enter the network address (or IP address) of a computer to
        monitor in the format <TT
CLASS="REPLACEABLE"
><I
>host:port</I
></TT
>.
        The host specified must be running ESD and have their esound
        daemon "unlocked" to allow other machines to connect. Note
        that the default port for ESD is 5001.  Leave
        this entry blank to monitor sound on the local machine.
       </P
></LI
></UL
>
    </P
><P
> 
      After you have made all the changes you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to apply the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="SOUNDMONITORAPPLET-MANAGER"
>The Sound Monitor Manager</A
></H2
><P
>      To start the <SPAN
CLASS="INTERFACE"
>Sound Monitor Manager</SPAN
>,
      right-click on the applet and choose
      <B
CLASS="GUIMENUITEM"
>Manager&#8230;</B
>. This will open the
      <SPAN
CLASS="INTERFACE"
>Sound Monitor - Manager</SPAN
> dialog(shown in <A
HREF="index.html#SOUNDMONITORAPPLETMANAGER-FIG"
>Figure 4</A
>), which allows you to 
      view and modify various ESD settings.
    </P
><DIV
CLASS="FIGURE"
><A
NAME="SOUNDMONITORAPPLETMANAGER-FIG"
></A
><P
><IMG
SRC="soundmonitor_manager_server.png"></P
><P
><B
>Figure 4. Properties dialog</B
></P
></DIV
><P
>     The <TT
CLASS="GUILABEL"
><B
>Server</B
></TT
> tab displays the following information:
     <P
></P
><UL
><LI
><P
>        Server information &#8212; This is a brief description of the
        esound server daemon's current status, including the sound
        output rate to the sound card, the number of currently playing
        sounds (connected streams), and the number of sound samples
        cached in the server.
       </P
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Streams</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Connected Streams &#8212; This displays a list of basic
	information for the current sound streams playing through the
	sound server. The user can adjust the volume and balance of a
	stream by first selecting the stream's line, then adjusting
	the volume and balance sliders. 
       </P
></LI
></UL
>
    </P
><P
>     The properties in the <TT
CLASS="GUILABEL"
><B
>Samples</B
></TT
> tab are:
     <P
></P
><UL
><LI
><P
>        Cached Samples &#8212; This displays a list of basic
	information for the current sounds cached in the sound
	server. The user can adjust the volume and balance of a cached
	sound by first selecting the sound's line, then adjusting the
	volume and balance sliders. To toggle between displaying the
	sound's length as bytes or time (format MM:SS.S) click on the
	length or time column heading.
       </P
></LI
></UL
>
    </P
><P
> After you made all the choices you want, click on
      <B
CLASS="GUIBUTTON"
>OK</B
> to make the changes and close the
      <SPAN
CLASS="INTERFACE"
>Properties</SPAN
> dialog. To cancel the changes
      and return to previous values, click the
      <B
CLASS="GUIBUTTON"
>Cancel</B
> button.
    </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="ESDPVD"
>The Esound Persistent Volume Daemon (ESDPVD)</A
></H2
><P
>    The <TT
CLASS="APPLICATION"
>Sound Monitor</TT
> applet comes with a
    companion program called the <TT
CLASS="APPLICATION"
>Esound Persistent Volume
    Daemon</TT
>
    (ESDPVD), which can run in the background and remembers the volume
    and balance of each stream that connects to the sound server. The
    main purpose of <TT
CLASS="APPLICATION"
>ESDPVD</TT
> is to be used in
    conjunction with the <TT
CLASS="APPLICATION"
>Sound Monitor</TT
>
    applet's <SPAN
CLASS="INTERFACE"
>Manager</SPAN
> dialog 
    to retain volume levels for individual streams that
    connect to the ESD sound server.
   </P
><P
>    As an example, suppose you are running the
    <TT
CLASS="APPLICATION"
>GTCD</TT
> CD Player and you 
    lower its volume using the <SPAN
CLASS="INTERFACE"
>Manager</SPAN
> window. Normally
    the volume setting will be lost when the program(in this case
    <TT
CLASS="APPLICATION"
>GTCD</TT
>) is exited and
    restarted. However, if <TT
CLASS="APPLICATION"
>esdpvd</TT
> is
    running and you start <TT
CLASS="APPLICATION"
>GTCD</TT
> again, the
    volume will be restored to its previous (in this case, 
    lower) value from before. 
   </P
><P
>    If you configure GNOME to start <TT
CLASS="APPLICATION"
>ESDPVD</TT
>
    each time GNOME is started (using the
    <SPAN
CLASS="INTERFACE"
>control-center</SPAN
>'s <SPAN
CLASS="INTERFACE"
>Startup 
    Programs</SPAN
> section), <TT
CLASS="APPLICATION"
>ESDPVD</TT
> will remember
    sound volume and balance customizations between GNOME sessions.
   </P
><P
>    <TT
CLASS="APPLICATION"
>ESDPVD</TT
> also remembers volume and
    balance adjustments to cached samples (often used for interface
    sound events such as button clicks, menus, etc.).
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="BUGS"
>Known Bugs and Limitations</A
></H2
><P
>    This applet has no known bugs.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AUTHORS"
>Authors</A
></H2
><P
>    <TT
CLASS="APPLICATION"
>Sound Monitor</TT
> was written by John Ellis
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:johne@bellatlantic.net"
>johne@bellatlantic.net</A
>&#62;</TT
>).  Please send all comments,
    suggestions, and bug 
    reports to the <A
HREF="http://bugs.gnome.org"
TARGET="_top"
>GNOME
    bug tracking database</A
>. (Instructions for submitting bug
    reports can be found <A
HREF="http://bugs.gnome.org/Reporting.html"
TARGET="_top"
>    on-line</A
>. If you are using
    GNOME 1.1 or later, you can also use <TT
CLASS="APPLICATION"
>Bug Report
    Tool</TT
> (<B
CLASS="COMMAND"
>bug-buddy</B
>), available in the
    <B
CLASS="GUISUBMENU"
>Utilities</B
> submenu of <B
CLASS="GUIMENU"
>Main
    Menu</B
>, for submitting bug reports.
   </P
><P
>    This manual was written by Dan Mueth
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:d-mueth@uchicago.edu"
>d-mueth@uchicago.edu</A
>&#62;</TT
>) and John Ellis
    (<TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:johne@bellatlantic.net"
>johne@bellatlantic.net</A
>&#62;</TT
>). Please send all comments and 
    suggestions regarding this manual to the <A
HREF="http://www.gnome.org/gdp"
TARGET="_top"
>GNOME Documentation Project</A
> 
    by sending an email to <TT
CLASS="EMAIL"
>&#60;<A
HREF="mailto:docs@gnome.org"
>docs@gnome.org</A
>&#62;</TT
>. You can also
    submit comments online by using the <A
HREF="http://www.gnome.org/gdp/doctable/"
TARGET="_top"
>GNOME Documentation Status
    Table</A
>.
   </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="LICENSE"
>License</A
></H2
><P
>    This program is free software; you can redistribute it and/or
    modify it under the terms of the <I
CLASS="CITETITLE"
>GNU General Public
    License</I
> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
   </P
><P
>    This program is distributed in the hope that it will be useful, but
    WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> for more details.
   </P
><P
>    A copy of the <I
CLASS="CITETITLE"
>GNU General Public License</I
> is
    included as an appendix to the <I
CLASS="CITETITLE"
>GNOME Users
    Guide</I
>.  You may also obtain a copy of the
    <I
CLASS="CITETITLE"
>GNU General Public License</I
> from the Free
    Software Foundation by visiting <A
HREF="http://www.fsf.org"
TARGET="_top"
>their Web site</A
> or by writing to
    <P
CLASS="ADDRESS"
>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Free&nbsp;Software&nbsp;Foundation,&nbsp;Inc.<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="STREET"
>59 Temple Place</SPAN
>&nbsp;-&nbsp;Suite&nbsp;330<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="CITY"
>Boston</SPAN
>,&nbsp;<SPAN
CLASS="STATE"
>MA</SPAN
>&nbsp;<SPAN
CLASS="POSTCODE"
>02111-1307</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<SPAN
CLASS="COUNTRY"
>USA</SPAN
><br>
&nbsp;&nbsp;&nbsp;&nbsp;</P
>
   </P
></DIV
></DIV
></DIV
></BODY
></HTML
>