X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fcreating_edge.doc;h=f22f4c4955ffca60297f4a80a54400cb39e21881;hb=a0e22ed86a0df64143edb095e07295a014b32c88;hp=6d45a541858e5e5970de5e3efc2287d0ef16ef7b;hpb=392885c1a8d50369708bbe5e6b44033ed8b8ba51;p=modules%2Fgeom.git
diff --git a/doc/salome/gui/GEOM/input/creating_edge.doc b/doc/salome/gui/GEOM/input/creating_edge.doc
index 6d45a5418..f22f4c495 100644
--- a/doc/salome/gui/GEOM/input/creating_edge.doc
+++ b/doc/salome/gui/GEOM/input/creating_edge.doc
@@ -2,25 +2,68 @@
\page create_edge_page Edge
-\n To create an \b Edge in the Main Menu select New Entity- > Build - > Edge
+To create an \b Edge, in the Main Menu select New Entity >
+Build > Edge
-\n You can create an \b Edge from two points (\b Point1 and \b Point2), being the first and the last vertices of the edge.
+There are three ways to create an edge. In all cases the \b Result
+will be a \b GEOM_Object (EDGE).
-The \b Result will be a \b GEOM_Object (EDGE).
+Firstly, you can create a linear \b Edge by specifying two points (\b Point1 and
+\b Point2), which are the first and the last vertices of the edge.
-TUI Command: geompy.MakeEdge(Vertex1, Vertex2), where
-Vertex1 and Vertex2 are correspondingly the first and the last vertex
-of the edge.
+TUI Command: geompy.MakeEdge(Vertex1, Vertex2)
+Arguments: Name + 2 vertices (Vertex1 and Vertex2 are
+correspondingly the first and the last vertex of the edge).
-Arguments: Name + 2 vertices.
+\image html edge1.png "Create edge by two points"
-\image html neo-obj2.png
+Secondly, you can create an \b Edge by specifying a single wire.
-\n Example:
+In this mode the following use cases are possible:
+- All edges that form the wire lie on the same geometrical curve
+(i.e. curve(edge1) == curve(edge2)).
+- The edges that form the wire lie on analytical curves of the same
+type, for example, segments of line, arcs, etc. In this case, the
+algorithm checks geometrical coincidence of these curves using
+a certain tolerance. If the curves are coinciding in terms of the given
+tolerance, the resulting edge is built as if on a single curve.
+- The edges that form the wire have the same tangency in the connection
+points. In this case the curves are interpolated by the single
+b-spline curve with sufficient precision. The resulting edge will
+be built on this curve.
+
+The case when the edges that form the wire have different tangency in
+the connection points (sharp bend) is not processed.
+
+TUI Command: geompy.MakeEdgeWire(Wire, LinearTolerance, AngularTolerance)
+Arguments: Name + 1 wire + Linear Tolerance + Angular Tolerance
+(tolerance values are used to check coincidence of the underlying curves).
+
+\image html edge2.png "Create edge from wire"
+
+Thirdly, it is possible to build an edge of required \b Length on any existing
+\b Edge.
+
+Start Point parameter is optional:
+- if used, it allows selecting any existing point - in such a case the start point
+of the new edge will be chosen as start or end point of the selected \b Edge
+whatever is closest to the selected Start Point
+- if it is missed, the start point of the initial edge is used
+
+Length can exceed the length of the initial edge length or be
+negative. In this case the existing edge is extrapolated
+along its curve (except for bezier and b-spline curves).
+
+TUI Command: geompy.MakeEdgeOnCurveByLength(Edge, Length, StartPoint = None)
+Arguments: Name + 1 edge + Length + 1 Vertex
+
+\image html edge3.png "Create edge on curve"
+
+Example:
\image html edgesn.png "Edge"
Our TUI Scripts provide you with useful examples of creation of
\ref tui_creation_edge "Advanced Geometric Objects".
-*/
\ No newline at end of file
+*/