#
# @(#)xmmix.hlp	2.5 95/05/12
#
#   xmmix - Motif(tm) Audio Mixer
#
#   Copyright (C) 1995  Ti Kan
#   E-mail: ti@amb.org
#
#   This program is free software; you can redistribute it and/or modify
#   it under the terms of the GNU General Public License as published by
#   the Free Software Foundation; either version 2 of the License, or
#   (at your option) any later version.
#
#   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
#   GNU General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with this program; if not, write to the Free Software
#   Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
#


   NAME
        xmmix - Audio mixer utility for X11/Motif


   SYNOPSIS
        xmmix [toolkitoption ...] [-dev device] [-autoload path]
		[-exitreset] [-debug] [-demo]


   DESCRIPTION
        Xmmix is a program that allows the use of the mixer section
        of the sound card hardware supported by the VoxWare driver.
        See the README file in the xmmix distribution for further
        information about VoxWare.

        There are up to ten input level sliders (Synth, PCM, Alt
        PCM, Line, Line-1, Line-2, Line-3, Mic, CD) and up to four
        output level sliders (Rec Mon, Rec Out, Speaker and Master).
        The Input Gain control, Output Gain control, Bass and Treble
        tone control sliders are also available.  Each of the level
        sliders include a "lock" toggle button which allows the
        settings of the two stereo channels to be changed
        simultaneously or independently.  The input controls also
        include a "rec" button (where applicable), which allows the
        input sources to be selected for recording.  The tone
        control sliders have a "Flat" button which causes these
        controls to revert to the center setting.  In addition,
        these controls are available: a "Mute" button to silence the
        audio, a "Loudness" button to engage frequency response
        compensation, and an "Stereo Enhance" button to set the
        stereo separation enhancement.

        Xmmix queries the capabilities of the sound board during
        start-up, and will only display controls corresponding to
        features that are actually implemented in the hardware.

        The various controls in the xmmix main window are meant to
        be self explanatory.  Additional features include the
        ability to save mixer settings in a file and load it at a
        later time.  A "Reset" feature resets all controls to their
        start-up settings.

        While the use of a mouse is natural with xmmix, all
        functionality can also be operated via the keyboard.  This
        is in conformance to the guidelines published in the
        OSF/Motif Style Guide from the Open Software Foundation.


   OPTIONS
        All standard Xt Intrinsics toolkit options are supported.
        In addition, xmmix supports the following options:

        -dev device
             Specifies the path name to the raw mixer device.  If
             this option is not used, the default device used is
             /dev/mixer.

        -autoload path
             Specifies the path name to a mixer settings file that
             is automatically loaded when xmmix starts.  This forces
             all control settings to those specified in the file.
             If this option is not used, then the control settings
             will be queried from the mixer hardware itself.  This
             option overrides the XMmix*autoLoadOnStartUp X
             resource.

        -exitreset
             Causes all mixer controls to reset to their start-up
             state when xmmix is exiting.  This option overrides the
             XMmix*resetOnExit X resource.

        -debug
             Causes verbose debugging diagnostics to be printed on
             stderr.

        -demo
             Invokes xmmix in "demo" mode.  This causes xmmix to
             display all controls as if they are functional, but
             does not actually operate the sound hardware.


   X RESOURCES
        Xmmix has many adjustable X resources to customize its look
        and feel, as well as its behavior.  Notably, the colors of
        virtually every feature on xmmix's windows can be changed,
        as well as the text fonts.

        The resource names and their defaults can be found in the
        LIBDIR/app-defaults/XMmix file (where LIBDIR is typically
        /usr/lib/X11).  It is not recommended that you change values
        in the LIBDIR/app-defaults/XMmix file, unless you want the
        changes to be forced upon all users of xmmix on the system.
        Instead, make a copy of this file, change the copy as you
        see fit, then place it in your home directory.  Your custom
        resource settings will then override the defaults when xmmix
        is subsequently started.  Alternatively, you may also place
        specific resources you wish to override in the .Xdefaults
        file in your home directory.


   SEE ALSO
        X(1).


   AUTHOR
        Ti Kan (ti@amb.org)
        AMB Research Laboratories, Sunnyvale, CA, U.S.A.

        Comments, suggestions, and bug reports are always welcome.

