Open CASCADE Technology 6.6.0
Public Member Functions | Protected Member Functions | Protected Attributes
ShapeFix_ComposeShell Class Reference

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>

Inheritance diagram for ShapeFix_ComposeShell:
Inheritance graph
[legend]

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_BooleanClosedMode ()
 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_ShapeResult () 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

Detailed Description


Constructor & Destructor Documentation

ShapeFix_ComposeShell::ShapeFix_ComposeShell ( )

Member Function Documentation

void ShapeFix_ComposeShell::BreakWires ( ShapeFix_SequenceOfWireSegment seqw) [protected]
Standard_Boolean& ShapeFix_ComposeShell::ClosedMode ( )
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]
void ShapeFix_ComposeShell::SplitByLine ( ShapeFix_SequenceOfWireSegment seqw,
const gp_Lin2d line,
const Standard_Boolean  cutbyu,
const Standard_Integer  cutindex 
) [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::SplitEdges ( )
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

Field Documentation


The documentation for this class was generated from the following file:
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines