X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fcreating_3dsketcher.doc;h=651ebc461f5d08852e90e26c624c1523d5f545d5;hb=00621ab4f35ece96476fc358acf598d78ec0a95d;hp=31b4107498713ed11ed5be28d4f80f1eb20cd127;hpb=72cb85eb5f520e1cdad469247e9e3aa1faeb61b9;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 31b410749..651ebc461 100755
--- a/doc/salome/gui/GEOM/input/creating_3dsketcher.doc
+++ b/doc/salome/gui/GEOM/input/creating_3dsketcher.doc
@@ -2,41 +2,56 @@
\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.
-To create a 3D Sketch, select in the main menu New Entity -> 3D Sketch.
+To create a 3D Sketch, select in the main menu New Entity -> Basic -> 3D Sketch.
\image html 3dsketch2.png
-In this dialog it is possible to define the coordinates of the points.
+The first sketcher point can be defined by \b Absolute coordinates X, Y and Z.
+When the first point is defined, it is possible to add straight segments.
+Each segment will start at the end point of previous segment or at the
+sketcher first point, if there are no validated segments.
-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 Coordinates Type
+Segment can be defined by:
+ - \b Absolute coordinates X, Y and Z of its second end,
+ - \b Relative coordinates DX, DY and DZ of its second end with
+ respect to the previous applied point,
+ - \b Direction and \b Length of the segment. Direction is set by two
+ \b Angles in selected coordinate system.
+
+The way of segment construction can be selected by the Coordinates Type
radio buttons.
-To add the point in the list of points and to proceed with the
-definition of the next point, click Apply button. \b Undo and
-\b Redo buttons, respectively, remove or restore the last point in the list.
+To validate the segment and to proceed with the definition of the next
+segment, click Apply button. \b Undo and \b Redo buttons,
+respectively, remove or restore the last segment in the wire.
\n "Sketch Validation" button applies the wire, built by the
user, "as is".
\n "Sketch Closure" 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.
-
-The Result of the operation will be a \b GEOM_Object.
-
-TUI Command: geompy.Make3DSketcher( [ PointsList ] )
-This algorithm creates a wire from the list of real values, which define XYZ
-coordinates of points.
-
Example:
\image html 3dsketch1.png
+TUI Command: geompy.Make3DSketcher( [ PointsList ] )
+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.
+
+\note To make a closed wire using this TUI command, the first and the
+last point should have the same coordinates.
+
+\n Another way to create the 3D Sketcher in TUI is using Sketcher3D
+interface.
+TUI Command: sk = geompy.Sketcher3D()
+Returns an instance of Sketcher3D interface sk.
+Use the below examples and see the \ref gsketcher.Sketcher3D "Sketcher3D"
+interface documentation for more information.
+
Our TUI Scripts provide you with useful examples of the use of
\ref tui_3dsketcher_page "3D Sketcher".
*/