1 -- File: BRepPrimAPI_MakeCone.cdl
2 -- Created: Wed Jul 21 16:07:30 1993
3 -- Author: Remi LEQUETTE
5 ---Copyright: Matra Datavision 1993
8 class MakeCone from BRepPrimAPI inherits MakeOneAxis from BRepPrimAPI
10 ---Purpose: Describes functions to build cones or portions of cones.
11 -- A MakeCone object provides a framework for:
12 -- - defining the construction of a cone,
13 -- - implementing the construction algorithm, and
14 -- - consulting the result.
22 DomainError from Standard
25 Create(R1, R2, H : Real)
26 returns MakeCone from BRepPrimAPI
27 ---Purpose: Make a cone of height H radius R1 in the plane z =
28 -- 0, R2 in the plane Z = H. R1 and R2 may be null.
31 DomainError from Standard; -- if H <= Precision::Confusion()
33 Create(R1, R2, H, angle : Real)
34 returns MakeCone from BRepPrimAPI
35 ---Purpose: Make a cone of height H radius R1 in the plane z =
36 -- 0, R2 in the plane Z = H. R1 and R2 may be null.
37 -- Take a section of <angle>
40 DomainError from Standard; -- if H <= Precision::Confusion()
42 Create(Axes : Ax2 from gp; R1, R2, H : Real)
43 returns MakeCone from BRepPrimAPI
44 ---Purpose: Make a cone of height H radius R1 in the plane z =
45 -- 0, R2 in the plane Z = H. R1 and R2 may be null.
48 DomainError from Standard; -- if H <= Precision::Confusion()
50 Create(Axes : Ax2 from gp; R1, R2, H, angle : Real)
51 returns MakeCone from BRepPrimAPI
52 ---Purpose: Make a cone of height H radius R1 in the plane z =
53 -- 0, R2 in the plane Z = H. R1 and R2 may be null.
54 -- Take a section of <angle>
57 DomainError from Standard; -- if H <= Precision::Confusion()
59 ---Purpose: Constructs a cone, or a portion of a cone, of height H,
60 -- and radius R1 in the plane z = 0 and R2 in the plane
61 -- z = H. The result is a sharp cone if R1 or R2 is equal to 0.
62 -- The cone is constructed about the "Z Axis" of either:
63 -- - the global coordinate system, or
64 -- - the local coordinate system Axes.
65 -- It is limited in these coordinate systems as follows:
66 -- - in the v parametric direction (the Z coordinate), by
67 -- the two parameter values 0 and H,
68 -- - and in the u parametric direction (defined by the
69 -- angle of rotation around the Z axis), in the case of a
70 -- portion of a cone, by the two parameter values 0 and
71 -- angle. Angle is given in radians.
72 -- The resulting shape is composed of:
73 -- - a lateral conical face
74 -- - two planar faces in the planes z = 0 and z = H,
75 -- or only one planar face in one of these two planes if a
76 -- radius value is null (in the case of a complete cone,
77 -- these faces are circles), and
78 -- - and in the case of a portion of a cone, two planar
79 -- faces to close the shape. (either two parallelograms or
80 -- two triangles, in the planes u = 0 and u = angle).
82 -- Standard_DomainError if:
83 -- - H is less than or equal to Precision::Confusion(), or
84 -- - the half-angle at the apex of the cone, defined by
85 -- R1, R2 and H, is less than Precision::Confusion()/H, or greater than
86 -- (Pi/2)-Precision::Confusion()/H.f
88 OneAxis(me : in out) returns Address;
89 ---Purpose: Returns the algorithm.
92 Cone(me : in out) returns Cone from BRepPrim
93 ---Purpose: Returns the algorithm.
101 myCone : Cone from BRepPrim;