2 .. |point_button.icon| image:: images/point_button.png
7 Point feature creates a new construction point.
9 Point is a construction object and it can be created in a part or in a partset. To create a point:
11 #. select in the Main Menu *Construction - > Point* item or
12 #. click |point_button.icon| **Point** button in the toolbar
14 There are 5 algorithms for creation of a Point:
16 .. image:: images/point_by_xyz_32x32.png
18 **By X,Y,Z** creates a point by three coordinates.
20 .. image:: images/point_by_distance_on_edge_32x32.png
22 **By distance on edge** creates a point on an edge.
24 .. image:: images/point_by_projection_32x32.png
26 **By projection on edge or plane** creates a point by projecting an existing point on an edge or plane.
28 .. image:: images/point_by_intersection_32x32.png
30 **By intersection of objects** creates a point by intersection of planes or/ and edges.
32 .. image:: images/point_by_geometrical_property_32x32.png
34 **By geometrical property of object** creates a point in COG or center of arc or circle.
39 .. image:: images/Point1.png
43 **By X,Y,Z coordinates**
45 A point is created by X, Y, and Z coordinates.
49 .. py:function:: model.addPoint(Part_doc, 50, 50, 50)
51 :param part: The current part object.
55 :return: Result object.
60 The Result of the operation will be a construction point:
62 .. image:: images/CreatePoint1.png
66 **Point by coordinates**
68 **See Also** a sample TUI Script of :ref:`tui_create_point_xyz` operation.
73 .. image:: images/Point2.png
79 To create a point, select an edge in a viewer and define a distance along the edge, where point will be defined. This distance can be defined by an absolute value or by a relative one as a ratio to the edge length. The direction of the edge can be reversed by the corresponded check box.
83 .. py:function:: model.addPoint(Part_doc, model.selection("EDGE", "Box_1_1/Left&Box_1_1/Top"), 0.5, True, False)
85 :param part: The current part object.
86 :param object: An edge.
88 :param boolean: Is by ratio.
89 :param boolean: Is reversed.
90 :return: Result object.
95 The Result of the operation will be a construction point created on edge:
97 .. image:: images/CreatePoint2.png
101 **Point created on edge**
103 **See Also** a sample TUI Script of :ref:`tui_create_point_edge` operation.
105 By projection on edge or plane
106 ------------------------------
108 .. image:: images/Point3.png
114 To create a point, 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.
118 .. py:function:: 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"))
120 :param part: The current part object.
121 :param object: A vertex.
122 :param object: An edge or plane.
123 :return: Result object.
128 The Result of the operation will be a construction point created by projection on a plane or an edge:
130 .. image:: images/CreatePoint3.png
134 **Point created by projection on a plane**
136 **See Also** a sample TUI Script of :ref:`tui_create_point_projection` operation.
138 By intersection of objects
139 --------------------------
141 .. image:: images/Point4.png
145 **Intersection of objects**
147 To create a point, select:
153 The new point will be defined by intersection of the selected objects.
157 .. py:function:: model.addPoint(Part_doc, model.selection("EDGE", "Box_1_1/Front&Box_1_1/Top"), model.selection("FACE", "Box_1_1/Left"), 10, False)
159 :param part: The current part object.
160 :param object: An edge.
161 :param object: A plane.
163 :param boolean: Is offset reversed.
164 :return: Result object.
169 The Result of the operation will be a construction point created by intersection of objects:
171 .. image:: images/CreatePoint4.png
175 **Point created by intersection of axis**
177 **See Also** a sample TUI Script of :ref:`tui_create_point_intersection` operation.
179 By geometrical property of object
180 ---------------------------------
182 .. image:: images/Point5.png
186 **By geometrical property**
188 In this case the new point can be defined as a center of gravity of the selected object or as a center of a circle. To create a point, select the desirable object.
192 .. py:function:: model.addPoint(Part_1_doc, model.selection("SOLID", "Box_1_1"))
194 :param part: The current part object.
195 :param object: Solid.
196 :return: Result object.
201 The Result of the operation will be a construction point defined by object property:
203 .. image:: images/CreatePoint5.png
207 **Point created in COG of a cylinder**
209 **See Also** a sample TUI Script of :ref:`tui_create_point_object` operation.