Open CASCADE Technology
6.5.4
|
This class is intended to create a shell from the composite
surface (grid of surfaces) and set of wires.
It may be either division of the supporting surface of the
face, or creating a shape corresponding to face on composite
surface which is missing in CAS.CADE but exists in some other
systems.
It splits (if necessary) original face to several ones by
splitting lines which are joint lines on a supplied grid of
surfaces (U- and V- isolines of the composite surface).
There are two modes of work, which differ in the way of
handling faces on periodic surfaces:
More...
#include <ShapeFix_ComposeShell.hxx>
Public Member Functions | |
ShapeFix_ComposeShell () | |
Creates empty tool. | |
void | Init (const Handle< ShapeExtend_CompositeSurface > &Grid, const TopLoc_Location &L, const TopoDS_Face &Face, const Standard_Real Prec) |
Initializes with composite surface, face and precision. Here face defines both set of wires and way of getting pcurves. Precision is used (together with tolerance of edges) for handling subtle cases, such as tangential intersections. | |
Standard_Boolean & | ClosedMode () |
Returns (modifiable) flag for special 'closed' mode which forces ComposeShell to consider all pcurves on closed surface as modulo period. This can reduce reliability, but allows to deal with wires closed in 3d but open in 2d (missing seam) Default is False | |
virtual Standard_Boolean | Perform () |
Performs the work on already loaded data. | |
void | SplitEdges () |
Splits edges in the original shape by grid. This is a part of Perform() which does not produce any resulting shape; the only result is filled context where splittings are recorded. NOTE: If edge is splitted, it is replaced by wire, and order of edges in the wire corresponds to FORWARD orientation of the edge. | |
const TopoDS_Shape & | Result () const |
Returns resulting shell or face (or Null shape if not done) | |
Standard_Boolean | Status (const ShapeExtend_Status status) const |
Queries status of last call to Perform() OK : nothing done (some kind of error) DONE1: splitting is done, at least one new face created DONE2: splitting is done, several new faces obtained FAIL1: misoriented wire encountered (handled) FAIL2: recoverable parity error FAIL3: edge with no pcurve on supporting face FAIL4: unrecoverable algorithm error (parity check) | |
void | DispatchWires (TopTools_SequenceOfShape &faces, ShapeFix_SequenceOfWireSegment &wires) const |
Creates new faces from the set of (closed) wires. Each wire is put on corresponding patch in the composite surface, and all pcurves on the initial (pseudo)face are reassigned to that surface. If several wires are one inside another, single face is created. | |
void | SetTransferParamTool (const Handle< ShapeAnalysis_TransferParameters > &TransferParam) |
Sets tool for transfer parameters from 3d to 2d and vice versa. | |
Handle_ShapeAnalysis_TransferParameters | GetTransferParamTool () const |
Gets tool for transfer parameters from 3d to 2d and vice versa. | |
Protected Member Functions | |
void | LoadWires (ShapeFix_SequenceOfWireSegment &seqw) const |
Fill sequence of wire segments by wires from myFace (pre-loaded). It performs reorder so that edges in segments are well-ordered. The context is applied to all wires before using them. | |
Standard_Integer | ComputeCode (const Handle< ShapeExtend_WireData > &wire, const gp_Lin2d &line, const Standard_Integer begInd, const Standard_Integer endInd, const Standard_Real begPar, const Standard_Real endPar, const Standard_Boolean IsInternal=Standard_False) |
Analyze tangencies and compute orientation code for wire segment between two intersections: tells if segment is on left or right side of cutting line, or tangent to it (by several points recomputed to 3d, distance is compared with tolerance of corresponding edge). | |
ShapeFix_WireSegment | SplitWire (ShapeFix_WireSegment &wire, TColStd_SequenceOfInteger &indexes, const TColStd_SequenceOfReal &values, TopTools_SequenceOfShape &vertices, const TColStd_SequenceOfInteger &segcodes, const Standard_Boolean cutbyu, const Standard_Integer cutindex) |
Splits edges in the wire by given indices of edges and parameters on them. Returns resulting wire and vertices corresponding to splitting parameters. If two consequtive splitting points are too near one to another (with tolerance of edge), edge is divided in single point. In the same way, splitting which is too near to end of edge, is not applied (end vertex is returned instead). NOTE: If edge is splitted, it is replaced by wire, and order of edges in the wire corresponds to FORWARD orientation of the edge. | |
Standard_Boolean | SplitByLine (ShapeFix_WireSegment &wire, const gp_Lin2d &line, const Standard_Boolean cutbyu, const Standard_Integer cutindex, TColStd_SequenceOfReal &SplitLinePar, TColStd_SequenceOfInteger &SplitLineCode, TopTools_SequenceOfShape &SplitLineVertex) |
Split edges in the wire by cutting line. Wires with FORWARD or REVERSED orientation are considered as closed. All modifications (splitting) are recorded in context, except splitting of wires marked as EXTERNAL (they are supposed to be former cutting lines). Method fills sequences of parameters of intersection points of cutting line with all edges, their types, and corresponding vertices (including ones created during splitting edges). | |
void | SplitByLine (ShapeFix_SequenceOfWireSegment &seqw, const gp_Lin2d &line, const Standard_Boolean cutbyu, const Standard_Integer cutindex) |
Split edges in the sequence of wires by cutting line. Wires with FORWARD or REVERSED orientation are considered as closed. Parts of cutting line which get inside the face (defined by parity check of intersections with all wires) are added into that sequence (with orientation EXTERNAL). Each part is represented by one-edge wire segment with no 3d curve. They share common vertices with all wires they intersect. All modifications (splitting) are recorded in context, except splitting of wires marked as EXTERNAL (they are supposed to be former cutting lines). | |
void | SplitByGrid (ShapeFix_SequenceOfWireSegment &seqw) |
Split initial set of (closed) wires by grid of lines corresponding to joints between patches on the composite surface. Parts of joint lines which get inside the face are also added into the sequence as wires with orientation EXTERNAL. They share common vertices with all wires they intersect. All modifications (splitting) are recorded in context, except splitting of joint edge itself and wires marked as EXTERNAL (they supposed to be another joint edges). | |
void | BreakWires (ShapeFix_SequenceOfWireSegment &seqw) |
Break wires into open wire segments by common vertices (splitting points), so that each segment is either closed and not touching others, or touches others at ends (have common vertices). After that, each wire segment lies on its own patch of grid. | |
void | CollectWires (ShapeFix_SequenceOfWireSegment &wires, ShapeFix_SequenceOfWireSegment &seqw) |
Collect set of wire segments (already splitted) into closed wires. This is done by traversing all the segments in allowed directions, starting only from the REVERSED and FORWARD and taking EXTERNAL as necessary in fork points. Forks are detected by common vertices. In fork point, most left way is seleccted among all possible ways. | |
void | MakeFacesOnPatch (TopTools_SequenceOfShape &faces, const Handle< Geom_Surface > &surf, TopTools_SequenceOfShape &loops) const |
Creates new faces on one path of grid. It dispatches given loops (wires) into one or several faces depending on their mutual position. | |
Protected Attributes | |
TopAbs_Orientation | myOrient |
TopoDS_Shape | myResult |
Standard_Integer | myStatus |
- if ClosedMode is False (default), when splitting itself is <br> done as if surface were not periodic. The periodicity of the <br> underlying surface is taken into account by duplicating splitting <br> lines in the periodic direction, as necessary to split all <br> the wires (whole parametrical range of a face) <br> In this mode, some regularization procedures are performed <br> (indexation of splitted segments by patch numbers), and it is <br> expected to be more reliable and robust in case of bad shapes <br>
void ShapeFix_ComposeShell::BreakWires | ( | ShapeFix_SequenceOfWireSegment & | seqw | ) | [protected] |
void ShapeFix_ComposeShell::CollectWires | ( | ShapeFix_SequenceOfWireSegment & | wires, |
ShapeFix_SequenceOfWireSegment & | seqw | ||
) | [protected] |
Standard_Integer ShapeFix_ComposeShell::ComputeCode | ( | const Handle< ShapeExtend_WireData > & | wire, |
const gp_Lin2d & | line, | ||
const Standard_Integer | begInd, | ||
const Standard_Integer | endInd, | ||
const Standard_Real | begPar, | ||
const Standard_Real | endPar, | ||
const Standard_Boolean | IsInternal = Standard_False |
||
) | [protected] |
void ShapeFix_ComposeShell::DispatchWires | ( | TopTools_SequenceOfShape & | faces, |
ShapeFix_SequenceOfWireSegment & | wires | ||
) | const |
Handle_ShapeAnalysis_TransferParameters ShapeFix_ComposeShell::GetTransferParamTool | ( | ) | const |
void ShapeFix_ComposeShell::Init | ( | const Handle< ShapeExtend_CompositeSurface > & | Grid, |
const TopLoc_Location & | L, | ||
const TopoDS_Face & | Face, | ||
const Standard_Real | Prec | ||
) |
void ShapeFix_ComposeShell::LoadWires | ( | ShapeFix_SequenceOfWireSegment & | seqw | ) | const [protected] |
void ShapeFix_ComposeShell::MakeFacesOnPatch | ( | TopTools_SequenceOfShape & | faces, |
const Handle< Geom_Surface > & | surf, | ||
TopTools_SequenceOfShape & | loops | ||
) | const [protected] |
virtual Standard_Boolean ShapeFix_ComposeShell::Perform | ( | ) | [virtual] |
const TopoDS_Shape& ShapeFix_ComposeShell::Result | ( | ) | const |
void ShapeFix_ComposeShell::SetTransferParamTool | ( | const Handle< ShapeAnalysis_TransferParameters > & | TransferParam | ) |
void ShapeFix_ComposeShell::SplitByGrid | ( | ShapeFix_SequenceOfWireSegment & | seqw | ) | [protected] |
Standard_Boolean ShapeFix_ComposeShell::SplitByLine | ( | ShapeFix_WireSegment & | wire, |
const gp_Lin2d & | line, | ||
const Standard_Boolean | cutbyu, | ||
const Standard_Integer | cutindex, | ||
TColStd_SequenceOfReal & | SplitLinePar, | ||
TColStd_SequenceOfInteger & | SplitLineCode, | ||
TopTools_SequenceOfShape & | SplitLineVertex | ||
) | [protected] |
void ShapeFix_ComposeShell::SplitByLine | ( | ShapeFix_SequenceOfWireSegment & | seqw, |
const gp_Lin2d & | line, | ||
const Standard_Boolean | cutbyu, | ||
const Standard_Integer | cutindex | ||
) | [protected] |
ShapeFix_WireSegment ShapeFix_ComposeShell::SplitWire | ( | ShapeFix_WireSegment & | wire, |
TColStd_SequenceOfInteger & | indexes, | ||
const TColStd_SequenceOfReal & | values, | ||
TopTools_SequenceOfShape & | vertices, | ||
const TColStd_SequenceOfInteger & | segcodes, | ||
const Standard_Boolean | cutbyu, | ||
const Standard_Integer | cutindex | ||
) | [protected] |
Standard_Boolean ShapeFix_ComposeShell::Status | ( | const ShapeExtend_Status | status | ) | const |
TopAbs_Orientation ShapeFix_ComposeShell::myOrient [protected] |
TopoDS_Shape ShapeFix_ComposeShell::myResult [protected] |
Standard_Integer ShapeFix_ComposeShell::myStatus [protected] |