\hypertarget{expand_8h}{
\section{expand.h File Reference}
\label{expand_8h}\index{expand.h@{expand.h}}
}
Expansion routines.  


{\tt \#include $<$unistd.h$>$}\par
{\tt \#include $<$stdlib.h$>$}\par
{\tt \#include $<$stdio.h$>$}\par
\subsection*{Typedefs}
\begin{CompactItemize}
\item 
\hypertarget{expand_8h_c724d558809a9307dfa242581d84cd69}{
typedef struct \hyperlink{structQSEC__expansion__}{QSEC\_\-expansion\_\-} \hyperlink{expand_8h_c724d558809a9307dfa242581d84cd69}{QSEC\_\-expansion}}
\label{expand_8h_c724d558809a9307dfa242581d84cd69}

\begin{CompactList}\small\item\em Declaration of the opaque expansion structure. \item\end{CompactList}\end{CompactItemize}
\subsection*{Functions}
\begin{CompactItemize}
\item 
void \hyperlink{expand_8h_bd579e0ef022b85aef7634d9e91ad685}{QSEC\_\-clearExpansion} (\hyperlink{structQSEC__expansion__}{QSEC\_\-expansion} $\ast$exp)
\begin{CompactList}\small\item\em Clear away any context from a previous cycle. \item\end{CompactList}\item 
\hyperlink{structQSEC__expansion__}{QSEC\_\-expansion} $\ast$ \hyperlink{expand_8h_72b501512416cbe5684750aac0ccb6ec}{QSEC\_\-constructExpansion} (void $\ast$buffer, unsigned cap)
\begin{CompactList}\small\item\em Construct a QSEC\_\-expansion structure in a buffer. \item\end{CompactList}\item 
const unsigned int $\ast$ \hyperlink{expand_8h_40cd442568e2900a369fff69f9c053ce}{QSEC\_\-recoverUser} (\hyperlink{structQSEC__expansion__}{QSEC\_\-expansion} $\ast$exp, const unsigned int $\ast$buf)
\begin{CompactList}\small\item\em Unpack the tables against which the events were encoded. \item\end{CompactList}\item 
void \hyperlink{expand_8h_cdafa7fc7dc224d05f57d4dbc961c437}{QSEC\_\-reportExpansion} (\hyperlink{structQSEC__expansion__}{QSEC\_\-expansion} $\ast$exp, FILE $\ast$fp)
\begin{CompactList}\small\item\em Report the contents of an expansion. \item\end{CompactList}\item 
void \hyperlink{expand_8h_5476ac4028f605b19103da2ae3332829}{QSEC\_\-reportExpCtx} (\hyperlink{structQSEC__expansion__}{QSEC\_\-expansion} $\ast$exp, FILE $\ast$fp)
\begin{CompactList}\small\item\em Report the contents of the expansion context. \item\end{CompactList}\item 
void \hyperlink{expand_8h_432e410d16b336f1be7012325929207a}{QSEC\_\-setMode} (\hyperlink{structQSEC__expansion__}{QSEC\_\-expansion} $\ast$exp, unsigned mode)
\begin{CompactList}\small\item\em Set the calibration mode of an expansion. \item\end{CompactList}\item 
size\_\-t \hyperlink{expand_8h_f2b835093871e036f994feb8c517c91d}{QSEC\_\-sizeofExpansion} (unsigned cap)
\begin{CompactList}\small\item\em Calculate the size of the memory block required to accomodate the expansion structure. \item\end{CompactList}\end{CompactItemize}


\subsection{Detailed Description}
Expansion routines. 

\begin{Desc}
\item[Author:]James Swain \& Owen Saxton\end{Desc}
\begin{Desc}
\item[Id]\hyperlink{expand_8h}{expand.h},v 1.5 2010/05/27 20:37:14 saxton Exp \end{Desc}


\subsection{Function Documentation}
\hypertarget{expand_8h_bd579e0ef022b85aef7634d9e91ad685}{
\index{expand.h@{expand.h}!QSEC\_\-clearExpansion@{QSEC\_\-clearExpansion}}
\index{QSEC\_\-clearExpansion@{QSEC\_\-clearExpansion}!expand.h@{expand.h}}
\subsubsection[{QSEC\_\-clearExpansion}]{\setlength{\rightskip}{0pt plus 5cm}void QSEC\_\-clearExpansion ({\bf QSEC\_\-expansion} $\ast$ {\em exp})}}
\label{expand_8h_bd579e0ef022b85aef7634d9e91ad685}


Clear away any context from a previous cycle. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em exp}]Pointer to a expansion object \end{description}
\end{Desc}


References QSEC\_\-calDecompress::accepts, QSEC\_\-expansion\_\-::acd, QSEC\_\-acdDecompress::cables, QSEC\_\-expansion\_\-::cal, QSEC\_\-acdDecompress::chns, QSEC\_\-gemDecompress::cno, QSEC\_\-calDecompress::columns, QSEC\_\-gemDecompress::cond, QSEC\_\-tkrDecompress::diags, QSEC\_\-calDecompress::diags, QSEC\_\-expansion\_\-::dtx, QSEC\_\-expansion\_\-::gem, QSEC\_\-gemDecompress::high, QSEC\_\-calDecompress::layCnts, QSEC\_\-tkrDecompress::layers, QSEC\_\-calDecompress::logs, QSEC\_\-gemDecompress::low, QSEC\_\-calDecompress::mean, QSEC\_\-calDecompress::means, QSEC\_\-acdDecompress::phas, QSEC\_\-acdDecompress::pvahs, QSEC\_\-clearDecompression(), QSEC\_\-calDecompress::ranges, QSEC\_\-gemDecompress::rbn, QSEC\_\-tkrDecompress::requests, QSEC\_\-gemDecompress::roi, QSEC\_\-tkrDecompress::strips, QSEC\_\-expansion\_\-::tkr, QSEC\_\-gemDecompress::tkr, QSEC\_\-tkrDecompress::tots, QSEC\_\-tkrDecompress::towers, QSEC\_\-calDecompress::towers, QSEC\_\-gemDecompress::xy0, QSEC\_\-gemDecompress::xy1, QSEC\_\-gemDecompress::xzm, QSEC\_\-gemDecompress::xzp, QSEC\_\-gemDecompress::yzm, and QSEC\_\-gemDecompress::yzp.\hypertarget{expand_8h_72b501512416cbe5684750aac0ccb6ec}{
\index{expand.h@{expand.h}!QSEC\_\-constructExpansion@{QSEC\_\-constructExpansion}}
\index{QSEC\_\-constructExpansion@{QSEC\_\-constructExpansion}!expand.h@{expand.h}}
\subsubsection[{QSEC\_\-constructExpansion}]{\setlength{\rightskip}{0pt plus 5cm}{\bf QSEC\_\-expansion}$\ast$ QSEC\_\-constructExpansion (void $\ast$ {\em buffer}, \/  unsigned {\em cap})}}
\label{expand_8h_72b501512416cbe5684750aac0ccb6ec}


Construct a QSEC\_\-expansion structure in a buffer. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em cap}]Capacity of the decompression, maximum number of events in a single cycle\item[{\em buffer}]Uninitialised memory large enough to hold the expansion structure\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]Pointer to an initialised expansion structure \end{Desc}


References QSEC\_\-calDecompress::accepts, QSEC\_\-expansion\_\-::acd, addDcm(), QSEC\_\-acdDecompress::cables, QSEC\_\-expansion\_\-::cal, QSEC\_\-acdDecompress::chns, QSEC\_\-gemDecompress::cno, QSEC\_\-calDecompress::columns, QSEC\_\-gemDecompress::cond, QSEC\_\-tkrDecompress::diags, QSEC\_\-calDecompress::diags, QSEC\_\-expansion\_\-::gem, QSEC\_\-gemDecompress::high, QSEC\_\-calDecompress::layCnts, QSEC\_\-tkrDecompress::layers, QSEC\_\-calDecompress::logs, QSEC\_\-gemDecompress::low, QSEC\_\-calDecompress::means, QSEC\_\-acdDecompress::phas, QSEC\_\-acdDecompress::pvahs, QSEC\_\-CURRENT\_\-VERSION, QSEC\_\-calDecompress::ranges, QSEC\_\-gemDecompress::rbn, QSEC\_\-tkrDecompress::requests, QSEC\_\-gemDecompress::roi, QSEC\_\-tkrDecompress::strips, QSEC\_\-expansion\_\-::tkr, QSEC\_\-gemDecompress::tkr, QSEC\_\-tkrDecompress::tots, QSEC\_\-tkrDecompress::towers, QSEC\_\-calDecompress::towers, QSEC\_\-expansion\_\-::ver, QSEC\_\-gemDecompress::xy0, QSEC\_\-gemDecompress::xy1, QSEC\_\-gemDecompress::xzm, QSEC\_\-gemDecompress::xzp, QSEC\_\-gemDecompress::yzm, and QSEC\_\-gemDecompress::yzp.

Referenced by QSEC\_\-construct().\hypertarget{expand_8h_40cd442568e2900a369fff69f9c053ce}{
\index{expand.h@{expand.h}!QSEC\_\-recoverUser@{QSEC\_\-recoverUser}}
\index{QSEC\_\-recoverUser@{QSEC\_\-recoverUser}!expand.h@{expand.h}}
\subsubsection[{QSEC\_\-recoverUser}]{\setlength{\rightskip}{0pt plus 5cm}const unsigned int$\ast$ QSEC\_\-recoverUser ({\bf QSEC\_\-expansion} $\ast$ {\em exp}, \/  const unsigned int $\ast$ {\em buf})}}
\label{expand_8h_40cd442568e2900a369fff69f9c053ce}


Unpack the tables against which the events were encoded. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em buf}]Pointer to the buffer where the context is held\item[{\em exp}]Pointer to the structure containing the tables (an expansion)\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]Pointer to the next input location to be read or NULL if there was an error during recovery of User data \end{Desc}


References QSEC\_\-expansion\_\-::mode, QSEC\_\-CURRENT\_\-VERSION, QSEC\_\-VERS\_\-ALL\_\-RAW, recoverUserAcd(), recoverUserCal(), recoverUserTkr(), and QSEC\_\-expansion\_\-::ver.

Referenced by QSEC\_\-updateAtContribution().\hypertarget{expand_8h_cdafa7fc7dc224d05f57d4dbc961c437}{
\index{expand.h@{expand.h}!QSEC\_\-reportExpansion@{QSEC\_\-reportExpansion}}
\index{QSEC\_\-reportExpansion@{QSEC\_\-reportExpansion}!expand.h@{expand.h}}
\subsubsection[{QSEC\_\-reportExpansion}]{\setlength{\rightskip}{0pt plus 5cm}void QSEC\_\-reportExpansion ({\bf QSEC\_\-expansion} $\ast$ {\em exp}, \/  FILE $\ast$ {\em fp})}}
\label{expand_8h_cdafa7fc7dc224d05f57d4dbc961c437}


Report the contents of an expansion. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em exp}]Pointer to a expansion object\item[{\em fp}]Pointer to the destination file \end{description}
\end{Desc}


References QSEC\_\-calDecompress::accepts, QSEC\_\-expansion\_\-::acd, QSEC\_\-acdDecompress::cables, QSEC\_\-expansion\_\-::cal, QSEC\_\-acdDecompress::chns, QSEC\_\-gemDecompress::cno, QSEC\_\-calDecompress::columns, QSEC\_\-gemDecompress::cond, QSEC\_\-tkrDecompress::diags, QSEC\_\-calDecompress::diags, QSEC\_\-expansion\_\-::gem, QSEC\_\-gemDecompress::high, QSEC\_\-calDecompress::layCnts, QSEC\_\-tkrDecompress::layers, QSEC\_\-calDecompress::logs, QSEC\_\-gemDecompress::low, QSEC\_\-calDecompress::means, QSEC\_\-acdDecompress::phas, QSEC\_\-acdDecompress::pvahs, QSEC\_\-reportDecompression(), QSEC\_\-calDecompress::ranges, QSEC\_\-gemDecompress::rbn, QSEC\_\-tkrDecompress::requests, QSEC\_\-gemDecompress::roi, QSEC\_\-tkrDecompress::strips, QSEC\_\-expansion\_\-::tkr, QSEC\_\-gemDecompress::tkr, QSEC\_\-tkrDecompress::tots, QSEC\_\-tkrDecompress::towers, QSEC\_\-calDecompress::towers, QSEC\_\-gemDecompress::xy0, QSEC\_\-gemDecompress::xy1, QSEC\_\-gemDecompress::xzm, QSEC\_\-gemDecompress::xzp, QSEC\_\-gemDecompress::yzm, and QSEC\_\-gemDecompress::yzp.

Referenced by QSEC\_\-reportExpand().\hypertarget{expand_8h_5476ac4028f605b19103da2ae3332829}{
\index{expand.h@{expand.h}!QSEC\_\-reportExpCtx@{QSEC\_\-reportExpCtx}}
\index{QSEC\_\-reportExpCtx@{QSEC\_\-reportExpCtx}!expand.h@{expand.h}}
\subsubsection[{QSEC\_\-reportExpCtx}]{\setlength{\rightskip}{0pt plus 5cm}void QSEC\_\-reportExpCtx ({\bf QSEC\_\-expansion} $\ast$ {\em exp}, \/  FILE $\ast$ {\em fp})}}
\label{expand_8h_5476ac4028f605b19103da2ae3332829}


Report the contents of the expansion context. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em exp}]Pointer to a expansion object\item[{\em fp}]Pointer to the destination file \end{description}
\end{Desc}


References QSEC\_\-CURRENT\_\-VERSION, QSEC\_\-VERS\_\-ALL\_\-RAW, QSEC\_\-VERS\_\-FIXED\_\-CAL, QSEC\_\-VERS\_\-NEW\_\-SCHEME, QSEC\_\-VERS\_\-NEWER, QSEC\_\-VERS\_\-ORIGINAL, and QSEC\_\-expansion\_\-::ver.

Referenced by QSEC\_\-reportExp().\hypertarget{expand_8h_432e410d16b336f1be7012325929207a}{
\index{expand.h@{expand.h}!QSEC\_\-setMode@{QSEC\_\-setMode}}
\index{QSEC\_\-setMode@{QSEC\_\-setMode}!expand.h@{expand.h}}
\subsubsection[{QSEC\_\-setMode}]{\setlength{\rightskip}{0pt plus 5cm}void QSEC\_\-setMode ({\bf QSEC\_\-expansion} $\ast$ {\em exp}, \/  unsigned {\em mode})}}
\label{expand_8h_432e410d16b336f1be7012325929207a}


Set the calibration mode of an expansion. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em exp}]Pointer to a expansion structure\item[{\em mode}]Type of calibration \end{description}
\end{Desc}


References QSEC\_\-expansion\_\-::mode.

Referenced by QSEC\_\-updateAtContribution().\hypertarget{expand_8h_f2b835093871e036f994feb8c517c91d}{
\index{expand.h@{expand.h}!QSEC\_\-sizeofExpansion@{QSEC\_\-sizeofExpansion}}
\index{QSEC\_\-sizeofExpansion@{QSEC\_\-sizeofExpansion}!expand.h@{expand.h}}
\subsubsection[{QSEC\_\-sizeofExpansion}]{\setlength{\rightskip}{0pt plus 5cm}size\_\-t QSEC\_\-sizeofExpansion (unsigned {\em cap})}}
\label{expand_8h_f2b835093871e036f994feb8c517c91d}


Calculate the size of the memory block required to accomodate the expansion structure. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em cap}]Capacity of the decompression, maximum number of events in a single cycle\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]Size of the memory block required to accomodate the expansion structure \end{Desc}


References QSEC\_\-sizeofDecompression().

Referenced by QSEC\_\-sizeof().