README
1wmsmixer - A mixer designed for WindowMaker with scrollwheel support
2Copyright (C) 2003 Damian Kramer <psiren@hibernaculum.net>
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
24
25To install:
26
27xmkmf
28make
29make install
30
31
32You probably want to read the README.wmmixer file too. Most of that
33applies to this program, apart from the recsrc code which has been
34removed.
35
36The main changes between this and wmmixer are:
37
38* Added scrollwheel support. If your scrollwheel is mapped to buttons
39 4 and 5, using it will increase/decrease the volume of the current
40 channel.
41
42* Removed all the recsrc code.
43
44* Changed the display arrangement slightly, and replaced the recsrc
45 button with a numeric/text display.
46
47* Added the setname configuration option, which allows you to give a
48 different channel name (4 chars max) to the built in one if you
49 wish.
50
51* Clicking on the channel icon will briefly display the text name for the
52 channel. This is also displayed when you switch channels.
53
54* Mono channels have one wide bar rather than two thinner ones.
55
56* Changed some icons, and added a few new ones. Several icons are
57 still to be created. Any submissions are always welcome.
58
59
60Please report any bugs to me <psiren@hibernaculum.net>, rather
61than Sam Hawker. I'm sure he doesn't want to go fixing my cockups ;-)
62
63
README.wmmixer
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.