5 The feature Point creates a new construction point.
7 Point is a construction object and it can be created as in a part as in part set. To create a point:
9 #. select in the Main Menu *Construction - > Point* item or
10 #. click **Point** button in the toolbar
12 .. image:: images/point_button.png
18 There are 5 algorithms for creation of a Point:
20 .. image:: images/point_by_xyz_32x32.png
22 **By X,Y,Z** creates a point by three coordinates.
24 .. image:: images/point_by_distance_on_edge_32x32.png
26 **By distance on edge** creates a point on an edge.
28 .. image:: images/point_by_projection_32x32.png
30 **By projection on edge or plane** creates a point projecting of existing point on an edge or plane.
32 .. image:: images/point_by_intersection_32x32.png
34 **By intersection of objects** creates a point by intersection of planes or/ and edges.
36 .. image:: images/point_by_geometrical_property_32x32.png
38 **By geometrical property of object** creates a point in COG or center of arc or circle.
43 .. image:: images/Point1.png
47 **By X,Y,Z coordinates**
49 In this case user has to input X, Y, and Z coordinates.
51 **TUI Commands**: *model.addPoint(Part_doc, 50, 50, 50)*
53 **Arguments**: Part + 3 values (X, Y, Z coordinates).
58 The Result of the operation will be a construction point:
60 .. image:: images/CreatePoint1.png
64 **Point by coordinates**
66 **See Also** a sample TUI Script of a :ref:`tui_create_point_xyz` operation.
71 .. image:: images/Point2.png
77 In this case user has to select an edge in a viewer and to define a distance along the edge where point will be defined. This distance can be defined as by an absolute value as by relative as a ratio to the edge length. The direction of the edge can be reverced by the corresponded check box.
79 **TUI Commands**: *model.addPoint(Part_doc, model.selection("EDGE", "Box_1_1/Left&Box_1_1/Top"), 0.5, True, False)*
81 **Arguments**: Part + edge + value + is by ratio flag + to reverce flag.
86 The Result of the operation will be a construction point create on edge:
88 .. image:: images/CreatePoint2.png
92 **Point created on edge**
94 **See Also** a sample TUI Script of a :ref:`tui_create_point_edge` operation.
96 By projection on edge or plane
97 ------------------------------
99 .. image:: images/Point3.png
105 In this case user has to select an existing point or vertex and an edge or face. The new point will be created by projection of the selected point on the edge or face.
107 **TUI Commands**: *model.addPoint(Part_doc, model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Left&Box_1_1/Top"), model.selection("EDGE", "Box_1_1/Right&Box_1_1/Top"))*
109 **Arguments**: Part + vertex + edge (or plane).
114 The Result of the operation will be a construction point created by projection on a plane or an edge:
116 .. image:: images/CreatePoint3.png
120 **Point created by projection on a plane**
122 **See Also** a sample TUI Script of a :ref:`tui_create_point_projection` operation.
124 By intersection of objects
125 --------------------------
127 .. image:: images/Point4.png
131 **Intersection of objects**
133 In this case user has to select:
139 The new point will be defined by intersection of selected objects.
141 **TUI Commands**: *model.addPoint(Part_doc, model.selection("EDGE", "Box_1_1/Front&Box_1_1/Top"), model.selection("FACE", "Box_1_1/Left"), 10, False)*
143 **Arguments**: Part + edge + plane (planar face) + offset value + is offcet reversed.
148 The Result of the operation will be a construction point created by intersection of objects:
150 .. image:: images/CreatePoint4.png
154 **Point created by intersection of axis**
156 **See Also** a sample TUI Script of a :ref:`tui_create_point_intersection` operation.
158 By geometrical property of object
159 ---------------------------------
161 .. image:: images/Point5.png
165 **By geometrical property**
167 In this case the new point can be defined as a center of gravity of selected object or as a center of a circle. User has to select desirable object.
169 **TUI Commands**: *model.addPoint(Part_1_doc, model.selection("SOLID", "Box_1_1"))*
171 **Arguments**: Part + solid
176 The Result of the operation will be a construction point defined by object property:
178 .. image:: images/CreatePoint5.png
182 **Point created in COG of a cylinder**
184 **See Also** a sample TUI Script of a :ref:`tui_create_point_object` operation.