X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fcreating_point.doc;h=46da866283907ebefb3a6142575e42d575ad6518;hb=ef20f40494c9ede9394c4465ed565a5a30332611;hp=3c992c8f0d832cd6f055407e2960e6c13c25a7b2;hpb=392885c1a8d50369708bbe5e6b44033ed8b8ba51;p=modules%2Fgeom.git
diff --git a/doc/salome/gui/GEOM/input/creating_point.doc b/doc/salome/gui/GEOM/input/creating_point.doc
index 3c992c8f0..46da86628 100644
--- a/doc/salome/gui/GEOM/input/creating_point.doc
+++ b/doc/salome/gui/GEOM/input/creating_point.doc
@@ -31,17 +31,39 @@ point is located in the middle of the edge.
\n TUI Command: geompy.MakeVertexOnCurve(Edge,Parameter).
\n Arguments: Name + 1 edge + 1 Parameter defining the
position of the point on the given edge.
-
\image html point3.png
-\n Fourthly, we can define a point by intersection of two \b Lines.
-\n TUI Command: geompy.MakePointOnLinesIntersection(myLine1,myLine2).
-\n Arguments: Name + 2 lines
+Alternatively, it is possible to define a point by an \b Edge and a \b Length.
+The \b Length defines the position of the point on the given edge. It
+can exceed the length of the edge or be negative. In this case the edge
+is extrapolated along its curve (except for bezier and b-spline
+curves).
+The Start Point defines the direction for the length
+calculation (if not defined, the first vertex of
+Edge is used, else the vertex of Edge closest to StartPoint is used).
+\n TUI Command: geompy.MakeVertexOnCurveByLength(Edge,Length,StartPoint=None).
+\n Arguments: Name + 1 edge + 1 Length + 1 Point.
+
+\image html point3_3.png
+
+It is also possible to define 3D coordinates of the point
+projected on the given edge to produce the resulting point.
+\n TUI Command: geompy.MakeVertexOnCurveByCoord(Edge,X,Y,Z).
+\n Arguments: Name + 1 edge + 3 coordinate values of the
+projected point.
+\image html point3_2.png
+
+\n Fourthly, we can define a point(s) by intersection of two \b Lines or \b Wires (or a Wire and a Line).
+If they intersect only once, a point will be created. If there are several intersections, a compound of
+points will be created. The type of the selected object (Line or Wire) can be changed in the popup menu,
+after clicking the corresponding selection button. (see the picture below)
+\n TUI Command: geompy.MakePointOnLinesIntersection(myLine1,myWire1).
+\n Arguments: Name + 2 1D objects
\image html point4.png
-Example:
-\n Finally, we can define a point by a \b Face and two Parameters: U and \b V
+\n Finally, we can define a point by a \b Face and
+Two Parameters: U and \b V
indicating its position on the Face, ranging from 0.0 to 1.0. For example, (0.5; 0.5) means that the
point is located in the middle of the face.
\n TUI Command: geompy.MakeVertexOnSurface(myFace,myUParameter,myVParameter).
@@ -50,6 +72,13 @@ position of the point on the given face.
\image html point5.png
+Alternatively, it is possible to define 3D coordinates of the point projected on the given face.
+\n TUI Command: geompy.MakeVertexOnSurfaceByCoord(myFace,X,Y,Z).
+\n Arguments: Name + 1 face + 3 coordinate values
+to project point on the given face.
+
+\image html point5_2.png
+
Example:
\image html points.png "Points by edge and parameter and by coordinates"