1wmmixer - A mixer designed for WindowMaker 205/09/98 Release 1.0 Beta1 3Copyright (C) 1998 Sam Hawker <shawkie@geocities.com> 4This software comes with ABSOLUTELY NO WARRANTY 5This software is free software, and you are welcome to redistribute it 6under certain conditions 7See 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., 675 Mass Ave, Cambridge, MA 02139, USA. 22 23 24THE AUTHOR: 25=========== 26 27Sam Hawker (17/m/uk) 28 29shawkie@geocities.com 30http://www.geocities.com/SiliconValley/Vista/2471/ 31 32 33INSTALLING: 34=========== 35 36xmkmf 37make 38strip wmmixer 39make install 40 41 42CONFIGURATION: 43============== 44 45Users can configure wmmixer to suit their requirements by means of a ~/.wmmixer 46file. A commented example is supplied, and would be a good starting point. 47 48cp home.wmmixer ~/.wmmixer 49 50 51USAGE: 52====== 53 54You can access all the channels on your soundcard's mixer with wmmixer. Most 55common channels are identified with an appropriate icon. 56Controls include a stereo (mono where appropriate) volume control and a recording 57source toggle button. 58 59Press the "<" and ">" arrow buttons to select a channel. 60The icon identifies the current channel (a volume symbol with a question mark 61represents an unrecognised channel). 62Click and/or drag the volume display to set channel volume. 63There is a also a button to set recording sources. 64 65 66AFTERSTEP USERS: 67================ 68(thanks to tygris@erols.com) 69 70This release includes in a new command line option. 71The effect this has is to enable shape support (it implies "-s"), and 72to reduce the size of the window to 56x56 pixels. 73The "-position position" option has also been added, so you can push 74wmcdplay off the edge of the screen while it gets swallowed. 75To put wmmount in your Wharf, add the following line in the appropriate 76part of your .steprc 77 78*Wharf wmmount nil MaxSwallow "wmmount" wmmount -a -position -0-0 & 79 80It is also possible (by editing and recompiling the afterstep sources), 81to make Wharf handle the new 56x56 pixel window properly - yes, I add 82an option to use a 56x56 pixel window, even though the AfterStep Wharf 83really wants 55x57 pixel ones. 84 85I am told (by tygris@erols.com): 86 87"Locate Wharf.c (or is it Wharf.cc?) Should be in 88AfterStep-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 95and change the 55 and 57 to 56's. Save and compile." 96 97 98BUILD PROBLEMS: 99=============== 100 101You may have trouble linking wmmixer with the compiler supplied on some 102recent Linux distributions (eg. Debian 2.0 & RedHat 5.1). 103It can be made to build by adding the following line to the top of the 104Imakefile, before executing xmkmf: 105 106CC = c++ 107 108I am not sure of the effect this has on memory usage, etc. 109 110 111RELEASE HISTORY: 112================ 113 114Release 0.1 07/02/98 Finally reached a state I am prepared to put my 115 name to. 116 No KNOWN bugs. 117 118Release 0.2 12/02/98 Fixed nasty memory hole. 119 120Release 0.3 24/02/98 Fixed bug relating to manual window positioning. 121 122Release 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 127Release 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 133Release 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 142Release 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 150Release 0.8 06/05/98 Removed broken display code. 151 Added "-b back_color" command line argument. 152 153Release 0.1 05/09/98 Added a little error checking. 154Beta1 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.