From 27212c6743d61f57b47a9a0aa856ba265edf1e82 Mon Sep 17 00:00:00 2001
From: ptv <ptv@opencascade.com>
Date: Fri, 13 Feb 2009 07:55:21 +0000
Subject: [PATCH] update documentation about new filters

---
 doc/salome/gui/SMESH/input/extrusion.doc      | 12 ++++++++-
 .../gui/SMESH/input/extrusion_along_path.doc  | 15 ++++++++---
 .../input/removing_nodes_and_elements.doc     | 22 +++++++++++++---
 doc/salome/gui/SMESH/input/revolution.doc     | 16 +++++++++---
 doc/salome/gui/SMESH/input/rotation.doc       | 14 ++++++++--
 .../SMESH/input/selection_filter_library.doc  |  2 +-
 doc/salome/gui/SMESH/input/smoothing.doc      | 20 +++++++++-----
 doc/salome/gui/SMESH/input/symmetry.doc       | 24 ++++++++++++-----
 doc/salome/gui/SMESH/input/translation.doc    | 26 ++++++++++++++-----
 9 files changed, 115 insertions(+), 36 deletions(-)

diff --git a/doc/salome/gui/SMESH/input/extrusion.doc b/doc/salome/gui/SMESH/input/extrusion.doc
index 7ceb1dca0..ea25158f1 100644
--- a/doc/salome/gui/SMESH/input/extrusion.doc
+++ b/doc/salome/gui/SMESH/input/extrusion.doc
@@ -28,7 +28,17 @@ The following dialog box will appear:
 <li>the type of elements which will be extruded (1D or 2D),</li>
 <li>specify the IDs of the elements which will be extruded by
 selecting them in the 3D viewer or select the whole mesh or
-submesh,</li>
+submesh,
+<ul>
+<li>Check on <b>Select the whole mesh, submesh or group</b> option
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on an element in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the elements. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
+</li>
 <li>specify the distance at which the elements will be extruded,</li>
 <li>specify the vector along which the elements will be extruded,</li>
 <li>number of steps.</li>
diff --git a/doc/salome/gui/SMESH/input/extrusion_along_path.doc b/doc/salome/gui/SMESH/input/extrusion_along_path.doc
index 80f86730e..d35d23315 100644
--- a/doc/salome/gui/SMESH/input/extrusion_along_path.doc
+++ b/doc/salome/gui/SMESH/input/extrusion_along_path.doc
@@ -98,9 +98,16 @@ The following dialog box will appear:
 <li>In the dialog box you should:
 <ul>
 <li>select the type of elements which will be extruded (1D or 2D),</li>
-<li>specify the <b>IDs of the elements</b> which will be extruded by
-selecting them in the 3D viewer or <b>Select the whole mesh, submesh
-or group</b>,
+<li>specify the <b>IDs of the elements</b> which will be extruded
+<ul>
+<li>Check on <b>Select the whole mesh, submesh or group</b> option
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on an element in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the elements. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
 </li>
 <li>define the Path along which the elements will be extruded,
 \n Path definition consists of several elements:
@@ -153,4 +160,4 @@ duplicated nodes and faces, because no sewing is done.
 <br><b>See Also</b> a sample TUI Script of an 
 \ref tui_extrusion_along_path "Extrusion along a Path" operation.  
 
-*/
\ No newline at end of file
+*/
diff --git a/doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc b/doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc
index 2786b14cc..6e0f7f804 100644
--- a/doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc
+++ b/doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc
@@ -29,8 +29,15 @@ The following dialog box will appear:
 
 \image html removenodes.png
 
-In this dialog box you can specify one or several nodes (with pressed
-Shift button) by choosing them in the 3D viewer.
+In this dialog box you can specify one or several nodes
+<ul>
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on a node in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the nodes. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
 </li>
 </ol>
 
@@ -56,8 +63,15 @@ The following dialog box will appear:
 
 \image html removeelements.png
 
-In this dialog box you can specify one or several elements of your
-mesh (with pressed Shift button) by choosing them in the 3D viewer.
+In this dialog box you can specify one or several elements
+<ul>
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on an element in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the elements. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
 </li>
 <li>Click \b Apply or <b>Apply and Close</b> to confirm deletion of the specified elements.</li>
 </ol>
diff --git a/doc/salome/gui/SMESH/input/revolution.doc b/doc/salome/gui/SMESH/input/revolution.doc
index e38dd8593..67dfdb374 100644
--- a/doc/salome/gui/SMESH/input/revolution.doc
+++ b/doc/salome/gui/SMESH/input/revolution.doc
@@ -27,9 +27,17 @@ The following dialog box shall appear:
 In this dialog box you should specify:
 <ul>
 <li>the type of elements which will be extruded (1D or 2D),</li>
-<li>specify the IDs of the elements which will be revolved by
-selecting them in the 3D viewer or select the whole mesh or
-submesh,</li>
+<li>specify the IDs of the elements which will be revolved
+<ul>
+<li>Check on <b>Select the whole mesh, submesh or group</b> option
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on an element in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the elements. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
+</li>
 <li>specify the axis (point and vector) around which the elements will
 be revolved,</li>
 <li>angle of rotation and number of steps,</li>
@@ -59,4 +67,4 @@ elements of the source mesh to the newly created one. </li>
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_revolution "Revolution" operation.
 
-*/
\ No newline at end of file
+*/
diff --git a/doc/salome/gui/SMESH/input/rotation.doc b/doc/salome/gui/SMESH/input/rotation.doc
index d693dd455..e64357276 100644
--- a/doc/salome/gui/SMESH/input/rotation.doc
+++ b/doc/salome/gui/SMESH/input/rotation.doc
@@ -15,7 +15,17 @@ select the \b Rotation item. The following dialog box shall appear:
 \image html rotation.png
 \par 
 In this dialog box you can specify the elements which should be
-rotated and the rotation parameters:
+rotated
+<ul>
+<li>Check on <b>Select the whole mesh, submesh or group</b> option
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on an element in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the elements. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
+ and the rotation parameters:
 <ul>
 <li>\b Axis: point and vector</li>
 <li>\b Angle of rotation</li>
@@ -36,4 +46,4 @@ rotated and the rotation parameters:
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_rotation "Rotation" operation.  
 
-*/
\ No newline at end of file
+*/
diff --git a/doc/salome/gui/SMESH/input/selection_filter_library.doc b/doc/salome/gui/SMESH/input/selection_filter_library.doc
index 30477fdae..66c72a0e8 100644
--- a/doc/salome/gui/SMESH/input/selection_filter_library.doc
+++ b/doc/salome/gui/SMESH/input/selection_filter_library.doc
@@ -46,7 +46,7 @@ in the Library.
 is no selected mesh in the Object Browser and the filter can not be
 created. You have to select the mesh and the button will be enabled.
 
-\image html a-filteronedges.png
+\image html a-filteronfaces.png
 
 Some criteria are applicable to all <b>Entity types</b>:
 <ul><li>
diff --git a/doc/salome/gui/SMESH/input/smoothing.doc b/doc/salome/gui/SMESH/input/smoothing.doc
index fe9770340..77a59f880 100644
--- a/doc/salome/gui/SMESH/input/smoothing.doc
+++ b/doc/salome/gui/SMESH/input/smoothing.doc
@@ -21,15 +21,23 @@ specified:
 
 <ul>
 <li><b>Id Elements</b> field allows to specify the elements which
-should be smoothed by selecting them in the 3D viewer (lock \b Shift
-button to select several elements).</li>
-<li><b>Select whole mesh, submesh or group</b> - smoothing is applied
-to the whole mesh or its part.</li>
-<li><b>Fixed nodes ids:</b> some nodes keep their location during
+should be smoothed
+<ul>
+<li>Check on <b>Select the whole mesh, submesh or group</b> option
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on an element in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the elements. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
+</li>
+<b>Fixed nodes ids:</b> some nodes keep their location during
 smoothing. If a mesh is built on a geometry shape, the nodes built on
 geometrical edges are always fixed. If smoothing is applied to a part
 of a mesh then the boundary nodes of an elements set are also
-fixed. Any other nodes may be additionally fixed.</li>
+fixed. Any other nodes may be additionally fixed. Fixed nodes can be
+selected manually or by filters too.</li>
 <li><b>Smoothing Method:</b>
 <ul>
 <li>\b Laplacian smoothing pulls a node toward the center of
diff --git a/doc/salome/gui/SMESH/input/symmetry.doc b/doc/salome/gui/SMESH/input/symmetry.doc
index 6bbe66873..67068e981 100644
--- a/doc/salome/gui/SMESH/input/symmetry.doc
+++ b/doc/salome/gui/SMESH/input/symmetry.doc
@@ -28,13 +28,23 @@ or some of its elements specifying:
 <li>one plane (point and normal)</li>
 </ul>
 
-
-\n Toggle the corresponding checkbox to <b> Select whole mesh, submesh or group.</b>  
-\n When <b>Move elements</b> radio button is selected, the source mesh (or elements) is created at the new location and erased from its previous location
-\n When <b>Copy elements</b> radio button is selected,the source mesh (or elements) is created at the new location, but it also remains at its previous location and is considered one and single mesh with the result of the translation.
-\n When <b>Create as new mesh</b> radio button is selected, the source mesh (or elements) remains at its previous location and a new mesh is created at the new location and appears in the Object Browser with the default name MeshName_mirrored (you can change this name in the adjacent box).
-\n <b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one.
-
+<ul>
+<li>Select elements for the symmetry operation
+<ul>
+<li>Check on <b>Select the whole mesh, submesh or group</b> option
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on an element in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the elements. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
+</li>
+<li>When <b>Move elements</b> radio button is selected, the source mesh (or elements) is created at the new location and erased from its previous location</li>
+<li>When <b>Copy elements</b> radio button is selected,the source mesh (or elements) is created at the new location, but it also remains at its previous location and is considered one and single mesh with the result of the translation.</li>
+<li>When <b>Create as new mesh</b> radio button is selected, the source mesh (or elements) remains at its previous location and a new mesh is created at the new location and appears in the Object Browser with the default name MeshName_mirrored (you can change this name in the adjacent box).</li>
+<li><b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one.</li>
+</ul>
 
 \par
 
diff --git a/doc/salome/gui/SMESH/input/translation.doc b/doc/salome/gui/SMESH/input/translation.doc
index 390feb7fc..45565acaa 100644
--- a/doc/salome/gui/SMESH/input/translation.doc
+++ b/doc/salome/gui/SMESH/input/translation.doc
@@ -24,14 +24,26 @@ or some of its elements specifying:
 <li>two points (starting and ending)</li>
 <li>one vector</li>
 </ul>
-Toggle the corresponding checkbox to <b>Select whole mesh, submesh or
-group</b>.
-\n When <b>Move elements</b> radio button is selected, the source mesh (or elements) is created at the new location and erased from its previous location
-\n When <b>Copy elements</b> radio button is selected,the source mesh (or elements) is created at the new location, but it also remains at its previous location and is considered one and single mesh with the result of the translation.
-\n When <b>Create as new mesh</b> radio button is selected, the source mesh (or elements) remains at its previous location and a new mesh is created at the new location and appears in the Object Browser with the default name MeshName_translated (you can change this name in the adjacent box).
-\n <b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one.
+
+<ul>
+<li>Select elements for the translation operation
+<ul>
+<li>Check on <b>Select the whole mesh, submesh or group</b> option
+<li>Choosing them manually with the mouse in the 3D Viewer. You can
+click on an element in the 3D viewer and it will be highlighted</li>
+<li>Applying Filters. The <b>Set filter</b> button allows to apply a
+definite filter to selection of the elements. See more
+about filters on the
+\ref selection_filter_library_page "Selection filter library" page.</li>
+</ul>
+</li>
+<li>When <b>Move elements</b> radio button is selected, the source mesh (or elements) is created at the new location and erased from its previous location</li>
+<li>When <b>Copy elements</b> radio button is selected,the source mesh (or elements) is created at the new location, but it also remains at its previous location and is considered one and single mesh with the result of the translation.</li>
+<li>When <b>Create as new mesh</b> radio button is selected, the source mesh (or elements) remains at its previous location and a new mesh is created at the new location and appears in the Object Browser with the default name MeshName_translated (you can change this name in the adjacent box).</li>
+<li><b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one.</li>
+</ul>
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_translation "Translation" operation.  
 
-*/
\ No newline at end of file
+*/
-- 
2.30.2