mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-04-07 18:30:55 +03:00
d5f74e42d6
License statement text corrected; compiler warnings caused by Bison 2.41 disabled for MSVC; a few other compiler warnings on 54-bit Windows eliminated by appropriate type cast Wrong license statements corrected in several files. Copyright and license statements added in XSD and GLSL files. Copyright year updated in some files. Obsolete documentation files removed from DrawResources.
274 lines
10 KiB
Plaintext
274 lines
10 KiB
Plaintext
-- Created on: 1995-02-22
|
|
-- Created by: Jacques GOUSSARD
|
|
-- Copyright (c) 1995-1999 Matra Datavision
|
|
-- Copyright (c) 1999-2014 OPEN CASCADE SAS
|
|
--
|
|
-- This file is part of Open CASCADE Technology software library.
|
|
--
|
|
-- This library is free software; you can redistribute it and/or modify it under
|
|
-- the terms of the GNU Lesser General Public License version 2.1 as published
|
|
-- by the Free Software Foundation, with special exception defined in the file
|
|
-- OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
|
|
-- distribution for complete text of the license and disclaimer of any warranty.
|
|
--
|
|
-- Alternatively, this file may be used under the terms of Open CASCADE
|
|
-- commercial license or contractual agreement.
|
|
|
|
class DraftAngle from BRepOffsetAPI inherits ModifyShape from BRepBuilderAPI
|
|
|
|
---Purpose: Taper-adding transformations on a shape.
|
|
-- The resulting shape is constructed by defining one face
|
|
-- to be tapered after another one, as well as the
|
|
-- geometric properties of their tapered transformation.
|
|
-- Each tapered transformation is propagated along the
|
|
-- series of faces which are tangential to one another and
|
|
-- which contains the face to be tapered.
|
|
-- This algorithm is useful in the construction of molds or
|
|
-- dies. It facilitates the removal of the article being produced.
|
|
-- A DraftAngle object provides a framework for:
|
|
-- - initializing the construction algorithm with a given shape,
|
|
-- - acquiring the data characterizing the faces to be tapered,
|
|
-- - implementing the construction algorithm, and
|
|
-- - consulting the results.
|
|
-- Warning
|
|
-- - This algorithm treats planar, cylindrical and conical faces.
|
|
-- - Do not use shapes, which with a draft angle added to
|
|
-- a face would modify the topology. This would, for
|
|
-- example, involve creation of new vertices, edges or
|
|
-- faces, or suppression of existing vertices, edges or faces.
|
|
-- - Any face, which is continuous in tangency with the
|
|
-- face to be tapered, will also be tapered. These
|
|
-- connected faces must also respect the above criteria.
|
|
|
|
|
|
uses
|
|
Shape from TopoDS,
|
|
Face from TopoDS,
|
|
ShapeModification from BRepBuilderAPI,
|
|
ListOfShape from TopTools,
|
|
Dir from gp,
|
|
Pln from gp,
|
|
ErrorStatus from Draft
|
|
|
|
raises
|
|
NotDone from StdFail,
|
|
NullObject from Standard,
|
|
NoSuchObject from Standard,
|
|
ConstructionError from Standard
|
|
|
|
is
|
|
|
|
Create
|
|
|
|
returns DraftAngle from BRepOffsetAPI;
|
|
---Purpose: Constructs an empty algorithm to perform
|
|
-- taper-adding transformations on faces of a shape.
|
|
-- Use the Init function to define the shape to be tapered.
|
|
|
|
Create(S: Shape from TopoDS)
|
|
returns DraftAngle from BRepOffsetAPI;
|
|
---Purpose: Initializes an algorithm to perform taper-adding
|
|
-- transformations on faces of the shape S.
|
|
-- S will be referred to as the initial shape of the algorithm.
|
|
|
|
Clear(me: in out)
|
|
|
|
---Purpose: Cancels the results of all taper-adding transformations
|
|
-- performed by this algorithm on the initial shape. These
|
|
-- results will have been defined by successive calls to the function Add.
|
|
is static;
|
|
|
|
|
|
Init(me: in out; S: Shape from TopoDS)
|
|
|
|
---Purpose: Initializes, or reinitializes this taper-adding algorithm with the shape S.
|
|
-- S will be referred to as the initial shape of this algorithm.
|
|
|
|
is static;
|
|
|
|
|
|
Add(me: in out; F : Face from TopoDS;
|
|
Direction : Dir from gp;
|
|
Angle : Real from Standard;
|
|
NeutralPlane: Pln from gp;
|
|
Flag : Boolean from Standard = Standard_True)
|
|
---Purpose: 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 taper-adding 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 taper-adding 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 taper-adding 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 non-empty 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 taper-adding
|
|
-- transformation and to retrieve the previous shape.
|
|
raises NullObject from Standard,
|
|
ConstructionError from Standard
|
|
is static;
|
|
|
|
|
|
AddDone(me)
|
|
|
|
---Purpose: Returns true if the previous taper-adding
|
|
-- 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 taper-adding
|
|
-- 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 non-empty constructor or the .Init function.
|
|
returns Boolean from Standard
|
|
raises NullObject from Standard
|
|
|
|
is static;
|
|
|
|
|
|
Remove(me: in out; F: Face from TopoDS)
|
|
---Purpose: Cancels the taper-adding 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 taper-adding 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 non-empty constructor or the Init function.
|
|
-- - Standard_NoSuchObject if F has not been added
|
|
-- or has already been removed.
|
|
raises NullObject from Standard,
|
|
NoSuchObject from Standard
|
|
|
|
is static;
|
|
|
|
|
|
ProblematicShape(me)
|
|
|
|
returns Shape from TopoDS
|
|
---Purpose: 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 non-empty constructor or the Init function.
|
|
---C++: return const&
|
|
raises NullObject from Standard
|
|
|
|
is static;
|
|
|
|
|
|
|
|
Status(me)
|
|
---Purpose: 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.
|
|
|
|
returns ErrorStatus from Draft
|
|
raises NullObject from Standard
|
|
-- The exception is raised if no shape has been
|
|
-- given(constructor or Init method).
|
|
|
|
is static;
|
|
|
|
|
|
ConnectedFaces(me; F: Face from TopoDS)
|
|
|
|
returns ListOfShape from TopTools
|
|
---Purpose: Returns all the faces which have been added
|
|
-- together with the face <F>.
|
|
--
|
|
---C++: return const&
|
|
|
|
raises NullObject from Standard,
|
|
-- The exception is raised if no shape has been
|
|
-- given(constructor or Init method).
|
|
NoSuchObject from Standard,
|
|
-- The exception is raised if F has not been added.
|
|
NotDone from StdFail
|
|
-- The exception is raised if AddDone returns False.
|
|
is static;
|
|
|
|
|
|
ModifiedFaces(me)
|
|
|
|
returns ListOfShape from TopTools
|
|
---Purpose: Returns all the faces on which a modification has
|
|
-- been given.
|
|
--
|
|
---C++: return const&
|
|
|
|
raises NullObject from Standard,
|
|
-- The exception is raised if no shape has been
|
|
-- given(constructor or Init method).
|
|
NotDone from StdFail
|
|
-- The exception is raised if AddDone returns False.
|
|
is static;
|
|
|
|
|
|
Build(me : in out)
|
|
|
|
---Purpose: Builds the resulting shape (redefined from MakeShape).
|
|
---Level: Public
|
|
is redefined;
|
|
|
|
CorrectWires(me : in out);
|
|
|
|
Generated (me: in out; S : Shape from TopoDS)
|
|
---Purpose: Returns the list of shapes generated from the
|
|
-- shape <S>.
|
|
---C++: return const &
|
|
---Level: Public
|
|
returns ListOfShape from TopTools
|
|
is redefined virtual;
|
|
|
|
|
|
|
|
Modified (me: in out; S : Shape from TopoDS)
|
|
---Purpose: Returns the list of shapes modified from the shape
|
|
-- <S>.
|
|
---C++: return const &
|
|
---Level: Public
|
|
returns ListOfShape from TopTools
|
|
is redefined virtual;
|
|
|
|
fields
|
|
|
|
myModifiedShapes : ListOfShape from TopTools;
|
|
|
|
end DraftAngle;
|
|
|
|
|
|
|
|
|
|
|