0022106: EDF 2464 SMESH : Split quadrangles in 4 triangles

doc/salome/gui/SMESH/input/cutting_quadrangles.doc

@@ -2,13 +2,12 @@
 
 \page cutting_quadrangles_page Cutting quadrangles
 
-\n This operation allows to cut one or several quadrangle elements by
+\n This operation allows cutting one or several quadrangle elements
-addition of a supplementary edge which will connect two opposite
+into two or four triangles.
-corners.
 
 <em>To cut quadrangles:</em>
 <ol>
-<li>Display a mesh or a sub-mesh in the 3D viewer.</li>
+<li>Display a mesh, a 2D sub-mesh or a group of faces in the 3D viewer.</li>
 <li>In the \b Modification menu select the <b>Cutting of quadrangles</b> item or
 click <em>"Cutting of quadrangles"</em> button in the toolbar.
 
@@ -19,44 +18,45 @@ The following dialog box will appear:
 
 \image html a-cuttingofquadrangles.png
 
-\par
 <ul>
-<li>The main list contains the list of quadrangles. You can click on
+<li>The main list contains the list of quadrangles selected for cutting. You can
-an quadrangle in the 3D viewer and it will be highlighted (lock Shift
+  click on an quadrangle in the 3D viewer and it will be highlighted (lock Shift
-keyboard button to select several quadrangles). Click \b Add button and
+  keyboard button to select several quadrangles). Click \b Add button and the ID of
-the ID of this quadrangle will be added to the list. To remove a
+  this quadrangle will be added to the list. To remove a selected element or elements
-selected element or elements from the list click \b Remove button. <b>Sort
+  from the list click \b Remove button. <b>Sort list</b> button allows to sort the
-list</b> button allows to sort the list of IDs. \b Filter button allows to
+  list of IDs. \b Filter button allows to apply a definite filter to the selection of
-apply a definite filter to the selection of quadrangles.</li>
+  quadrangles.</li> 
-<li><b>Apply to all</b> check box allows to modify the orientation of all
+<li><b>Apply to all</b> check box allows to cut all quadrangles of the selected mesh,
-quadrangles of the currently displayed mesh or sub-mesh.</li>
+  sub-mesh or group.</li> 
-<li>\b Preview - provides a preview of cutting in the viewer.</li>
+<li>\b Preview provides a preview of cutting in the viewer. It is disabled for <b>Cut
+    into 4 triangles</b> as this cutting way implies no ambiguity.</li>
 </ul>
 
 <ul>
-<li>\b Criterion
+<li>\b Criterion defines a cutting way.
 <ul>
-<li><b>Use diagonal 1-3</b> and <b>Use diagonal 2-4</b> allows to
+<li><b>Cut into 4 triangles</b> selects cutting the quadrangle into four triangles by
-specify the opposite corners which will be connected by the cutting
+  inserting a new node at the center of quadrangle. The other options selects cutting
-edge.</li>
+  the quadrangle into two triangles by connecting nodes of either of the two diagonals.
-<li><b>Use numeric functor</b> - allows to choose a quality criterion
+<li><b>Use diagonal 1-3</b> and <b>Use diagonal 2-4</b> allows to specify the
- which will be optimized at the outcome of the operation.
+  opposite corners which will be connected to form two new triangles.</li>
-<ul>
+<li><b>Use numeric functor</b> allows to choose a quality metric which will be
-<li><b>Minimum diagonal</b> - cuts by the shortest edge.</li>
+  optimized when choosing a diagonal for cutting a quadrangle. 
-<li><b>Aspect Ratio</b> - cuts by the edge splitting the quadrangle 
+  <ul>
-into triangles with optimal \ref aspect_ratio_page "Aspect Ratio". The reference value is 1.</li>
+    <li><b>Minimum diagonal</b> cuts by the shortest diagonal.</li>
-<li><b>Minimum Angle</b> -  cuts by the edge splitting the quadrangle 
+    <li><b>Aspect Ratio</b> cuts by the diagonal splitting the quadrangle into
-into triangles with optimal  \ref minimum_angle_page "Minimum Angle". The reference value is 60 degrees.</li>
+      triangles with \ref aspect_ratio_page "Aspect Ratio" closer to 1.</li>
-<li><b>Skew</b> -   cuts by the edge splitting the quadrangle 
+    <li><b>Minimum Angle</b> cuts by the diagonal splitting the quadrangle into
-into triangles with optimal \ref skew_page "Skew". The reference value 
+      triangles with \ref minimum_angle_page "Minimum Angle" closer to 60
-is 0.0 degrees.</li>
+      degrees.</li> 
-</ul>
+    <li><b>Skew</b> cuts by the diagonal splitting the quadrangle into triangles
+      with \ref skew_page "Skew" closer to 0.0 degrees.</li>
+  </ul>
 </li>
 </ul>
 </li>
-<li><b>Select from</b> - allows to choose a sub-mesh or an existing
+<li><b>Select from</b> allows to choose a sub-mesh or an existing group whose
-group whose quadrangle elements will be automatically added to the
+  quadrangle elements will be automatically added to the main list.</li>
-list.</li>
 </ul>
 
 </li>