<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[ ]>

<article id="index">
<!--  For DocBook 4 to replace artheader
  <articleinfo>
-->
  <artheader> 
    <title>Gmix</title>
    <copyright><year>2000</year><holder>Erik Jarvi</holder></copyright>
    <legalnotice>
    <para>
    Permission is granted to copy, distribute and/or modify this
    document under the terms of the <citetitle>GNU Free Documentation
    License</citetitle>, 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 may obtain a copy
    of the <citetitle>GNU Free Documentation License</citetitle> from
    the Free Software Foundation by visiting <ulink type="http"
    url="http://www.fsf.org">their Web site</ulink> or by writing to:
    Free Software Foundation, Inc., 59 Temple Place - Suite 330,
    Boston, MA 02111-1307, USA.
    </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 those trademarks are made aware to the members
    of the GNOME Documentation Project, the names have been printed in caps
    or initial caps.
    </para>
    </legalnotice>
    <releaseinfo>
    This is version .1 of the gmix manual.
    </releaseinfo>
<!-- For DocBook 4 to replace artheader
  </articleinfo>
-->
  </artheader>

<!-- ############# GNOME Mixer - APPLICATION ############# -->

  <sect1 id="intro">
    <title>Introduction</title>
    <para>
  <indexterm><primary>GNOME Mixer</primary><secondary>gmix</secondary>
    <seealso>gtcd</seealso><seealso>grecord</seealso><seealso>grip</seealso>
  </indexterm>
  The application <application>GNOME Mixer</application> 
  (<command>gmix</command>) is a GNOME enabled audio mixer. Gmix allows you
  to mix audio for 2 channel sound cards.
    </para>
    <para>
  To run <application>GNOME Mixer</application> select 
  <menuchoice>
  <guisubmenu>Multimedia</guisubmenu>
  <guimenuitem>Audio Mixer</guimenuitem>
  </menuchoice>
  from the <guimenu>Main Menu</guimenu>, and can also be invoked in
  the command line with <prompt>$</prompt> <command>gmix</command>.
    </para> 
  </sect1>

<!--  ############# Main page  ############# -->

  <sect1 id="gmix-use">
  <title>Using the GNOME Mixer</title>
    <para>
  There are four main components to the <application>GNOME Mixer</application>:
  the <guibutton>faders</guibutton>, <guibutton>Mute</guibutton> buttons,
  <guibutton>Rec.</guibutton> buttons, and the <guibutton>Lock</guibutton>
  buttons.  The <guibutton>Lock</guibutton> locks the left and right channels
  together so that you can adjust either <guibutton>fader</guibutton> and both
  with be syncronized.  The <guibutton>Mute</guibutton> silences the channel, 
  but once you change the volume from the <guibutton>fader</guibutton> the
  channel is unmuted.  
<!-- [I find this to be anti-intutive, IMHO this should be
  an option.  If this feature was on a real console, I'd probably be fired
  more than a few times. :)] 
-->
  The last button, <guibutton>Rec.</guibutton> is toggled to turn
  on/off the recording functions of your soundcard on that channel. There 
  always has to be one channel with the record button pressed.
<!-- [Why does there have to be one on?] -->
  The 
  <guibutton>faders</guibutton> control the volume of each channel. Below is a
  listing of what each <guibutton>fader</guibutton> represents.
  </para>
  <itemizedlist mark="bullet">
    <listitem>
      <para>
    <guilabel>Vol</guilabel> &mdash; This is the main volume fader.
      </para>
    </listitem>
    <listitem>
      <para>
    <guilabel>Synth</guilabel> &mdash; This fader controls the volume of the
    midi devices.
      </para>
    </listitem>
    <listitem>
      <para>
    <guilabel>Pcm</guilabel> &mdash; This fader controls the "wave" files.
      </para>
    </listitem>
    <listitem>
      <para>
    <guilabel>Spkr</guilabel> &mdash; This fader controls the Speaker output
    jack.   <!-- ??? -->
      </para>
    </listitem>
    <listitem>
      <para>
    <guilabel>Line</guilabel> &mdash; This is the Line input on your
    sound card, if you have one. 
      </para>
    </listitem>
    <listitem>
      <para>
    <guilabel>Mic</guilabel> &mdash; This is the Microphone input on your sound
    card.
      </para>
    </listitem>
    <listitem>
      <para>
    <guilabel>CD</guilabel> &mdash; This is the CD player input gain. 
      </para>
    </listitem>
    <listitem>
      <para>
    <guilabel>Rec</guilabel> &mdash; This is the overall Record level fader. 
    (Master Record level)
      </para>
    </listitem>
    <listitem>
      <para>
    <guilabel>Line2</guilabel> &mdash; If your sound card has a second
    line input this is the fader that controls the volume.
      </para>
    </listitem>
    </itemizedlist> 
   <figure>
    <title>The GNOME Mixer</title>
   <screenshot>
    <screeninfo>GMIX</screeninfo>
    <graphic format="png" fileref="figures/gmix" srccredit="eej">
    </graphic>
   </screenshot>
   </figure>
  </sect1>

  <sect1 id="gmix-prefs">
    <title>The GNOME Mixer Preferences</title>
    <para>
    In the <guimenu>Settings</guimenu> <!--<guisubmenu>Preferences</guisubmenu> -->
    <guimenuitem>Preferences</guimenuitem> 
    menu window, the <guilabel>On startup</guilabel>
    <guilabel>Restore saved mixer levels on startup</guilabel> saves your
    current mixer settings and adjusts them upon start up.  Under
    <guilabel>GUI</guilabel>, <guilabel>Use mixer icons</guilabel> and 
    <guilabel>Use mixer labels</guilabel> displays icon representation of the
    channels and the text equivalent respectively.
    </para>
    <figure><title>GNOME Mixer Preference</title>
    <screenshot><screeninfo>Gmix-prefs</screeninfo>
    <graphic format="png" fileref="figures/gmix-prefs" srccredit="eej">
    </graphic></screenshot></figure>
  </sect1>  
<!-- ================== BUGS ======================= -->  

  <sect1 id="bugs">
    <title>Known Bugs and Limitations</title>
    <para>
    No known bugs at this time.
    </para>
  </sect1>

<!-- ============= Authors ================================ -->

  <sect1 id="authors">
    <title>Authors</title>
    <para>
    <application>Gnome Mixer</application> was written by Jens Ch. Restemeier
    <email>jchrr@hrz.uni-bielefeld.de</email>.  To find more information about
    <application>Gnome Mixer</application>, please visit the <ulink
    url="http://www.gnome.org" type="http">Gmix Web
    page</ulink>.  Please send all comments, suggestions, and bug
    reports to the <ulink url="http://bugs.gnome.org" type="http">GNOME
    bug tracking database</ulink>. (Instructions for submitting bug
    reports can be found <ulink
    url="http://bugs.gnome.org/Reporting.html" type="http">
    on-line</ulink>.) If you are using
    GNOME 1.1 or later, you can also use <application>Bug Report
    Tool</application> (<command>bug-buddy</command>), available in the
    <guisubmenu>Utilities</guisubmenu> submenu of <guimenu>Main
    Menu</guimenu>, for submitting bug reports.
    </para>

    <para>
    This manual was written by Erik Jarvi <email>ejarvi@megsinet.net</email>. 
    Please send all comments and suggestions regarding this manual to the 
    <ulink type="http" url="http://www.gnome.org/gdp">
    GNOME Documentation Project</ulink> 
    by sending an email to <email>docs@gnome.org</email>. You can also
    add your comments online by using the <ulink type="http"
    url="http://www.gnome.org/gdp/doctable/">GNOME Documentation Status
    Table</ulink>.
    </para>
  </sect1>

<!-- ============= Application License ============================= -->

  <sect1 id="license">
    <title>License</title>
    <para>
    This program is free software; you can redistribute it and/or
    modify it under the terms of the <citetitle>GNU General Public
    License</citetitle> as published by the Free Software Foundation;
    either version 2 of the License, or (at your option) any later
    version.
    </para>
    <para>
    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
    <citetitle>GNU General Public License</citetitle> for more details.
    </para>
    <para>
    A copy of the <citetitle>GNU General Public License</citetitle> is
    included as an appendix to the <citetitle>GNOME Users
    Guide</citetitle>.  You may also obtain a copy of the
    <citetitle>GNU General Public License</citetitle> from the Free
    Software Foundation by visiting <ulink type="http"
    url="http://www.fsf.org">their Web site</ulink> or by writing to
    <address>
     Free Software Foundation, Inc.
     <street>59 Temple Place</street> - Suite 330
     <city>Boston</city>, <state>MA</state> <postcode>02111-1307</postcode>
     <country>USA</country>
    </address>
   </para>
  </sect1>
</article>
