.TH MIXER 1 "MIDI"
.SH NAME
mixer - control Iota Systems ``Midi-Fader\(tm'' graphically
.SH SYNOPSIS
.B mixer
[\fB-f\fP]
[\fB-i\fP]
[\fB-m\fPFILE]
[\fB-s\fPFILE]
.SH DESCRIPTION
.I Mixer
displays a control panel on the Sun screen that contains \fIgain\fP,
\fIsolo\fP, and \fImute\fP controls for each of up to thirty-two slide pots.
The slide pots can be configured to control a set of up to thirty-two
\fIfaders\fP representing the thirty-two attenuators in four Iota Systems
``Midi-Fader''s.
.PP
The left and middle buttons on the mouse may be used to activate the
\fIsolo\fP or \fImute\fP functions and to change the \fIgain\fP sliders.
The left button is ``latching'', i.e. only one operation can be performed
for each button push and the button must be released to reset it;
whereas the middle button can trigger multiple operations
with the button held down.
.PP
The right-hand button on the Sun's mouse can be used to pop up a menu
that offers the following options:
.PP
INIT \- Send the System Exclusive parameter setting sequence
(described below under the \fB-i\fP option).
This can be useful if the Midi-Fader doesn't seem to be responding.
.PP
SAVE \- Save the current mixer state
(slider, mute, and solo settings)
in a file (``/tmp/mixstate0'' currently).
This file may be used with the \fB\-s\fP option.
.PP
RESTORE \- Restore the mixer state
(slider, mute, and solo settings)
from a file (``/tmp/mixstate0'' currently).
.PP
ALL UP \- Set all sliders to maximum value.
.PP
ALL DOWN \- Set all sliders to minimum value.
.PP
QUIT \- Stop execution and exit; (a handy utility).
.PP
The \fB-f\fP argument suppresses the display of the faders (outputs).
The display organizes itself in various ways to take best advantage of the
particular window it is given.
The fader display will be placed above or to the right of the solo/mute/slider
panel as best fits the window.  Similarly, solo & mute buttons will be
placed above/below each other, or side-by-side at the program's discretion.
.PP
The \fB-i\fP option sends a System Exclusive command to reset all the
parameters on the Iota Systems Midi-Fader(s)
(assuming the first eight faders are on unit 0, the second 8 on unit 1, etc.)
to the following values:
.Cs
Receive levels over MIDI: YES   Accept MIDI prog change: YES
Send levels over MIDI: YES      Send MIDI prog change: NO
Send levels every second: NO    Program change channel: 8      
Fader change rate: 4 ms.        DIAL sensitivity: 10
Faders 1..n use channel: 8
Faders 1..n controlled by: continuous controllers 32..32+n-1
Mutes 1..n controlled by: continuous controllers 64..64+n-1
.Ce
Where \fIn\fP is the number of faders specified in the setup file
(see \fB-s\fP).
The maximum \fIn\fP is 32; while the default (as of 2/20/88)
is 24.
.PP
Specifying a file name with the \fB-m\fP option directs \fImixer\fP to
configure itself according to the mapping specifications in the named file.
See mm(5) for details on the file format.
.PP
The \fB-s\fP option initializes the mixer state to that contained in the
specified file.
slider levels, slider mute button settings, slider solo button settings
fader mute button settings, and fader solo button settings are all initialized.
The specified file must have been created using the \fBSAVE\fP option from the
menu associated with the right-hand mouse button.
In the absence of a \fB\-s\fP argument all the solo and mute buttons are
initially off and the slider levels are all set to be 6 dB down (half volume).
.PP
When the control panel is being displayed on the Sun screen, any unused
sliders or faders will not be drawn, and the panel will only be wide enough
to hold slider 1 through the last slider used.
.SH CAVEATS
The output from \fImixer\fP is raw MIDI, with no time-tags.
Sending \fImixer\fP output directly to the MPU driver
(e.g. ``mixer >/dev/mpu0'') will probably hang the MPU driver.
\fIMixer\fP output should only be sent to the MPU driver through programs
which put the MPU in UART mode or which package the MIDI data as
``MPU_WANT_TO_SEND_DATA'' data (e.g. mixplay(1)).
.PP
The Midi-Fader must be set up to use controller change commands to
change fader and mute settings and to read a particular MIDI channel.
The \fB-i\fP option can set these parameters, but the Midi-Fader must
be configured as ``Unit 0''.  See the Midi-Fader manual for further
details.
.PP
.SH SEE ALSO
Iota Systems, \fIMidi-Fader\(tm Operations Manual\fP, 1987
.br
fade(1), mixer_sa(1), mixplay(1), mm(5)
.SH AUTHOR
Peter Langston, Bell Communications Research
(bellcore!psl)