C3D Toolkit  Kernel - 117982, Vision - 2.9.2.2

Fillet surface of constant radii, ordinary or with preservation of fillet. More...

#include <surf_fillet_surface.h>

+ Inheritance diagram for MbFilletSurface:
+ Collaboration diagram for MbFilletSurface:

Classes

class  MbFilletSurfaceAuxiliaryData
 Auxiliary data. More...
 

Public Types

enum  MbeFilletSurfaceVersion { fsv_Ver0 = 0 , fsv_Ver1 = 1 , fsv_Count }
 Version of implementation of surface. More...
 
enum  MbeFilletSurfType {
}
 Implemented types of fillets with exact mathematics. More...
 

Public Member Functions

 MbFilletSurface (MbSurfaceCurve &curv1, MbSurfaceCurve &curv2, double d1, double d2, MbeSmoothForm fm, double cn, bool ev)
 Constructor of fillet surface. More...
 
 MbFilletSurface (MbSurfaceCurve &curv1, MbSurfaceCurve &curv2, double d1, double d2, MbeSmoothForm fm, double cn, bool byFirst, bool ev)
 Constructor of surface with preservation of fillet. More...
 
 MbFilletSurface (MbSurface &surf1, MbCurve &curv1, MbSurface &surf2, MbCurve &curv2, MbCurve3D &curv0, double d1, double d2, MbeSmoothForm fm, double cn, bool ev)
 Constructor of fillet surface. More...
 
Initialization functions
void Init0 (double wmin, double wmax, bool insertPoints=true) override
 Correction of the middle line of fillet surface. More...
 
Common functions of a geometric object
MbeSpaceType IsA () const override
 Get the type of the object.
 
MbeFilletSurfaceVersion GetVersion () const
 Version.
 
MbSpaceItemDuplicate (MbRegDuplicate *=nullptr) const override
 Create a copy of the object. More...
 
bool IsSame (const MbSpaceItem &other, double accuracy=LENGTH_EPSILON) const override
 Determine whether an object is equal. More...
 
bool SetEqual (const MbSpaceItem &) override
 Make objects equal if they are similar. More...
 
bool IsSimilar (const MbSpaceItem &) const override
 Determine whether an object is similar. More...
 
void Transform (const MbMatrix3D &, MbRegTransform *=nullptr) override
 Convert the object according to the matrix. More...
 
void Move (const MbVector3D &, MbRegTransform *=nullptr) override
 Move an object along a vector. More...
 
void Rotate (const MbAxis3D &, double angle, MbRegTransform *=nullptr) override
 Rotate an object around an axis at a given angle. More...
 
void GetProperties (MbProperties &properties) override
 Outstanding properties of the object. More...
 
void SetProperties (const MbProperties &properties) override
 Change the properties of an object. More...
 
void GetBasisItems (RPArray< MbSpaceItem > &s) override
 Outstanding reference objects in a container sent.
 
Functions for surface domain description
double GetVPeriod () const override
 Return period for smoothly closed surface or 0.
 
Functions for working at surface domain

Functions PointOn, Derive... of smooth surfaces don't correct first parameter when it is out of domain bounds.

void PointOn (double &u, double &v, MbCartPoint3D &) const override
 Calculate a point on the surface. More...
 
void DeriveU (double &u, double &v, MbVector3D &) const override
 Calculate first derivative with respect to u.
 
void DeriveV (double &u, double &v, MbVector3D &) const override
 Calculate first derivative with respect to v.
 
void DeriveUU (double &u, double &v, MbVector3D &) const override
 Calculate second derivative with respect to u.
 
void DeriveVV (double &u, double &v, MbVector3D &) const override
 Calculate second derivative with respect to v.
 
void DeriveUV (double &u, double &v, MbVector3D &) const override
 Calculate second derivative.
 
void DeriveUUU (double &u, double &v, MbVector3D &) const override
 Calculate third derivative.
 
void DeriveUUV (double &u, double &v, MbVector3D &) const override
 Calculate third derivative.
 
void DeriveUVV (double &u, double &v, MbVector3D &) const override
 Calculate third derivative.
 
void DeriveVVV (double &u, double &v, MbVector3D &) const override
 Calculate third derivative.
 
void Normal (double &u, double &v, MbVector3D &) const override
 Calculate normal.
 
void NormalU (double &u, double &v, MbVector3D &) const override
 Calculate derivative of normal with respect to U.
 
void NormalV (double &u, double &v, MbVector3D &) const override
 Calculate derivative of normal with respect to V.
 
Functions for working inside and outside the surface's domain

functions _PointOn, _Derive... of surfaces don't correct parameters when they are out of bounds of rectangular domain of parameters.

void _PointOn (double u, double v, MbCartPoint3D &) const override
 Calculate a point on the surface. More...
 
void _DeriveU (double u, double v, MbVector3D &) const override
 Calculate first derivative with respect to u on extended surface.
 
void _DeriveV (double u, double v, MbVector3D &) const override
 Calculate first derivative with respect to v on extended surface.
 
void _DeriveUU (double u, double v, MbVector3D &) const override
 Calculate second derivative with respect to u on extended surface.
 
void _DeriveVV (double u, double v, MbVector3D &) const override
 Calculate second derivative with respect to v on extended surface.
 
void _DeriveUV (double u, double v, MbVector3D &) const override
 Calculate second derivative on extended surface.
 
void _DeriveUUU (double u, double v, MbVector3D &) const override
 Calculate third derivative on extended surface.
 
void _DeriveUUV (double u, double v, MbVector3D &) const override
 Calculate third derivative on extended surface.
 
void _DeriveUVV (double u, double v, MbVector3D &) const override
 Calculate third derivative on extended surface.
 
void _DeriveVVV (double u, double v, MbVector3D &) const override
 Calculate third derivative on extended surface.
 
void _Normal (double u, double v, MbVector3D &) const override
 Calculate a normal on extended surface.
 
void _NormalU (double u, double v, MbVector3D &) const override
 Calculate derivative of normal vector on extended surface.
 
void _NormalV (double u, double v, MbVector3D &) const override
 Calculate derivative of normal vector on extended surface.
 
Functions for get of the group of data inside and outside the surface's domain of parameters.
void Explore (double &u, double &v, bool ext, MbCartPoint3D &pnt, MbVector3D &uDer, MbVector3D &vDer, MbVector3D *uuDer, MbVector3D *vvDer, MbVector3D *uvDer, MbVector3D *nor) const override
 Calculate point and derivatives of object for given parameters. More...
 
void SurfaceCurveExplore (size_t ind, double t, MbCartPoint &pnt, MbVector *fir, MbVector *sec, MbVector *thir) const
 Calculate the two-dimensional values of the point and derivatives for the surface curve (0 - first, otherwise - second) (for internal use)
 
void _PointNormal (double u, double v, MbCartPoint3D &pnt, MbVector3D &uDer, MbVector3D &vDer, MbVector3D &norm, MbVector3D &uNorm, MbVector3D &vNorm, MbVector3D &uuDer, MbVector3D &vvDer, MbVector3D &uvDer) const override
 Calculate all derivatives at point. More...
 
Functions of moving along the surface
double StepU (double u, double v, double sag) const override
 Calculate parameter step. More...
 
double StepV (double u, double v, double sag) const override
 Calculate parameter step. More...
 
double DeviationStepU (double u, double v, double angle) const override
 Calculate parameter step. More...
 
double DeviationStepV (double u, double v, double angle) const override
 Calculate parameter step. More...
 
double MetricStepV (double u, double v, double length) const override
 Calculate parameter step. More...
 
Common functions of surface
double CurvatureV (double u, double v) const override
 Calculate line curvature along the direction of v. More...
 
MbSplineSurfaceNurbsSurface (double, double, double, double, bool bmatch=false) const override
 Construct a NURBS copy of trimmed surface. More...
 
MbSurfaceNurbsSurface (const MbNurbsParameters &uParam, const MbNurbsParameters &vParam) const override
 Construct a NURBS copy of a surface. More...
 
MbSurfaceOffset (double d, bool same) const override
 Create an offset surface. More...
 
MbFilletSurfaceOffsetByFillet (double d, const MbSurface &offSurf1, const MbSurface &offSurf2) const
 
MbCurve3DCurveV (double u, MbRect1D *pRgn, bool bApprox=true) const override
 Construct spatial copy of the line u = const.
More...
 
void ChangeCarrier (const MbSpaceItem &item, MbSpaceItem &init) override
 Changing of carrier. More...
 
bool ChangeCarrierBorne (const MbSurface &item, MbSurface &init, const MbMatrix &matr) override
 Changing of carrier elements. More...
 
MbeNewtonResult SurfaceTangentNewton (const MbSurface &, MbeParamDir switchPar, double funcEpsilon, size_t iterLimit, double &u0, double &v0, double &u1, double &v1, bool ext0, bool ext1) const override
 Solution of equation system for determination of surfaces tangency. For internal use only.
 
MbeNewtonResult PointProjectionNewton (const MbCartPoint3D &p, size_t iterLimit, double &u, double &v, bool ext) const override
 Finding of point projection on surface. For internal use only.
 
bool NearPointProjection (const MbCartPoint3D &p, double &u, double &v, bool ext, MbRect2D *uvRange=nullptr) const override
 Find the projection of a point onto the surface. More...
 
double GetFilletRadius (const MbCartPoint3D &p, double accuracy=METRIC_REGION) const override
 Get fillet radius if the surface is a fillet surface with the set accuracy. More...
 
virtual double GetFilletRadius (double u) const
 
bool CreateNormalPlacements (const MbVector3D &axisZ, double angle, SArray< MbPlacement3D > &places, VERSION version=Math::DefaultMathVersion()) const override
 Construct normal placements of constructive planes.

 
bool CreateTangentPlacements (const MbVector3D &axisZ, SArray< MbPlacement3D > &places) const override
 Construct tangent placements of constructive planes.
 
bool GetCylinderAxis (MbAxis3D &axis) const override
 Get rotation axis of a surface.
 
bool IsSimilarToSurface (const MbSurface &surf, VERSION version, double precision=METRIC_PRECISION) const override
 Define whether the surfaces are similar for merge. More...
 
bool GetMatrixToSurface (const MbSurface &surf, MbMatrix &matr, VERSION version, double precision=METRIC_PRECISION) const override
 Get two-dimensional matrix of transformation from its parametric region to the parametric region of 'surf'. More...
 
bool IsSpecialSimilarToSurface (const MbSurface &surf, VERSION version, double precision=METRIC_PRECISION) const override
 Whether the surfaces are similar to merge. Special case. For internal use only.
 
ThreeStates Salient () const override
 Determine whether the surface is convex. More...
 
double GetRadius () const override
 Get the physical radius of the object or null if it impossible.
More...
 
size_t GetUMeshCount () const override
 The the number of splittings in u-direction.
 
size_t GetVMeshCount () const override
 The the number of splittings in v-direction.
 
Functions of smooth surface
MbSmoothSurfaceCurvesDuplicate () const override
 A copy with the same support surfaces.

 
double GetSmoothRadius () const override
 Get radius.
 
void GetDistances (double u, double &d1, double &d2) const override
 Get radii with a sign.
 
double GetDistance (bool s) const override
 Get radius with a sign.
 
bool SurfacesCombine (const MbSurfaceIntersectionCurve &edge, const MbSurface &init, bool add, MbMatrix &matr, const MbSurfaceIntersectionCurve *seam) override
 Combine surfaces by inclusion of the surface 'init' into the given surface. More...
 
double DistanceRatio (bool firstCurve, MbCartPoint3D &p, double distance) const override
 Get coefficient for radius.
 
void GetTesselation (const MbStepData &stepData, double u1, double u2, double v1, double v2, SArray< double > &uu, SArray< double > &vv) const override
 Determine a splitting of parametric region of a surface by verticals and horizontals. More...
 
void GetCurve1 (SPtr< const MbSurfaceCurve > &c) const override
 Support curve on the first surface.
 
void GetCurve2 (SPtr< const MbSurfaceCurve > &c) const override
 Support curve on the second surface.
 
void SetCurve1 (SPtr< MbSurfaceCurve > &c) override
 Get the support curve on the first surface for changing.
 
void SetCurve2 (SPtr< MbSurfaceCurve > &c) override
 Get the support curve on the second surface for changing.
 
Functions of fillet surface
double GetWeight (double u) const
 Weights of points of mid-curve. More...
 
double GetAngle (double u) const
 Arc opening angle. More...
 
double GetLocalAxis (double u, MbAxis3D &axis) const
 Axis of surface at given point. More...
 
void GetCentrePoint (double u, MbCartPoint3D &p1, MbCartPoint3D &p2, MbCartPoint3D &p0) const
 Get point on axis. More...
 
bool GetMiddlePoint (double u, MbCartPoint3D &p1, MbCartPoint3D &p2, MbCartPoint3D &p0, double &w) const
 Get the mid-point. More...
 
double GetVPeriod (double u) const
 Period by direction V. More...
 
const MbCurve3DGetCurve0 () const
 Intersection curve of tangents to surfaces.
 
bool IsEllipse () const
 Fillet isn't circular. More...
 
bool IsEven () const
 Uniform arc length parameterization.

 
bool IsFilletSurface () const
 Whether the fillet surface is homogeneous. More...
 
bool IsConic () const
 General conic section. More...
 
double Conic () const
 Coefficient of shape. More...
 
bool IsKerbSurface () const
 Fillet surface with preservation of fillet. More...
 
bool ByFirstCurve () const
 Whether the first curve is fillet. More...
 
void SetKerbSurface (bool bc1)
 Set fillet surface with preservation of fillet. Need to call this->Init0() after this method. More...
 
const MbFunctionGetWeights () const
 
bool SetWeights (MbFunction &func)
 
MbCurve3DGetSpine () const
 
void SetSpine (MbCurve3D *)
 
MbeFilletSurfType GetFilletType () const
 
- Public Member Functions inherited from MbSmoothSurface
MbeSpaceType Type () const override
 Get the group object type.
 
double GetUMin () const override
 Get the minimum value of u.
 
double GetUMax () const override
 Get the maximum value of u.
 
double GetVMin () const override
 Get the minimum value of v.
 
double GetVMax () const override
 Get the maximum value of v.
 
bool IsUClosed () const override
 Determine whether a surface is closed in u-parameter direction. More...
 
bool IsVClosed () const override
 Determine whether a surface is closed in v-parameter direction. More...
 
double GetUPeriod () const override
 Return period for smoothly closed surface or 0.
 
bool GetPoleUMin () const override
 Whether a pole exists on parametric region boundary.
 
bool GetPoleUMax () const override
 Whether a pole exists on parametric region boundary.
 
bool GetPoleVMin () const override
 Whether a pole exists on parametric region boundary.
 
bool GetPoleVMax () const override
 Whether a pole exists on parametric region boundary.
 
bool IsPole (double u, double v, double paramPrecision=PARAM_PRECISION) const override
 Whether the point is a pole.
 
size_t GetUCount () const override
 The number of splittings by u-parameter for a check of events.
 
size_t GetVCount () const override
 The number of splittings by v-parameter for a check of events.
 
MbeNewtonResult CurveIntersectNewton (const MbCurve3D &, double funcEpsilon, size_t iterLimit, double &u0, double &v0, double &t1, bool ext0, bool ext1) const override
 Solution of equation system for determination of intersections between a surface and a curve. For internal use only.
 
double GetParamDelta () const override
 Get the maximum increment of parameter.
 
double GetParamPrice () const override
 Get the minimum distinguishable value of parameter.
 
MbSurfaceNurbsSurface (const MbNurbsParameters &uParam, const MbNurbsParameters &vParam) const override
 Construct a NURBS copy of a surface. More...
 
MbSurfaceTotalDuplicate () const
 Perform a full copying of a surface.
 
const MbSurfaceGetSurface1 () const
 Get the first surface.
 
const MbSurfaceGetSurface2 () const
 Get the second surface.
 
MbCurveCreateBound (bool s) const
 Construct boundary curve along a surface (V = const). More...
 
MbeCurveBuildType GetBuildType () const
 Type of support curves. More...
 
MbeSmoothForm Form () const
 Form of a surface. More...
 
virtual bool InsertPoints (double &t1, const MbCartPoint &p1, bool add1, double &t2, const MbCartPoint &p2, bool add2)
 Add a point to the support curves of the boundary. More...
 
bool ProlongSurface (double u, const MbCartPoint &p1, const MbCartPoint &p2, bool anyCase)
 Prolong surface. More...
 
bool CurveStraighten (double t1, double t2)
 Correct curves. More...
 
void AddProperties (MbProperties &properties)
 Get the object properties.
 
void SetPole ()
 Check poles.
 
- Public Member Functions inherited from MbSurface
virtual ~MbSurface ()
 Destructor.
 
virtual void Accept (Visitor &visitor)
 Implementation of a function initializing a visit of an object.
 
MbeSpaceType Type () const override
 Get the group object type.
 
MbeSpaceType Family () const override
 Get family of objects.
 
double DistanceToPoint (const MbCartPoint3D &) const override
 Determine the distance to the point. More...
 
void AddYourGabaritTo (MbCube &c) const override
 Expand sent bounding box (a.k.a. gabarit), so that it included the object. More...
 
void Refresh () override
 Translate all the time (mutable) data objects in an inconsistent (initial) state.
 
virtual void PrepareIntegralData (const bool forced) const
 Calculate temporary (mutable) data of an object. More...
 
void CalculateMesh (const MbStepData &stepData, const MbFormNote &note, MbMesh &mesh) const override
 Build polygonal copy mesh. More...
 
MbPropertyCreateProperty (MbePrompt name) const override
 Create your own property with the name.
 
void GetBasisPoints (MbControlData3D &) const override
 Get control points of object.
 
void SetBasisPoints (const MbControlData3D &) override
 Change the object by control points.
 
size_t size () const
 Number of objects if object is interpreted as vector of objects.
 
const MbSurfaceoperator[] (size_t) const
 An access operator.
 
virtual bool IsUTouch () const
 Determine whether a surface is closed in u-parameter direction regardless of the smoothness of the closure. More...
 
virtual bool IsVTouch () const
 Determine whether a surface is closed in v-parameter direction regardless of the smoothness of the closure. More...
 
virtual bool IsUPeriodic () const
 Determine whether a surface is closed in u-parameter direction. More...
 
virtual bool IsVPeriodic () const
 Determine whether a surface is closed in v-parameter direction. More...
 
virtual double GetPeriod (ptrdiff_t i) const
 Return period. More...
 
virtual size_t Periodicity () const
 Determine periodicity. More...
 
bool IsPole (const MbCartPoint &uv, double paramPrecision=PARAM_PRECISION) const
 Whether the point is a pole.
 
virtual void TangentU (double &u, double &v, MbVector3D &) const
 Calculate tangent vector in u.
 
virtual void TangentV (double &u, double &v, MbVector3D &) const
 Calculate tangent vector in v.
 
virtual void Explore (double &u, double &v, MbCartPoint3D &pnt, MbVector3D &uDer, MbVector3D &vDer) const
 Calculate point and first derivatives with respect to u and with respect to v. More...
 
virtual void _TangentU (double u, double v, MbVector3D &) const
 Calculate tangent vector in u direction on extended surface.
 
virtual void _TangentV (double u, double v, MbVector3D &) const
 Calculate tangent vector in v direction on extended surface.
 
virtual void _NormalUU (double u, double v, MbVector3D &) const
 Calculate second derivative of normal vector on extended surface.
 
virtual void _NormalUV (double u, double v, MbVector3D &) const
 Calculate second derivative of normal vector on extended surface.
 
virtual void _NormalVV (double u, double v, MbVector3D &) const
 Calculate second derivative of normal vector on extended surface.
 
virtual void _NormalD (double u, double v, double du, double dv, MbVector3D &der) const
 Calculate derivative of normal vector at the point with the given parameters u and v along the line with the given direction (du,dv).
 
virtual void _NormalDD (double u, double v, double du, double dv, MbVector3D &der) const
 Calculate second derivative of normal vector at the point with the given parameters u and v along the line with the given direction (du,dv).
 
virtual double MetricStepU (double u, double v, double length) const
 Calculate parameter step. More...
 
double SurfaceStep (const double &u, const double &v, bool alongU, const MbStepData &stepData) const
 Calculate parameter step. More...
 
virtual const MbSurfaceGetSurface () const
 Get itself (it is overloaded only in CurveBoundedSurface).
 
virtual const MbSurfaceGetBasisSurface () const
 Get the base surface if exists or itself.
 
virtual MbSurfaceSetSurface ()
 Get itself (it is overloaded only in CurveBoundedSurface).
 
virtual MbSurfaceSetBasisSurface ()
 Get the base surface if exists or itself.
 
virtual void GetLimitPoint (ptrdiff_t number, MbCartPoint3D &pnt) const
 Calculate the boundary point. More...
 
virtual void GetLimitPoint (ptrdiff_t number, MbCartPoint &pnt) const
 Calculate the boundary two-dimensional point. More...
 
MbCartPoint3D GetLimitPoint (ptrdiff_t number) const
 Calculate the boundary point. More...
 
virtual double CurvatureU (double u, double v) const
 Calculate line curvature along the direction of u. More...
 
double NormalCurvatureU (double u, double v) const
 Calculate a normal curvature of line along the direction of u. More...
 
double NormalCurvatureV (double u, double v) const
 Calculate a normal curvature of line along the direction of v. More...
 
double NormalCurvature (double u, double v, double du, double dv) const
 Calculate a normal curvature of surface. More...
 
bool MeanGaussCurvature (double u, double v, double &mean, double &gauss) const
 Calculate the mean and the Gaussian curvature.
More...
 
bool MainCurvatures (double u, double v, double &c1, double &c2, double &du, double &dv) const
 Calculate the mean and the Gaussian curvature.
More...
 
virtual bool IsSameBase (const MbSurface &) const
 Whether a base surface is a copy of the base surface of the given object.
 
virtual bool IsPlanar (double accuracy=METRIC_EPSILON) const
 Whether a surface is planar.
 
virtual MbeParamDir GetFilletDirection (double accuracy=METRIC_REGION) const
 Direction of fillet surface with accuracy. More...
 
virtual bool GetCentre (MbCartPoint3D &c) const
 Give the center of sphere surface.
 
virtual bool GetCenterLines (std::vector< MbCurve3D * > &clCurves) const
 Get center lines of a surface.
 
virtual bool IsSpinePeriodic () const
 Periodicity of the guide. More...
 
MbSplineSurfaceNurbsSurface (bool bmatch=false) const
 Construct a NURBS copy of a surface. More...
 
bool NurbsParam (const MbNurbsParameters &tParam, bool uParam, double op1, double op2, bool &isClosedNurbs, double &epsilon, SArray< double > &params) const
 Prepare parameters for the transformation to NURBS surface. More...
 
void CheckApproxPointParamsOpen (bool isU, double par, size_t degree, size_t pCount, SArray< double > &tList, SArray< double > &aKnots) const
 Chose points for approximation along the parameter. More...
 
void CheckApproxPointParamsClosed (bool isU, double par, size_t degree, size_t pCount, SArray< double > &tList, SArray< double > &aKnots) const
 Chose points for approximation along the parameter. More...
 
virtual MbCurve3DCurveU (double v, MbRect1D *pRgn, bool bApprox=true) const
 Construct spatial copy of the line v = const. More...
 
virtual MbCurve3DCurveUV (const MbLineSegment &segm, bool bApprox=true) const
 Construct spatial copy of line by parametric line. More...
 
virtual MbeItemLocation PointRelative (const MbCartPoint3D &pnt, double eps=ANGLE_REGION) const
 Get point location relative to the surface. More...
 
virtual MbeItemLocation PointClassification (const MbCartPoint &pnt, bool ignoreClosed=false) const
 A point is located inside the region on a surface. More...
 
virtual double DistanceToBorder (const MbCartPoint &point, double &epsilon) const
 Calculate the parametric distance to the nearest boundary. More...
 
virtual size_t CurveClassification (const MbCurve &curve, SArray< double > &tcurv, SArray< MbVector > &dir) const
 Determine points of intersections between the curve and the surface contours. More...
 
size_t SurfaceBorderIntersection (const MbCurve &curve, SArray< double > &tcurv, SArray< MbVector > &dir) const
 Determine points of intersections between the curve and the surface contours. More...
 
virtual MbeNewtonResult DirectPointProjectionNewton (const MbCartPoint3D &p, const MbVector3D &vect, size_t iterLimit, double &u, double &v, double &w, bool ext) const
 Finding of point projections to the surface in direction of the vector. For internal use only.
 
virtual void DirectPointProjection (const MbCartPoint3D &pnt, const MbVector3D &vect, SArray< MbCartPoint > &uv, bool ext, MbRect2D *uvRange=nullptr) const
 Find all a point projection onto the surface along a vector in either of two directions. More...
 
virtual bool NearDirectPointProjection (const MbCartPoint3D &pnt, const MbVector3D &vect, double &u, double &v, bool ext, MbRect2D *uvRange=nullptr, bool onlyPositiveDirection=false) const
 Find the nearest point projection to the surface in the vector direction. More...
 
virtual MbeNewtonResult CurveTangentNewton (const MbCurve3D &curv1, double funcEpsilon, size_t iterLimit, double &u0, double &v0, double &t1, bool ext0, bool ext1) const
 Solution of equation system for determination of tangency between a surface and a curve. For internal use only.
 
virtual void CurveIntersection (const MbCurve3D &curv, SArray< MbCartPoint > &uv, SArray< double > &tt, bool ext0, bool ext, bool touchInclude=false) const
 Determine points of intersection between a surface and a curve. More...
 
virtual MbeNewtonResult SurfaceIntersectNewton (const MbSurface &surf1, MbeParamDir switchPar, double funcEpsilon, size_t iterLimit, double &u0, double &v0, double &u1, double &v1, bool ext0, bool ext1) const
 Solution of equation system for determination of surfaces intersections. For internal use only.
 
virtual MbeNewtonResult SilhouetteNewton (const MbVector3D &eye, bool perspective, const MbAxis3D *axis, MbeParamDir switchPar, double funcEpsilon, size_t iterLimit, double &u, double &v, bool ext) const
 Solution of equation system for determination of surface silhouette points. For internal use only.

 
virtual bool ProjectCurveOnSimilarSurface (const MbCurve3D &spaceCurve, const MbCurve &curve, const MbSurface &surfNew, MbCurve *&curveNew) const
 Construction of projection of a surface curve on coincident surface. More...
 
bool ProjectCurveOnSimilarSurface (const MbCurve3D &spaceCurve, const MbCurve &curve, const MbSurface &surfNew, SPtr< MbCurve > &curveNew) const
 Construction of projection of a surface curve on coincident surface. More...
 
virtual double DistanceToCurve (const MbCurve3D &curve, double &u, double &v, double &t, bool tCalc=false) const
 Calculate the nearest distance to a curve. More...
 
virtual double DistanceToSurface (const MbSurface &surf1, double &u0, double &v0, double &u1, double &v1) const
 Calculate the nearest distance to a surface. More...
 
MbeNewtonResult PlacementNewton (const MbVector3D &vec, double angle, MbeParamDir switchPar, size_t iterLimit, double &u, double &v) const
 Construct tangent placements of constructive planes. For internal use only.
 
bool CreateVconstPlacements (const MbVector3D &axisZ, double angle, bool normalPlace, SArray< MbPlacement3D > &places) const
 Construct the normal or tangent placements on v-lines.
 
bool CreateUconstPlacements (const MbVector3D &axisZ, double angle, bool normalPlace, SArray< MbPlacement3D > &places) const
 Construct the normal or tangent placements on u-lines.
 
virtual double ParamArea () const
 Calculate the area of parameters domain.
 
virtual size_t GetUPairs (double v, SArray< double > &u) const
 Calculate U-pairs by V. More...
 
virtual size_t GetVPairs (double u, SArray< double > &v) const
 Calculate V-pairs by U. More...
 
MbeNewtonResult IsoclinalNewton (const MbVector3D &dir, size_t iterLimit, double &u, double &v) const
 Determination of parameters of a surface isocline point. For internal use only.
 
virtual void GetIsoclinal (const MbVector3D &nor, SArray< MbCartPoint > &uv) const
 Find all isoclines of a surface. More...
 
virtual void CalculateGabarit (MbCube &cube) const
 Calculate bounding box of surface. It is recommended to use GetGabarit.
 
void CalculateLocalGabarit (const MbMatrix3D &into, MbCube &cube) const override
 Calculate bounding box in the local coordinate system.
 
const MbCubeGetGabarit () const
 Calculate bounding box of surface.
 
const MbCubeCube () const
 Return saved bounding box. It should be empty. It is recommended to use GetGabarit.
 
void SetDirtyGabarit () const
 Make the bounding box empty. For internal use only.
 
void CopyGabarit (const MbSurface &s, const MbVector3D *to=nullptr)
 Copy the bounding box from the copy. More...
 
double GetGabDiagonal () const
 Calculate the diagonal of the bounding box.
 
void CalculateRect (const MbPlacement3D &place, MbRect &rect) const
 Calculate the rectangular bounding box of a surface in the given plane. More...
 
virtual MbContourMakeContour (bool sense) const
 Return the bounding two-dimensional contour. More...
 
virtual MbCurveMakeSegment (size_t i, bool sense) const
 Return a segment of the bounding two-dimensional contour. More...
 
MbCurveMakeCurve (size_t number1, size_t number2) const
 Return a segment of the bounding two-dimensional contour. More...
 
virtual bool SetLimit (double u1, double v1, double u2, double v2)
 Set surface limits. For internal use only.
 
bool SetLimit (const MbRect &)
 Set surface limits. For internal use only.
 
virtual void SetExtendedParamRegion (double u1, double v1, double u2, double v2)
 Set extended limits of surface. For internal use only.
 
virtual void IncludePoint (double u, double v)
 Include a point into domain. For internal use only.
 
double GetMaxParamDeltaU () const
 Get the maximum increment of U-parameter.
 
double GetMaxParamDeltaV () const
 Get the maximum increment of V-parameter.
 
virtual double GetUParamToUnit () const
 Get increment of u-parameter, corresponding to the unit length in space.
 
virtual double GetVParamToUnit () const
 Get increment of v-parameter, corresponding to the unit length in space.
 
virtual double GetUParamToUnit (double u, double v) const
 Get increment of u-parameter, corresponding to the unit length in space.
 
virtual double GetVParamToUnit (double u, double v) const
 Get increment of v-parameter, corresponding to the unit length in space.
 
double GetUParamToUnit (const MbCartPoint &uv) const
 Get increment of u-parameter, corresponding to the unit length in space.
 
double GetVParamToUnit (const MbCartPoint &uv) const
 Get increment of v-parameter, corresponding to the unit length in space.
 
virtual void GetParamsToUnit (double u, double v, double &uParam, double &vParam) const
 Get increment of parameters, corresponding to the unit length in space.
 
double GetUEpsilon () const
 Get the minimum distinguishable value of u-parameter. It corresponds to the length Math::metricEpsilon in space.
 
double GetVEpsilon () const
 Get the minimum distinguishable value of v-parameter. It corresponds to the length Math::metricEpsilon in space.
 
double GetUEpsilon (double u, double v) const
 Get the minimum distinguishable value of u-parameter. It corresponds to the length Math::metricEpsilon in space.
 
double GetVEpsilon (double u, double v) const
 Get the minimum distinguishable value of v-parameter. It corresponds to the length Math::metricEpsilon in space.
 
double GetURegion () const
 Get the minimum distinguishable value of u-parameter. It corresponds to the length Math::metricRegion in space.
 
double GetVRegion () const
 Get the minimum distinguishable value of v-parameter. It corresponds to the length Math::metricRegion in space.
 
double GetURegion (double u, double v) const
 Get the minimum distinguishable value of u-parameter. It corresponds to the length Math::metricRegion in space.
 
double GetVRegion (double u, double v) const
 Get the minimum distinguishable value of v-parameter. It corresponds to the length Math::metricRegion in space.
 
void CalculatePolygon (double minPar, double maxPar, double constPar, MbeParamDir dir, const MbStepData &stepData, MbPolygon3D &polygon) const
 Calculate polygon by u or v. More...
 
virtual void CalculateSurfaceWire (const MbStepData &stepData, size_t beg, MbMesh &mesh, size_t uMeshCount=c3d::WIRE_MAX, size_t vMeshCount=c3d::WIRE_MAX) const
 Calculate mesh. More...
 
void AddTesselation (const MbStepData &stepData, MbeParamDir dir, double u1, double u2, double v1, double v2, SArray< double > &uu, SArray< double > &vv) const
 Determine splitting of the surface parametric region according to direction. More...
 
virtual void CalculateSurfaceGrid (const MbStepData &stepData, bool sense, MbGrid &grid) const
 Approximate a surface by triangular plates. More...
 
virtual bool IsRectangular () const
 Determine whether derivatives with respect to u and v are orthogonal.
 
virtual bool IsLineU () const
 Check that all derivatives of surface with respect to u which have more than first order are equal to null.
 
virtual bool IsLineV () const
 Check that all derivatives of surface with respect to v which have more than first order are equal to null.
 
virtual bool IsShift (const MbSpaceItem &obj, MbVector3D &dir, bool &isSame, double accuracy=LENGTH_EPSILON) const
 Determine whether the object is a translation. More...
 
virtual void CheckSurfParams (double &u, double &v) const
 Check parameters. Analogue of the global function _CheckParams, optimized for caches usage. More...
 
bool GetPlacement (MbPlacement3D *place, bool exact=false) const
 Get a local coordinate system of planar surface (or only a possibility of getting it).
 
bool GetPlanePlacement (MbPlacement3D &place) const
 Get a local coordinate system if a surface is a plane.
 
bool GetControlPlacement (MbPlacement3D &place, bool sameSense=true) const
 Construct a local coordinate system of a surface with origin at the middle point of base surface parametric limits. More...
 
bool OrientPlacement (MbPlacement3D &place, bool normalSense=true) const
 Orient an axis X of a placement along the line of its intersection with surface.
 
bool IsPointOn (const MbCartPoint3D &, double eps=METRIC_PRECISION) const
 Determine whether a point is located on a surface or not.
 
void PointOn (MbCartPoint &uv, MbCartPoint3D &p) const
 Calculate the point on a surface inside the domain of surface.
 
void _PointOn (const MbCartPoint &uv, MbCartPoint3D &p) const
 Calculate a point on a surface extension.
 
void Normal (MbCartPoint &uv, MbVector3D &v) const
 Calculate the normal vector to a surface inside the domain of surface.
 
bool GetMatrix (double xMin, double xMax, double yMin, double yMax, MbMatrix &matr) const
 Find a matrix of transformation for the curves on a surface when the parameterization is changed. More...
 
double GetUMid () const
 The middle value of u.
 
double GetVMid () const
 The middle value of v.
 
double GetURange () const
 Parametric length by u.
 
double GetVRange () const
 Parametric length by v.
 
void GetRect (MbRect &r) const
 Get parametric bounding box.
 
void GetRect (MbRect2D &r) const
 Get parametric bounding box.
 
- Public Member Functions inherited from MbSpaceItem
virtual ~MbSpaceItem ()
 Destructor.
 
void PrepareWrite () const
 Register object. More...
 
MbeRefType RefType () const override
 Get a registration type (for copying, duplication).
 
bool IsFamilyRegistrable () const override
 Whether the object belongs to a registrable family.
 
void CalculateWire (const MbStepData &stepData, MbMesh &mesh) const
 
void CalculateWire (double sag, MbMesh &mesh) const
 
- Public Member Functions inherited from TapeBase
 TapeBase (RegistrableRec regs=noRegistrable)
 Constructor.
 
 TapeBase (const TapeBase &)
 Copy-constructor.
 
virtual ~TapeBase ()
 Destructor.
 
RegistrableRec GetRegistrable () const
 Whether the stream class is registrable.
 
void SetRegistrable (RegistrableRec regs=registrable) const
 Set the state of registration of the stream class.
 
virtual const char * GetPureName (const VersionContainer &) const
 Get the class name.
 
- Public Member Functions inherited from MbRefItem
refcount_t GetUseCount () const
 Get count of references (get count of owners of an object).
 
refcount_t AddRef () const
 Increase count of references by one.
 
refcount_t DecRef () const
 Decrease count of references by one.
 
refcount_t Release () const
 Decrease count of references by one and if count of references became zero, then remove itself.
 
- Public Member Functions inherited from MbNestSyncItem
void Lock () const
 Switch lock on (locking happens only in parallel region).
 
void Unlock () const
 Switch lock off if locking has been set.
 
CommonRecursiveMutexGetLock () const
 Get a pointer to the mutex object. Return nullptr if no parallelism. For use in ScopedLock.
 

Static Public Member Functions

static MbFilletSurfaceCreateSimpleFillet (double rad, MbSurfaceCurve &curv1, bool sgn1, MbSurfaceCurve &curv2, bool sgn2, double conicFact, VERSION vers)
 Create a fillet surface by two surfaces with a constant radius. More...
 
static MbFilletSurfaceCreateEllipticalFillet (MbSurfaceCurve &curv1, double rad1, MbSurfaceCurve &curv2, double rad2, VERSION vers)
 Create a fillet surface by two surfaces by an "arc of an ellipse". More...
 
static MbFilletSurfaceCreateChordFillet (double h, MbSurfaceCurve &curv1, bool sgn1, MbSurfaceCurve &curv2, bool sgn2, VERSION vers)
 Create a fillet surface by two surfaces with a constant chord. More...
 
static MbFilletSurfaceCreateKerbFillet (double rad, MbSurfaceCurve &curv1, bool sgn1, MbSurfaceCurve &curv2, bool sgn2, bool byFirst, double conicFact, VERSION vers)
 Create fillet surface a constant radius by support surface and support kerb-curve. More...
 
static MbFilletSurfaceCreateKerbTouchingFillet (MbSurfaceCurve &curv1, bool sgn1, MbSurfaceCurve &curv2, bool sgn2, bool byFirst, VERSION vers)
 Create a fillet surface by two support surfaces, specifying the kerb-curve of touching. More...
 

Protected Member Functions

 MbFilletSurface (MbSurfaceCurve &curv1, double d1, MbSurfaceCurve &curv2, double d2, MbeSmoothForm fm, double cn, bool ev)
 Constructor for inheritors of ordinary fillet surface.

 
 MbFilletSurface (MbSurfaceCurve &curv1, double d1, MbSurfaceCurve &curv2, double d2, MbeSmoothForm fm, double cn, bool byFirst, bool ev)
 Constructor for inheritors of surface with preservation of fillet.
 
 MbFilletSurface (MbSurface &surf1, MbCurve &curv1, double d1, MbSurface &surf2, MbCurve &curv2, double d2, MbCurve3D &curv0, MbFunction &weig0, MbeSmoothForm fm, double cn, bool ev)
 Constructor of fillet surface with intersection curve of tangents to surfaces.
 
 MbFilletSurface (const MbFilletSurface &, MbRegDuplicate *)
 Copy-constructor.
 
 MbFilletSurface (const MbFilletSurface *)
 Copy-constructor with the same support surfaces.
 
- Protected Member Functions inherited from MbSmoothSurface
 MbSmoothSurface (MbSurfaceCurve &crv1, MbSurfaceCurve &crv2, MbeSmoothForm fm, double d1, double d2)
 Constructor by two curves and conjugation type. More...
 
 MbSmoothSurface (MbSurface &surf1, MbCurve &curv1, MbSurface &surf2, MbCurve &curv2, MbeSmoothForm fm, double d1, double d2)
 Constructor by two curves and conjugation type. More...
 
 MbSmoothSurface (const MbSmoothSurface &, MbRegDuplicate *)
 Copy-constructor.
 
 MbSmoothSurface (const MbSmoothSurface *)
 Copy constructor with the same support surfaces.
 
void CheckParam (double &u, double &v) const
 Correction of parameters.
 
- Protected Member Functions inherited from MbSurface
 MbSurface ()
 Constructor.
 
 MbSurface (const MbSurface &)
 Copy-constructor.
 
void MoveGabarit (const MbVector3D &v)
 Move bounding box.
 
void NormalCalculation (const MbVector3D &uDer, const MbVector3D &vDer, double u, double v, bool ext, MbVector3D &nor) const
 Normal calculation by derivatives uDer and vDer on point with parameters u, v.
 
double StepAlong (double u, double v, double sag, bool alongU, double stepMinCoeff, const MbVector3D &der, const MbVector3D &sec) const
 Step calculation by sag.
 
double DeviationStepAlong (double u, double v, double angle, bool alongU, const MbVector3D &der, const MbVector3D &sec) const
 Step calculation by normal deviation.
 
- Protected Member Functions inherited from MbSpaceItem
 MbSpaceItem ()
 Default constructor.
 
- Protected Member Functions inherited from MbRefItem
 MbRefItem ()
 Constructor without parameters.
 

Protected Attributes

MbCurve3Dcurve0
 Intersection curve of tangents to surfaces - always not nullptr.
 
MbFunctionweights0
 Function of weight of points of curve0 mid-curve.
 
double conic
 Coefficient of shape is changed between 0.05 and 0.95 and determines weight of points of curve0 curve.
 
bool even
 Whether arc length parameterization is uniform or not.
 
bool equable
 True - ordinary surface, false - curve1 or curve2 is fillet.
 
bool byCurve1
 True - curve2 is fillet, false - curve1 is fillet.
 
MbCurve3Dspine
 Curve of centers of circular arcs in case of uniform parameterization.
 
MbeFilletSurfaceVersion version
 Version.
 
- Protected Attributes inherited from MbSmoothSurface
MbSurfaceCurvecurve1
 Support curve on the first surface (it never equals nullptr).
 
MbSurfaceCurvecurve2
 Support curve on the second surface (it never equals nullptr).
 
MbeSmoothForm form
 Conjugation type.
 
double distance1
 Fillet radius or chamfer "cathetus" with sign for surface of curve1 curve.
 
double distance2
 Fillet radius or chamfer "cathetus" with sign for surface of curve2 curve.
 
double umin
 Minimal value of parameter u.
 
double umax
 Maximal value of parameter u.
 
double vmin
 Minimal value of parameter v.
 
double vmax
 Maximal value of parameter v.
 
bool uclosed
 An attribute of closedness in u-parameter direction.
 
bool poleUMin
 Existence of a pole at umin.
 
bool poleUMax
 Existence of a pole at umax.
 
bool poleVMin
 Existence of a pole at vmin.
 
bool poleVMax
 Existence of a pole at vmax.
 
- Protected Attributes inherited from MbSurface
MbCube cube
 Bounding box of surface. More...
 

Detailed Description

Fillet surface of constant radii, ordinary or with preservation of fillet.

Fillet surface is NURBS-surface constructed by three curves: curve1, curve0, curve2. First parameter of surface coincides with parameter of curve1, curve0, curve2 curves. Second parameter is changed between 0 (points are coincident to curve1) and 1 (points are coincident to curve2). For fillet surface in contrast to other surfaces PointOn and Derive... functions don't correct first parameter when it is out of domain bounds. If coefficient of shape conic = ARC ( 0 ), then weight of each point of curve0 curve is given by weights0 function and is calculated as that the section of surface along its second parameter will be a circular arc, that is three points curve1(u), curve0(u), curve2(u) determine NURBS-curve with shape of circular arc at any u parameter. If coefficient of shape conic != ARC, then weight of each point of curve0 curve is equal to conic / ( 1.0 - conic ). If conic = 0.5, then section of surface along its second parameter will be a parabola.

Member Enumeration Documentation

◆ MbeFilletSurfaceVersion

Version of implementation of surface.

Enumerator
fsv_Ver0 

The first version.

fsv_Ver1 

The first version.

fsv_Count 

Count of versions.

◆ MbeFilletSurfType

Implemented types of fillets with exact mathematics.

Enumerator
ft_SimpleFillet 

Fillet of two surfaces with a constant radius.

ft_EllipticalFillet 

Fillet of two surfaces by an "arc of an ellipse".

ft_ChordFillet 

Fillet of two surfaces with a constant chord.

ft_LawFillet 

Fillet of two surfaces with a radius that varies according to the law.

ft_KerbFillet 

Fillet surface and kerb-curve with constant radius.

ft_KerbLawFillet 

Fillet surface and kerb-curve with a radius that varies according to the law.

ft_KerbTouchingFillet 

Fillet of two surfaces with the specified kerb-curve of touching.

Constructor & Destructor Documentation

◆ MbFilletSurface() [1/3]

MbFilletSurface::MbFilletSurface ( MbSurfaceCurve curv1,
MbSurfaceCurve curv2,
double  d1,
double  d2,
MbeSmoothForm  fm,
double  cn,
bool  ev 
)

Constructor of fillet surface.

Constructor of fillet surface.

Parameters
[in]curv1- Support curve on the first surface
[in]curv2- Support curve on the second surface
[in]d1- Fillet radius with sign for surface of crve1 curve
[in]d2- Fillet radius with sign for surface of crve2 curve
[in]fm- Conjugation type:
st_Span - fillet with a given chord st_Fillet - fillet with given radii
[in]cn- Coefficient of shape is changed between 0.05 and 0.95 (if 0 - circular arc)
[in]ev- Whether arc length parameterization is uniform or not

◆ MbFilletSurface() [2/3]

MbFilletSurface::MbFilletSurface ( MbSurfaceCurve curv1,
MbSurfaceCurve curv2,
double  d1,
double  d2,
MbeSmoothForm  fm,
double  cn,
bool  byFirst,
bool  ev 
)

Constructor of surface with preservation of fillet.

Constructor of surface with preservation of fillet.

Parameters
[in]curv1- Support curve on the first surface
[in]curv2- Support curve on the second surface
[in]d1- Fillet radius with sign for surface of crve1 curve
[in]d2- Fillet radius with sign for surface of crve2 curve
[in]fm- Conjugation type:
st_Span - fillet with a given chord
st_Fillet - fillet with given radii
[in]cn- Coefficient of shape is changed between 0.05 and 0.95 (if 0 - circular arc)
[in]byFirst- True - curve2 curve is fillet, false - curve1 curve is fillet.
[in]ev- Whether arc length parameterization is uniform or not

◆ MbFilletSurface() [3/3]

MbFilletSurface::MbFilletSurface ( MbSurface surf1,
MbCurve curv1,
MbSurface surf2,
MbCurve curv2,
MbCurve3D curv0,
double  d1,
double  d2,
MbeSmoothForm  fm,
double  cn,
bool  ev 
)

Constructor of fillet surface.

Constructor of fillet surface with intersection curve of tangents to surfaces.

Parameters
[in]surf1- First surface
[in]curv1- Support curve at parameters of the first surface
[in]surf2- Second surface
[in]curv2- Support curve at parameters of the second surface
[in]curv0- Intersection curve of tangents to surfaces
[in]d1- Fillet radius with sign for surface of curv1 curve
[in]d2- Fillet radius with sign for surface of curv2 curve
[in]fm- Conjugation type:
st_Span - fillet with a given chord
st_Fillet - fillet with given radii
[in]cn- Coefficient of shape is changed between 0.05 and 0.95 (if 0 - circular arc)
[in]ev- Whether arc length parameterization is uniform or not

Member Function Documentation

◆ CreateSimpleFillet()

static MbFilletSurface* MbFilletSurface::CreateSimpleFillet ( double  rad,
MbSurfaceCurve curv1,
bool  sgn1,
MbSurfaceCurve curv2,
bool  sgn2,
double  conicFact,
VERSION  vers 
)
static

Create a fillet surface by two surfaces with a constant radius.

If successful, a fillet surface is created with version >= fsv_Ver1.

Parameters
[in]rad- Fillet radius.
[in]curv1- Support curve at parameters of the first surface
[in]sgn1- The orientation of the first support surface.
[in]curv2- Support curve at parameters of the second surface
[in]sgn2- The orientation of the second support surface.
[in]cn- Coefficient of shape is changed between 0.05 and 0.95 (if 0 - circular arc)
[in]vers- Version.
Returns
Returns a pointer to the created fillet surface if successful, nullptr otherwise.

◆ CreateEllipticalFillet()

static MbFilletSurface* MbFilletSurface::CreateEllipticalFillet ( MbSurfaceCurve curv1,
double  rad1,
MbSurfaceCurve curv2,
double  rad2,
VERSION  vers 
)
static

Create a fillet surface by two surfaces by an "arc of an ellipse".

If successful, a fillet surface is created with version >= fsv_Ver1.

Parameters
[in]curv1- Support curve at parameters of the first surface
[in]rad1- Fillet radius with sign for surface of curv1 curve
[in]curv2- Support curve at parameters of the second surface
[in]rad2- Fillet radius with sign for surface of curv2 curve
[in]vers- Version.
Returns
Returns a pointer to the created fillet surface if successful, nullptr otherwise.

◆ CreateChordFillet()

static MbFilletSurface* MbFilletSurface::CreateChordFillet ( double  h,
MbSurfaceCurve curv1,
bool  sgn1,
MbSurfaceCurve curv2,
bool  sgn2,
VERSION  vers 
)
static

Create a fillet surface by two surfaces with a constant chord.

If successful, a fillet surface is created with version >= fsv_Ver1.

Parameters
[in]h- Fillet radius.
[in]curv1- Support curve at parameters of the first surface
[in]sgn1- The orientation of the first support surface.
[in]curv2- Support curve at parameters of the second surface
[in]sgn2- The orientation of the second support surface.
[in]vers- Version.
Returns
Returns a pointer to the created fillet surface if successful, nullptr otherwise.

◆ CreateKerbFillet()

static MbFilletSurface* MbFilletSurface::CreateKerbFillet ( double  rad,
MbSurfaceCurve curv1,
bool  sgn1,
MbSurfaceCurve curv2,
bool  sgn2,
bool  byFirst,
double  conicFact,
VERSION  vers 
)
static

Create fillet surface a constant radius by support surface and support kerb-curve.

If successful, a fillet surface is created with version >= fsv_Ver1.

Parameters
[in]rad- Fillet radius.
[in]curv1- Support curve at parameters of the first surface
[in]sgn1- The orientation of the first support surface.
[in]curv2- Support curve at parameters of the second surface
[in]sgn2- The orientation of the second support surface.
[in]byFirst- True - curve2 curve is fillet, false - curve1 curve is fillet.
[in]cn- Coefficient of shape is changed between 0.05 and 0.95 (if 0 - circular arc)
[in]vers- Version.
Returns
Returns a pointer to the created fillet surface if successful, nullptr otherwise.

◆ CreateKerbTouchingFillet()

static MbFilletSurface* MbFilletSurface::CreateKerbTouchingFillet ( MbSurfaceCurve curv1,
bool  sgn1,
MbSurfaceCurve curv2,
bool  sgn2,
bool  byFirst,
VERSION  vers 
)
static

Create a fillet surface by two support surfaces, specifying the kerb-curve of touching.

If successful, a fillet surface is created with version >= fsv_Ver1.

Parameters
[in]curv1- Support curve at parameters of the first surface
[in]sgn1- The orientation of the first support surface.
[in]curv2- Support curve at parameters of the second surface
[in]sgn2- The orientation of the second support surface.
[in]byFirst- True - curve2 curve is fillet, false - curve1 curve is fillet.
[in]vers- Version.
Returns
Returns a pointer to the created fillet surface if successful, nullptr otherwise.

◆ Init0()

void MbFilletSurface::Init0 ( double  tmin,
double  tmax,
bool  insertPoints = true 
)
overridevirtual

Correction of the middle line of fillet surface.

Correction of the middle line of fillet surface.

Parameters
[in]tmin- New minimal parameter of the middle line.
[in]tmax- New maximal parameter of the middle line.
[in]insertPoints- Insert control points for middle cerve0.

Implements MbSmoothSurface.

◆ Duplicate()

MbSpaceItem& MbFilletSurface::Duplicate ( MbRegDuplicate iReg = nullptr) const
overridevirtual

Create a copy of the object.

Create a copy of an object using the registrator. Registrator is used to prevent multiple copy of the object. If the object contains references to the other objects, then nested objects are copied as well. It is allowed not to pass registrator into the function. Then new copy of object will be created. While copying of single object or set of not connected objects, it is allowed not to use registrator. Registrator should be used if it is required to copy several connected objects. It is possible, that objects connection is based on the references to common objects. Then, while copying without using of registrator, it is possible to obtain set of copies, that contain references to the different copies of the same nested object, that leads to loss of connection between copies.

Parameters
[in]iReg- Registrator.
Returns
A copy of the object.

Implements MbSpaceItem.

◆ IsSame()

bool MbFilletSurface::IsSame ( const MbSpaceItem other,
double  accuracy = LENGTH_EPSILON 
) const
overridevirtual

Determine whether an object is equal.

Still considered objects of the same type, all data is the same (equal).

Parameters
[in]item- The object to compare.
[in]accuracy- The accuracy to compare.
Returns
Whether the objects are equal.

Implements MbSpaceItem.

◆ SetEqual()

bool MbFilletSurface::SetEqual ( const MbSpaceItem item)
overridevirtual

Make objects equal if they are similar.

You can still make only a similar objects.

Parameters
[in]item- The object to initialize.
Returns
Object is changed.

Implements MbSpaceItem.

◆ IsSimilar()

bool MbFilletSurface::IsSimilar ( const MbSpaceItem item) const
overridevirtual

Determine whether an object is similar.

Such are considered the same objects whose data are similar.

Parameters
[in]item- The object to compare.
Returns
Whether the objects are similar.

Reimplemented from MbSpaceItem.

◆ Transform()

void MbFilletSurface::Transform ( const MbMatrix3D matr,
MbRegTransform iReg = nullptr 
)
overridevirtual

Convert the object according to the matrix.

Convert the original object according to the matrix using the registrator. If object contains references to the other geometric objects, then nested objects are transformed according to the matrix. Registrator is needed to prevent multiple object copying. It is allowed to use function without registrator, if it is needed to transform single object. If it is needed to transform a set of connected objects, then one should use registrator to prevent repeating transformation of nested objects, because of the possible situation when several objects contain references to the same common objects, that require to be transformed.

Parameters
[in]matr- Transformation matrix.
[in]iReg- Registrator.

Implements MbSpaceItem.

◆ Move()

void MbFilletSurface::Move ( const MbVector3D to,
MbRegTransform iReg = nullptr 
)
overridevirtual

Move an object along a vector.

Move an object along a geometric vector using the registrator. If object contains references to the other geometric objects then the move operation is applied to the nested objects. Registrator is needed to prevent multiple copying of the object. It is allowed to use function without registrator, if it is needed to transform a single object. If it is needed to transform a set of connected objects, then one should use registrator to prevent repeating transformation of nested objects, because of the possible situation when several objects contain references to the same common objects, that require to be moved.

Parameters
[in]to- Shift vector.
[in]iReg- Registrator.

Implements MbSpaceItem.

◆ Rotate()

void MbFilletSurface::Rotate ( const MbAxis3D axis,
double  angle,
MbRegTransform iReg = nullptr 
)
overridevirtual

Rotate an object around an axis at a given angle.

Rotate an object around an axis at a given angle with the registrator. If object contains references to the other geometric objects then the rotation operation is applied to the nested objects. Registrator is needed to prevent multiple copying of the object. It is allowed to use function without registrator, if it is needed to transform a single object. If it is needed to transform a set of connected objects, then one should use registrator to prevent repeating transformation of nested objects, because of the possible situation when several objects contain references to the same common objects, that require to be rotated.

Parameters
[in]axis- The axis of rotation.
[in]angle- Rotation.
[in]iReg- Registrator.

Implements MbSpaceItem.

◆ GetProperties()

void MbFilletSurface::GetProperties ( MbProperties properties)
overridevirtual

Outstanding properties of the object.

Issue internal data (properties) of the object for viewing and modification.

Parameters
[in]properties- Container for the internal data of the object.

Implements MbSpaceItem.

◆ SetProperties()

void MbFilletSurface::SetProperties ( const MbProperties properties)
overridevirtual

Change the properties of an object.

Changing the internal data (properties) of the object you are copying the corresponding values from the sent object.

Parameters
[in]properties- Container for the internal data of the object.

Implements MbSpaceItem.

◆ PointOn()

void MbFilletSurface::PointOn ( double &  u,
double &  v,
MbCartPoint3D p 
) const
overridevirtual

Calculate a point on the surface.

Correct parameters when getting out of rectangular domain bounds and Calculate a point on the surface.

Parameters
[in]u- First surface parameter.
[in]v- Second surface parameter.
[out]p- A point on the surface.

Implements MbSurface.

◆ _PointOn()

void MbFilletSurface::_PointOn ( double  u,
double  v,
MbCartPoint3D p 
) const
overridevirtual

Calculate a point on the surface.

Calculate a point on the surface including the outside area determination parameters.

Parameters
[in]u- First surface parameter.
[in]v- Second surface parameter.
[out]p- A point on the surface or on extended surface.

Reimplemented from MbSurface.

◆ Explore()

void MbFilletSurface::Explore ( double &  u,
double &  v,
bool  ext,
MbCartPoint3D pnt,
MbVector3D uDer,
MbVector3D vDer,
MbVector3D uuDer,
MbVector3D vvDer,
MbVector3D uvDer,
MbVector3D nor 
) const
overridevirtual

Calculate point and derivatives of object for given parameters.

Values of point and derivatives are calculated on parameters area and on extended surface.

Parameters
[in]u- Parameter.
[in]v- Parameter.
[in]ext- On parameters area (false), on extended surface (true).
[out]pnt- Point.
[out]uDer- Derivative with respect to u.
[out]vDer- Derivative with respect to v.
[out]uuDer- Second derivative with respect to u, if not nullptr.
[out]vvDer- Second derivative with respect to v, if not nullptr.
[out]uvDer- Second derivative with respect to u and v, if not nullptr.

Reimplemented from MbSurface.

◆ _PointNormal()

void MbFilletSurface::_PointNormal ( double  u,
double  v,
MbCartPoint3D pnt,
MbVector3D deru,
MbVector3D derv,
MbVector3D norm,
MbVector3D noru,
MbVector3D norv,
MbVector3D deruu,
MbVector3D dervv,
MbVector3D deruv 
) const
overridevirtual

Calculate all derivatives at point.

Values of point and derivatives are calculated an extended surface.

Parameters
[in]u- Parameter.
[in]v- Parameter.
[out]pnt- Point.
[out]deru- Derivative with respect to u.
[out]derv- Derivative with respect to v.
[out]norm- Normal.
[out]noru- Derivative of normal vector with respect to u.
[out]norv- Derivative of normal vector with respect to v.
[out]deruu- Second derivative with respect to u.
[out]dervv- Second derivative with respect to v.
[out]deruv- Second derivative with respect to u and v.

Reimplemented from MbSurface.

◆ StepU()

double MbFilletSurface::StepU ( double  u,
double  v,
double  sag 
) const
overridevirtual

Calculate parameter step.

Calculate parameter step for the surface approximation by its sag value along a line with a constant value of v. Calculation of the step is performed with consideration of curvature radius. A step of surface approximation along a curve is chosen in such way, that the deviation from its polygon does not exceed the given value of sag.

Parameters
[in]u- A parameter defining a point on the surface.
[in]v- A parameter defining a point on the surface.
[in]sag- Maximum feasible sag value.
Returns
A sag value by parameter at given point.

Reimplemented from MbSurface.

◆ StepV()

double MbFilletSurface::StepV ( double  u,
double  v,
double  sag 
) const
overridevirtual

Calculate parameter step.

Calculate parameter step for the surface approximation by its sag value along a line with a constant value of u. Calculation of the step is performed with consideration of curvature radius. A step of surface approximation along a curve is chosen in such way, that the deviation from its polygon does not exceed the given value of sag.

Parameters
[in]u- A parameter defining a point on the surface.
[in]v- A parameter defining a point on the surface.
[in]sag- Maximum feasible sag value.
Returns
A sag value by parameter at given point.

Reimplemented from MbSurface.

◆ DeviationStepU()

double MbFilletSurface::DeviationStepU ( double  u,
double  v,
double  angle 
) const
overridevirtual

Calculate parameter step.

Calculate parameter step for the surface approximation by the deviation angle of the tangent vector along a line with a constant value of u. A step of surface approximation along a curve is chosen in such way, that angular deviation of the tangent to the curve at the next point does not exceed the given value ang.

Parameters
[in]u- A parameter defining a point on the surface.
[in]v- A parameter defining a point on the surface.
[in]ang- The maximum feasible deviation angle of tangent.
Returns
A sag value by parameter at given point.

Reimplemented from MbSurface.

◆ DeviationStepV()

double MbFilletSurface::DeviationStepV ( double  u,
double  v,
double  angle 
) const
overridevirtual

Calculate parameter step.

Calculate parameter step for the surface approximation by the deviation angle of the tangent vector along a line with a constant value of v. A step of surface approximation along a curve is chosen in such way, that angular deviation of the tangent to the curve at the next point does not exceed the given value ang.

Parameters
[in]u- A parameter defining a point on the surface.
[in]v- A parameter defining a point on the surface.
[in]ang- The maximum feasible deviation angle of tangent.
Returns
A sag value by parameter at given point.

Reimplemented from MbSurface.

◆ MetricStepV()

double MbFilletSurface::MetricStepV ( double  u,
double  v,
double  length 
) const
overridevirtual

Calculate parameter step.

Calculate the parameter step for approximation of a surface by the given metric length of a step along a line with a constant value of v.

Parameters
[in]u- A parameter defining a point on the surface.
[in]v- A parameter defining a point on the surface.
[in]len- The given metric length.
Returns
A sag value by parameter at given point.

Reimplemented from MbSurface.

◆ CurvatureV()

double MbFilletSurface::CurvatureV ( double  u,
double  v 
) const
overridevirtual

Calculate line curvature along the direction of v.

There is calculated a line curvature along the direction of v when u = const.

Parameters
[in]u- Parameter.
[in]v- Parameter.
Returns
Curvature.

Reimplemented from MbSurface.

◆ NurbsSurface() [1/2]

MbSplineSurface* MbFilletSurface::NurbsSurface ( double  u1,
double  u2,
double  v1,
double  v2,
bool  bmatch = false 
) const
overridevirtual

Construct a NURBS copy of trimmed surface.

An obtained surface is always unclosed in u and in v. The exception is the NURBS surface itself. If the surface does not require recalculation, then a copy of it is returned. Parameters u1, u2, v1 and v2 are the bounds of surface trimming.

Parameters
[in]u1- Minimum parameter in U.
[in]u2- Maximum parameter in U.
[in]v1- Minimum parameter in V.
[in]v2- Maximum parameter in V.
[in]bmatch- true, if it is required to keep one-to-one correspondence of parametric regions in mapping.

Reimplemented from MbSurface.

◆ NurbsSurface() [2/2]

MbSurface* MbFilletSurface::NurbsSurface ( const MbNurbsParameters uParam,
const MbNurbsParameters vParam 
) const
overridevirtual

Construct a NURBS copy of a surface.

Constructs a NURBS surface which approximates a given surface with the given parameters in each direction. In parameters the degree and the number of knots of a spline and the range of curve's parameters changing may be set. If the flag of accurate approximation is not set in parameters then NURBS without multiple knots is constructed.

Parameters
[in]uParam- Parameters of construction in u direction.
[in]vParam- Parameters of construction in v direction.
Returns
The constructed NURBS surface or nullptr in a case of failure.

Reimplemented from MbSurface.

◆ Offset()

MbSurface* MbFilletSurface::Offset ( double  d,
bool  same 
) const
overridevirtual

Create an offset surface.

Parameters
[in]d- Distance by the normal vector from the base surface to the offset surface.
[in]same- A flag showing whether to use the current surface or its copy in offset surface.

Reimplemented from MbSurface.

◆ CurveV()

MbCurve3D* MbFilletSurface::CurveV ( double  u,
MbRect1D pRgn,
bool  bApprox = true 
) const
overridevirtual

Construct spatial copy of the line u = const.

Parameters
[in]u- Parameter in U direction.
[in]pRgn- A range of v-parameters.
[in]bApprox- If false, then it returns null only in a case when the exact curve has been successfully created.
If true, then it returns null in a case when the curve is not degenerate.
Returns
Constructed curve.

Reimplemented from MbSurface.

◆ ChangeCarrier()

void MbFilletSurface::ChangeCarrier ( const MbSpaceItem item,
MbSpaceItem init 
)
overridevirtual

Changing of carrier.

It is used for union of coplanar faces.

Reimplemented from MbSurface.

◆ ChangeCarrierBorne()

bool MbFilletSurface::ChangeCarrierBorne ( const MbSurface item,
MbSurface init,
const MbMatrix matr 
)
overridevirtual

Changing of carrier elements.

It is used for union of coplanar faces. The surfaces 'item' and 'init' must be similar.

Parameters
[in]item- Changed surface
[in]init- New surface
[in]matr- Transition matrix from 'item' to 'init'
Returns
True if the operation succeeded
otherwise false.

Reimplemented from MbSurface.

◆ NearPointProjection()

bool MbFilletSurface::NearPointProjection ( const MbCartPoint3D pnt,
double &  u,
double &  v,
bool  ext,
MbRect2D uvRange = nullptr 
) const
overridevirtual

Find the projection of a point onto the surface.

Find the nearest point projection to the surface or its extension by the given initial approximation. If the range of parameters changing 'uvRange' is set, then it is required to find a projection in the given range. A range of parameters may not belong to the domain of a surface. The Newton method is used.

Parameters
[in]pnt- A given point.
[in,out]u- Input - initial approximation, output - parameter of a surface, corresponding to the nearest projection.
[in,out]v- Input - initial approximation, output - parameter of a surface, corresponding to the nearest projection.
[in]ext- A flag defining whether to seek projection on the extension of the surface.
[in]uvRange- A range of parameters changing in which the solution should be found.
Returns
True - if there is found a projection which satisfies to all input conditions.

Reimplemented from MbSurface.

◆ GetFilletRadius()

double MbFilletSurface::GetFilletRadius ( const MbCartPoint3D p,
double  accuracy = METRIC_REGION 
) const
overridevirtual

Get fillet radius if the surface is a fillet surface with the set accuracy.

Get fillet radius if the surface is a fillet surface with the set accuracy. Accuracy is used to compare surface slices to an arc to find rotation axis.

Parameters
[in]p- Point near which the radius is searched. Used when the radius is variable.
[in]accuracy- Accuracy.
Returns
Fillet radius if possible or 0.

Reimplemented from MbSurface.

◆ IsSimilarToSurface()

bool MbFilletSurface::IsSimilarToSurface ( const MbSurface surf,
VERSION  version,
double  precision = METRIC_PRECISION 
) const
overridevirtual

Define whether the surfaces are similar for merge.

Surfaces are similar for merge if they coincide geometrically or one surface transits to another.

Parameters
[in]surf- A given surface.
[in]version- Version of operation.
[in]precision- Precision of calculation.
Returns
True - if surfaces are similar.

Reimplemented from MbSurface.

◆ GetMatrixToSurface()

bool MbFilletSurface::GetMatrixToSurface ( const MbSurface surf,
MbMatrix matr,
VERSION  version,
double  precision = METRIC_PRECISION 
) const
overridevirtual

Get two-dimensional matrix of transformation from its parametric region to the parametric region of 'surf'.

Calculation of matrix of transformation from one parametric region to another. it is performed for the surfaces which are similar for merge.

Parameters
[in]surf- A given surface.
[out]matr- A transformation matrix.
[in]version- Version of operation.
[in]precision- Precision of calculation.
Returns
True - matrix is calculated.

Reimplemented from MbSurface.

◆ Salient()

ThreeStates MbFilletSurface::Salient ( ) const
overridevirtual

Determine whether the surface is convex.

Determine whether the surface is convex.

Determine whether the surface is convex.

Returns
ts_positive - the surface is convex, ts_negative - the surface is concave, ts_neutral - impossible to determine.

Reimplemented from MbSurface.

◆ GetRadius()

double MbFilletSurface::GetRadius ( ) const
overridevirtual

Get the physical radius of the object or null if it impossible.

Method returns maximum physical radius by one of the parametric direction if the corresponding parametric curve is the arc, method returns zero otherwise.

Reimplemented from MbSurface.

◆ SurfacesCombine()

bool MbFilletSurface::SurfacesCombine ( const MbSurfaceIntersectionCurve edge,
const MbSurface init,
bool  add,
MbMatrix matr,
const MbSurfaceIntersectionCurve seam 
)
overridevirtual

Combine surfaces by inclusion of the surface 'init' into the given surface.

Combine surfaces by inclusion of the surface 'init' into the given surface.

Parameters
[in]edge- A curve of the splitting edge.
[in]init- A surface which should be added into the given one
[in]add- Add to end (true) or add to start (false)
[in]matr- A matrix of transformation of objects from 'init' to the given surface,
[in]seam- A curve of another splitting edge (possibly it is nullptr)

Reimplemented from MbSmoothSurface.

◆ GetTesselation()

void MbFilletSurface::GetTesselation ( const MbStepData stepData,
double  u1,
double  u2,
double  v1,
double  v2,
SArray< double > &  uu,
SArray< double > &  vv 
) const
overridevirtual

Determine a splitting of parametric region of a surface by verticals and horizontals.

Determine a splitting of parametric region of a surface by verticals and horizontals during triangulation.

Parameters
[in]stepData- Data for step calculation during triangulation.
[in]u1- Minimal value of u-parameter in the region of surface splitting.
[in]u2- Maximal value of u-parameter in the region of surface splitting.
[in]v1- Minimal value of v-parameter in the region of surface splitting.
[in]v2- Maximal value of v-parameter in the region of surface splitting.
[out]uu- A set of parameters of splitting by u.
[out]vv- A set of parameters of splitting by v.

Reimplemented from MbSurface.

◆ GetWeight()

double MbFilletSurface::GetWeight ( double  u) const

Weights of points of mid-curve.

Weights of points of mid-curve.

Parameters
[in]u- Parameter on mid-curve (by U direction)

◆ GetAngle()

double MbFilletSurface::GetAngle ( double  u) const

Arc opening angle.

Arc opening angle.

Parameters
[in]u- Parameter by U direction
Returns
Angle of opening

◆ GetLocalAxis()

double MbFilletSurface::GetLocalAxis ( double  u,
MbAxis3D axis 
) const

Axis of surface at given point.

Axis of surface at given point.

Parameters
[in]u- Parameter by U direction
[out]axis- Result - rotation axis

◆ GetCentrePoint()

void MbFilletSurface::GetCentrePoint ( double  u,
MbCartPoint3D p1,
MbCartPoint3D p2,
MbCartPoint3D p0 
) const

Get point on axis.

Get point on axis.

Parameters
[in]u- Parameter by U direction
[out]p1- Point on first support curve by U parameter
[out]p2- Point on second support curve by U parameter
[out]p0- Point on intersection curve of tangents to surfaces by u parameter (point on axis)

◆ GetMiddlePoint()

bool MbFilletSurface::GetMiddlePoint ( double  u,
MbCartPoint3D p1,
MbCartPoint3D p2,
MbCartPoint3D p0,
double &  w 
) const

Get the mid-point.

Get the mid-point.

Parameters
[in]u- Parameter by U direction
[out]p1- Point on first support curve by U parameter
[out]p2- Point on second support curve by U parameter
[out]p0- Mid-point
[out]w- Weight of obtained mid-point

◆ GetVPeriod()

double MbFilletSurface::GetVPeriod ( double  u) const

Period by direction V.

Period by direction V.
If parameterization of surface is uniform, then period by direction V depends on U parameter.

Parameters
[in]u- Parameter by U direction
Returns
Period for given parameter

◆ IsEllipse()

bool MbFilletSurface::IsEllipse ( ) const
inline

Fillet isn't circular.

Fillet isn't circular.

Returns
True if surfaces fillet radii aren't equal

◆ IsFilletSurface()

bool MbFilletSurface::IsFilletSurface ( ) const
inline

Whether the fillet surface is homogeneous.

Whether the fillet surface is homogeneous. Fillet surface without preservation of fillet.

Returns
False if one of curve1 or curve2 curves is fillet

◆ IsConic()

bool MbFilletSurface::IsConic ( ) const
inline

General conic section.

General conic section.

Returns
False if section of fillet surface is circular arc

◆ Conic()

double MbFilletSurface::Conic ( ) const
inline

Coefficient of shape.

Coefficient of shape of section of fillet surface.
Is changed between 0.05 and 0.95, if 0, then section is circular arc.

Returns
Coefficient

◆ IsKerbSurface()

bool MbFilletSurface::IsKerbSurface ( ) const
inline

Fillet surface with preservation of fillet.

Fillet surface with preservation of fillet.

Returns
True if one of curve1 or curve2 curves is fillet

◆ ByFirstCurve()

bool MbFilletSurface::ByFirstCurve ( ) const
inline

Whether the first curve is fillet.

Whether the first curve is fillet.

Returns
True if the first curve is fillet.

◆ SetKerbSurface()

void MbFilletSurface::SetKerbSurface ( bool  bc1)
inline

Set fillet surface with preservation of fillet. Need to call this->Init0() after this method.

Set fillet surface with preservation of fillet.

Parameters
[in]bc1- General curve on surface: curve1 (bc1 = true), curve2 (bc1 = false).

The documentation for this class was generated from the following file: