|
||||
File indexing completed on 2025-01-18 10:03:31
0001 // Created on: 1991-04-03 0002 // Created by: Remi GILET 0003 // Copyright (c) 1991-1999 Matra Datavision 0004 // Copyright (c) 1999-2014 OPEN CASCADE SAS 0005 // 0006 // This file is part of Open CASCADE Technology software library. 0007 // 0008 // This library is free software; you can redistribute it and/or modify it under 0009 // the terms of the GNU Lesser General Public License version 2.1 as published 0010 // by the Free Software Foundation, with special exception defined in the file 0011 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT 0012 // distribution for complete text of the license and disclaimer of any warranty. 0013 // 0014 // Alternatively, this file may be used under the terms of Open CASCADE 0015 // commercial license or contractual agreement. 0016 0017 #ifndef _GccAna_Lin2dTanPer_HeaderFile 0018 #define _GccAna_Lin2dTanPer_HeaderFile 0019 0020 #include <Standard.hxx> 0021 #include <Standard_DefineAlloc.hxx> 0022 0023 #include <Standard_Integer.hxx> 0024 #include <TColgp_Array1OfLin2d.hxx> 0025 #include <GccEnt_Array1OfPosition.hxx> 0026 #include <TColgp_Array1OfPnt2d.hxx> 0027 #include <TColStd_Array1OfReal.hxx> 0028 #include <GccEnt_Position.hxx> 0029 class gp_Pnt2d; 0030 class gp_Lin2d; 0031 class gp_Circ2d; 0032 class GccEnt_QualifiedCirc; 0033 0034 0035 //! This class implements the algorithms used to 0036 //! create 2d lines tangent to a circle or a point and 0037 //! perpendicular to a line or a circle. 0038 //! Describes functions for building a 2D line perpendicular 0039 //! to a line and: 0040 //! - tangential to a circle, or 0041 //! - passing through a point. 0042 //! A Lin2dTanPer object provides a framework for: 0043 //! - defining the construction of 2D line(s), 0044 //! - implementing the construction algorithm, and 0045 //! - consulting the result(s). 0046 class GccAna_Lin2dTanPer 0047 { 0048 public: 0049 0050 DEFINE_STANDARD_ALLOC 0051 0052 0053 //! This method implements the algorithms used to 0054 //! create 2d lines passing through a point and 0055 //! perpendicular to a line. 0056 Standard_EXPORT GccAna_Lin2dTanPer(const gp_Pnt2d& ThePnt, const gp_Lin2d& TheLin); 0057 0058 //! This method implements the algorithms used to 0059 //! create 2d lines passing through a point and 0060 //! perpendicular to a circle. 0061 Standard_EXPORT GccAna_Lin2dTanPer(const gp_Pnt2d& ThePnt, const gp_Circ2d& TheCircle); 0062 0063 //! This method implements the algorithms used to 0064 //! create 2d lines tangent to a circle and 0065 //! perpendicular to a line. 0066 Standard_EXPORT GccAna_Lin2dTanPer(const GccEnt_QualifiedCirc& Qualified1, const gp_Lin2d& TheLin); 0067 0068 //! This method implements the algorithms used to 0069 //! create 2d lines tangent to a circle and 0070 //! perpendicular to a circle. 0071 Standard_EXPORT GccAna_Lin2dTanPer(const GccEnt_QualifiedCirc& Qualified1, const gp_Circ2d& TheCircle); 0072 0073 //! Returns True if the algorithm succeeded. 0074 Standard_EXPORT Standard_Boolean IsDone() const; 0075 0076 //! Returns the number of solutions. 0077 //! Raises NotDone if the construction algorithm didn't succeed. 0078 Standard_EXPORT Standard_Integer NbSolutions() const; 0079 0080 //! Returns the qualifier Qualif1 of the tangency argument 0081 //! for the solution of index Index computed by this algorithm. 0082 //! The returned qualifier is: 0083 //! - that specified at the start of construction when the 0084 //! solutions are defined as enclosing or outside with 0085 //! respect to the argument, or 0086 //! - that computed during construction (i.e. enclosing or 0087 //! outside) when the solutions are defined as unqualified 0088 //! with respect to the argument, or 0089 //! - GccEnt_noqualifier if the tangency argument is a point. 0090 //! Exceptions 0091 //! Standard_OutOfRange if Index is less than zero or 0092 //! greater than the number of solutions computed by this algorithm. 0093 //! StdFail_NotDone if the construction fails. 0094 Standard_EXPORT void WhichQualifier (const Standard_Integer Index, GccEnt_Position& Qualif1) const; 0095 0096 //! Returns the solution number Index and raises OutOfRange 0097 //! exception if Index is greater than the number of solutions. 0098 //! Be careful: the Index is only a way to get all the 0099 //! solutions, but is not associated to those outside the 0100 //! context of the algorithm-object. 0101 //! Raises NotDone if the construction algorithm 0102 //! didn't succeed. 0103 //! It raises OutOfRange if Index is greater than the 0104 //! number of solutions. 0105 Standard_EXPORT gp_Lin2d ThisSolution (const Standard_Integer Index) const; 0106 0107 //! Returns information about the tangency point between the 0108 //! result number Index and the first argument. 0109 //! ParSol is the intrinsic parameter of the point on the 0110 //! solution curv. 0111 //! ParArg is the intrinsic parameter of the point on the 0112 //! argument curv. 0113 //! If the first argument is a point ParArg is equal zero. 0114 //! raises NotDone if the construction algorithm didn't succeed. 0115 //! It raises OutOfRange if Index is greater than the 0116 //! number of solutions. 0117 Standard_EXPORT void Tangency1 (const Standard_Integer Index, Standard_Real& ParSol, Standard_Real& ParArg, gp_Pnt2d& Pnt) const; 0118 0119 //! Returns information about the intersection between the 0120 //! solution number Index and the second argument. 0121 //! It returns the first intersection in a case of 0122 //! Lin2dTanPer which is perpendicular to a circle . 0123 //! ParSol is the intrinsic parameter of the point on the 0124 //! solution curv. 0125 //! ParArg is the intrinsic parameter of the point on the 0126 //! argument curv. Raises NotDone if the construction algorithm 0127 //! didn't succeed. 0128 //! It raises OutOfRange if Index is greater than the 0129 //! number of solutions. 0130 Standard_EXPORT void Intersection2 (const Standard_Integer Index, Standard_Real& ParSol, Standard_Real& ParArg, gp_Pnt2d& PntSol) const; 0131 0132 0133 0134 0135 protected: 0136 0137 0138 0139 0140 0141 private: 0142 0143 0144 0145 Standard_Boolean WellDone; 0146 Standard_Integer NbrSol; 0147 TColgp_Array1OfLin2d linsol; 0148 GccEnt_Array1OfPosition qualifier1; 0149 TColgp_Array1OfPnt2d pnttg1sol; 0150 TColgp_Array1OfPnt2d pntint2sol; 0151 TColStd_Array1OfReal par1sol; 0152 TColStd_Array1OfReal par2sol; 0153 TColStd_Array1OfReal pararg1; 0154 TColStd_Array1OfReal pararg2; 0155 0156 0157 }; 0158 0159 0160 0161 0162 0163 0164 0165 #endif // _GccAna_Lin2dTanPer_HeaderFile
[ Source navigation ] | [ Diff markup ] | [ Identifier search ] | [ general search ] |
This page was automatically generated by the 2.3.7 LXR engine. The LXR team |