From 89acbfbb2c4f218c9f71c8197b9e5e5af47a09b9 Mon Sep 17 00:00:00 2001
From: David Runge <dave@sleepmap.de>
Date: Sun, 25 Jun 2017 10:17:24 +0200
Subject: thesis/thesis.tex: Adding pdfcomments. Making IP interface paragraphs
 to subsubsections.

---
 thesis/thesis.tex | 43 ++++++++++++++++++++++++++-----------------
 1 file changed, 26 insertions(+), 17 deletions(-)

diff --git a/thesis/thesis.tex b/thesis/thesis.tex
index cd02e1f..643c579 100644
--- a/thesis/thesis.tex
+++ b/thesis/thesis.tex
@@ -5,7 +5,7 @@ parskip=never]{paper}
 \usepackage[utf8]{inputenc}
 \usepackage[T1]{fontenc}
 \usepackage{textcomp}
-\usepackage[usenames,dvipsnames,svgnames,table]{xcolor}
+\usepackage[usenames,dvipsnames,rgb,svgnames,table]{xcolor}
 \definecolor{osc-out}{RGB}{150,0,255}
 \definecolor{osc-in}{RGB}{0,0,255}
 \definecolor{audio-in}{RGB}{255,0,0}
@@ -24,6 +24,7 @@ parskip=never]{paper}
 \usepackage{url}
 \usepackage{graphicx}
 \usepackage{pdfpages}
+\usepackage[author={David Runge}]{pdfcomment}
 \usepackage{mathtools}
 
 \usepackage{float}
@@ -492,14 +493,14 @@ parskip=never]{paper}
       to be linted (error checked) before sending and again parsed, after
       receiving an answer from the application.\\
 
-      \paragraph{OSC through PureData}
-        \label{par:osc_through_puredata}
+      \subsubsection{OSC through PureData}
+        \label{subsubsec:osc_through_puredata}
         To allow \gls{osc} communication, the \gls{ssr} incorporates a Lua
         based \gls{pd} external. It uses two externals (iemnet and pdlua)
         alongside a Lua library for parsing and creating \gls{xml} (SLAXML).
 
-      \paragraph{Sending and receiving}
-        \label{par:sending_and_receiving}
+      \subsubsection{Sending and receiving}
+        \label{subsubsec:sending_and_receiving}
         As mentioned in
         section~\nameref{subsec:publisher_subscriber_interface}, the
         NetworkSubscriber class (part of the \gls{ip} interface) implements the
@@ -570,7 +571,10 @@ parskip=never]{paper}
       that of the \textbf{\nameref{subsec:ip-interface}}, expanding however in
       creating a client-server architecture, controlled by
       \textbf{\nameref{subsubsec:message_levels}}, using a unified
-      \textbf{\nameref{subsubsec:message_interface}}.
+      \textbf{\nameref{subsubsec:message_interface}}.\\
+      \gls{ssr} client instances only evaluate messages of server instances
+      they are subscribed to. Server instances only evaluate messages of client
+      instances, that are subscribed to them.
 
       \subsubsection{Open Sound Control}
         \label{subsubsec:open-sound-control}
@@ -706,9 +710,11 @@ parskip=never]{paper}
         \paragraph{Client instance}
           \label{para:client-instance}
           By default the \gls{ssr} is started as an \gls{osc} client on port
-          50001. As shown in Listing~\ref{lst:ssr-binaural-client-start}, it is
-          possible to use a different port, by defining it with the help of the
-          \textbf{-p} flag.\\
+          50001\pdfcomment[color=red,icon=Note]{Handle failure to startup the
+          liblo ServerThread more gracefully. Instead of segfaulting in case of
+          port in use, throw error message and exit.}. As shown in
+          Listing~\ref{lst:ssr-binaural-client-start}, it is possible to use a
+          different port, by defining it with the help of the \textbf{-p} flag.\\
 
           \begin{listing}[!htb]
             \begin{mdframed}
@@ -729,12 +735,13 @@ ssr-binaural -p “50002”
 
         \paragraph{Server instance}
           \label{para:server-instance}
-          With the help of the \textbf{-N} flag, it is possible to start the
-          \gls{ssr} as an \gls{osc} server. In
-          Listing~\ref{lst:ssr-binaural-server-start} additionally flag
-          \textbf{-C} is used to specify an initial client \gls{ip} and its
-          port (the flag actually accepts a comma-separated list of
-          \gls{ip}-port pairs).\\
+          With the help of the \textbf{-N} flag
+          \pdfcomment[color=red,icon=Note]{Make -N start server, client is
+          default anyways}, it is possible to start the \gls{ssr} as an
+          \gls{osc} server. In Listing~\ref{lst:ssr-binaural-server-start}
+          additionally flag \textbf{-C} is used to specify an initial client
+          \gls{ip} and its port (the flag actually accepts a comma-separated
+          list of \gls{ip}-port pairs).\\
           The \textbf{-p} flag, for setting a specific port is also available,
           when starting a server instance.
 
@@ -929,8 +936,10 @@ ssr-aap -N “server” -C “127.0.0.1:50002”
         To be able to distinguish between types of
         clients and servers, several message levels were implemented for the
         \gls{osc} interface conceived in the course of this work.\\
-        The \textit{enumeration class} MessageLevel (see
-        Listing~\ref{lst:ssr_global.h}) defines the four types \textit{CLIENT},
+        The \textit{enumeration class} \textit{MessageLevel}
+        \pdfcomment[color=red,icon=Note]{Don't allow static\_casts above
+        MessageLevel::GUI\_SERVER} (see Listing~\ref{lst:ssr_global.h}) defines
+        the four types \textit{CLIENT},
         \textit{GUI\_CLIENT}, \textit{SERVER}, \textit{GUI\_SERVER}, which are
         represented as non-negative integers (in ascending order), starting
         from 0.\\
-- 
cgit v1.2.3-54-g00ecf