3 \page create_point_page Point
5 To create a \b Point in the <b>Main Menu</b> select <b>New Entity - >
8 \n There are five 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
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
17 \image html point1.png
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.
26 \image html point2.png
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 \image html point3.png
36 Alternatively, it is possible to define the point by \b Edge and \b Length,
37 the given length must not exceed the length of the edge. The orientation of the edge can be reversed.
38 \n <b>TUI Command:</b> <em>geompy.MakeVertexOnCurveByLength(Edge,Length,Reverse).</em>
39 \n <b>Arguments:</b> Name + 1 edge + 1 Length defining the
40 position of the point on the given edge + 1 Reverse flag defining the direction for the
41 calculation of the length (False = forward, True = reversed).
42 \image html point3_3.png
44 It is also possible to define 3D coordinates of the point
45 projected on the given edge to produce the resulting point.
46 \n <b>TUI Command:</b> <em>geompy.MakeVertexOnCurveByCoord(Edge,X,Y,Z).</em>
47 \n <b>Arguments:</b> Name + 1 edge + 3 coordinate values of the
49 \image html point3_2.png
51 \n Fourthly, we can define a point(s) by intersection of two \b Lines or \b Wires (or a Wire and a Line).
52 If they intersect only once, a point will be created. If there are several intersections, a compound of
53 points will be created. The type of the selected object (Line or Wire) can be changed in the popup menu,
54 after clicking the corresponding selection button. (see the picture below)
55 \n <b>TUI Command:</b> <em>geompy.MakePointOnLinesIntersection(myLine1,myWire1).</em>
56 \n <b>Arguments:</b> Name + 2 1D objects
58 \image html point4.png
60 \n Finally, we can define a point by a \b Face and
61 Two <b> Parameters: U </b> and \b V
62 indicating its position on the Face, ranging from 0.0 to 1.0. For example, (0.5; 0.5) means that the
63 point is located in the middle of the face.
64 \n <b>TUI Command:</b> <em>geompy.MakeVertexOnSurface(myFace,myUParameter,myVParameter).</em>
65 \n <b>Arguments:</b> Name + 1 face + 2 Parameters defining the
66 position of the point on the given face.
68 \image html point5.png
70 Alternatively, it is possible to define 3D coordinates of the point projected on the given face.
71 \n <b>TUI Command:</b> <em>geompy.MakeVertexOnSurface(myFace,X,Y,Z).</em>
72 \n <b>Arguments:</b> Name + 1 face + 3 coordinate values
73 to project point on the given face.
75 \image html point5_2.png
79 \image html points.png "Points by edge and parameter and by coordinates"
81 Our <b>TUI Scripts</b> provide you with useful examples of creation of
82 \ref tui_creation_point "Basic Geometric Objects".