thesis/thesis.tex: Adding information on how the OSC interface handles gain on a linear scale, instead of a logarithmic scale.

1 files changed, 17 insertions, 3 deletions

diff --git a/thesis/thesis.tex b/thesis/thesis.tex
index bf729c8..b8f7670 100644
--- a/thesis/thesis.tex
+++ b/thesis/thesis.tex
@@ -1657,8 +1657,8 @@ ssr-aap -N “server” -C “127.0.0.1:50002”
             \texttt{[/source/file\_name\_ or\_port\_number, 1, “1”]}\\
             \texttt{/source/port\_name } & is & Set a source's \gls{jack} input
             port name & \texttt{[/source/port\_name, 1, “system:capture\_2”]}\\
-            \texttt{/source/gain} & if & Set a source's gain &
-            \texttt{[/source/gain, 1, 0.2]}\\
+            \texttt{/source/gain} & if & Set a source's gain on a linear scale
+            (0.0 - inf) & \texttt{[/source/gain, 1, 0.2]}\\
             \texttt{/source/model} & is & Set a source's model &
             \texttt{[/source/model, 1, “point”]}\\
             \texttt{/source/mute} & iF & Unmute a source &
@@ -1707,7 +1707,21 @@ ssr-aap -N “server” -C “127.0.0.1:50002”
         ,~\ref{tab:ssr-osc-scene} ,~\ref{tab:ssr-osc-source}
         ,~\ref{tab:ssr-osc-processing-tracker-transport}
         and~\ref{tab:ssr-osc-reference}, but is able to send \textit{update}
-        messages.
+        messages.\\
+
+        There is one significant difference between the \textit{direct}
+        messages understood by the \gls{osc} interface and the functionality of
+        the \gls{ip} interface. The latter expects source gain to be
+        transmitted on a logarithmic scale, ranging from \textit{-inf} to
+        \textit{inf}. However, the \gls{ssr} is internally calculating on a
+        linear scale and a linear gain level of \textit{0} is therefore hard to
+        be reached\footnote{
+          \href{https://github.com/SoundScapeRenderer/ssr/issues/28}
+        {https://github.com/SoundScapeRenderer/ssr/issues/28}}. For a more
+        intuitive use, a linear scale was chosen for the \gls{osc} interface,
+        ranging from \textit{0.0} to \textit{inf} (see gain related messages in
+        Table~\ref{tab:ssr-osc-source}), where \textit{1.0} signifies 100\%
+        source level.
 
         \begin{table}[!htb]
           \renewcommand{\arraystretch}{1.2}