From 8e7760e8922b8dd900ce5af5008511696c6f694f Mon Sep 17 00:00:00 2001 From: David Runge Date: Mon, 19 Jun 2017 22:18:03 +0200 Subject: thesis/thesis.tex: Adding fancyhdr. Adding minted for listing source code. Adding AAP and NFC-HOA acronyms. Adding Roman page numbering for everything up to TOC. Moving lists before toc. Adding subsubsection about Starting the SSR (with client/server paragraphs). Adding code block for enum class MessageLevel. Adding more info on osc messaging. Adding remaining OSC messages in tables. Adding appendix. --- thesis/thesis.tex | 117 +++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 89 insertions(+), 28 deletions(-) diff --git a/thesis/thesis.tex b/thesis/thesis.tex index 4ba79f3..86ecd0d 100644 --- a/thesis/thesis.tex +++ b/thesis/thesis.tex @@ -1,9 +1,11 @@ -\documentclass[12pt,a4paper,oneside,titlepage]{paper} +\documentclass[11pt, a4paper, oneside, titlepage, listof=totoc, headinclude, +open=right, glossaries=totoc, captions=tableheading, final, BCOR=10mm, +parskip=never]{paper} \usepackage[english]{babel} \usepackage[utf8]{inputenc} \usepackage[T1]{fontenc} \usepackage{textcomp} -\usepackage[dvipsnames,table]{xcolor} +\usepackage[usenames,dvipsnames,svgnames,table]{xcolor} \definecolor{osc-out}{RGB}{150,0,255} \definecolor{osc-in}{RGB}{0,0,255} \definecolor{audio-in}{RGB}{255,0,0} @@ -13,21 +15,16 @@ \definecolor{table-background-one}{RGB}{194,195,194} \definecolor{table-background-two}{RGB}{210,213,210} -\usepackage{listings} -\lstdefinelanguage{Ini}{basicstyle=\ttfamily\tiny, - columns=fullflexible, - tag=[s]{[]}, - tagstyle=\color{blue}\bfseries, - usekeywordsintag=true -}[html] -\lstdefinelanguage{bash}{basicstyle=\ttfamily\tiny} +\usepackage[cache=false,newfloat=true]{minted} +\usepackage{mdframed} -\usepackage{ulem} -\usepackage{lmodern} -\usepackage{multirow} +\usepackage{fancyhdr} +%\usepackage{ulem} +%\usepackage{lmodern} \usepackage{url} \usepackage{graphicx} \usepackage{pdfpages} +\usepackage{mathtools} \usepackage{float} \floatstyle{boxed} @@ -43,6 +40,7 @@ % glossary \usepackage[acronym,nonumberlist,toc]{glossaries} +\newacronym{aap}{AAP}{Ambisonics Amplitude Panning} \newacronym{adat}{ADAT}{Alesis Digital Audio Tape} \newacronym{alsa}{ALSA}{Advanced Linux Sound Architecture} \newacronym{api}{API}{Application programming interface} @@ -62,6 +60,7 @@ \newacronym{ip}{IP}{Internet Protocol} \newacronym{jack}{JACK}{JACK Audio Connection Kit} \newacronym{madi}{MADI}{Multichannel Audio Digital Interface} +\newacronym{nfc-hoa}{NFC-HOA}{Near-field-corrected Higher Order Ambisonics} \newacronym{oop}{OOP}{Object-oriented Programming} \newacronym{os}{OS}{Operating System} \newacronym{osc}{OSC}{Open Sound Control} @@ -81,6 +80,8 @@ \graphicspath{{../images//}} \begin{document} + \pagenumbering{Roman} + \pagestyle{empty} \begin{titlepage} \centering \includegraphics[width=0.3\textwidth]{tu-berlin-logo.pdf}\par\vspace{1cm} @@ -100,7 +101,6 @@ {\large \today\par} \end{titlepage} - \pagestyle{empty} \section*{Eidesstattliche Erklärung} \vspace{1cm} Hiermit erkläre ich, dass ich die vorliegende Arbeit selbstständig und @@ -110,6 +110,10 @@ \vspace{2cm} \noindent\ldots\ldots\ldots\ldots\ldots\ldots\ldots\ldots\ldots\ldots\ldots\\ David Runge + \newpage + + Thanks + \newpage \begin{abstract} \gls{wfs} as a technological concept has been around for @@ -128,6 +132,7 @@ This work is about the extension of the SoundScape Renderer's functionality to turn it into a networking application for large scale \gls{wfs} setups. \end{abstract} + \newpage \renewcommand{\abstractname}{Zusammenfassung} \begin{abstract} @@ -147,11 +152,39 @@ This work is about the extension of the SoundScape Renderer's functionality to turn it into a networking application for large scale \gls{wfs} setups. \end{abstract} + \newpage + + \setcounter{page}{1} + \pagestyle{plain} + \printglossaries + \newpage + \phantomsection + \addcontentsline{toc}{section}{\listtablename} + \listoftables + \newpage + + \phantomsection + \addcontentsline{toc}{section}{\listfigurename} + \listoffigures + \newpage + + \phantomsection + \addcontentsline{toc}{section}{\listlistingname} + \listoflistings + \newpage + + \pagestyle{empty} + { + \renewcommand{\thispagestyle}[1]{} + \tableofcontents + \newpage + } - \tableofcontents - \cleardoublepage \pagestyle{headings} \setcounter{page}{1} + \pagenumbering{arabic} + \renewcommand{\theFancyVerbLine}{\textcolor{gray}{\scriptsize\arabic{FancyVerbLine}}} + \RecustomVerbatimEnvironment{Verbatim}{Verbatim}{xleftmargin=5mm} \section{Introduction} \label{sec:introduction} @@ -567,6 +600,19 @@ version, instead of the current stable version of liblo was chosen for the implementation. + \subsubsection{Starting the SSR} + \label{subsubsec:starting-the-ssr} + The \gls{ssr} can be started with a rendering engine preselected (an + executable postfixed by the rendering acronym), or by selecting one + through the configuration file, when using the executable named + \textbf{ssr}. This way \gls{aap}, \gls{bs}, \gls{brs}, generic, + \gls{nfc-hoa}, \gls{vbap}, \gls{wfs} renderers become available.\\ + + \paragraph{Client instance} + \label{para:client-instance} + \paragraph{Server instance} + \label{para:server-instance} + \subsubsection{Setups} \label{subsubsec:setups} The \gls{ssr} offers the possibility for many different \gls{osc} @@ -735,10 +781,18 @@ 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 in - \textit{src/ssr\_global.h} defines the four types \textit{CLIENT}, + The \textit{enumeration class} MessageLevel (see + Listing~\ref{lst:ssr_global.h}) defines the four types \textit{CLIENT}, \textit{GUI\_CLIENT}, \textit{SERVER}, \textit{GUI\_SERVER}, (in ascending order).\\ + \begin{listing}[!htb] + \begin{mdframed} + \inputminted[numbers=left, firstline=54, lastline=60, + fontsize=\footnotesize]{c++}{../../ssr/src/ssr_global.h} + \end{mdframed} + \caption{src/ssr\_global.h: enum class MessageLevel} + \label{lst:ssr_global.h} + \end{listing}\\ \gls{ssr} client instances subscribe to (\gls{ssr}) server instances with the \textit{MessageLevel} \textit{CLIENT} by default. Server instances get the \textit{MessageLevel} \textit{SERVER} assigned @@ -773,7 +827,13 @@ 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. + were integrated as well.\\ + When starting a \gls{ssr} server instance (see + \nameref{para:server-instance}), it responds to the messages shown in + Table~\ref{tab:ssr-osc-subscribe}, + Table~\ref{tab:ssr-osc-scene}, + Table~\ref{tab:ssr-osc-processing-tracker-transport}, + Table~\ref{tab:ssr-osc-reference} and Table~\ref{tab:ssr-osc-update}. \begin{table}[!htb] \scriptsize @@ -805,8 +865,8 @@ \end{tabular} \caption{\gls{osc} messages relevant for subscribing and setting of message levels for clients.\\ - Understood by server. } + \caption*{Understood by server.} \label{tab:ssr-osc-subscribe} \end{table} @@ -916,8 +976,13 @@ true]}\\ \texttt{/scene/clear} & & Delete all sources & \texttt{[/scene/clear]}\\ + \texttt{/scene/decay\_exponent} & f & Set amplitude decay exponent + in virtual space ($1/r^{exp}$). & \texttt{[/scene/decay\_exponent, + 2.0]}\\ \texttt{/scene/load} & s & Load scene from \gls{asdf} file. & \texttt{[/scene/load, “example.asd”]}\\ + \texttt{/scene/master\_signal\_level} & f & Set the renderers + signal level. & \texttt{[/scene/master\_signal\_level, -20]}\\ \texttt{/scene/save} & s & Save scene to \gls{asdf} file. & \texttt{[/scene/save, “example.asd”]}\\ \texttt{/scene/volume} & f & Set scene master volume. & @@ -943,6 +1008,9 @@ \texttt{[/source/delete, 1]}\\ \texttt{/source/file\_channel} & ii & Set a source's file channel & \texttt{[/source/file\_channel, 1, 2]}\\ + \texttt{/source/file\_name\_or\_port\_number} & is & Set a source's + file name or port number & + \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 & @@ -1115,14 +1183,7 @@ \pagestyle{empty} \cleardoublepage - \addcontentsline{toc}{section}{\listfigurename} - \listoffigures - \cleardoublepage - \addcontentsline{toc}{section}{\listtablename} - \listoftables - \cleardoublepage - \printindex - \printglossaries + \appendix \cleardoublepage \bibliographystyle{plainnat} \bibliography{../bib/ssr-networking} -- cgit v1.2.3-54-g00ecf