X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fcutting_quadrangles.doc;h=34f26a67dd20a5be6d238176dc7c18b48f537509;hb=762641c5edac12dcbb64246bef97a34cf39e1f45;hp=d857165e16b5b63e598f3ef35b92047b4371aae9;hpb=79b1ac2b6df9117f16f11d444b1f165d477a1813;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/cutting_quadrangles.doc b/doc/salome/gui/SMESH/input/cutting_quadrangles.doc
index d857165e1..34f26a67d 100644
--- a/doc/salome/gui/SMESH/input/cutting_quadrangles.doc
+++ b/doc/salome/gui/SMESH/input/cutting_quadrangles.doc
@@ -2,62 +2,50 @@
\page cutting_quadrangles_page Cutting quadrangles
-\n This operation allows to cut one or several quadrangle elements by
-addition of a supplementary edge which will connect two opposite
-corners.
+This operation allows cutting one or several quadrangle elements into two or four triangles.
To cut quadrangles:
-
-- Display a mesh or a submesh in the 3D viewer.
-- In the \b Modification menu select the Cutting of quadrangles item or
+
+1) Select a mesh (and display it in the 3D Viewer if you are going to pick elements by mouse).
+
+2) In the \b Modification menu select the Cutting of quadrangles item or
click "Cutting of quadrangles" button in the toolbar.
-\image html image82.gif
+\image html image82.png
"Cutting of quadrangles" button
The following dialog box will appear:
\image html a-cuttingofquadrangles.png
-\par
-
-- The main list contains the list of quadrangles. You can 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
-the ID of this quadrangle will be added to the list. To remove a
-selected element or elements from the list click \b Remove button. Sort
-list button allows to sort the list of IDs. \b Filter button allows to
-apply a definite filter to the selection of quadrangles.
-- Apply to all radio button allows to modify the orientation of all
-quadrangles of the currently displayed mesh or submesh.
-- \b Preview - provides a preview of cutting in the viewer.
-
-
-
-- \b Criterion
-
-- Use diagonal 1-3 and Use diagonal 2-4 allows to
-specify the opposite corners which will be connected by the cutting
-edge.
-- Use numeric factor - allows to apply the operation only to
-those objects which meet the chosen criterion (from the list of
-Quality Controls, i.e. Skew, Warping, Minimum Angle, etc.)
-
-
-- Select from - allows to choose a submesh or an existing
-group whose quadrangle elements will be automatically added to the
-list.
-
-
-
-- Click the \b Apply or \b OK button to confirm the operation.
-
-
-\image html image52.jpg
-
-\image html image51.jpg
+
+- The main list contains the list of quadrangles selected for cutting. You can
+click on a quadrangle in the 3D viewer and it will be highlighted (lock Shift
+keyboard button to select several quadrangles):
+ - Click \b Add button and the ID of this quadrangle will be added to the list.
+ - To remove a selected element or elements from the list click \b Remove button.
+ - Sort list button allows sorting the list of IDs.
+ - \b Filter button allows applying a definite \ref filtering_elements "filter"
+ to the selection of quadrangles.
+- Apply to all check box allows cutting all quadrangles of the selected mesh.
+- \b Preview provides a preview of cutting in the viewer. It is disabled for Cut into 4 triangles as this cutting way implies no ambiguity.
+- \b Criterion defines the way of cutting:
+ - Cut into 4 triangles allows cutting a quadrangle into four triangles by inserting a new node at the center of the quadrangle. The other options allow cutting a quadrangle into two triangles by connecting the nodes of a diagonal.
+ - Use diagonal 1-3 and Use diagonal 2-4 allow specifying the opposite corners, which will be connected to form two new triangles.
+ - Use numeric functor allows selecting in the field below a quality metric, which will be optimized when choosing a diagonal for cutting a quadrangle:
+ - Minimum diagonal cuts by the shortest diagonal.
+ - Aspect Ratio cuts by the diagonal splitting the quadrangle into triangles with \ref aspect_ratio_page "Aspect Ratio" closer to 1
+ - Minimum Angle cuts by the diagonal splitting the quadrangle into triangles with \ref minimum_angle_page "Minimum Angle" closer to 60 degrees.
+ - Skew cuts by the diagonal splitting the quadrangle into triangles with \ref skew_page "Skew" closer to 0.0 degrees.
+- Select from allows choosing a sub-mesh or an existing group, whose quadrangle elements then can be added to the main list.
+
+3) Click the \b Apply or Apply and Close button to confirm the operation.
+
+\image html image52.jpg "The chosen quadrangular element"
+
+\image html image51.jpg "Two resulting triangular elements"
See Also a sample TUI Script of a
\ref tui_cutting_quadrangles "Cutting Quadrangles" operation.
-*/
\ No newline at end of file
+*/