OCC.BRepOffsetAPI module¶

class
BRepOffsetAPI_DraftAngle
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_ModifyShape
 Constructs an empty algorithm to perform taperadding transformations on faces of a shape. Use the Init function to define the shape to be tapered.
Return type: None  Initializes an algorithm to perform taperadding transformations on faces of the shape S. S will be referred to as the initial shape of the algorithm.
Parameters: S (TopoDS_Shape &) – Return type: None 
Add
()¶  Adds the face F, the direction Direction, the angle Angle, the plane NeutralPlane, and the flag Flag to the framework created at construction time, and with this data, defines the taperadding transformation. F is a face, which belongs to the initial shape of this algorithm or to the shape loaded by the function Init. Only planar, cylindrical or conical faces can be tapered:  If the face F is planar, it is tapered by inclining it through the angle Angle about the line of intersection between the plane NeutralPlane and F. Direction indicates the side of NeutralPlane from which matter is removed if Angle is positive or added if Angle is negative.  If F is cylindrical or conical, it is transformed in the same way on a single face, resulting in a conical face if F is cylindrical, and a conical or cylindrical face if it is already conical. The taperadding transformation is propagated from the face F along the series of planar, cylindrical or conical faces containing F, which are tangential to one another. Use the function AddDone to check if this taperadding transformation is successful. Warning Nothing is done if:  the face F does not belong to the initial shape of this algorithm, or  the face F is not planar, cylindrical or conical. Exceptions  Standard_NullObject if the initial shape is not defined, i.e. if this algorithm has not been initialized with the nonempty constructor or the Init function.  Standard_ConstructionError if the previous call to Add has failed. The function AddDone ought to have been used to check for this, and the function Remove to cancel the results of the unsuccessful taperadding transformation and to retrieve the previous shape.
Parameters: Return type:

AddDone
()¶  Returns true if the previous taperadding transformation performed by this algorithm in the last call to Add, was successful. If AddDone returns false:  the function ProblematicShape returns the face on which the error occurred,  the function Remove has to be used to cancel the results of the unsuccessful taperadding transformation and to retrieve the previous shape. Exceptions Standard_NullObject if the initial shape has not been defined, i.e. if this algorithm has not been initialized with the nonempty constructor or the .Init function.
Return type: bool

Clear
()¶  Cancels the results of all taperadding transformations performed by this algorithm on the initial shape. These results will have been defined by successive calls to the function Add.
Return type: None

ConnectedFaces
()¶  Returns all the faces which have been added together with the face <F>.
Parameters: F (TopoDS_Face &) – Return type: TopTools_ListOfShape

Init
()¶  Initializes, or reinitializes this taperadding algorithm with the shape S. S will be referred to as the initial shape of this algorithm.
Parameters: S (TopoDS_Shape &) – Return type: None

ModifiedFaces
()¶  Returns all the faces on which a modification has been given.
Return type: TopTools_ListOfShape

ProblematicShape
()¶  Returns the shape on which an error occurred after an unsuccessful call to Add or when IsDone returns false. Exceptions Standard_NullObject if the initial shape has not been defined, i.e. if this algorithm has not been initialized with the nonempty constructor or the Init function.
Return type: TopoDS_Shape

Remove
()¶  Cancels the taperadding transformation previously performed by this algorithm on the face F and the series of tangential faces which contain F, and retrieves the shape before the last taperadding transformation. Warning You will have to use this function if the previous call to Add fails. Use the function AddDone to check it. Exceptions  Standard_NullObject if the initial shape has not been defined, i.e. if this algorithm has not been initialized with the nonempty constructor or the Init function.  Standard_NoSuchObject if F has not been added or has already been removed.
Parameters: F (TopoDS_Face &) – Return type: None

Status
()¶  Returns an error status when an error has occured (Face, Edge or Vertex recomputaion problem). Otherwise returns Draft_NoError. The method may be called if AddDone returns Standard_False, or when IsDone returns Standard_False.
Return type: Draft_ErrorStatus

thisown
¶ The membership flag

class
BRepOffsetAPI_FindContigousEdges
(*args)¶ Bases:
object
 Initializes an algorithm for identifying contiguous edges on shapes with tolerance as the tolerance of contiguity (defaulted to 1.0e6). This tolerance value is used to determine whether two edges or sections of edges are coincident. Use the function Add to define the shapes to be checked. Set option to false. This argument (defaulted to true) will serve in subsequent software releases for performing an analysis of degenerated shapes.
Parameters: Return type: 
Add
()¶  Adds the shape shape to the list of shapes to be checked by this algorithm. Once all the shapes to be checked have been added, use the function Perform to find the contiguous edges and the function ContigousEdge to return these edges.
Parameters: shape (TopoDS_Shape &) – Return type: None

ContigousEdge
()¶  Returns the contiguous edge of index index found by the function Perform on the shapes added to this algorithm. Exceptions Standard_OutOfRange if:  index is less than 1, or  index is greater than the number of contiguous edges found by the function Perform on the shapes added to this algorithm.
Parameters: index (int) – Return type: TopoDS_Edge

ContigousEdgeCouple
()¶  Returns a list of edges coincident with the contiguous edge of index index found by the function Perform. There are as many edges in the list as there are faces adjacent to this contiguous edge. Exceptions Standard_OutOfRange if:  index is less than 1, or  index is greater than the number of contiguous edges found by the function Perform on the shapes added to this algorithm.
Parameters: index (int) – Return type: TopTools_ListOfShape

DegeneratedShape
()¶  Gives a degenerated shape
Parameters: index (int) – Return type: TopoDS_Shape

Init
()¶  Initializes this algorithm for identifying contiguous edges on shapes using the tolerance of contiguity tolerance. This tolerance value is used to determine whether two edges or sections of edges are coincident. Use the function Add to define the shapes to be checked. Sets <option> to false.
Parameters: Return type:

IsDegenerated
()¶  Indicates if a input shape is degenerated
Parameters: shape (TopoDS_Shape &) – Return type: bool

IsModified
()¶  Returns true if the copy of the initial shape shape was modified by the function Perform (i.e. if one or more of its edges was broken down into contiguous and noncontiguous sections). Warning Returns false if shape is not one of the initial shapes added to this algorithm.
Parameters: shape (TopoDS_Shape &) – Return type: bool

Modified
()¶  Gives a modifieded shape Raises NoSuchObject if shape has not been modified
Parameters: shape (TopoDS_Shape &) – Return type: TopoDS_Shape

NbContigousEdges
()¶  Returns the number of contiguous edges found by the function Perform on the shapes added to this algorithm.
Return type: int

Perform
()¶  Finds coincident parts of edges of two or more shapes added to this algorithm and breaks down these edges into contiguous and noncontiguous sections on copies of the initial shapes. The function ContigousEdge returns contiguous edges. The function Modified can be used to return modified copies of the initial shapes where one or more edges were broken down into contiguous and noncontiguous sections. Warning This function must be used once all the shapes to be checked have been added. It is not possible to add further shapes subsequently and then to repeat the call to Perform.
Return type: None

SectionToBoundary
()¶  Returns the edge on the initial shape, of which the modified copy contains the edge section. section is coincident with a contiguous edge found by the function Perform. Use the function ContigousEdgeCouple to obtain a valid section. This information is useful for verification purposes, since it provides a means of determining the surface to which the contiguous edge belongs. Exceptions Standard_NoSuchObject if section is not coincident with a contiguous edge. Use the function ContigousEdgeCouple to obtain a valid section.
Parameters: section (TopoDS_Edge &) – Return type: TopoDS_Edge

thisown
¶ The membership flag

class
BRepOffsetAPI_MakeDraft
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_MakeShape
 Constructs the draft surface object defined by the shape Shape, the direction Dir, and the angle Angle. Shape must be a TopoDS_Wire, Topo_DS_Face or TopoDS_Shell with free boundaries. Exceptions Standard_NotDone if Shape is not a TopoDS_Wire, Topo_DS_Face or TopoDS_Shell with free boundaries.
Parameters: Return type: 
Perform
()¶  Performs the draft using the length LengthMax as the maximum length for the corner edge between two draft faces.
Parameters: LengthMax (float) – Return type: None  Performs the draft up to the surface Surface. If KeepInsideSurface is true, the part of Surface inside the draft is kept in the result.
Parameters:  Surface (Handle_Geom_Surface &) –
 KeepInsideSurface (bool) – default value is Standard_True
Return type:  Performs the draft up to the shape StopShape. If KeepOutSide is true, the part of StopShape which is outside the Draft is kept in the result.
Parameters:  StopShape (TopoDS_Shape &) –
 KeepOutSide (bool) – default value is Standard_True
Return type:

SetDraft
()¶  Sets the direction of the draft for this object. If IsInternal is true, the draft is internal to the argument Shape used in the constructor.
Parameters: IsInternal (bool) – default value is Standard_False Return type: None

SetOptions
()¶  Sets the options of this draft tool. If a transition has to be performed, it can be defined by the mode Style as RightCorner or RoundCorner, RightCorner being a corner defined by a sharp angle, and RoundCorner being a rounded corner. AngleMin is an angular tolerance used to detect whether a transition has to be performed or not. AngleMax sets the maximum value within which a RightCorner transition can be performed. AngleMin and AngleMax are expressed in radians.
Parameters: Return type:

Shell
()¶  Returns the shell resulting from performance of the draft along the wire.
Return type: TopoDS_Shell

thisown
¶ The membership flag

class
BRepOffsetAPI_MakeEvolved
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_MakeShape
Return type: Parameters: Return type:  These constructors construct an evolved shape by sweeping the profile Profile along the spine Spine. The profile is defined in a coordinate system R. The coordinate system is determined by AxeProf:  if AxeProf is true, R is the global coordinate system,  if AxeProf is false, R is computed so that:  its origin is given by the point on the spine which is closest to the profile,  its ‘X Axis’ is given by the tangent to the spine at this point, and  its ‘Z Axis’ is the normal to the plane which contains the spine. The position of the profile at the current point of the spine is given by making R coincident with the local coordinate system given by the current point, the tangent vector and the normal to the spine. Join defines the type of pipe generated by the salient vertices of the spine. The default type is GeomAbs_Arc where the vertices generate revolved pipes about the axis passing along the vertex and the normal to the plane of the spine. At present, this is the only construction type implemented.
Parameters: Return type: 
Bottom
()¶  Return the face Bottom if <Solid> is True in the constructor.
Return type: TopoDS_Shape

Evolved
()¶ Return type: BRepFill_Evolved

GeneratedShapes
()¶  Returns the shapes created from a subshape <SpineShape> of the spine and a subshape <ProfShape> on the profile.
Parameters:  SpineShape (TopoDS_Shape &) –
 ProfShape (TopoDS_Shape &) –
Return type:

Top
()¶  Return the face Top if <Solid> is True in the constructor.
Return type: TopoDS_Shape

thisown
¶ The membership flag

class
BRepOffsetAPI_MakeFilling
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_MakeShape
 Constructs a wire filling object defined by  the energy minimizing criterion Degree  the number of points on the curve NbPntsOnCur  the number of iterations NbIter  the Boolean Anisotropie  the 2D tolerance Tol2d  the 3D tolerance Tol3d  the angular tolerance TolAng  the tolerance for curvature TolCur  the highest polynomial degree MaxDeg  the greatest number of segments MaxSeg. If the Boolean Anistropie is true, the algorithm’s performance is better in cases where the ratio of the length U and the length V indicate a great difference between the two. In other words, when the surface is, for example, extremely long.
Parameters:  Degree (int) – default value is 3
 NbPtsOnCur (int) – default value is 15
 NbIter (int) – default value is 2
 Anisotropie (bool) – default value is Standard_False
 Tol2d (float) – default value is 0.00001
 Tol3d (float) – default value is 0.0001
 TolAng (float) – default value is 0.01
 TolCurv (float) – default value is 0.1
 MaxDeg (int) – default value is 8
 MaxSegments (int) – default value is 9
Return type: 
Add
()¶  Adds a new constraint which also defines an edge of the wire of the face Order: Order of the constraint: GeomAbs_C0 : the surface has to pass by 3D representation of the edge GeomAbs_G1 : the surface has to pass by 3D representation of the edge and to respect tangency with the first face of the edge GeomAbs_G2 : the surface has to pass by 3D representation of the edge and to respect tangency and curvature with the first face of the edge. Raises ConstructionError if the edge has no representation on a face and Order is GeomAbs_G1 or GeomAbs_G2.
Parameters:  Constr (TopoDS_Edge &) –
 Order (GeomAbs_Shape) –
 IsBound (bool) – default value is Standard_True
Return type:  Adds a new constraint which also defines an edge of the wire of the face Order: Order of the constraint: GeomAbs_C0 : the surface has to pass by 3D representation of the edge GeomAbs_G1 : the surface has to pass by 3D representation of the edge and to respect tangency with the given face GeomAbs_G2 : the surface has to pass by 3D representation of the edge and to respect tangency and curvature with the given face. Raises ConstructionError if the edge has no 2d representation on the given face
Parameters:  Constr (TopoDS_Edge &) –
 Support (TopoDS_Face &) –
 Order (GeomAbs_Shape) –
 IsBound (bool) – default value is Standard_True
Return type:  Adds a free constraint on a face. The corresponding edge has to be automatically recomputed. It is always a bound.
Parameters:  Support (TopoDS_Face &) –
 Order (GeomAbs_Shape) –
Return type:  Adds a punctual constraint.
Parameters: Point (gp_Pnt) – Return type: int  Adds a punctual constraint.
Parameters: Return type:

G0Error
()¶  Returns the maximum distance between the result and the constraints. This is set at construction time.
Return type: float  Returns the maximum distance attained between the result and the constraint Index. This is set at construction time.
Parameters: Index (int) – Return type: float

G1Error
()¶  Returns the maximum angle between the result and the constraints. This is set at construction time.
Return type: float  Returns the maximum angle between the result and the constraints. This is set at construction time.
Parameters: Index (int) – Return type: float

G2Error
()¶  Returns the maximum angle between the result and the constraints. This is set at construction time.
Return type: float  Returns the greatest difference in curvature found between the result and the constraint Index.
Parameters: Index (int) – Return type: float

LoadInitSurface
()¶  Loads the initial surface Surf to begin the construction of the surface. This optional function is useful if the surface resulting from construction for the algorithm is likely to be complex. The support surface of the face under construction is computed by a deformation of Surf which satisfies the given constraints. The set of bounding edges defines the wire of the face. If no initial surface is given, the algorithm computes it automatically. If the set of edges is not connected (Free constraint), missing edges are automatically computed. Important: the initial surface must have orthogonal local coordinates, i.e. partial derivatives dS/du and dS/dv must be orthogonal at each point of surface. If this condition breaks, distortions of resulting surface are possible.
Parameters: Surf (TopoDS_Face &) – Return type: None

SetApproxParam
()¶  Sets the parameters used to approximate the filling surface. These include:  MaxDeg  the highest degree which the polynomial defining the filling surface can have  MaxSegments  the greatest number of segments which the filling surface can have.
Parameters: Return type:

SetConstrParam
()¶  Sets the values of Tolerances used to control the constraint. Tol2d: Tol3d: it is the maximum distance allowed between the support surface and the constraints TolAng: it is the maximum angle allowed between the normal of the surface and the constraints TolCurv: it is the maximum difference of curvature allowed between the surface and the constraint
Parameters: Return type:

SetResolParam
()¶  Sets the parameters used for resolution. The default values of these parameters have been chosen for a good ratio quality/performance. Degree: it is the order of energy criterion to minimize for computing the deformation of the surface. The default value is 3 The recommanded value is i+2 where i is the maximum order of the constraints. NbPtsOnCur: it is the average number of points for discretisation of the edges. NbIter: it is the maximum number of iterations of the process. For each iteration the number of discretisation points is increased. Anisotropie:
Parameters: Return type:

thisown
¶ The membership flag

class
BRepOffsetAPI_MakeOffset
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_MakeShape
 Constructs an algorithm for creating an empty offset
Return type: None  Constructs an algorithm for creating an algorithm to build parallels to the spine Spine
Parameters:  Spine (TopoDS_Wire &) –
 Join (GeomAbs_JoinType) – default value is GeomAbs_Arc
 IsOpenResult (bool) – default value is Standard_False
 Spine –
 Join – default value is GeomAbs_Arc
 IsOpenResult – default value is Standard_False
Return type: Return type: 
AddWire
()¶  Initializes the algorithm to construct parallels to the wire Spine.
Parameters: Spine (TopoDS_Wire &) – Return type: None

Init
()¶  Initializes the algorithm to construct parallels to the spine Spine. Join defines the type of parallel generated by the salient vertices of the spine. The default type is GeomAbs_Arc where the vertices generate sections of a circle. If join type is GeomAbs_Intersection, the edges that intersect in a salient vertex generate the edges prolonged until intersection.
Parameters:  Spine (TopoDS_Face &) –
 Join (GeomAbs_JoinType) – default value is GeomAbs_Arc
 IsOpenResult (bool) – default value is Standard_False
Return type:  Initialize the evaluation of Offseting.
Parameters:  Join (GeomAbs_JoinType) – default value is GeomAbs_Arc
 IsOpenResult (bool) – default value is Standard_False
Return type:

Perform
()¶  Computes a parallel to the spine at distance Offset and at an altitude Alt from the plane of the spine in relation to the normal to the spine. Exceptions: StdFail_NotDone if the offset is not built.
Parameters: Return type:

thisown
¶ The membership flag

class
BRepOffsetAPI_MakeOffsetShape
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_MakeShape
Return type: None  Constructs a shape parallel to the shape S, where  S may be a face, a shell, a solid or a compound of these shape kinds;  Offset is the offset value. The offset shape is constructed:  outside S, if Offset is positive,  inside S, if Offset is negative;  Tol defines the coincidence tolerance criterion for generated shapes;  Mode defines the construction type of parallels applied to the free edges of shape S; currently, only one construction type is implemented, namely the one where the free edges do not generate parallels; this corresponds to the default value BRepOffset_Skin;  Intersection specifies how the algorithm must work in order to limit the parallels to two adjacent shapes:  if Intersection is false (default value), the intersection is calculated with the parallels to the two adjacent shapes,  if Intersection is true, the intersection is calculated by taking all generated parallels into account; this computation method is more general as it avoids some selfintersections generated in the offset shape from features of small dimensions on shape S, however this method has not been completely implemented and therefore is not recommended for use;  SelfInter tells the algorithm whether a computation to eliminate selfintersections must be applied to the resulting shape; however, as this functionality is not yet implemented, it is recommended to use the default value (false);  Join defines how to fill the holes that may appear between parallels to the two adjacent faces. It may take values GeomAbs_Arc or GeomAbs_Intersection:  if Join is equal to GeomAbs_Arc, then pipes are generated between two free edges of two adjacent parallels, and spheres are generated on ‘images’ of vertices; it is the default value,  if Join is equal to GeomAbs_Intersection, then the parallels to the two adjacent faces are enlarged and intersected, so that there are no free edges on parallels to faces. Warnings 1. All the faces of the shape S should be based on the surfaces with continuity at least C1. 2. The offset value should be sufficiently small to avoid selfintersections in resulting shape. Otherwise these selfintersections may appear inside an offset face if its initial surface is not plane or sphere or cylinder, also some nonadjacent offset faces may intersect each other. Also, some offset surfaces may ‘turn inside out’. 3. The algorithm may fail if the shape S contains vertices where more than 3 edges converge. 4. Since 3doffset algorithm involves intersection of surfaces, it is under limitations of surface intersection algorithm. 5. A result cannot be generated if the underlying geometry of S is BSpline with continuity C0. Exceptions Geom_UndefinedDerivative if the underlying geometry of S is BSpline with continuity C0.
Parameters: Return type: 
GeneratedEdge
()¶  Returns the list of edges generated from the shape <S>.
Parameters: S (TopoDS_Shape &) – Return type: TopTools_ListOfShape

GetJoinType
()¶  Returns offset join type.
Return type: GeomAbs_JoinType

MakeOffset
()¶ Return type: BRepOffset_MakeOffset

thisown
¶ The membership flag

class
BRepOffsetAPI_MakePipe
(*args)¶ Bases:
OCC.BRepPrimAPI.BRepPrimAPI_MakeSweep
 Constructs a pipe by sweeping the shape Profile along the wire Spine.The angle made by the spine with the profile is maintained along the length of the pipe. Warning Spine must be G1 continuous; that is, on the connection vertex of two edges of the wire, the tangent vectors on the left and on the right must have the same direction, though not necessarily the same magnitude. Exceptions Standard_DomainError if the profile is a solid or a composite solid.
Parameters:  Spine (TopoDS_Wire &) –
 Profile (TopoDS_Shape &) –
Return type:  the same as previous but with setting of mode of sweep and the flag that indicates attempt to approximate a C1continuous surface if a swept surface proved to be C0.
Parameters:  Spine (TopoDS_Wire &) –
 Profile (TopoDS_Shape &) –
 aMode (GeomFill_Trihedron) –
 ForceApproxC1 (bool) – default value is Standard_False
Return type: 
Generated
()¶ Parameters:  SSpine (TopoDS_Shape &) –
 SProfile (TopoDS_Shape &) –
Return type:

Pipe
()¶ Return type: BRepFill_Pipe

thisown
¶ The membership flag

class
BRepOffsetAPI_MakePipeShell
(*args)¶ Bases:
OCC.BRepPrimAPI.BRepPrimAPI_MakeSweep
 Constructs the shellgenerating framework defined by the wire Spine. Sets an sweep’s mode If no mode are setted, the mode use in MakePipe is used
Parameters: Spine (TopoDS_Wire &) – Return type: None 
Add
()¶  Adds the section Profile to this framework. First and last sections may be punctual, so the shape Profile may be both wire and vertex. Correspondent point on spine is computed automatically. If WithContact is true, the section is translated to be in contact with the spine. If WithCorrection is true, the section is rotated to be orthogonal to the spine?s tangent in the correspondent point. This option has no sense if the section is punctual (Profile is of type TopoDS_Vertex).
Parameters: Return type:  Adds the section Profile to this framework. Correspondent point on the spine is given by Location. Warning: To be effective, it is not recommended to combine methods Add and SetLaw.
Parameters: Return type:

Delete
()¶  Removes the section Profile from this framework.
Parameters: Profile (TopoDS_Shape &) – Return type: None

GetStatus
()¶  Get a status, when Simulate or Build failed. It can be BRepBuilderAPI_PipeDone, BRepBuilderAPI_PipeNotDone, BRepBuilderAPI_PlaneNotIntersectGuide, BRepBuilderAPI_ImpossibleContact.
Return type: BRepBuilderAPI_PipeError

IsReady
()¶  Returns true if this tool object is ready to build the shape, i.e. has a definition for the wire section Profile.
Return type: bool

MakeSolid
()¶  Transforms the sweeping Shell in Solid. If a propfile is not closed returns False
Return type: bool

SetForceApproxC1
()¶  Set the flag that indicates attempt to approximate a C1continuous surface if a swept surface proved to be C0.
Parameters: ForceApproxC1 (bool) – Return type: None

SetLaw
()¶  Sets the evolution law defined by the wire Profile with its position (Location, WithContact, WithCorrection are the same options as in methods Add) and a homotetic law defined by the function L. Warning: To be effective, it is not recommended to combine methods Add and SetLaw.
Parameters: Return type:  Sets the evolution law defined by the wire Profile with its position (Location, WithContact, WithCorrection are the same options as in methods Add) and a homotetic law defined by the function L. Warning: To be effective, it is not recommended to combine methods Add and SetLaw.
Parameters: Return type:

SetMaxDegree
()¶  Define the maximum V degree of resulting surface
Parameters: NewMaxDegree (int) – Return type: None

SetMaxSegments
()¶  Define the maximum number of spans in Vdirection on resulting surface
Parameters: NewMaxSegments (int) – Return type: None

SetMode
()¶  Sets a Frenet or a CorrectedFrenet trihedron to perform the sweeping If IsFrenet is false, a corrected Frenet trihedron is used.
Parameters: IsFrenet (bool) – default value is Standard_False Return type: None  Sets a fixed trihedron to perform the sweeping all sections will be parallel.
Parameters: Axe (gp_Ax2) – Return type: None  Sets a fixed BiNormal direction to perform the – sweeping. Angular relations beetween the section(s) and <BiNormal> will be constant
Parameters: BiNormal (gp_Dir) – Return type: None  Sets support to the spine to define the BiNormal of the trihedron, like the normal to the surfaces. Warning: To be effective, Each edge of the <spine> must have an representaion on one face of<SpineSupport>
Parameters: SpineSupport (TopoDS_Shape &) – Return type: bool  Sets an auxiliary spine to define the Normal For each Point of the Spine P, an Point Q is evalued on <AuxiliarySpine> If <CurvilinearEquivalence> Q split <AuxiliarySpine> with the same length ratio than P split <Spline>. Else the plan define by P and the tangent to the <Spine> intersect <AuxiliarySpine> in Q. If <KeepContact> equals BRepFill_NoContact: The Normal is defined by the vector PQ. If <KeepContact> equals BRepFill_Contact: The Normal is defined to achieve that the sweeped section is in contact to the auxiliarySpine. The width of section is constant all along the path. In other words, the auxiliary spine lies on the swept surface, but not necessarily is a boundary of this surface. However, the auxiliary spine has to be close enough to the main spine to provide intersection with any section all along the path. If <KeepContact> equals BRepFill_ContactOnBorder: The auxiliary spine becomes a boundary of the swept surface and the width of section varies along the path. Give section to sweep. Possibilities are :  Give one or sevral section  Give one profile and an homotetic law.  Automatic compute of correspondance beetween spine, and section on the sweeped shape  correspondance beetween spine, and section on the sweeped shape defined by a vertex of the spine
Parameters:  AuxiliarySpine (TopoDS_Wire &) –
 CurvilinearEquivalence (bool) –
 KeepContact (BRepFill_TypeOfContact) – default value is BRepFill_NoContact
Return type:

SetTolerance
()¶  Sets the following tolerance values  3D tolerance Tol3d  boundary tolerance BoundTol  angular tolerance TolAngular.
Parameters: Return type:

SetTransitionMode
()¶  Sets the transition mode to manage discontinuities on the swept shape caused by fractures on the spine. The transition mode can be BRepBuilderAPI_Transformed (default value), BRepBuilderAPI_RightCorner, BRepBuilderAPI_RoundCorner:  RepBuilderAPI_Transformed: discontinuities are treated by modification of the sweeping mode. The pipe is ‘transformed’ at the fractures of the spine. This mode assumes building a selfintersected shell.  BRepBuilderAPI_RightCorner: discontinuities are treated like right corner. Two pieces of the pipe corresponding to two adjacent segments of the spine are extended and intersected at a fracture of the spine.  BRepBuilderAPI_RoundCorner: discontinuities are treated like round corner. The corner is treated as rotation of the profile around an axis which passes through the point of the spine?s fracture. This axis is based on cross product of directions tangent to the adjacent segments of the spine at their common point. Warnings The mode BRepBuilderAPI_RightCorner provides a valid result if intersection of two pieces of the pipe (corresponding to two adjacent segments of the spine) in the neighborhood of the spine?s fracture is connected and planar. This condition can be violated if the spine is nonlinear in some neighborhood of the fracture or if the profile was set with a scaling law. The last mode, BRepBuilderAPI_RoundCorner, will assuredly provide a good result only if a profile was set with option WithCorrection = True, i.e. it is strictly orthogonal to the spine.
Parameters: Mode (BRepBuilderAPI_TransitionMode) – default value is BRepBuilderAPI_Transformed Return type: None

Simulate
()¶  Simulates the resulting shape by calculating its crosssections. The spine is devided by this crosssections into (NumberOfSection  1) equal parts, the number of crosssections is NumberOfSection. The crosssections are wires and they are returned in the list Result. This gives a rapid preview of the resulting shape, which will be obtained using the settings you have provided. Raises NotDone if <self> it is not Ready
Parameters:  NumberOfSection (int) –
 Result (TopTools_ListOfShape &) –
Return type:

thisown
¶ The membership flag

class
BRepOffsetAPI_MakeThickSolid
(*args)¶ Bases:
OCC.BRepOffsetAPI.BRepOffsetAPI_MakeOffsetShape
Return type: None  Constructs a hollowed solid from the solid S by removing the set of faces ClosingFaces from S, where: Offset defines the thickness of the walls. Its sign indicates which side of the surface of the solid the hollowed shape is built on;  Tol defines the tolerance criterion for coincidence in generated shapes;  Mode defines the construction type of parallels applied to free edges of shape S. Currently, only one construction type is implemented, namely the one where the free edges do not generate parallels; this corresponds to the default value BRepOffset_Skin; Intersection specifies how the algorithm must work in order to limit the parallels to two adjacent shapes:  if Intersection is false (default value), the intersection is calculated with the parallels to the two adjacent shapes,  if Intersection is true, the intersection is calculated by taking account of all parallels generated; this computation method is more general as it avoids selfintersections generated in the offset shape from features of small dimensions on shape S, however this method has not been completely implemented and therefore is not recommended for use;  SelfInter tells the algorithm whether a computation to eliminate selfintersections needs to be applied to the resulting shape. However, as this functionality is not yet implemented, you should use the default value (false);  Join defines how to fill the holes that may appear between parallels to the two adjacent faces. It may take values GeomAbs_Arc or GeomAbs_Intersection:  if Join is equal to GeomAbs_Arc, then pipes are generated between two free edges of two adjacent parallels, and spheres are generated on ‘images’ of vertices; it is the default value,  if Join is equal to GeomAbs_Intersection, then the parallels to the two adjacent faces are enlarged and intersected, so that there are no free edges on parallels to faces. Warnings Since the algorithm of MakeThickSolid is based on MakeOffsetShape algorithm, the warnings are the same as for MakeOffsetShape.
Parameters:  S (TopoDS_Shape &) –
 ClosingFaces (TopTools_ListOfShape &) –
 Offset (float) –
 Tol (float) –
 Mode (BRepOffset_Mode) – default value is BRepOffset_Skin
 Intersection (bool) – default value is Standard_False
 SelfInter (bool) – default value is Standard_False
 Join (GeomAbs_JoinType) – default value is GeomAbs_Arc
Return type: 
thisown
¶ The membership flag

class
BRepOffsetAPI_MiddlePath
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_MakeShape
 General constructor. StartShape and EndShape may be a wire or a face
Parameters:  aShape (TopoDS_Shape &) –
 StartShape (TopoDS_Shape &) –
 EndShape (TopoDS_Shape &) –
Return type: 
thisown
¶ The membership flag

class
BRepOffsetAPI_NormalProjection
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_MakeShape
 Constructs an empty framework to define projection on a shape according to the normal from each point to be projected to the shape.
Return type: None  Constructs a framework to define projection onto the basis shape S according to the normal from each point to be projected from the shape added to this framework by Add. Default parameters of the algorithm: Tol3D = 1.e04, Tol2D =sqr(tol3d) , InternalContinuity = GeomAbs_C2, MaxDegree = 14, MaxSeg = 16.
Parameters: S (TopoDS_Shape &) – Return type: None 
Add
()¶  Adds the shape ToProj to the framework for calculation of the projection by Compute3d. ToProj is an edge or a wire and will be projected onto the basis shape. Exceptions Standard_ConstructionError if ToProj is not added.
Parameters: ToProj (TopoDS_Shape &) – Return type: None

Ancestor
()¶  Returns the initial edge corresponding to the edge E resulting from the computation of the projection. Exceptions StdFail_NotDone if no edge was found. Standard_NoSuchObject if an edge corresponding to E has already been found.
Parameters: E (TopoDS_Edge &) – Return type: TopoDS_Shape

BuildWire
()¶  build the result as a list of wire if possible in – a first returns a wire only if there is only a wire.
Parameters: Liste (TopTools_ListOfShape &) – Return type: bool

Compute3d
()¶  Returns true if a 3D curve is computed. If not, false is returned and an initial 3D curve is kept to build the resulting edges.
Parameters: With3d (bool) – default value is Standard_True Return type: None

Couple
()¶  Returns the initial face corresponding to the projected edge E. Exceptions StdFail_NotDone if no face was found. Standard_NoSuchObject if if a face corresponding to E has already been found.
Parameters: E (TopoDS_Edge &) – Return type: TopoDS_Shape

Init
()¶  Initializes the empty constructor framework with the shape S.
Parameters: S (TopoDS_Shape &) – Return type: None

Projection
()¶  Performs the projection. The construction of the result is performed by Build. Exceptions StdFail_NotDone if the projection was not performed.
Return type: TopoDS_Shape

SetLimit
()¶  Manage limitation of projected edges.
Parameters: FaceBoundaries (bool) – default value is Standard_True Return type: None

SetMaxDistance
()¶  Sets the maximum distance between target shape and shape to project. If this condition is not satisfied then corresponding part of solution is discarded. if MaxDist < 0 then this method does not affect the algorithm
Parameters: MaxDist (float) – Return type: None

SetParams
()¶  Sets the parameters used for computation Tol3 is the requiered tolerance between the 3d projected curve and its 2d representation InternalContinuity is the order of constraints used for approximation MaxDeg and MaxSeg are the maximum degree and the maximum number of segment for BSpline resulting of an approximation.
Parameters: Return type:

thisown
¶ The membership flag

class
BRepOffsetAPI_SequenceNodeOfSequenceOfSequenceOfReal
(*args)¶ Bases:
OCC.TCollection.TCollection_SeqNode
Parameters:  I (TColStd_SequenceOfReal &) –
 n (TCollection_SeqNodePtr &) –
 p (TCollection_SeqNodePtr &) –
Return type: 
GetHandle
()¶

Value
()¶ Return type: TColStd_SequenceOfReal

thisown
¶ The membership flag

class
BRepOffsetAPI_SequenceNodeOfSequenceOfSequenceOfShape
(*args)¶ Bases:
OCC.TCollection.TCollection_SeqNode
Parameters:  I (TopTools_SequenceOfShape &) –
 n (TCollection_SeqNodePtr &) –
 p (TCollection_SeqNodePtr &) –
Return type: 
GetHandle
()¶

Value
()¶ Return type: TopTools_SequenceOfShape

thisown
¶ The membership flag

class
BRepOffsetAPI_SequenceOfSequenceOfReal
(*args)¶ Bases:
OCC.TCollection.TCollection_BaseSequence
Return type: None Parameters: Other (BRepOffsetAPI_SequenceOfSequenceOfReal &) – Return type: None 
Append
()¶ Parameters:  T (TColStd_SequenceOfReal &) –
 S (BRepOffsetAPI_SequenceOfSequenceOfReal &) –
Return type: Return type:

Assign
()¶ Parameters: Other (BRepOffsetAPI_SequenceOfSequenceOfReal &) – Return type: BRepOffsetAPI_SequenceOfSequenceOfReal

ChangeValue
()¶ Parameters: Index (int) – Return type: TColStd_SequenceOfReal

First
()¶ Return type: TColStd_SequenceOfReal

InsertAfter
()¶ Parameters:  Index (int) –
 T (TColStd_SequenceOfReal &) –
 Index –
 S (BRepOffsetAPI_SequenceOfSequenceOfReal &) –
Return type: Return type:

InsertBefore
()¶ Parameters:  Index (int) –
 T (TColStd_SequenceOfReal &) –
 Index –
 S (BRepOffsetAPI_SequenceOfSequenceOfReal &) –
Return type: Return type:

Last
()¶ Return type: TColStd_SequenceOfReal

Prepend
()¶ Parameters:  T (TColStd_SequenceOfReal &) –
 S (BRepOffsetAPI_SequenceOfSequenceOfReal &) –
Return type: Return type:

Remove
()¶ Parameters: Return type: Return type:

Set
()¶ Parameters: Other (BRepOffsetAPI_SequenceOfSequenceOfReal &) – Return type: BRepOffsetAPI_SequenceOfSequenceOfReal

Value
()¶ Parameters: Index (int) – Return type: TColStd_SequenceOfReal

thisown
¶ The membership flag


class
BRepOffsetAPI_SequenceOfSequenceOfShape
(*args)¶ Bases:
OCC.TCollection.TCollection_BaseSequence
Return type: None Parameters: Other (BRepOffsetAPI_SequenceOfSequenceOfShape &) – Return type: None 
Append
()¶ Parameters:  T (TopTools_SequenceOfShape &) –
 S (BRepOffsetAPI_SequenceOfSequenceOfShape &) –
Return type: Return type:

Assign
()¶ Parameters: Other (BRepOffsetAPI_SequenceOfSequenceOfShape &) – Return type: BRepOffsetAPI_SequenceOfSequenceOfShape

ChangeValue
()¶ Parameters: Index (int) – Return type: TopTools_SequenceOfShape

First
()¶ Return type: TopTools_SequenceOfShape

InsertAfter
()¶ Parameters:  Index (int) –
 T (TopTools_SequenceOfShape &) –
 Index –
 S (BRepOffsetAPI_SequenceOfSequenceOfShape &) –
Return type: Return type:

InsertBefore
()¶ Parameters:  Index (int) –
 T (TopTools_SequenceOfShape &) –
 Index –
 S (BRepOffsetAPI_SequenceOfSequenceOfShape &) –
Return type: Return type:

Last
()¶ Return type: TopTools_SequenceOfShape

Prepend
()¶ Parameters:  T (TopTools_SequenceOfShape &) –
 S (BRepOffsetAPI_SequenceOfSequenceOfShape &) –
Return type: Return type:

Remove
()¶ Parameters: Return type: Return type:

Set
()¶ Parameters: Other (BRepOffsetAPI_SequenceOfSequenceOfShape &) – Return type: BRepOffsetAPI_SequenceOfSequenceOfShape

Value
()¶ Parameters: Index (int) – Return type: TopTools_SequenceOfShape

thisown
¶ The membership flag


class
BRepOffsetAPI_ThruSections
(*args)¶ Bases:
OCC.BRepBuilderAPI.BRepBuilderAPI_MakeShape
 Initializes an algorithm for building a shell or a solid passing through a set of sections, where:  isSolid is set to true if the construction algorithm is required to build a solid or to false if it is required to build a shell (the default value),  ruled is set to true if the faces generated between the edges of two consecutive wires are ruled surfaces or to false (the default value) if they are smoothed out by approximation,  pres3d defines the precision criterion used by the approximation algorithm; the default value is 1.0e6. Use AddWire and AddVertex to define the successive sections of the shell or solid to be built.
Parameters: Return type: 
AddVertex
()¶  Adds the vertex Vertex (punctual section) to the set of sections through which the shell or solid is built. A vertex may be added to the set of sections only as first or last section. At least one wire must be added to the set of sections by the method AddWire. Use the Build function to construct the shape.
Parameters: aVertex (TopoDS_Vertex &) – Return type: None

AddWire
()¶  Adds the wire wire to the set of sections through which the shell or solid is built. Use the Build function to construct the shape.
Parameters: wire (TopoDS_Wire &) – Return type: None

Continuity
()¶  returns the Continuity used in the approximation
Return type: GeomAbs_Shape

CriteriumWeight
()¶  returns the Weights associed to the criterium used in the optimization.
Parameters:  W1 (float &) –
 W2 (float &) –
 W3 (float &) –
Return type:

FirstShape
()¶  Returns the TopoDS Shape of the bottom of the loft if solid
Return type: TopoDS_Shape

GeneratedFace
()¶  if Ruled Returns the Face generated by each edge except the last wire if smoothed Returns the Face generated by each edge of the first wire
Parameters: Edge (TopoDS_Shape &) – Return type: TopoDS_Shape

Init
()¶  Initializes this algorithm for building a shell or a solid passing through a set of sections, where:  isSolid is set to true if this construction algorithm is required to build a solid or to false if it is required to build a shell. false is the default value;  ruled is set to true if the faces generated between the edges of two consecutive wires are ruled surfaces or to false (the default value) if they are smoothed out by approximation,  pres3d defines the precision criterion used by the approximation algorithm; the default value is 1.0e6. Use AddWire and AddVertex to define the successive sections of the shell or solid to be built.
Parameters: Return type:

LastShape
()¶  Returns the TopoDS Shape of the top of the loft if solid
Return type: TopoDS_Shape

ParType
()¶  returns the type of parametrization used in the approximation
Return type: Approx_ParametrizationType

SetContinuity
()¶  Define the Continuity used in the approximation
Parameters: C (GeomAbs_Shape) – Return type: None

SetCriteriumWeight
()¶  define the Weights associed to the criterium used in the optimization. //! if Wi <= 0
Parameters: Return type:

SetMaxDegree
()¶  Define the maximal U degree of result surface
Parameters: MaxDeg (int) – Return type: None

SetParType
()¶  Define the type of parametrization used in the approximation
Parameters: ParType (Approx_ParametrizationType) – Return type: None

SetSmoothing
()¶  Define the approximation algorithm
Parameters: UseSmoothing (bool) – Return type: None

thisown
¶ The membership flag

class
Handle_BRepOffsetAPI_SequenceNodeOfSequenceOfSequenceOfReal
(*args)¶ Bases:
OCC.TCollection.Handle_TCollection_SeqNode

static
DownCast
()¶

GetObject
()¶

IsNull
()¶

Nullify
()¶

thisown
¶ The membership flag

static

class
Handle_BRepOffsetAPI_SequenceNodeOfSequenceOfSequenceOfShape
(*args)¶ Bases:
OCC.TCollection.Handle_TCollection_SeqNode

static
DownCast
()¶

GetObject
()¶

IsNull
()¶

Nullify
()¶

thisown
¶ The membership flag

static

class
SwigPyIterator
(*args, **kwargs)¶ Bases:
object

advance
()¶

copy
()¶

decr
()¶

distance
()¶

equal
()¶

incr
()¶

next
()¶

previous
()¶

thisown
¶ The membership flag

value
()¶


register_handle
(handle, base_object)¶ Inserts the handle into the base object to prevent memory corruption in certain cases