Salome HOME
5e170327046556b193c2c3e5963f77c341be847b
[modules/geom.git] / doc / salome / gui / GEOM / input / creating_point.doc
1 /*!
2
3 \page create_point_page Point
4
5 To create a \b Point in the <b>Main Menu</b> select <b>New Entity - >
6 Basic - > Point</b>
7
8 \n There are four algorithms to create a \b Point in the 3D space.
9 \n Each time the \b Result of the operation will be a GEOM_Object
10 (vertex).
11
12 \n Firstly, we can define a point by setting its X, Y and Z \b Coordinates. 
13 \n <b>TUI Command:</b> <em>geompy.MakeVertex(X, Y, Z)</em>
14 \n \b Arguments: Name (Vertex_n by default) + X, Y and Z coordinates of
15 the point.
16
17 \image html point1.png
18
19 \n Secondly,  we can define a point by a \b Reference to another point
20 and the shift of the coordinates of the new point regarding the
21 coordinates of the old one.
22 \n <b>TUI Command:</b> <em>geompy.MakeVertexWithRef(Reference, X,Y,Z).</em>
23 \n <b>Arguments:</b> Name + 1 reference point + 3 coordinates defining
24 the position of this point regarding the reference one.
25
26 \image html point2.png
27
28 \n Thirdly, we can define a point by an \b Edge and a \b Parameter
29 indicating its position on the Edge, ranging from 0.0 to 1.0. For example, 0.5 means that the
30 point is located in the middle of the edge.
31 \n <b>TUI Command:</b> <em>geompy.MakeVertexOnCurve(Edge,Parameter).</em>
32 \n <b>Arguments:</b> Name + 1 edge  + 1 Parameter defining the
33 position of the point on the given edge.
34
35 \image html point3.png
36
37 \n Finally, we can define a point by intersection of two \b  Lines.
38 \n <b>TUI Command:</b> <em>geompy.MakePointOnLinesIntersection(myLine1,myLine2).</em>
39 \n <b>Arguments:</b> Name + 2 lines
40
41 \image html point4.png
42 <b>Example:</b>
43
44 \image html points.png
45
46 Our <b>TUI Scripts</b> provide you with useful examples of creation of 
47 \ref tui_creation_point "Basic Geometric Objects".
48
49 */