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
20 **By X,Y,Z** creates a point by three coordinates.
22 .. 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
32 **By projection on edge or plane** creates a point by projecting an existing point on an edge or plane.
34 .. image:: images/point_by_intersection_32x32.png
38 **By intersection of objects** creates a point by intersection of planes or/ and edges.
40 .. image:: images/point_by_geometrical_property_32x32.png
44 **By geometrical property of object** creates a point in COG or center of arc or circle.
46 --------------------------------------------------------------------------------
51 .. image:: images/Point1.png
55 **By X,Y,Z coordinates**
57 A point is created by X, Y, and Z coordinates.
61 .. py:function:: model.addPoint(Part_doc, 50, 50, 50)
63 :param part: The current part object.
67 :return: Result object.
72 The Result of the operation will be a construction point:
74 .. image:: images/CreatePoint1.png
78 **Point by coordinates**
80 **See Also** a sample TUI Script of :ref:`tui_create_point_xyz` operation.
85 .. image:: images/Point2.png
91 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 corresponding check-box.
95 .. py:function:: model.addPoint(Part_doc, model.selection("EDGE", "Box_1_1/Left&Box_1_1/Top"), 0.5, True, False)
97 :param part: The current part object.
98 :param object: An edge.
100 :param boolean: Is by ratio.
101 :param boolean: Is reversed.
102 :return: Result object.
107 The Result of the operation will be a construction point created on edge:
109 .. image:: images/CreatePoint2.png
113 **Point created on edge**
115 **See Also** a sample TUI Script of :ref:`tui_create_point_edge` operation.
117 By projection on edge or plane
118 ------------------------------
120 To create a point by projection it is necessary to select an existing point or wertex which will be projected and an edge or a plane (planar face) on which it will be projected:
124 .. image:: images/Point3.png
128 **By projection on an edge**
132 .. image:: images/Point3-1.png
136 **By projection on a plane**
139 The new point will be created by projection of the selected point on the selected object.
143 .. 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"))
145 :param part: The current part object.
146 :param object: A vertex.
147 :param object: An edge or plane.
148 :return: Result object.
153 The Result of the operation will be a construction point created by projection on a plane or an edge:
155 .. image:: images/CreatePoint3.png
159 **Point created by projection on a plane**
161 **See Also** a sample TUI Script of :ref:`tui_create_point_projection` operation.
163 By intersection of objects
164 --------------------------
166 A point can be created by intersection of selected objects:
170 .. image:: images/Point4.png
174 **Intersection of edges**
178 .. image:: images/Point4-1.png
182 **Intersection of and edge and a plane**
184 In this case it is possible to define an offset from a plane along the plane normal for the created point.
188 .. image:: images/Point4-2.png
192 **Intersection of three planes**
194 The new point will be defined by intersection of the selected objects.
198 .. 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)
200 :param part: The current part object.
201 :param object: An edge.
202 :param object: A plane.
204 :param boolean: Is offset reversed.
205 :return: Result object.
210 The Result of the operation will be a construction point created by intersection of objects:
212 .. image:: images/CreatePoint4.png
216 **Point created by intersection of axis**
218 **See Also** a sample TUI Script of :ref:`tui_create_point_intersection` operation.
220 By geometrical property of object
221 ---------------------------------
223 It is possible to use the following property of selected object:
225 **A center of gravity**
227 .. image:: images/Point5.png
231 **By center of gravity**
233 **A center of circle or arc**
235 .. image:: images/Point5-1.png
239 **By center of a circle**
241 To create a point, select a desirable object.
245 .. py:function:: model.addPoint(Part_1_doc, model.selection("SOLID", "Box_1_1"))
247 :param part: The current part object.
248 :param object: Solid.
249 :return: Result object.
254 The Result of the operation will be a construction point defined by object property:
256 .. image:: images/CreatePoint5.png
260 **Point created in COG of a cylinder**
262 **See Also** a sample TUI Script of :ref:`tui_create_point_object` operation.