/*!
\page create_face_page Face
To create a \b Face in the Main Menu select New Entity - >
Build - > Face
There are three algorithms to create a \b Face. In all cases the \b Result
of the operation will be a GEOM_Object (FACE).
\n Firstly, to create a \b Face you need to select input shape(s). The list of
input shapes can include shapes of any type except vertices; if the shapes are
neither wires nor edges, the algorithm extracts all edges from
the input shapes and works on the obtaineed edges.
\n The edges and wires do not necessarily have to be closed, the
algorithm automatically builds a wire of maximum length from all
given edges and wires. If several closed wires are detected the algorithm tries
to create a face with holes. It is possible only if there is only one wire
that can be interpreted as an outer one; other wires can be considered as
inner ones.
\n Check Try to create a planar face to create a planar
face or nothing if it is impossible.
\note Please note, that the resulting face can have a huge tolerance, if
the initial wire has a big deviation from the plane. If the final tolerance
exceeds 1e-06, a warning will be shown, but the face will be created
and published in the study in a normal way. Using such faces can lead to failures
or unpredictable results in most operations.
\n The \b Result will be a \b GEOM_Object (FACE).
\n TUI Command: geompy.MakeFaceWires([list of Shapes], isPlanarWanted)
\n Arguments: Name + 1 wire.
\image html neo-obj4.png "Create face by input shape(s)"
\n Secondly, it is possible to create a face based on another face's surface and bounded by a wire.
\n The \b Result will be a \b GEOM_Object (FACE).
\n TUI Command: geompy.MakeFaceFromSurface(theFace, theWire)
\n Arguments: Name + 1 face + 1 wire.
\image html neo-obj4_2.png "Create face by another face's surface"
Thirdly, user can create a \b Face by specifying a wire and its constraints.
It is necessary to define an input wire by selecting it in the object browser
or in the viewer. The input wire will be exploded on edges which will be shown
in the \b Constraints tree widget.
User must define the constraint face for each edge to get a good result.
\note Please note, that the constraint face must be connected to the edge.
\n The \b Result will be a \b GEOM_Object (FACE).
\n TUI Command: geompy.MakeFaceWithConstraints([List of constraints])
\n Arguments: Name + List of constraints, each constraint is a couple (Edge, Face),
where Edge is an Edge within the source Wire and Face is a Face connected to this Edge.
\image html neo-obj4_3.png "Create face by a wire and its constraints"
\n Example:
\image html facesn1.png
\image html facesn2.png
\image html facesn3.png "Examples of faces"
Our TUI Scripts provide you with useful examples of creation of
\ref tui_creation_face "Advanced Geometric Objects".
*/