mirror of
https://git.salome-platform.org/gitpub/modules/geom.git
synced 2025-02-15 04:13:08 +05:00
72 lines
2.9 KiB
Plaintext
72 lines
2.9 KiB
Plaintext
/*!
|
|
|
|
\page create_face_page Face
|
|
|
|
To create a \b Face in the <b>Main Menu</b> select <b>New Entity - >
|
|
Build - > Face</b>
|
|
|
|
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 <b>Try to create a planar face</b> 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 <b>TUI Command:</b> <em>geompy.MakeFaceWires([list of Shapes], isPlanarWanted)</em>
|
|
\n <b>Arguments:</b> 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 <b>TUI Command:</b> <em>geompy.MakeFaceFromSurface(theFace, theWire)</em>
|
|
\n <b>Arguments:</b> 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 <b>TUI Command:</b> <em>geompy.MakeFaceWithConstraints([List of constraints])</em>
|
|
\n <b>Arguments:</b> 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 <b>Example:</b>
|
|
|
|
\image html facesn1.png
|
|
|
|
\image html facesn2.png
|
|
|
|
\image html facesn3.png "Examples of faces"
|
|
|
|
Our <b>TUI Scripts</b> provide you with useful examples of creation of
|
|
\ref tui_creation_face "Advanced Geometric Objects".
|
|
|
|
*/
|