X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fcreating_3dsketcher.doc;h=030912ad65ba002aab4d44b921d2e48d7043f6ab;hb=a0e22ed86a0df64143edb095e07295a014b32c88;hp=fcc0ba56d3c711e01d8775ac8f3617db4327e6c5;hpb=73555c78ebf12a1fdb85157b8e7934ad566ae90a;p=modules%2Fgeom.git

diff --git a/doc/salome/gui/GEOM/input/creating_3dsketcher.doc b/doc/salome/gui/GEOM/input/creating_3dsketcher.doc
index fcc0ba56d..030912ad6 100755
--- a/doc/salome/gui/GEOM/input/creating_3dsketcher.doc
+++ b/doc/salome/gui/GEOM/input/creating_3dsketcher.doc
@@ -2,41 +2,75 @@
 
 \page create_3dsketcher_page 3D Sketcher
 
-3D Sketcher allows creating a closed or unclosed 3D wire from a list of points.
+3D Sketcher allows creating a closed or unclosed 3D wire, made of
+consequent straight segments.
+
+<b>Example:</b>
+
+\image html 3dsketch4.png
 
 To create a 3D Sketch, select in the main menu <em>New Entity -> Basic -> 3D Sketch</em>.
 
-\image html 3dsketch2.png
+\image html 3dsketch_dlg.png
+
+The first point of a sketch can be defined by \b Absolute coordinates X, Y and Z.
+After this, it is possible to add straight segments.
+
+Each segment starts at the end point of the previous segment or at the first point of the sketch, if there are no validated segments.
 
-In this dialog it is possible to define the coordinates of the points.
+The second point of a segment can be defined in two different ways depending on the selected <b>Coordinates Type</b> radio buttons:
 
-The position of each point can be defined by \b  Absolute coordinates X, Y, Z or
-by \b Relative coordinates DX, DY, DZ with respect to the previous Applied point.
-The type of coordinates can be selected by the <b>Coordinates Type</b>
-radio buttons.
+By <b>Cartesian coordinates</b> , which can be either:
+- \b Absolute coordinates \b X, \b Y and \b Z, or
+- \b Relative coordinates \b DX, \b DY and \b DZ with respect to the previous applied point,
+ 
+By <b>Angular coordinates</b>, which include:
+- the \b Length of the segment and an \b Angle in the chosen plane (OXY for example) in \b Relative mode. The angle is then relative to a local coordinate system with the last point of the sketch as origin. </li>
+   
+\image html 3dsketch_angle_rel.png
+   
+- the \b Radius (i.e. the distance from the origin) and an \b Angle in the chosen plane in \b Absolute mode 
+   
+\image html 3dsketch_angle_abs.png
 
-To add the point in the list of points and to proceed with the
-definition of the next point, click <b>Apply</b> button. \b Undo and
-\b Redo buttons, respectively, remove or restore the last point in the list.
+In both angular modes you can additionally specify the following:
+- the second \b Angle (latitude)
 
-\n <b>"Sketch Validation"</b> button applies the wire, built by the
+\image html 3dsketch_2angles_rel.png
+   
+- the \b Height
+ 
+\image html 3dsketch_angle_height_rel.png
+   
+To validate a segment and to proceed with the definition of the next
+one, click <b>Apply</b> button. \b Undo and \b Redo buttons,
+respectively, remove or restore the last segment in the wire.
+
+\n <b>Sketch Validation</b> button applies the wire, built by the
 user, "as is".
-\n <b>"Sketch Closure"</b> closes the Sketch by a straight line from
+\n <b>Sketch Closure</b> closes the Sketch by a straight line from
 the start to the end point and applies it. 
 
-To make a closed wire using the TUI command, the first and the last point should 
-have the same coordinates.
+<h2>TUI Commands</h2>
 
-The Result of the operation will be a \b GEOM_Object.
+<em>geompy.Make3DSketcher( [ PointsList ] )</em>
+This algorithm creates a wire from the list of real values, which
+define absolute XYZ coordinates of points. The Result of the operation
+will be a \b GEOM_Object.
 
-<b>TUI Command:</b> <em>geompy.Make3DSketcher( [ PointsList ] )</em>
-This algorithm creates a wire from the list of real values, which define XYZ 
-coordinates of points.
+\note To make a closed wire using this TUI command, the first and the
+last point should have the same coordinates.
 
-<b>Example:</b>
+\n Another way to create the 3D Sketcher in TUI is using Sketcher3D
+interface.
+
+<em>sk = geompy.Sketcher3D()</em>
+
+Returns an instance of Sketcher3D interface <em>sk</em>.
 
-\image html 3dsketch1.png
+Use the below examples and see the \ref gsketcher.Sketcher3D "Sketcher3D"
+interface documentation for more information.
 
-Our <b>TUI Scripts</b> provide you with useful examples of the use of
+<b>TUI Scripts</b> provide you with useful examples of the use of
 \ref tui_3dsketcher_page "3D Sketcher".
 */