wmsmixer/README.wmmixer

   1 wmmixer - A mixer designed for WindowMaker
   2 05/09/98  Release 1.0 Beta1
   3 Copyright (C) 1998  Sam Hawker <shawkie@geocities.com>
   4 This software comes with ABSOLUTELY NO WARRANTY
   5 This software is free software, and you are welcome to redistribute it
   6 under certain conditions
   7 See the COPYING file for details.
   8
   9   This program is free software; you can redistribute it and/or modify
  10   it under the terms of the GNU General Public License as published by
  11   the Free Software Foundation; either version 2 of the License, or
  12   (at your option) any later version.
  13
  14   This program is distributed in the hope that it will be useful,
  15   but WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17   GNU General Public License for more details.
  18
  19   You should have received a copy of the GNU General Public License
  20   along with this program; if not, write to the Free Software
  21   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  22
  23
  24 THE AUTHOR:
  25 ===========
  26
  27 Sam Hawker (17/m/uk)
  28
  29 shawkie@geocities.com
  30 http://www.geocities.com/SiliconValley/Vista/2471/
  31
  32
  33 INSTALLING:
  34 ===========
  35
  36 xmkmf
  37 make
  38 strip wmmixer
  39 make install
  40
  41
  42 CONFIGURATION:
  43 ==============
  44
  45 Users can configure wmmixer to suit their requirements by means of a ~/.wmmixer
  46 file. A commented example is supplied, and would be a good starting point.
  47
  48 cp home.wmmixer ~/.wmmixer
  49
  50
  51 USAGE:
  52 ======
  53
  54 You can access all the channels on your soundcard's mixer with wmmixer. Most
  55 common channels are identified with an appropriate icon.
  56 Controls include a stereo (mono where appropriate) volume control and a recording
  57 source toggle button.
  58
  59 Press the "<" and ">" arrow buttons to select a channel.
  60 The icon identifies the current channel (a volume symbol with a question mark
  61 represents an unrecognised channel).
  62 Click and/or drag the volume display to set channel volume.
  63 There is a also a button to set recording sources.
  64
  65
  66 AFTERSTEP USERS:
  67 ================
  68 (thanks to tygris@erols.com)
  69
  70 This release includes in a new command line option.
  71 The effect this has is to enable shape support (it implies "-s"), and
  72 to reduce the size of the window to 56x56 pixels.
  73 The "-position position" option has also been added, so you can push
  74 wmcdplay off the edge of the screen while it gets swallowed.
  75 To put wmmount in your Wharf, add the following line in the appropriate
  76 part of your .steprc
  77
  78 *Wharf wmmount nil MaxSwallow "wmmount" wmmount -a -position -0-0 &
  79
  80 It is also possible (by editing and recompiling the afterstep sources),
  81 to make Wharf handle the new 56x56 pixel window properly - yes, I add
  82 an option to use a 56x56 pixel window, even though the AfterStep Wharf
  83 really wants 55x57 pixel ones.
  84
  85 I am told (by tygris@erols.com):
  86
  87 "Locate Wharf.c (or is it Wharf.cc?)  Should be in
  88 AfterStep-1.0/modules/Wharf.  Locate this:
  89
  90             if (Buttons[button].maxsize) {
  91               Buttons[button].icons[0].w = 55;
  92               Buttons[button].icons[0].h = 57;
  93             }
  94
  95 and change the 55 and 57 to 56's.  Save and compile."
  96
  97
  98 BUILD PROBLEMS:
  99 ===============
 100
 101 You may have trouble linking wmmixer with the compiler supplied on some
 102 recent Linux distributions (eg. Debian 2.0 & RedHat 5.1).
 103 It can be made to build by adding the following line to the top of the
 104 Imakefile, before executing xmkmf:
 105
 106 CC = c++
 107
 108 I am not sure of the effect this has on memory usage, etc.
 109
 110
 111 RELEASE HISTORY:
 112 ================
 113
 114 Release 0.1    07/02/98   Finally reached a state I am prepared to put my
 115                           name to.
 116                           No KNOWN bugs.
 117
 118 Release 0.2    12/02/98   Fixed nasty memory hole.
 119
 120 Release 0.3    24/02/98   Fixed bug relating to manual window positioning.
 121
 122 Release 0.4    04/03/98   Reduced CPU Load (thanks to aseltine@cs.umass.edu).
 123                           Support for NetBSD (you may need to make it use -lossaudio when linking).
 124                              (thanks to Geir.I.Jensen@runit.sintef.no)
 125                           Only updates when it has to now.
 126
 127 Release 0.5    05/03/98   Better support for NetBSD and FreeBSD.
 128                           Fixed bug relating to cards with no volume channel.
 129                              (thanks to dalroi@wit401310.student.utwente.nl)
 130                           Fixed bug relating to hiding "Rec" checkbox on FreeBSD.
 131                              (thanks to dalroi@wit401310.student.utwente.nl)
 132
 133 Release 0.6    12/03/98   Fixed setRec() in mixctl.h.
 134                              (thanks to Geir.I.Jensen@runit.sintef.no)
 135                           Now works on 8bpp displays with full colormaps.
 136                              (thanks to devernay@istar.fr on the mailing-list)
 137                           Now configurable through a ~/.wmmixer file.
 138                              (suggested by steeve@minet.net)
 139                           New channel symbols.
 140                              (thanks to steeve@minet.net)
 141
 142 Release 0.7    25/04/98   Better checking of supported channels.
 143                           Now GPL.
 144                           Sensible CPU load.
 145                           New FAQ.
 146                           New mixctl.h.
 147                           New look.
 148                              (thanks to warp@xs4all.nl)
 149
 150 Release 0.8    06/05/98   Removed broken display code.
 151                           Added "-b back_color" command line argument.
 152
 153 Release 0.1    05/09/98   Added a little error checking.
 154 Beta1                     More delicate volume leds fit in better with other apps.
 155                           Added "-a" command line argument for AfterStep users.
 156                           Added "-position position" command line argument.
 157                           Command line arguments, "-a", "-w" and "-s" are now toggle,
 158                              so if you enable one at compile-time, you can override
 159                              it at run-time.
 160                           Added command to configuration file format.