← Back to branch summary

~ubuntu-branches/ubuntu/wily/oss4/wily

« back to all changes in this revision

Viewing changes to cmd/ossmix/ossmix.man

  • Committer: Bazaar Package Importer
  • Author(s): Romain Beauxis, Samuel Thibault, Romain Beauxis, Sebastien NOEL
  • Date: 2011-06-14 10:06:56 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20110614100656-cx4oc7u426zn812z
Tags: 4.2-build2004-1
http://bugs.debian.org/589127
http://bugs.debian.org/604679
http://bugs.debian.org/595298
http://bugs.debian.org/619272
http://bugs.debian.org/627149
http://bugs.debian.org/628879
[ Samuel Thibault ]
* debian/control: Add liboss4-salsa2, liboss4-salsa-dev and
  liboss4-salsa-asound2 packages, equivalent to (and will replace) those from
  the oss-libsalsa package (Closes: #589127).
* debian/patches/liboss4-salsa.patch: New patch to rename libsalsa into
  liboss4-salsa to avoid conflicts in the archive for no good reason.
* debian/rules: Make in libOSSlib and libsalsa.
* debian/liboss4-salsa-dev.install, debian/liboss4-salsa2.install,
  debian/liboss4-salsa-asound2.links, debian/liboss4-salsa-dev.links:
  Install liboss4-salsa libraries like was done in the oss-libsalsa package.
* include-alsa: Add a copy of ALSA 1.0.5 headers: Cf ALSA_1.0.* symbols in
  libsalsa, this is the roughly supported version.
* debian/copyright: Update for new include-alsa files.
* alsa.pc: New file for compatibility with libasound-dev.
* debian/control:
  - Add Vcs-Browser and Vcs-Svn fields.
  - Use linux-any instead of the list of Linux archs (Closes: #604679).
  - Make dkms dependency linux-any only.
* debian/patches/hurd_iot.patch: New patch to fix soundcard.h usage in
  libsalsa on hurd-i386.
* debian/patches/libsalsa_fixes.patch: New patch to fix some printf usages
  and ioctl declaration in libsalsa.
* debian/patches/no_EBADE.patch: New patch to cope with hurd-i386 not having
  EBADE.
* debian/patches/CFLAGS.patch: New patch to make oss4 take debian/rules
  CFLAGS into account.
* debian/patches/snd_asoundlib_version.patch: New patch to add
  snd_asoundlib_version().
* debian/patches/generic_srccconf.patch: New patch to fix source
  configuration on unknown archs.

[ Romain Beauxis ]
* Fixed README.Debian to only mention dkms' modules.
* Switch to dpkg-source 3.0 (quilt) format
* Added DM-Upload-Allowed: yes

[ Sebastien NOEL ]
* New upstream release (Closes: #595298, #619272).
* Fix typo in initscript (Closes: #627149).
* debian/control: adjust linux-headers dependencies (Closes: #628879).

Show diffs side-by-side

added added

removed removed

Lines of Context:
cmd/ossmix/ossmix.man
 
1
NAME
 
2
ossmix - Open Sound System command-line mixer program.
 
3
 
 
4
SYNOPSIS
 
5
ossmix [-d <dev#>] [-achqD] [control name] [value]
 
6
 
 
7
DESCRIPTION
 
8
ossmix is a simple command-line mixer utility that is used to display the mixer
 
9
settings of physical and virtual audio devices. OSS version 4 has an extended
 
10
mixer API which supports some device specific features that may not available
 
11
using other mixer applications. 
 
12
 
 
13
OPTIONS
 
14
-D              Display device information.
 
15
-a              Dump mixer settings for all mixers (normal format).
 
16
-c              Dump mixer settings for all mixers (command format).
 
17
-h              Display usage information.
 
18
-q              Quiet mode.
 
19
-v[1|2]         Verbose mode. -v2 prints more detailed infoamation than -v1.
 
20
ctrl# value     Change value of a mixer control.
 
21
<no arg>        Display current/possible settings.
 
22
 
 
23
USAGE
 
24
ossmix without any arguments displays the current settings of the
 
25
default mixer device (usually the motherboard sound chip). This
 
26
printout can also be used to find out the supported control names and
 
27
their possible values. Currently all controls accept an ON/OFF value, a
 
28
mono value (0 to 100) or a stereo value (left:right where both channel
 
29
volumes can be between 0 and 100). The value can also be expressed in a
 
30
relative form (e.g. +1 to add 1 to the previous volume). An ON/OFF control
 
31
can also receive a TOGGLE value. If a control has a name in quotes following
 
32
the normal output, than the name can be used instead of the control when
 
33
setting a value.
 
34
 
 
35
The following is a sample printout produced by ossmix:
 
36
 
 
37
        Selected mixer 0/Creative AudioPCI
 
38
        Known controls are:
 
39
        vol <both/leftvol>[:<rightvol>] (currently 50:50)
 
40
        pcm <both/leftvol>[:<rightvol>] (currently 50:50)
 
41
        speaker <monovol> (currently 21)
 
42
        line <both/leftvol>[:<rightvol>] (currently 32:32)
 
43
        line.rec ON|OFF (currently OFF)
 
44
        mic <monovol> (currently 16)
 
45
        mic.rec ON|OFF (currently ON)
 
46
        cd <both/leftvol>[:<rightvol>] (currently 100:100)
 
47
        cd.rec ON|OFF (currently OFF)
 
48
        pcm2 <both/leftvol>[:<rightvol>] (currently 75:75)
 
49
        line1 <both/leftvol>[:<rightvol>] (currently 32:32)
 
50
        line1.rec ON|OFF (currently OFF)
 
51
        line2 <monovol> (currently 32)
 
52
        line2.rec ON|OFF (currently OFF)
 
53
        line3 <monovol> (currently 0)
 
54
        line3.rec ON|OFF (currently OFF)
 
55
        mic.micboost ON|OFF (currently ON)
 
56
        mic.micbias ON|OFF (currently ON)
 
57
        mute.pcmmute ON|OFF (currently OFF)
 
58
        mute.pcm2mute ON|OFF (currently OFF)
 
59
        mute.micmute ON|OFF (currently OFF)
 
60
        mute.cdmute ON|OFF (currently OFF)
 
61
        mute.linemute ON|OFF (currently OFF)
 
62
        mute.line1mute ON|OFF (currently OFF)
 
63
        mute.line2mute ON|OFF (currently OFF)
 
64
        mute.line3mute ON|OFF (currently OFF)
 
65
 
 
66
SELECTING MIXER DEVICE
 
67
It's possible to select the mixer device by using the -d<mixernumber>
 
68
command line argument. This argument (when used) should be the first one
 
69
on the command line. By default the mixer number 0 will be accessed.
 
70
To find the available mixer devices, type ossinfo -x and look
 
71
under the Mixers heading for available mixer devices. 
 
72
 
 
73
CHANGING MIXER SETTINGS
 
74
Changing the values is done just like with the original "mixer" applet.
 
75
For example:
 
76
 
 
77
        ossmix pcm 50:60
 
78
 
 
79
The above sets the pcm control (audio playback volume) so that the left
 
80
channel volume is 50 and the right channel volume is 60. With just
 
81
"ossmix pcm 50" the both channel volumes will be set to 50.
 
82
 
 
83
In addition to the old mixer there are now some (usually ON/OFF) settings.
 
84
These settings are device specific and don't work with all soundcards.
 
85
The easiest way to find them out is to start ossmix without command line
 
86
arguments (other than -d#).
 
87
 
 
88
Some control names contain a dot ("."). This dot is required when changing
 
89
the value. For example: "ossmix -d0 mic.micboost ON".
 
90
 
 
91
."USING OSSMIX WITH A MIDI CONTROLLED MIXER
 
92
."The ossmix program has capability to listen MIDI main volume controller
 
93
."messages from a MIDI port. You can assign a ossmix control to each MIDI
 
94
."channel. After receiving a channel main volume change message ossmix will then
 
95
."change the mixer level of the volume control assigned to the channel. In this
 
96
."mode ossmix will not exit (you need to kill it manually).
 
97
."
 
98
."This mode is very useful if you need to make several rapid mixer changes
 
99
."simultaneously.
 
100
."
 
101
."To use this mode you need to give the MIDI device file and a list of the
 
102
."volume sliders on command line. For example:
 
103
."
 
104
    ."ossmix -d1 -m/dev/midi00 vol mic pcm line gain.out1/2 gain.in3/4
 
105
."
 
106
."After that the MIDI channels will be assigned in the following way:
 
107
."
 
108
    ."Ch 0 = "vol"
 
109
    ."Ch 1 = "mic"
 
110
    ."Ch 2 = "pcm"
 
111
    ."Ch 3 = "line"
 
112
    ."Ch 4 = "gain.out1/2"
 
113
    ."Ch 5 = "gain.in3/4"
 
114
."
 
115
."Other MIDI channels (6 to 15) will be ignored.
 
116
."
 
117
."Only mono and stereo slider type controls can be assigned to MIDI channels.
 
118
."Both stereo channels will be set to the same volume (there is no balance 
 
119
."support).
 
120
."
 
121
."After starting ossmix you should move the sliders on the external fader box
 
122
."so that ossmix can figure out their current settings.
 
123
."
 
124
."At this moment only MIDI fader boxes that send only main volume change messages
 
125
."are supported (any other MIDI data will make ossmix to behave incorrectly).
 
126
."For example the FM3 MIDI Mixer (AKA "FaderBaby") by JLCooper is compatible
 
127
."with ossmix.
 
128
."
 
129
 
 
130
EXAMPLES
 
131
 
 
132
  ossmix vol 50  
 
133
    Set the vol control volume to 50. If the pcm control is a stereo control,
 
134
    than both channels will be set to 50.
 
135
 
 
136
  ossmix vol 50:60  
 
137
    Set the vol control so that the left channel volume is 50 and the right
 
138
    channel volume is 60.
 
139
 
 
140
  ossmix vol +2  
 
141
    Raise vol volume by 2.
 
142
 
 
143
  ossmix -- vol +2:-2  
 
144
    Raise the left channel volume by 2, and lower right channel volume by 2.
 
145
    The "--" is needed on some systems so that the "-2" won't be mistaken for
 
146
    a parameter.
 
147
 
 
148
  ossmix micboost ON  
 
149
    Set micboost to ON.
 
150
 
 
151
  ossmix micboost TOGGLE  
 
152
    Toggle micboost.
 
153
 
 
154
  ossmix mplayer +2  
 
155
    Raise mplayer volume by 2. This would only work if mplayer is using the
 
156
    virtual mixer.
 
157
 
 
158
FILES
 
159
/usr/bin/ossmix
 
160
 
 
161
SEE ALSO
 
162
ossdevlinks(1), ossxmix(1), savemixer(1)
 
163
 
 
164
AUTHOR
 
165
4Front Technologies