X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fcreating_point.doc;h=9844a3cff6892564c7c6416b6ff829df0ad8ff9a;hb=f4b5386b2ea36dbc789e4d31a877a11922b71fc8;hp=5e170327046556b193c2c3e5963f77c341be847b;hpb=239f8109c64fa0c5a2e1d87a420bad5529b57f48;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 5e1703270..9844a3cff 100644
--- a/doc/salome/gui/GEOM/input/creating_point.doc
+++ b/doc/salome/gui/GEOM/input/creating_point.doc
@@ -5,7 +5,7 @@
To create a \b Point in the Main Menu select New Entity - >
Basic - > Point
-\n There are four algorithms to create a \b Point in the 3D space.
+\n There are five algorithms to create a \b Point in the 3D space.
\n Each time the \b Result of the operation will be a GEOM_Object
(vertex).
@@ -31,17 +31,57 @@ 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 Finally, 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
+
+\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).
+\n Arguments: Name + 1 face + 2 Parameters defining the
+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.MakeVertexOnSurface(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
+\image html points.png "Points by edge and parameter and by coordinates"
Our TUI Scripts provide you with useful examples of creation of
\ref tui_creation_point "Basic Geometric Objects".