src/BRepPrim/BRepPrim_Cone.hxx

   1 // Created on: 1992-11-05
   2 // Created by: Remi LEQUETTE
   3 // Copyright (c) 1992-1999 Matra Datavision
   4 // Copyright (c) 1999-2014 OPEN CASCADE SAS
   5 //
   6 // This file is part of Open CASCADE Technology software library.
   7 //
   8 // This library is free software; you can redistribute it and/or modify it under
   9 // the terms of the GNU Lesser General Public License version 2.1 as published
  10 // by the Free Software Foundation, with special exception defined in the file
  11 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
  12 // distribution for complete text of the license and disclaimer of any warranty.
  13 //
  14 // Alternatively, this file may be used under the terms of Open CASCADE
  15 // commercial license or contractual agreement.
  16
  17 #ifndef _BRepPrim_Cone_HeaderFile
  18 #define _BRepPrim_Cone_HeaderFile
  19
  20 #include <Standard.hxx>
  21 #include <Standard_DefineAlloc.hxx>
  22 #include <Standard_Handle.hxx>
  23
  24 #include <Standard_Real.hxx>
  25 #include <BRepPrim_Revolution.hxx>
  26 class Standard_DomainError;
  27 class gp_Ax2;
  28 class gp_Pnt;
  29 class TopoDS_Face;
  30
  31
  32 //! Implement the cone primitive.
  33 class BRepPrim_Cone  : public BRepPrim_Revolution
  34 {
  35 public:
  36
  37   DEFINE_STANDARD_ALLOC
  38
  39
  40   //! the STEP definition
  41   //! Angle = semi-angle of the cone
  42   //! Position : the coordinate system
  43   //! Height : height of the cone.
  44   //! Radius : radius of truncated face at z = 0
  45   //!
  46   //! The apex is on z < 0
  47   //!
  48   //! Errors : Height < Resolution
  49   //! Angle < Resolution / Height
  50   //! Angle > PI/2 - Resolution / Height
  51   Standard_EXPORT BRepPrim_Cone(const Standard_Real Angle, const gp_Ax2& Position, const Standard_Real Height, const Standard_Real Radius = 0);
  52
  53   //! infinite cone at origin on Z negative
  54   Standard_EXPORT BRepPrim_Cone(const Standard_Real Angle);
  55
  56   //! infinite cone at Apex on Z negative
  57   Standard_EXPORT BRepPrim_Cone(const Standard_Real Angle, const gp_Pnt& Apex);
  58
  59   //! infinite cone with Axes
  60   Standard_EXPORT BRepPrim_Cone(const Standard_Real Angle, const gp_Ax2& Axes);
  61
  62   //! create a  Cone at origin  on Z axis, of height  H,
  63   //! radius R1 at Z = 0, R2 at  Z = H, X is  the origin
  64   //! of angles.  If R1 or  R2 is 0   there is  an apex.
  65   //! Otherwise, it is a truncated cone.
  66   //!
  67   //! Error  : R1 and R2  < Resolution
  68   //! R1 or R2 negative
  69   //! Abs(R1-R2) < Resolution
  70   //! H < Resolution
  71   //! H negative
  72   Standard_EXPORT BRepPrim_Cone(const Standard_Real R1, const Standard_Real R2, const Standard_Real H);
  73
  74   //! same as above but at a given point
  75   Standard_EXPORT BRepPrim_Cone(const gp_Pnt& Center, const Standard_Real R1, const Standard_Real R2, const Standard_Real H);
  76
  77   //! same as above with given axes system.
  78   Standard_EXPORT BRepPrim_Cone(const gp_Ax2& Axes, const Standard_Real R1, const Standard_Real R2, const Standard_Real H);
  79
  80   //! The surface normal should be directed  towards the
  81   //! outside.
  82   Standard_EXPORT virtual TopoDS_Face MakeEmptyLateralFace() const Standard_OVERRIDE;
  83
  84
  85
  86
  87 protected:
  88
  89
  90
  91
  92
  93 private:
  94
  95
  96   Standard_EXPORT void SetMeridian();
  97
  98   Standard_EXPORT void SetParameters (const Standard_Real R1, const Standard_Real R2, const Standard_Real H);
  99
 100
 101   Standard_Real myHalfAngle;
 102   Standard_Real myRadius;
 103
 104
 105 };
 106
 107
 108
 109
 110
 111
 112
 113 #endif // _BRepPrim_Cone_HeaderFile