6 The feature Point creates a new construction point.
8 Point is a construction object and it can be created as in a part as in part set. To create a point:
10 #. select in the Main Menu *Construction - > Point* item or
11 #. click **Point** button in the toolbar
13 .. image:: images/point_button.png
19 There are 5 algorithms for creation of a Point:
21 .. image:: images/point_by_xyz_32x32.png
23 **By X,Y,Z** creates a point by three coordinates.
25 .. image:: images/point_by_distance_on_edge_32x32.png
27 **By distance on edge** creates a point on an edge.
29 .. image:: images/point_by_projection_32x32.png
31 **By projection on edge or plane** creates a point projecting of existing point on an edge or plane.
33 .. image:: images/point_by_intersection_32x32.png
35 **By intersection of objects** creates a point by intersection of planes or/ and edges.
37 .. image:: images/point_by_geometrical_property_32x32.png
39 **By geometrical property of object** creates a point in COG or center of arc or circle.
44 .. image:: images/Point1.png
48 **By X,Y,Z coordinates**
50 In this case user has to input X, Y, and Z coordinates.
52 **TUI Commands**: *model.addPoint(Part_doc, 50, 50, 50)*
54 **Arguments**: Part + 3 values (X, Y, Z coordinates).
59 The Result of the operation will be a construction point:
61 .. image:: images/CreatePoint1.png
65 **Point by coordinates**
67 **See Also** a sample TUI Script of a :ref:`tui_create_point_xyz` operation.
72 .. image:: images/Point2.png
78 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.
80 **TUI Commands**: *model.addPoint(Part_doc, model.selection("EDGE", "Box_1_1/Left&Box_1_1/Top"), 0.5, True, False)*
82 **Arguments**: Part + edge + value + is by ratio flag + to reverce flag.
87 The Result of the operation will be a construction point create on edge:
89 .. image:: images/CreatePoint2.png
93 **Point created on edge**
95 **See Also** a sample TUI Script of a :ref:`tui_create_point_edge` operation.
97 By projection on edge or plane
98 ------------------------------
100 .. image:: images/Point3.png
106 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.
108 **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"))*
110 **Arguments**: Part + vertex + edge (or plane).
115 The Result of the operation will be a construction point created by projection on a plane or an edge:
117 .. image:: images/CreatePoint3.png
121 **Point created by projection on a plane**
123 **See Also** a sample TUI Script of a :ref:`tui_create_point_projection` operation.
125 By intersection of objects
126 --------------------------
128 .. image:: images/Point4.png
132 **Intersection of objects**
134 In this case user has to select:
140 The new point will be defined by intersection of selected objects.
142 **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)*
144 **Arguments**: Part + edge + plane (planar face) + offset value + is offcet reversed.
149 The Result of the operation will be a construction point created by intersection of objects:
151 .. image:: images/CreatePoint4.png
155 **Point created by intersection of axis**
157 **See Also** a sample TUI Script of a :ref:`tui_create_point_intersection` operation.
159 By geometrical property of object
160 ---------------------------------
162 .. image:: images/Point5.png
166 **By geometrical property**
168 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.
170 **TUI Commands**: *model.addPoint(Part_1_doc, model.selection("SOLID", "Box_1_1"))*
172 **Arguments**: Part + solid
177 The Result of the operation will be a construction point defined by object property:
179 .. image:: images/CreatePoint5.png
183 **Point created in COG of a cylinder**
185 **See Also** a sample TUI Script of a :ref:`tui_create_point_object` operation.