5 Plane feature creates a new constructive plane.
7 Plane is a construction object that can be created in a part or in a partset. To create a plane:
9 #. select in the Main Menu *Construction - > Plane* item or
10 #. click **Point** button in the toolbar
12 .. image:: images/plane_button.png
18 There are 4 algorithms for creation of a Plane:
20 .. image:: images/plane_by_three_points_32x32.png
22 **By three points** creates a plane by three points.
24 .. image:: images/plane_by_line_and_point_32x32.png
26 **By line and point** creates a plane by a line and a point.
28 .. image:: images/plane_by_other_plane_32x32.png
30 **By other plane** creates a plane parallel to another plane.
32 .. image:: images/plane_by_two_parallel_planes_32x32.png
34 **By two parallel planes** creates a plane between two parallel planes.
40 .. image:: images/Plane1.png
46 A plane is created by selecting three points in a viewer.
48 **TUI Commands**: *model.addPlane(Part_doc, model.selection("VERTEX", "Box_1_1/Back&Box_1_1/Left&Box_1_1/Top"), model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Right&Box_1_1/Top"), model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Left&Box_1_1/Bottom"))*
50 **Arguments**: Part + 3 vertices.
55 The Result of the operation will be a plane:
57 .. image:: images/CreatedPlane1.png
61 **A plane by three points**
63 **See Also** a sample TUI Script of :ref:`tui_create_plane_points` operation.
69 .. image:: images/Plane2.png
75 A plane is created by selecting a linear edge and point. It is possible to create a new plane perpendicular to the selected edge.
77 **TUI Commands**: *model.addPlane(Part_doc, model.selection("EDGE", "Box_1_1/Left&Box_1_1/Top"), model.selection("VERTEX", "Box_1_1/Front&Box_1_1/Right&Box_1_1/Bottom"), False)*
79 **Arguments**: Part + line + point + is perpendicular to line flag.
84 The Result of the operation will be a plane:
86 .. image:: images/CreatedPlane2.png
92 **See Also** a sample TUI Script of :ref:`tui_create_plane_line` operation.
98 .. image:: images/Plane3.png
104 A plane is created by selecting an already existing plane (planar face). There are following possibilities to define a new plane:
106 .. image:: images/plane_by_distance_from_other_24x24.png
109 By distance from the selected plane.
111 .. image:: images/plane_by_coincident_to_point_24x24.png
114 By coincidence with a point.
116 .. image:: images/plane_by_rotation_24x24.png
119 By rotation around an edge by a specified angle.
121 **TUI Commands**: *model.addPlane(Part_doc, model.selection("FACE", "Box_1_1/Front"), 10, False)*
123 **Arguments**: Part + a plane + offset + is reverse flag.
128 The Result of the operation will be a plane parallel to already existing one:
130 .. image:: images/CreatedPlane3.png
134 **Plane parallel to a planar face**
136 **See Also** a sample TUI Script of :ref:`tui_create_plane_plane` operation.
139 By two parallel planes
140 ----------------------
142 .. image:: images/Plane4.png
146 **By two parallel planes**
148 A plane is created by selecting two parallel planes. A new plane will be defined between them.
150 **TUI Commands**: *model.addPlane(Part_doc, model.selection("FACE", "Box_1_1/Left"), model.selection("FACE", "Box_1_1/Right"))*
152 **Arguments**: Part + 2 planes.
157 The Result of the operation will be a plane created between two selected planes:
159 .. image:: images/CreatedPlane4.png
163 **Plane created between others**
165 **See Also** a sample TUI Script of :ref:`tui_create_plane_parallel` operation.