/*!
\page create_plane_page Plane
To create a \b Plane in the Main Menu select New Entity - >
Basic - > Plane
\n There are three algorithms to create a plane in the 3D space.
\n The \b Result of each operation will be a GEOM_Object (face).
\n Firstly, you can define a \b Plane by a \b Point through which the
plane passes, a \b Vector giving a normal of the plane and a Size
of the Plane (size of a side of quadrangle face, representing the
plane).
\n TUI Command: geompy.MakePlane(Point, Vector, TrimSize)
\n Arguments: Name + 1 vertex + 1 vector + 1 value (to define
the size of the plane).
\image html plane1.png
\n Secondly, you can define a \b Plane by three \b Points through
which the plane passes and a Size of the Plane.
\n TUI Command: geompy.MakePlaneThreePnt(Point1, Point2, Point3, TrimSize)
\n Arguments: Name + 3 vertices + 1 value (to define the size
of the plane).
\image html plane2.png
\n Thirdly, you can define a \b Plane by another \b Plane or Face and a Size of the Plane.
\n TUI Command: geompy.MakePlaneFace(Face, TrimSize)
\n Arguments: Name + 1 face + 1 value (to define the size of the plane).
\image html plane3.png
\n Fourthly, you can define a \b Plane by two Vectors. The first vector defines the center point and the direction,
the second vector defines the normal to the Plane.
\n TUI Command: geompy.MakePlane2Vec(Vec1, Vec2, TrimSize)
\n Arguments: Name + 2 vectors + 1 value (to define the size of the plane).
\image html plane4.png
\n Finally, you can define a \b Plane by the Local Coordinate System and the orientation (OXY, OYZ, OZX).
\n TUI Command: geompy.MakePlaneLCS(LCS, TrimSize, [1, 2, or 3])
\n Arguments: Name + LCS + 1 value (to define the size of the plane) + 1 value (to define the orientation)
\image html plane5.png
Examples:
\image html planes1.png
Planes created on the basis of the Global Coordinate System
\image html plane_on_face.png
A Plane created on a Face of another Shape
Our TUI Scripts provide you with useful examples of creation of
\ref tui_creation_plane "Basic Geometric Objects".
*/