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=fcc0ba56d3c711e01d8775ac8f3617db4327e6c5;hpb=426cef8148b6ba6d12b2fe09ea636ccc4840308b;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..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 -> 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". */