X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fclipping.doc;h=f28b880019315a3d9514a0388e1b1273e9923655;hb=2cd148d0668de3bfbeeceeb7df1995bb5b39475b;hp=f3b19f3742cd61033b1c20584a5f0a2482270206;hpb=0635c9fc80f67d1e5dc0e94ec85f487286a92070;p=modules%2Fsmesh.git

diff --git a/doc/salome/gui/SMESH/input/clipping.doc b/doc/salome/gui/SMESH/input/clipping.doc
index f3b19f374..f28b88001 100644
--- a/doc/salome/gui/SMESH/input/clipping.doc
+++ b/doc/salome/gui/SMESH/input/clipping.doc
@@ -2,27 +2,61 @@
 
 \page clipping_page Clipping
 
-\n Using this menu you can create cross-section views (clipping planes)
+\b Clipping allows creating cross-section views (clipping planes)
 of your mesh.
 
-To start, click on the \em New button.
+It is available as a sub-item in the context menu of an active mesh. 
 
-\image html a-clipping2.png
+To create a clipping plane, click on the \b New button in the dialog and choose how it is  defined: by \b Absolute or \b Relative coordinates.
 
-Now you can define the parameters of your cross-section: \b Orientation
-(X-Y, X-Z or Y-Z); \b Distance between the opposite extremities of the
-object, if it is set to 0.5 the object is split in two halves; and
-\b Rotation (in angle degrees) <b>around X</b> (Y to Z) and <b>around Y</b> (X to
-Z). If the <b>Show preview</b> button is on, you can see the clipping plane
-in the <b>3D Viewer</b>.
+<b>Absolute Coordinates</b>
 
-\image html image79.jpg "The plane and the cut object"
+\image html Clipping_Absolute.png
 
-If the <b>Auto Apply</b> button is on, you can preview the
+- <b>Base point</b> - allows defining the coordinates of the base
+  point for the clipping plane.
+
+  - <b>Reset</b> - returns the base point to coordinate origin.
+
+- <b>Direction</b> - allows defining the orientation of the
+  clipping plane.
+
+	- <b>Invert</b> - allows selecting, which part of the object will be
+    removed and which will remain after clipping.
+    
+<b>Relative mode</b>  
+
+\image html Clipping_Relative.png
+
+- \b Orientation ( ||X-Y, ||X-Z or ||Y-Z).
+
+- \b Distance between the opposite extremities of the boundary box of 
+selected objects, if it is set to 0.5 the boundary box is split in two halves.
+
+- \b Rotation (in angle degrees) <b>around X</b> (Y to Z) and <b>around 
+Y</b> (X to Z) (depending on the chosen Orientation)
+
+\image html before_clipping_preview.png "The preview plane and the cut object"
+
+The other parameters are available in both modes : 
+
+- <b>OpenGL clipping</b> check-box allows choosing OpenGL native clipping, which clips the whole presentation. If it is unchecked, the clipping is done on the dataset i.e. only the visibility of separate mesh cells is changed (see the examples).
+- The List contains <b>Meshes, sub-meshes and groups</b> to which the cross-section will be applied.
+- <b>Select all</b> check-box allows to selecting and deselecting all available objects at once.
+- <b>Show preview</b> check-box shows the clipping plane in the <b>3D Viewer</b>.
+- <b>Auto Apply</b> check-box shows button is on, you can preview the
 cross-section in the <b>3D Viewer</b>.
 
-\image html image99.gif "The cross-section"
+It is also possible to interact  with the clipping plane directly in 3D 
+view using the mouse. 
 
 To get a new object from \b Clipping, click \b Apply.
 
+<b>Examples:</b>
+
+\image html dataset_clipping.png "The cross-section using dataset"
+
+\image html opengl_clipping.png "The OpenGL cross-section"
+
+
 */