From a81d71e0afbb97f995d09142f2fe284ad2c9af5c Mon Sep 17 00:00:00 2001 From: David Runge Date: Tue, 25 Jul 2017 18:44:57 +0200 Subject: thesis/thesis.tex: Adding information on how the OSC interface handles gain on a linear scale, instead of a logarithmic scale. --- thesis/thesis.tex | 20 +++++++++++++++++--- 1 file 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} -- cgit v1.2.3-54-g00ecf