<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appletversion "2.8">
<!ENTITY manrevision "2.8">
<!ENTITY date "August 2004">
<!ENTITY applet "Volume Control">
]>
<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Mar 12, 2002
  
-->
<article id="index" lang="en_GB">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <articleinfo> 
	 <title>Volume Control Manual</title> 
	 <abstract role="description">
	   <para>Volume Control enables you to control the sound volume on your system and provides visual feedback on the current volume level.</para>
	 </abstract>
	 <copyright> 
		<year>2002</year> 
		<year>2003</year> 
		<year>2004</year> 
		<holder>Sun Microsystems</holder> 
	 </copyright> 
	 <copyright> 
		<year>2000</year> 
		<holder>Dan Mueth</holder> 
	 </copyright><copyright><year>2007</year><holder>David Lodge (dave@cirt.net)</holder></copyright>
<!-- translators: uncomment this:

  <copyright>
   <year>2003</year>
   <holder>ME-THE-TRANSLATOR (Latin translation)</holder>
  </copyright>

   -->

	 <publisher role="maintainer"> 
		<publishername>GNOME Documentation Project</publishername> 
	 </publisher> 

  <legalnotice id="legalnotice">
	<para>Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation Licence (GFDL), Version 1.1 or any later version published by the Free Software Foundation with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can find a copy of the GFDL at this <ulink type="help" url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS distributed with this manual.</para>
         <para>This manual is part of a collection of GNOME manuals distributed under the GFDL. If you want to distribute this manual separately from the collection, you can do so by adding a copy of the licence to the manual, as described in section 6 of the licence.</para>

	<para>Many of the names used by companies to distinguish their products and services are claimed as trademarks. Where those names appear in any GNOME documentation, and the members of the GNOME Documentation Project are made aware of those trademarks, then the names are in capital letters or initial capital letters.</para>

	<para>DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENCE WITH THE FURTHER UNDERSTANDING THAT: <orderedlist>
		<listitem>
		  <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES THAT THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY, ACCURACY AND PERFORMANCE OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENCE. NO USE OF ANY DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT IS AUTHORISED HEREUNDER EXCEPT UNDER THIS DISCLAIMER; AND</para>
		</listitem>
		<listitem>
		  <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT OR OTHERWISE, SHALL THE AUTHOR, INITIAL WRITER, ANY CONTRIBUTOR OR ANY DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION OF THE DOCUMENT OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE TO ANY PERSON FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR LOSSES ARISING OUT OF OR RELATING TO USE OF THE DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF SUCH DAMAGES.</para>
		</listitem>
	  </orderedlist></para>
  </legalnotice>




	 <authorgroup> 
		<author> 
		  <firstname>Angela</firstname> 
		  <surname>Boyle</surname> 
		  <affiliation> 
			 <address><email>aboyle@aboyle.com</email></address> 
		  </affiliation> 
		</author> 
		<author> 
		  <firstname>Dan</firstname> 
		  <surname>Mueth</surname> 
		  <affiliation> 
			 <orgname>GNOME Documentation Project</orgname> 
			 <address> <email>d-mueth@uchicago.edu</email> </address> 
		  </affiliation> 
		</author>
      <!-- This is appropriate place for other contributors: translators,
           maintainers,  etc. Commented out by default.
           <othercredit role="translator">
	     <firstname>Latin</firstname> 
	     <surname>Translator 1</surname> 
	     <affiliation> 
	       <orgname>Latin Translation Team</orgname> 
	       <address> <email>translator@gnome.org</email> </address> 
	     </affiliation>
	     <contrib>Latin translation</contrib>
           </othercredit>
-->
	 </authorgroup>

	 <revhistory>
		<revision> 
		  <revnumber>Volume Control Applet Manual V2.8</revnumber> 
		  <date>August 2004</date> 
		  <revdescription> 
			 <para role="author">Angela Boyle</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>  
		<revision> 
		  <revnumber>Volume Control Applet Manual V2.6</revnumber> 
		  <date>February 2004</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>  
		<revision> 
		  <revnumber>Volume Control Applet Manual V2.5</revnumber> 
		  <date>September 2003</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>Volume Control Applet Manual V2.4</revnumber> 
		  <date>August 2003</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision>  
		<revision> 
		  <revnumber>Volume Control Applet Manual V2.3</revnumber> 
		  <date>March 2003</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>Volume Control Applet Manual V2.2</revnumber> 
		  <date>January 2003</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>Volume Control Applet Manual V2.1</revnumber> 
		  <date>August 2002</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>Volume Control Applet Manual V2.0</revnumber> 
		  <date>April 2002</date> 
		  <revdescription> 
			 <para role="author">Sun GNOME Documentation Team</para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
		<revision> 
		  <revnumber>Mixer Applet</revnumber> 
		  <date>2000</date> 
		  <revdescription> 
			 <para role="author">Dan Mueth <email>d-mueth@uchicago.edu</email></para> 
			 <para role="publisher">GNOME Documentation Project</para> 
		  </revdescription> 
		</revision> 
	 </revhistory> 
	 <releaseinfo>This manual describes version 2.8 of Volume Control.</releaseinfo> 
	 <legalnotice> 
		<title>Feedback</title> 
		<para>To report a bug or make a suggestion regarding the Volume Control applet or this manual, follow the directions in the <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback Page</ulink>.</para>
		
	 </legalnotice> 
  </articleinfo> 
  <indexterm> 
	 <primary>Volume Control</primary> 
  </indexterm> 

<!-- ============= Document Body ============================= -->
<!-- ============= Introduction ============================== -->
<sect1 id="volumecontrol-introduction">
<title>Introduction</title>
<!-- ==== Figure ============================================= -->
	 <figure id="volumecontrol-fig"> 
		<title>Volume Control Applet</title> 
		<screenshot> 
		  <mediaobject> 
			 <imageobject><imagedata fileref="figures/volumecontrol_applet.png" format="PNG"/> 
			 </imageobject>
			 <textobject> 
				<phrase>Shows Volume Control applet. Contains image of a speaker.</phrase> 
			 </textobject> 
		  </mediaobject> 
		</screenshot> 
	 </figure> 
    <!-- ==== End of Figure ======================================= -->
<para>The <application>Volume Control</application> applet enables you to control the sound volume on your system. The applet icon changes depending on the volume level that you select. For example, if you select a low volume level, the icon displays one sound wave emanating from the speaker in the applet icon. As you increase the volume, the icon changes to display more sound waves.</para>

    <sect2 id="volumecontrol-introduction-add">
      <title>To Add Volume Control to a Panel</title>
      <para>To add <application>Volume Control</application> to a panel, right-click on the panel, then choose <guimenuitem>Add to Panel</guimenuitem>. Select <application>Volume Control</application> in the <application>Add to the panel</application> dialogue, then click <guibutton>OK</guibutton>.</para>
    </sect2>
</sect1>

<sect1 id="volumecontrol-usage">
<title>Using Volume Control</title>

	<sect2 id="volumecontrol-adjust">
	<title>To Adjust the Volume</title>
	<para>Click on the applet to display a slider control. To increase the volume, move the slider upwards. To decrease the volume, move the slider downwards.</para>
	</sect2>
	
	<sect2 id="volumecontrol-off">
	<title>To Switch the Volume Off</title>
	<para>To switch the volume off, right-click on the applet, then choose <guimenuitem>Mute</guimenuitem>.</para>
	</sect2>
	
	<sect2 id="volumecontrol-add">
	<title>To Access Additional Features</title>
	<para>To access additional functionality for working with volume, right-click on the applet, then choose <guimenuitem>Open Volume Control</guimenuitem>. A volume control application starts, which enables you to control the volume and balance levels for audio playback and recording.</para>
	</sect2>

</sect1>

<sect1 id="volumecontrol-prefs">
<title>Customising Volume Control</title>
<para>To configure <application>Volume Control</application>, right-click on the applet, then choose <guimenuitem>Preferences</guimenuitem>.</para> 
    <note>
      <para><application>Volume Control</application> populates the <guilabel>Volume Control Preferences</guilabel> dialogue dynamically, based on the functionality supported by your sound card.</para>
    </note>

<variablelist> 
		  <varlistentry> 
			 <term><guilabel>Audio Channels</guilabel></term> 
			 <listitem> 
			 <para>Select the audio output channel that you want to control:</para> 
			 <itemizedlist>
			 	<listitem><para><guilabel>Volume</guilabel></para></listitem>
			 	<listitem><para><guilabel>PCM</guilabel></para></listitem>
			 	<listitem><para><guilabel>Speaker</guilabel></para></listitem>
				<listitem><para><guilabel>Line-in</guilabel></para></listitem>
				<listitem><para><guilabel>Microphone</guilabel></para></listitem>
				<listitem><para><guilabel>CD</guilabel></para></listitem>
				<listitem><para><guilabel>Record</guilabel></para></listitem>
				<listitem><para><guilabel>Line-1</guilabel></para></listitem>
				<listitem><para><guilabel>Line-2</guilabel></para></listitem>
			 </itemizedlist>
			 </listitem> 
		  </varlistentry> 
		</variablelist> 

<para>Click <guibutton>Close</guibutton> to close the <guilabel>Volume Control Preferences</guilabel> dialogue.</para>

</sect1>
</article>
