From 3dc05db91489cc8ee9c107852e80154c87d23fac Mon Sep 17 00:00:00 2001
From: David Runge <dave@sleepmap.de>
Date: Fri, 16 Jun 2017 18:52:38 +0200
Subject: thesis/thesis.tex: Extending Message interface introduction. Removing
 all smallskips from tables, as they now have an alternating background color
 for better readability. Fixing OSC type tag table header. Fixing OSC
 reference messages table width.

---
 thesis/thesis.tex | 106 ++++++++++++++++++------------------------------------
 1 file changed, 34 insertions(+), 72 deletions(-)

(limited to 'thesis/thesis.tex')

diff --git a/thesis/thesis.tex b/thesis/thesis.tex
index 463091f..2c113fc 100644
--- a/thesis/thesis.tex
+++ b/thesis/thesis.tex
@@ -499,6 +499,7 @@
         \rowcolors{2}{table-background-one}{table-background-two}
         \begin{tabular}{ p{2cm} | p{8cm} }
           \textbf{\gls{osc} type tag} & \textbf{Type} \\
+          \hline
           \texttt{i} & int32 \\
           \texttt{f} & float32 \\
           \texttt{s} & \gls{osc}-string \\
@@ -755,7 +756,13 @@
 
       \subsubsection{Message interface}
         \label{subsubsec:message_interface}
-        \gls{osc} offers the possibility of a hierarchical path tree, that can be used to group messages 
+        \gls{osc} offers the possibility of a hierarchical path tree, that can
+        be used to group messages by type. In conjunction with messages only
+        understood by client or server (or a context dependant meaning), most
+        of the messages understood by the \nameref{subsec:ip-interface} could
+        be implemented. Additional features, related to the server-client setup
+        were integrated as well.
+
         \begin{table}[!htb]
           \scriptsize
           \centering
@@ -769,23 +776,17 @@
             \hline
             \texttt{/message\_level} & i & Set message level of sender &
             \texttt{[/message\_level, 1]} \\
-            \noalign{\smallskip}
             \texttt{/message\_level} & ssi & Set message level of a specific
             client & \texttt{[/message\_level, “127.0.0.1”,
             “50002”, 1]} \\
-            \noalign{\smallskip}
             \texttt{/subscribe} & F & Unsubscribe sender & \texttt{[/subscribe,
             false]} \\
-            \noalign{\smallskip}
             \texttt{/subscribe} & Fss & Unsubscribe specific client &
             \texttt{[/subscribe, false, “127.0.0.1”, “50002”]}\\
-            \noalign{\smallskip}
             \texttt{/subscribe} & T & Subscribe sender & \texttt{[/subscribe,
             true]} \\
-            \noalign{\smallskip}
             \texttt{/subscribe} & Ti & Subscribe sender with specific message
             level & \texttt{[/subscribe, true, 1]} \\
-            \noalign{\smallskip}
             \texttt{/subscribe} & Tssi & Subscribe specific client with
             specific message level & \texttt{[/subscribe, true, “127.0.0.1”,
             “50002”, 1]} \\
@@ -796,6 +797,30 @@
           }
           \label{tab:ssr-osc-subscribe}
         \end{table}
+
+        \begin{table}[!htb]
+          \scriptsize
+          \centering
+          \rowcolors{2}{table-background-one}{table-background-two}
+          \caption*{(Data types and their acronyms are listed in
+            Table~\ref{tab:ssr-osc-data-type-acronyms}.)
+          }
+          \begin{tabular}{ p{2cm} | p{1cm} | p{3.5cm} | p{3cm} }
+            \textbf{Path} & \textbf{Types} & \textbf{Description} &
+            \textbf{Example}\\
+            \hline
+            \texttt{/message\_level} & i & Set message level of sender (the
+            server) & \texttt{[/message\_level, 1]} \\
+            \texttt{/poll} & & Polls clients (continuously) to (re-)subscribe &
+            \texttt{[/poll]} \\
+          \end{tabular}
+          \caption{\gls{osc} messages relevant for polling and setting of
+            message levels for servers subscribed to.\\
+            Understood by clients.
+          }
+          \label{tab:ssr-osc-client-poll-message-level}
+        \end{table}
+
         \begin{table}[!htb]
           \scriptsize
           \centering
@@ -809,22 +834,16 @@
             \hline
             \texttt{/processing/state} & F & Unset processing state &
             \texttt{[/processing/state, false]} \\
-            \noalign{\smallskip}
             \texttt{/processing/state} & T & Set processing state &
             \texttt{[/processing/state, true]} \\
-            \noalign{\smallskip}
             \texttt{/tracker/reset} & & Reset tracker &
             \texttt{[/tracker/reset]} \\
-            \noalign{\smallskip}
             \texttt{/transport/rewind} & & Rewind the \gls{jack} transport &
             \texttt{[/transport/rewind]} \\
-            \noalign{\smallskip}
             \texttt{/transport/seek} & s & Seek to time code in
             \gls{jack} transport & \texttt{[/transport/seek, “42:00:00”]} \\
-            \noalign{\smallskip}
             \texttt{/transport/state} & F & Unset \gls{jack} transport
             state & \texttt{[/transport/state, false]} \\
-            \noalign{\smallskip}
             \texttt{/transport/state} & T & Set \gls{jack} transport
             state & \texttt{[/transport/state, true]} \\
           \end{tabular}
@@ -841,20 +860,17 @@
           \caption*{(Data types and their acronyms are listed in
             Table~\ref{tab:ssr-osc-data-type-acronyms}.)
           }
-          \begin{tabular}{ p{4.3cm} | p{1cm} | p{2.5cm} | p{4.3cm} }
+          \begin{tabular}{ p{4.3cm} | p{1cm} | p{2.5cm} | p{4.4cm} }
             \textbf{Path} & \textbf{Types} & \textbf{Description} &
             \textbf{Example}\\
             \hline
             \texttt{/reference/orientation} & f & Set azimuth of reference
             point & \texttt{[/reference/orientation, -90.0]} \\
-            \noalign{\smallskip}
             \texttt{/reference/position} & ff & Set position of reference &
             \texttt{[/reference/position, 1.5, 2.0]} \\
-            \noalign{\smallskip}
             \texttt{/reference\_offset/orientation} & f & Set azimuth of
             reference offset position &
             \texttt{[/reference\_offset/orientation, -90.0]} \\
-            \noalign{\smallskip}
             \texttt{/reference\_offset/position} & ff & Set position of
             reference offset & \texttt{[/reference\_offset/position, 1.5,
             2.0]}\\
@@ -880,24 +896,18 @@
             reference distance. &
             \texttt{[/scene/amplitude\_reference
             \_distance, 6.0]}\\
-            \noalign{\smallskip}
             \texttt{/scene/auto\_rotate\_sources} & F & Disable automatic
             rotation of sources. & \texttt{[/scene/auto\_rotate\_sources,
             false]}\\
-            \noalign{\smallskip}
             \texttt{/scene/auto\_rotate\_sources} & T & Enable automatic
             rotation of sources. & \texttt{[/scene/auto\_rotate\_sources,
             true]}\\
-            \noalign{\smallskip}
             \texttt{/scene/clear} & & Delete all sources &
             \texttt{[/scene/clear]}\\
-            \noalign{\smallskip}
             \texttt{/scene/load} & s & Load scene from \gls{asdf} file. &
             \texttt{[/scene/load, “example.asd”]}\\
-            \noalign{\smallskip}
             \texttt{/scene/save} & s & Save scene to \gls{asdf} file. &
             \texttt{[/scene/save, “example.asd”]}\\
-            \noalign{\smallskip}
             \texttt{/scene/volume} & f & Set scene master volume. &
             \texttt{[/scene/volume, 0.23]}\\
           \end{tabular}
@@ -919,60 +929,45 @@
             \hline
             \texttt{/source/delete} & i & Delete source with given id &
             \texttt{[/source/delete, 1]}\\
-            \noalign{\smallskip}
             \texttt{/source/file\_channel} & ii & Set a source's file channel &
             \texttt{[/source/file\_channel, 1, 2]}\\
-            \noalign{\smallskip}
             \texttt{/source/port\_name } & is & Set a source's \gls{jack} input
             port name & \texttt{[/source/port\_name, 1, “system:capture\_2”]}\\
-            \noalign{\smallskip}
             \texttt{/source/gain} & if & Set a source's gain &
             \texttt{[/source/gain, 1, 0.2]}\\
-            \noalign{\smallskip}
             \texttt{/source/model} & is & Set a source's model &
             \texttt{[/source/model, 1, “point”]}\\
-            \noalign{\smallskip}
             \texttt{/source/mute} & iF & Unmute a source &
             \texttt{[/source/mute, 1, false]}\\
-            \noalign{\smallskip}
             \texttt{/source/mute} & iT & Mute a source &
             \texttt{[/source/mute, 1, true]}\\
-            \noalign{\smallskip}
             \texttt{/source/name} & is & Set a source's name &
             \texttt{[/source/name, 1, “Daisy”]}\\
-            \noalign{\smallskip}
             \texttt{/source/new} & i & Create a new source stub using id &
             \texttt{[/source/new, 1]}\\
-            \noalign{\smallskip}
             \texttt{/source/new} & sssffffTFF & Create a new source
             (auto-generated id) with name, model, port number, X-coordinate,
             Y-coordinate, orientation, gain, movability, orientation movability
             and mute status & \texttt{[/source/new, “Daisy”, “point”, “1”, 1.0,
             2.5, 90.0, 0.2, true, false, false]} \\
-            \noalign{\smallskip}
             \texttt{/source/new} & sssffffisTFF & Create a new source
             (auto-generated id) with name, model, port number, X-coordinate,
             Y-coordinate, orientation, gain, file channel, properties file,
             movability, orientation movability and mute status &
             \texttt{[/source/new, “Daisy”, “point”, “1”, 1.0, 2.5, 90.0, 0.2,
             2, “properties.xml”, true, false, false]} \\
-            \noalign{\smallskip}
             \texttt{/source/orientation} & if & Set a source's orientation &
             \texttt{[/source/orientation, 1, -90.0]}\\
-            \noalign{\smallskip}
             \texttt{/source/position} & iff & Set a source's position &
             \texttt{[/source/position, 1, 1.5, 2.0]}\\
-            \noalign{\smallskip}
             \texttt{/source/position\_fixed} & iF & Set a source movable &
             \texttt{[/source/position\_fixed, 1, false]}\\
-            \noalign{\smallskip}
             \texttt{/source/position\_fixed} & iT & Set a source immovable &
             \texttt{[/source/position\_fixed, 1, true]}\\
-            \noalign{\smallskip}
             \texttt{/source/properties\_file} & is & Set a source's properties
             file & \texttt{[/source/properties\_file, 1,
             “source-properties.xml”]}\\
-        \end{tabular}
+          \end{tabular}
           \caption{\gls{osc} messages relevant for source management.\\
               Understood by server and clients.
           }
@@ -989,96 +984,63 @@
             \textbf{Path} & \textbf{Types} & \textbf{Description} \\
             \hline
             \texttt{/update/cpu\_load} & f & \gls{cpu} load changes.\\
-            \noalign{\smallskip}
             \texttt{/update/processing/state} & T & Processing state is set.\\
-            \noalign{\smallskip}
             \texttt{/update/processing/state} & F & Processing state is
             unset.\\
-            \noalign{\smallskip}
             \texttt{/update/reference/orientation} & f & Reference orientation
             changes.\\
-            \noalign{\smallskip}
             \texttt{/update/reference/position} & ff & Reference position
             changes.\\
-            \noalign{\smallskip}
             \texttt{/update/reference\_offset/orientation} & f & Reference
             offset orientation changes.\\
-            \noalign{\smallskip}
             \texttt{/update/reference\_offset/position} & ff & Reference offset
             position changes.\\
-            \noalign{\smallskip}
             \texttt{/update/scene/amplitude\_reference\_distance} & f &
             Amplitude reference distance changes.\\
-            \noalign{\smallskip}
             \texttt{/update/scene/auto\_rotate\_sources} & T & Auto rotation of
             sources is set.\\
-            \noalign{\smallskip}
             \texttt{/update/scene/auto\_rotate\_sources} & F & Auto rotation of
             sources is unset.\\
-            \noalign{\smallskip}
             \texttt{/update/scene/decay\_exponent} & f & The scene's decay
             exponent has changed.\\
-            \noalign{\smallskip}
             \texttt{/update/scene/master\_signal\_level} & f & Master signal
             level has changed.\\
-            \noalign{\smallskip}
             \texttt{/update/scene/sample\_rate} & i & Sample rate of the scene
             changed.\\
-            \noalign{\smallskip}
             \texttt{/update/scene/volume} & f & Volume of the scene has
             changed.\\
-            \noalign{\smallskip}
             \texttt{/update/source/delete} & i & A source with given id was
             deleted. \\
-            \noalign{\smallskip}
             \texttt{/update/source/file\_channel} & ii & A source's file
             channel was set.\\
-            \noalign{\smallskip}
             \texttt{/update/source/file\_name\_or\_port\_number} & is & A
             source's file name or port number was set.\\
-            \noalign{\smallskip}
             \texttt{/update/source/gain} & if & A source's gain was set.\\
-            \noalign{\smallskip}
             \texttt{/update/source/length} & ii & A source's length was set.\\
-            \noalign{\smallskip}
             \texttt{/update/source/level} & if & A source's output level has
             changed.\\
-            \noalign{\smallskip}
             \texttt{/update/source/model} & is & A source's model was set.\\
-            \noalign{\smallskip}
             \texttt{/update/source/mute} & iF & A source was unmuted.\\
-            \noalign{\smallskip}
             \texttt{/update/source/mute} & iT & A source was muted.\\
-            \noalign{\smallskip}
             \texttt{/update/source/name} & is & A source's name was set.\\
-            \noalign{\smallskip}
             \texttt{/update/source/orientation} & if & A source's orientation
             was set. \\
-            \noalign{\smallskip}
             \texttt{/update/source/new} & i & A new source with given id was
             created. \\
-            \noalign{\smallskip}
             \texttt{/update/source/port\_name} & is & A source's \gls{jack}
             port\_name was set. \\
-            \noalign{\smallskip}
             \texttt{/update/source/position} & iff & A source's position was
             set. \\
-            \noalign{\smallskip}
             \texttt{/update/source/position\_fixed} & iF & A source was set to
             be movable. \\
-            \noalign{\smallskip}
             \texttt{/update/source/position\_fixed} & iT & A source was set to
             be immovable. \\
-            \noalign{\smallskip}
             \texttt{/update/source/properties\_file} & is & A source's
             properties\_file was set.\\
-            \noalign{\smallskip}
             \texttt{/update/transport/seek} & s & \gls{jack} transport seeked
             to a timecode position.\\
-            \noalign{\smallskip}
             \texttt{/update/transport/state} & F & \gls{jack} transport was
             stopped.\\
-            \noalign{\smallskip}
             \texttt{/update/transport/state} & T & \gls{jack} transport was
             started.\\
           \end{tabular}
-- 
cgit v1.2.3-54-g00ecf

