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.