2023-08-24 Fred Gleason <fredg@paravelsystems.com>

* Added a 'TestOutputStreams=' directive to the '[Caed]' section
	of rd.conf(5).
	* Added code to the 'Unload Playback' ['UP'] CAE command to mute all
	output port volume controls from the subject output stream.
	* Added a feature to the 'Set Output Port' ['OP'] CAE command where
	passing a '-1' for the 'port-num' argument will cause all output
	stream volume controls for the specified stream to be muted.

Signed-off-by: Fred Gleason <fredg@paravelsystems.com>
This commit is contained in:
Fred Gleason
2023-08-24 13:10:10 -04:00
parent d9e16f65a0
commit ba1e2d84ab
12 changed files with 215 additions and 41 deletions

View File

@@ -173,7 +173,8 @@
<sect2>
<title><command>Unload Playback</command></title>
<para>
Free an audio playback interface.
Free an audio playback interface. This will also mute all associated
output stream->output port volume controls.
</para>
<para>
<userinput>UP <replaceable>conn-handle</replaceable>!</userinput>
@@ -662,6 +663,70 @@
</variablelist>
</sect2>
<sect2>
<title><command>Set Output Port</command></title>
<para>
Configure an output stream to use a particular output port.
</para>
<para>
This will cause the <replaceable>stream-num</replaceable> output volume
control feeding the <replaceable>port-num</replaceable> port to be set
to the level given by <replaceable>level</replaceable>, while all other
output_volume controls for that stream to be muted --e.g. set to
-100 dB.
</para>
<para>
<userinput>OP <replaceable>card-num</replaceable>
<replaceable>stream-num</replaceable>
<replaceable>port-num</replaceable>
<replaceable>level</replaceable>!</userinput>
</para>
<variablelist>
<varlistentry>
<term>
<replaceable>card-num</replaceable>
</term>
<listitem>
<para>
The number of the audio adapter to use.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<replaceable>stream-num</replaceable>
</term>
<listitem>
<para>
The stream number to use. This is relative to the audio adapter
selected.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<replaceable>port-num</replaceable>
</term>
<listitem>
<para>
The port number to use. This is relative to the audio adapter
selected.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<replaceable>level</replaceable>
</term>
<listitem>
<para>
The level, in hundreths of a dB.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>
<sect2>
<title><command>Set Output Volume</command></title>
<para>
@@ -702,7 +767,10 @@
<listitem>
<para>
The port number to use. This is relative to the audio adapter
selected.
selected. If a value less than <userinput>0</userinput> is
provided, then <emphasis>all</emphasis> output ports for
<replaceable>stream-num</replaceable> will have their volume
controls set to <replaceable>level</replaceable>.
</para>
</listitem>
</varlistentry>