X-Git-Url: http://git.kpe.io/?p=ctsim.git;a=blobdiff_plain;f=doc%2Fctsim-gui.tex;h=8d675de29f81518b0ad58ac0b034f220553023bd;hp=99bc69d5ac4a525dba86eb8d7f888020d75947b3;hb=d3fa225aa232e132cc198672c4fc148f96a1ab8c;hpb=103b084776d861a93e851ebff9c72798019b7561

diff --git a/doc/ctsim-gui.tex b/doc/ctsim-gui.tex
index 99bc69d..8d675de 100644
--- a/doc/ctsim-gui.tex
+++ b/doc/ctsim-gui.tex
@@ -1,14 +1,126 @@
-\chapter{ctsim - the Graphical User Interface}\label{ctsim}\index{ctsim}% 
+\chapter{The Graphical User Interface}\label{ctsim}\index{ctsim}%
 \setheader{{\it CHAPTER \thechapter}}{}{}{}{}{{\it CHAPTER \thechapter}}%
 \setfooter{\thepage}{}{}{}{}{\thepage}%
 
-\ctsim is the graphical shell for the CTSim project. It is
-written using the wxLibrary for cross-platform compatibility with GTK,
-Motif, and Microsoft Windows. It includes all of the functionality of
-the command-line tool {\tt ctsimtext} as well as image processing and visualization features.
+\section{Overview}
+\ctsim\ is the graphical shell for the CTSim project. It utilizes
+using the \urlref{wxWindows}{http://www.wxwindows.org} library for
+cross-platform compatibility. The graphical shell is compatible
+with Microsoft Windows, \urlref{GTK}{http://www.gtk.org}, and
+\urlref{Motif}{http://www.openmotif.org} graphical environments.
+This graphical includes all of the functionality of the
+command-line interface \helprefn{\ctsimtext}{ctsimtext} as well as
+great image processing and visualization features.
 
-\ctsim can open projection files, image files, phantom definition files, and plotfiles.
+\ctsim\ can open projection files, image files, phantom files, and
+plotfiles.
 
-\usage
-ctsim [OPTIONS] [files to open...]
+\usage \texttt{ctsim [files to open...]
 
+You can invoke \ctsim\ by itself on the command line, or include
+any number of files that you want \ctsim\ to automatically open.
+
+\section{File Types Support}
+
+Phantom and plot files are stored as ASCII text. In contrast,
+image and projection files are stored in binary format. \ctsim\
+incorporates logic so that binary files are cross-platform
+compatible between both little and big endian architectures.
+
+\subsection{Phantom}
+Besides loading phantom files from the disk, the Herman and
+Shepp-Logan phantoms are built-in to \ctsim. Phantom files can be
+read and stored on the disk. However, a text editor is required to
+create and edit these files.
+
+\subsection{Image}
+Image files are 2-dimensional files that store 4-byte floating
+point values. Images files can be either real or complex valued.
+Typically, all images are real except for images that have been
+processed by Fourier transforms. As you might expect,
+complex-valued images are twice the size of real-valued images
+since both a real and imaginary component need to be store.
+
+\subsection{Projection}
+Projection files are created from Phantom files during the projection process.
+Numerous options are available for creation of the these files.
+
+\subsection{Plot}
+Plot files are created by \ctsim\ during analysis of image files.
+They can be read and stored on the disk. They are stored as ASCII
+files for easy cross-platform support.
+
+\section{Phantom Menus}
+
+\subsection{Rasterize Dialog}
+This creates an image file from a phantom. Technically, it
+converts the phantom from a vector (infinite resolution) object
+into a 2-dimension array of floating-point pixels. The parameters
+to set are:
+
+\begin{twocollist}
+%\twocolitemruled{\textbf{Parameter}}{\textbf{Options}}
+\twocolitem{\texttt{X size}}{Number of columns in image file}
+\twocolitem{\texttt{Y size}}{Number of rows in image file}
+\twocolitem{\texttt{Samples per pixel}}{Numbers of samples taken
+per pixel in both the x and y directions. For example, if the
+\texttt{Samples per pixel} is set to \texttt{3}, then for every
+pixel in the image file 9 samples (3 x 3) are averaged.}
+\end{twocollist}
+
+\subsection{Projection Dialog}
+This creates a projection file from a phantom.
+
+\section{Image Menus}
+\subsection{File - Properties}
+Properties of image files include
+\begin{itemize}\itemsep=0pt
+  \item Whether the image is real or complex valued
+  \item Numeric statistics
+  \item Image file labels
+\end{itemize}
+
+\subsection{View}
+These options are for change the intensity scale for viewing the image.
+They do not change the image data.
+
+\subsection{Image}
+These commands create a new image based upon the current image,
+and for some commands, also a comparison image.
+
+\subsection{Filter}
+These commands filter image.
+
+\subsection{Anaylze}
+These commands are used for analyzing an image.
+
+\section{Projection Menus}
+\subsection{Process - Convert Polar Dialog}\label{convertpolardialog}
+The parameters are \texttt{xsize}, \texttt{ysize}, and \texttt{interpolation}.
+The \texttt{xsize} and \texttt{ysize} parameters set the size of the
+resulting image file. The \texttt{interpolation} parameter selects the
+interpolation method. Currently, the \texttt{bilinear} option provides
+the highest quality interpolation.
+
+\subsection{Process - Convert FFT Polar Dialog}
+The parameters for this option are the same as
+\helprefn{convertpolardialog}{Convert Polar Dialog}. For this
+command, though, the projections are Fourier transformed prior to
+conversion to polar image.
+
+\subsection{Reconstruct - Filtered Backprojection Dialog}
+This dialog sets the parameters for reconstructing an image from projections
+using the Filtered Backprojection technique. The parameters are identical
+to those for the \helprefn{pjrec}{pjrec} program.
+
+\section{Plot Menus}
+\subsection{File - Properties}
+
+\subsection{File - Save}
+Plot files can be saved. They are saved in an ASCII text format.
+
+\subsection{View Menu}
+These commands set the scaling for the y-axis.
+\subsubsection{Set}
+\subsubsection{Auto}
+\subsubsection{Full}