/*!
\page create_pipe_path_page Restore Path
To generate a \b Path in the Main Menu select New Entity - > Generation - > Restore Path
\image html pipe_path_dlg.png
\n To obtain the \b Path of a pipe-like shape, you should define the
Pipe-like shell or solid and two pipe \b Bases, which can
be defined by a wire, a face or a list of edges.
\n Select unpublished edges checkbox - if checked, allows
selecting in the viewer the edges, that are not published in the Object
Browser.
\n The \b Result of the operation will be a GEOM_Object (edge or wire).
\n Advanced options:
- \ref preview_anchor "Preview"
\note It is not always possible to obtain an exact or approximate
copy of the Shape by applying the \b Pipe operation to the
resulting "Path" wire with the first Base as the base;
though in some particular cases it might
work. Thus, Restore Path function should not
be considered as an exact reverse operation of the Pipe.
\n Example:
\image html pipe_path.png "Path (red) between two faces (green)"
\n TUI Command: geompy.RestorePath(aShape, aBase1, aBase2)
\n Arguments: Name + 1 pipe-like shape (shell or solid) + 1
shape (edge, wire or face) for the first base + 1 shape (edge, wire or
face) for the last base.
\n TUI Command: geompy.RestorePathEdges(aShape, listEdges1, listEdges2)
\n Arguments: Name + 1 pipe-like shape (shell or solid) + 1
list of edges for the first base + 1 list of edges for the last base.
Our TUI Scripts provide you with useful examples of creation of
\ref tui_creation_pipe_path "Complex Geometric Objects".
*/