]> Creatis software - bbtk.git/blobdiff - kernel/doc/bbtkUsersGuide/bbtkUsersGuide.tex
*** empty log message ***
[bbtk.git] / kernel / doc / bbtkUsersGuide / bbtkUsersGuide.tex
index 8e539ee7f304ea7e427511a47dd5038a41b4b12a..bb7ce7ac5d24c1fd9da1420f8297f71eaf791f23 100644 (file)
@@ -3,65 +3,6 @@
 \input{config.tex}
 
 
-\def\todo{\scriptsize\fbox{\bf TODO !!}\normalsize}
-\def\x{\bm{x}}
-\def\BBTK{{\xspace}The {\bf Black Box Toolkit} }
-\def\bbtk{{\xspace}$\texttt{bbtk}$ }
-\def\bbi{{\xspace}$\texttt{bbi}$ }
-\def\bbStudio{{\xspace}$\texttt{bbStudio}$ }
-\def\bbfy{{\xspace}$\texttt{bbfy}$ }
-\def\bbdoc{{\xspace}$\texttt{bbdoc}$ }
-\def\bbCreatePackage{{\xspace}$\texttt{bbCreatePackage}$ }
-
-\def\bb{{\xspace}$\texttt{bb}$ }
-%\def\bbp{{\xspace}$\texttt{bbp}$\xspace}
-
-\def\cmake{{\xspace}$\texttt{cmake}$ }
-
-\def\C{{\xspace}$\texttt{C}$ }
-\def\CPP{{\xspace}$\texttt{C++}$ }
-
-\def\xml{{\xspace}$\texttt{xml}$ }
-
-\def\itk{{\xspace}$\texttt{itk}$ }
-\def\vtk{{\xspace}$\texttt{vtk}$ }
-\def\gdcm{{\xspace}$\texttt{gdcm}$ }
-\def\gsmis{{\xspace}$\texttt{gsmis}$ }
-\def\wx{{\xspace}$\texttt{wxWidgets}$ }
-
-\def\lin{{\xspace}\textit{Linux} }
-\def\win{{\xspace}\textit{Windows} }
-
-% the same macros with no space at the end
-
-\def\BBTKns{{\xspace}The {\bf Black Box Toolkit}}
-\def\bbtkns{{\xspace}$\texttt{bbtk}$}
-\def\bbins{{\xspace}$\texttt{bbi}$}
-\def\bbfyns{{\xspace}$\texttt{bbfy}$}
-\def\bbdocns{{\xspace}$\texttt{bbdoc}$}
-\def\bbCreatePackagens{{\xspace}$\texttt{bbCreatePackage}$}
-
-\def\bbns{{\xspace}$\texttt{bb}$}
-%\def\bbp{{\xspace}$\texttt{bbp}$\xspace}
-
-\def\cmakens{{\xspace}$\texttt{cmake}$}
-
-\def\Cns{{\xspace}$\texttt{C}$}
-\def\CPPns{{\xspace}$\texttt{C++}$}
-
-\def\xmlns{{\xspace}$\texttt{xml}$}
-
-\def\itkns{{\xspace}$\texttt{itk}$}
-\def\vtkns{{\xspace}$\texttt{vtk}$}
-\def\gdcmns{{\xspace}$\texttt{gdcm}$}
-\def\gsmisns{{\xspace}$\texttt{gsmis}$}
-\def\wxns{{\xspace}$\texttt{wxWidgets}$}
-
-\def\linns{{\xspace}\textit{Linux}}
-\def\winns{{\xspace}\textit{Windows}}
-
-
-
 
 \begin{document}
 \begin{center}
@@ -249,6 +190,7 @@ have been written by different persons, using different libraries, etc.
          \end{itemize}
       \item A full {\bf\emph{documentation}} printable (pdf), browsable (html), queryable thru keywords.         
 \end{itemize}
+
 The general architecture of \BBTK 
 is shown in figure \ref{bb-architecture}.
 
@@ -397,9 +339,9 @@ All the entries of the starting page are self-explanatory :
         
    \item {\bf\emph{Boxes}} : Box retrieving on various criterions :
    \begin{itemize} 
-    \item {\bf\emph{    \texttt{By name}}} (Alphabetical list), 
-    \item {\bf\emph{    \texttt{{By package}}}, 
-     \item {\bf\emph{   \texttt{{By category}}}.
+    \item {\bf\emph{ \texttt{By name}}} (Alphabetical list), 
+    \item {\bf\emph{    \texttt{By package}}}, 
+     \item {\bf\emph{   \texttt{By category}}}.
    \end{itemize} 
    
         A special hidden Box category, called \texttt{{Adaptors}} exists. \\ 
@@ -533,7 +475,7 @@ connect slider.BoxChange text.BoxExecute
 connect slider.Out       text.In
 \end{verbatim}
 We tell  \emph{slider} to inform \emph{text} every time it's modified.\\
-We tell  \emph{slider} to pass its output value (\texttt{Out} to \emph{text}  input value (\testtt{In})
+We tell  \emph{slider} to pass its output value (\texttt{Out} to \emph{text}  input value (\texttt{In})
 \begin{verbatim}
 exec layout
 \end{verbatim}
@@ -792,12 +734,11 @@ An html version of all the guides is browsable in the \texttt{Help} part of \bbS
    \end{itemize}
         
 
-   \end{itemize} 
    
 % ==========================================
 \subsubsection{Boxes Help}
 % ==========================================
- Box retrieving on various criterions :
+ Box retrieving on various criteria :
    \begin{itemize} 
     \item {\bf\emph{Alphabetical list}} \\ This is the 'zero-level' of retrieving.
     \item {\bf\emph{List by package}} \\ Several packages are supplied with bbtk :
@@ -849,6 +790,7 @@ An html version of all the guides is browsable in the \texttt{Help} part of \bbS
         \item{misc}              
     \end {itemize}
   \end {itemize}
+
 % ==============================================
 \subsection{The Menu}
 % ==============================================
@@ -978,7 +920,7 @@ Box processing is needed if :
 \texttt{'Always'}, which forces box reprocessing. 
 \end{itemize}
 
-Note that all boxes have an input named \texttt{'BoxProcessMode'}.\\ 
+Note that all boxes have an input named \texttt{'BoxProcessMode'}.
 
 Another way to process the box \texttt{a} is to issue the command :
 \begin{verbatim}
@@ -990,7 +932,7 @@ box itself displays something in its processing).
 It just processes the box if needed. 
 This command is used to execute boxes that do not have any output,  
 such as boxes that write something to a file or, display a 
-graphical interface, and so on. \\
+graphical interface, and so on. 
 
 %To exit \bbi, type :
 %\begin{verbatim}
@@ -1944,11 +1886,11 @@ cd buildBBTK
 ccmake ../bbtk
 \end{verbatim}
 
-Don't forget to switch ON the flag \textttBBTK\_COMPILE\_DEBUG\_MESSAGE \\
+Don't forget to switch ON the flag \texttt{BBTK\_COMPILE\_DEBUG\_MESSAGE} \\
 (see figure : \ref{bb-ccmake})
 
 \begin{figure}[!ht]
-\caption{\label{bb-ccmake}\Running ccmake}
+\caption{\label{bb-ccmake}Running ccmake}
 \begin{center}
 \includegraphics[width=0.6\textwidth]{ccmake.png}
 \end{center}
@@ -1964,7 +1906,7 @@ make
 For some strange reasons (?!?), you may be warned that an error occured while documentation generation.\\
 Take it easy, \texttt{make} again!\\
 
-The dynamic libraries (\texttt{.dll} or \texttt{.so} and the executable programs will be created in the \testtt{bin}
+The dynamic libraries (\texttt{.dll} or \texttt{.so} and the executable programs will be created in the \texttt{bin}
 directory of the built tree.
 
 \item choose to install or not your own version.
@@ -2223,7 +2165,9 @@ The box \texttt{box} must already have been created in the complex box and of co
 \newpage
 
 % ==========================================
-\vspace{0.5cm}\hrule \\
+%\vspace{0.5cm}\hrule \\
+
+
 \section{The Package Browser}
 \label{Package_Browser}
 % ==========================================
@@ -2269,7 +2213,8 @@ You can get the whole description of a given box or application clicking on its
 
 
 % ==========================================
-\vspace{0.5cm}\hrule \\
+%\vspace{0.5cm}\hrule \\
+
 \section{Using third party Package}
 \label{Third_Party_Package}
 % ==========================================
@@ -2316,7 +2261,7 @@ want to use,
 If you want (and sure you will) to be able to use the Help tools as well on the features provided by this package, you must use the
 option \texttt{Generate index}  in the menu \texttt{Tools} of the \texttt{Files} part toolbar.  
 % ==========================================
-\vspace{0.5cm}\hrule \\
+%\vspace{0.5cm}\hrule \\
 \section{Using black boxes in \CPP programs}
 \label{cpp}
 % ==========================================