]> Creatis software - creaMaracasVisu.git/blobdiff - lib/doxygen/TemplateHomeLibDoxygen.html
Merge remote-tracking branch 'refs/remotes/origin/master'
[creaMaracasVisu.git] / lib / doxygen / TemplateHomeLibDoxygen.html
index a94786092abef6912aa05c3bab553108046b6c5d..71a8490539b62450f41d2fc408cad0beddf4c836 100644 (file)
@@ -33,6 +33,7 @@ color:#1A41A8;
        font-family: Geneva, Arial, Helvetica, sans-serif;
        margin-left: 25px;
        font-size: small;
+       font-weight: bold;
 }
 .paragraph {
        margin-left: 40px;
@@ -41,13 +42,27 @@ color:#1A41A8;
 }
 .style1 {
        text-decoration: underline;
+       font-weight: bold;
+}
+.style3 {
+       font-family: Geneva, Arial, Helvetica, sans-serif;
+       font-size: 21px;
+       text-decoration: underline;
+       text-align: justify;
+}
+.style4 {
+       font-family: Geneva, Arial, Helvetica, sans-serif;
+       color: #000000;
+       font-size: x-large;
+       font-weight: bold;
+       text-align: center;
 }
 </style>
 </head>
 
 <body>
 
-<H2 class="titles">General Description</H2>
+<H2 class="style4">General Description</H2>
 <H2><span class="text">First of all, <strong> 
 <a class="el" href="http://www.creatis.insa-lyon.fr/site/fr/CreatoolsBBTKPackageCreaMaracasVisuUserInteractionDescription">creaMaracasVisu</a></strong> is a C++ library developed by 
 <a class="el" href="http://www.creatis.insa-lyon.fr/site/fr/creatools">Creatools</a> 
@@ -59,7 +74,7 @@ software team and it follows the general architecture of Creatools architecture
 images and the interaction with them. </span></H2>
 <hr />
 
-<H2 class="titles">&nbsp;Architecture Description</H2>
+<H2 class="style4">&nbsp;Architecture Description</H2>
 <H2><span class="text">The core of the library is divided into 
 different modules, and each one provides a list of diferent functionalities that can be 
 used in specific contexts. The principal components are the following:<br />
@@ -77,39 +92,83 @@ diagram :<br />
 <a class="el" href="../GeneralArchitecture_HTML/index.html">Architecture Diagram</a></span></H2>
 <hr />
 
-<H2 class="titles">&nbsp;Modules Description</H2>
+<H2 class="style4">&nbsp;Modules Description</H2>
 <p class="text">In this section are presented the corresponding diagrams for 
 each model in <span class="text"> <strong> 
 <a class="el" href="http://www.creatis.insa-lyon.fr/site/fr/CreatoolsBBTKPackageCreaMaracasVisuUserInteractionDescription">creaMaracasVisu</a> </strong> </span>
 library including classes, components and sequence diagrams, as well as a short 
 description of the module of interest.</p>
-<span class="subtitles"><a name="ViewersInteractors"></a>Viewers and interactors</span><br />
+
+
+
+<a name="ViewersInteractors"></a>
+<div class="style3">
+       <br />
+               Viewers and interactors</div>
+<br />
+<span class="text">This module provides a set of classes that manage the 
+visualization and the interaction with images. For example, the black box 
+ViewerNV is constructed using these classes and it provides the possibility to 
+use different viewers depending of the context. For example, to manage an image 
+3D is useful to use the wxVtk3DBaseBiew and to control a 2D image it is possible 
+to use wxVtk2DBaseView. It is important to note that these viewers make the 
+connection between a wxWindow and a vtkRenderWindow, in order to include the 
+world VTK in any application implemented with wxWidgets.<br />
+<br />
+Another important point to keep in mind is that all the wxVtkBaseView instances 
+have a manager of its interactor styles. These interactors describe how the 
+events are handled and how the actual mechanism respond to the interaction 
+callbacks. Every new instance of InteractorStyleMaracas class can be added to 
+the wxBaseView in order to manage all the events made over an object. An example 
+of this process is presented in the contours section.</span><br />
 <br />
-&nbsp;<span class="listDiagrams"><strong><span class="style1">Class diagrams</span><br />
+<span class="listDiagrams">Class diagrams</span><br />
 <br />
-</strong></span><br />
 <span class="listDiagrams">&nbsp;&nbsp;
 <a href="../wxVtkViewer_classDiagram1_HTML/index.html" class="el"> - wxVtkViewer Class Diagram 1</a><br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 <a href="../wxVtkViewer_classDiagram2_HTML/index.html" class="el"> - wxVtkViewer Class Diagram 2</a></span><br />
 &nbsp;<br>
-<hr /><span class="subtitles"><a name="Contours"></a>Contours<br />
+
+<hr /><span class="subtitles"><a name="Contours"></a></span>
+<span class="style3">Contours</span><br />
+<br />
+<span class="text">This module provides a set of tools to draw different types 
+of contours over the viewers of the first section. In the MVC class diagram and 
+the sequence diagram to create a new contour are explained the steps necessary 
+to include this functionnality into a wx-vtk scene. An example of this process 
+of creation of new contours is presented in the creaContours application. It is 
+important to note that the contours follow as well the same interaction system 
+of the wxVtkBaseView. It means that all the contour&#39;s controllers use the 
+InteractorStyleMaracas system to manage the events of the mouse and the 
+keyborard in the scene. In addition, every contour controller registered in the 
+wxVtkBaseView with the method AddInteractorStyleMaracas of 
+vtkInteractorStyleBaseView class (see the doxygen documentation of these 
+classes) will react to the mouse and keyboard events, and for this reason is 
+important to have a managing system of all the interactors in the scene.<br />
+<br />
+Regarding the different actions that can be made using the contours, they react 
+in a different way depending of the actual state of each one of them. For 
+example, when any contour is into an editable state, the control points are 
+visualized and can be moved, removed, etc. In brief, the actions applied to the 
+contours (check the <span class="text"> <strong> 
+<a class="el" href="http://www.creatis.insa-lyon.fr/site/fr/CreaMaracasVisuUserGuide#Contours">User Guide</a> </strong> </span>
+ documentation) are described as a state diagram and every contours reacts 
+depending of its state.</span><br />
 <br />
-<strong>
 <span class="listDiagrams">Class diagrams<br />
 <br />
-</span></strong></span><div class="text">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
+</strong></span><div class="text">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
        - 
-<a href="../manualContour_MVC_HTML/index.html" class="el"> MVC (Model View Controler)</a> <br>
+<a href="../manualContour_MVC_HTML/index.html" class="el"> MVC (Model View Controller)</a> <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../manualContour_Model_HTML/index.html" class="el">- Model</a> <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../manualContour_View_HTML/index.html" class="el">- View</a> <br>
-&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../manualContour_Controler_HTML/index.html" class="el">- Controler</a><br />
-       <br />
-</div><span class="subtitles">
-<strong>
-<span class="listDiagrams">Sequence diagrams<br />
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../manualContour_Controler_HTML/index.html" class="el">- Controller</a><br />
+</div>
+<br />
+<span class="listDiagrams">Sequence diagrams</span><br />
 <br />
-</span></strong></span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
        - 
 <a class="el" href="../manualContour_SeqCreateContour_HTML/index.html">To create a new 
        contour MVC</a> 
@@ -122,23 +181,21 @@ When a new
        (Controller uses View and Model, and View has relation with the model), it 
        is necessary to say the viewer where it will be managed. The specific 
        methods to do this task are in the diagram.</div><br />
-<hr /><span class="subtitles"><a name="Cutter"></a>Cutter</span><br>
-<span class="subtitles">
+<hr /><span class="style3"><a name="Cutter"></a>Cutter</span><br>
+
 <br />
-<strong>
 <span class="listDiagrams">Component diagrams<br />
 <br />
-</span></strong></span><div class="text">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
+</strong></span><div class="text">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
        - 
 <a href="../CutModuleDiagrams_HTML/index.html" class="el"> Cutter module 
        components </a>
 </div>
-<span class="subtitles">
+
 <br />
-<strong>
 <span class="listDiagrams">Class diagrams<br />
 <br />
-</span></strong></span><div class="text">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -
+</span><div class="text">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; -
        <a href="../CutModuleDiagrams_HTML/fig141309.png" class="el"> Cutter module 
        integration </a> <br>
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../CutModuleDiagrams_HTML/fig134653.png" class="el">- 
@@ -146,12 +203,11 @@ When a new
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../CutModuleDiagrams_HTML/fig134781.png" class="el">- 
        Kernel</a></div>
 <br />
-<hr /><span class="subtitles"><a name="Plotter"></a>Plotter and data representation</span><br>
+<hr /><span class="style3"><a name="Plotter"></a>Plotter and data representation</span><br>
 
 <br />
-<strong>
-<span class="listDiagrams"><span class="style1">Class diagrams</span><br class="style1" />
-</span></strong><span class="style1"></span></span><br />
+
+<span class="listDiagrams">Class diagrams</span><br class="style1" />
 <br />
 <div class="text">
 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="../pPlotter_HTML/index.html" class="el">- pPlotter Class Diagram</a> <br>