Files
Extern/C3d/Include/surf_exploration_surface.h
T
Dario Sassi e8f0fa2d27 Extern :
- C3d aggiornamento delle librerie.
2020-09-14 16:42:31 +00:00

195 lines
15 KiB
C++

////////////////////////////////////////////////////////////////////////////////
/**
\file
\brief \ru Поверхность заметания с масштабированием и поворотом образующей кривой.
\en The swept surface with scaling and winding of generation curve. \~
*/
////////////////////////////////////////////////////////////////////////////////
#ifndef __SURF_EXTENSION_SURFACE_H
#define __SURF_EXTENSION_SURFACE_H
#include <surf_evolution_surface.h>
#include <mb_axis3d.h>
class MATH_CLASS MbFunction;
//------------------------------------------------------------------------------
/** \brief \ru Поверхность заметания с масштабированием и поворотом образующей кривой.
\en The swept surface with scaling and winding of generation curve. \~
\details \ru Кинематическая поверхность образуется путем движения образующей кривой curve по направляющей кривой spine->curve.
В процессе движения вдоль направляющей кривой образующая кривая сохраняет своё положение в движущейся локальной системе координат,
начало которой совпадает с текущей точкой базовой кривой.
Одна из осей движущейся локальной системы координат всегда совпадает с касательной направляющей кривой,
а две другие оси ортогональны ей.
Первый параметр поверхности совпадает с параметром образующей кривой.
Второй параметр поверхности совпадает с параметром направляющей кривой.
\en Sweep with guide curve surface is formed by moving the 'curve' generating curve along spine->curve guide curve.
While moving along a guide curve the generating curve keeps its position in the moving local coordinate system,
which origin coincides with the current point of the base curve.
One of the axes of the moving local coordinate system is always coincident to the tangent of the guide curve,
and the other two axes are orthogonal to it.
First parameter of surface coincides with parameter of generating curve.
Second parameter of surface coincides with parameter of guide curve. \~
\ingroup Surfaces
*/
// ---
class MATH_CLASS MbExplorationSurface : public MbEvolutionSurface {
protected:
MbFunction * scaling; ///< \ru Функция второго параметра (v) масштабирования образующей кривой. \en The function of curve scale by second parameter (v).
MbFunction * winding; ///< \ru Функция второго параметра (v) вращения образующей кривой. \en The function of curve rotation by second parameter (v).
MbAxis3D axis; ///< \ru Не пишется. \en The axis are not writing.
protected:
/** \brief \ru Конструктор по образующей и направляющей.
\en Constructor by generating curve and guide curve. \~
\details \ru Конструктор по образующей и направляющей.
\en Constructor by generating curve and guide curve. \~
\param[in] c - \ru Образующая
\en Generating curve \~
\param[in] s - \ru Направляющая
\en Guide curve \~
\param[in] sameCurve - \ru Признак использования оригинала образующей, а не копии
\en Attribute of usage of original of generating curve, not a copy \~
\param[in] sameSpine - \ru Признак использования оригинала направляющей, а не копии
\en Attribute of usage of original of guide curve, not a copy \~
*/
MbExplorationSurface( const MbCurve3D & c, const MbSpine & s, bool sameCurve, bool sameSpine,
MbFunction & _scaling, MbFunction & _winding );
protected:
MbExplorationSurface( const MbExplorationSurface &, MbRegDuplicate * );
private:
MbExplorationSurface( const MbExplorationSurface & ); // \ru Не реализовано. \en Not implemented.
public:
virtual ~MbExplorationSurface();
public:
VISITING_CLASS( MbExplorationSurface );
/** \ru \name Общие функции геометрического объекта
\en \name Common functions of a geometric object
\{ */
virtual MbeSpaceType IsA() const; // \ru Тип элемента \en A type of element
virtual MbSpaceItem & Duplicate( MbRegDuplicate * = NULL ) const; // \ru Сделать копию элемента. \en Create a copy of the element.
virtual bool IsSame ( const MbSpaceItem & other, double accuracy = LENGTH_EPSILON ) const; // \ru Равны ли объекты. \en Whether the objects are equal.
virtual bool SetEqual ( const MbSpaceItem & ); // \ru Сделать равным. \en Make equal.
virtual bool IsSimilar ( const MbSpaceItem & ) const; // \ru Являются ли объекты подобными. \en Determine whether the objects are similar.
virtual void Transform( const MbMatrix3D &, MbRegTransform * = NULL ); // \ru Преобразовать элемент согласно матрице. \en Transform element according to the matrix.
virtual void Move ( const MbVector3D &, MbRegTransform * = NULL ); // \ru Сдвиг. \en Move.
virtual void Rotate ( const MbAxis3D &, double angle, MbRegTransform * = NULL ); // \ru Повернуть вокруг оси. \en Rotate around an axis.
virtual void GetProperties( MbProperties & ); // \ru Выдать свойства объекта. \en Get properties of the object.
virtual void SetProperties( const MbProperties & ); // \ru Записать свойства объекта. \en Set properties of the object.
/** \} */
/** \ru \name Функции для работы в области определения поверхности
Функции PointOn, Derive... поверхностей корректируют параметры
при выходе их за пределы прямоугольной области определения параметров.\n
\en \name Functions for working at surface domain
Functions PointOn, Derive... of surfaces correct parameters
when they are out of bounds of rectangular domain of parameters.\n
\{ */
virtual void PointOn ( double & u, double & v, MbCartPoint3D & ) const; // \ru Точка на поверхности. \en The point on the surface.
virtual void DeriveU ( double & u, double & v, MbVector3D & ) const; // \ru Первая производная по u. \en The first derivative with respect to u.
virtual void DeriveV ( double & u, double & v, MbVector3D & ) const; // \ru Первая производная по v. \en The first derivative with respect to v.
virtual void DeriveUU ( double & u, double & v, MbVector3D & ) const; // \ru Вторая производная по u. \en The second derivative with respect to u.
virtual void DeriveVV ( double & u, double & v, MbVector3D & ) const; // \ru Вторая производная по v. \en The second derivative with respect to v.
virtual void DeriveUV ( double & u, double & v, MbVector3D & ) const; // \ru Вторая производная по uv. \en The second derivative with respect to uv.
virtual void DeriveUUU( double & u, double & v, MbVector3D & ) const;
virtual void DeriveUUV( double & u, double & v, MbVector3D & ) const;
virtual void DeriveUVV( double & u, double & v, MbVector3D & ) const;
virtual void DeriveVVV( double & u, double & v, MbVector3D & ) const;
/** \} */
/** \ru \name Функции для работы внутри и вне области определения поверхности
функции _PointOn, _Derive... поверхностей не корректируют
параметры при выходе их за пределы прямоугольной области определения параметров.
\en \name 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.
\{ */
virtual void _PointOn ( double u, double v, MbCartPoint3D & ) const; // \ru Точка на расширенной поверхности. \en The point on the extended surface.
virtual void _DeriveU ( double u, double v, MbVector3D & ) const; // \ru Первая производная по u. \en The first derivative with respect to u.
virtual void _DeriveV ( double u, double v, MbVector3D & ) const; // \ru Первая производная по v. \en The first derivative with respect to v.
virtual void _DeriveUU ( double u, double v, MbVector3D & ) const; // \ru Вторая производная по u. \en The second derivative with respect to u.
virtual void _DeriveVV ( double u, double v, MbVector3D & ) const; // \ru Вторая производная по v. \en The second derivative with respect to v.
virtual void _DeriveUV ( double u, double v, MbVector3D & ) const; // \ru Вторая производная по uv. \en The second derivative with respect to uv.
virtual void _DeriveUUU( double u, double v, MbVector3D & ) const;
virtual void _DeriveUUV( double u, double v, MbVector3D & ) const;
virtual void _DeriveUVV( double u, double v, MbVector3D & ) const;
virtual void _DeriveVVV( double u, double v, MbVector3D & ) const;
/** \} */
/** \ru \name Функции доступа к группе данных для работы внутри и вне области определения параметров поверхности.
\en \name Functions for get of the group of data inside and outside the surface's domain of parameters.
\{ */
virtual void Explore( double & u, double & v, bool ext,
MbCartPoint3D & pnt, MbVector3D & uDer, MbVector3D & vDer,
MbVector3D * uuDer, MbVector3D * vvDer, MbVector3D * uvDer, MbVector3D * nor ) const;
/** \} */
/** \ru \name Функции движения по поверхности
\en \name Functions of moving along the surface
\{ */
virtual double StepU ( double u, double v, double sag ) const; // \ru Вычисление шага по u по заданной стрелке прогиба. \en Calculation of the parameter step in u direction by the sag.
virtual double StepV ( double u, double v, double sag ) const; // \ru Вычисление шага по v по заданной стрелке прогиба. \en Calculation of the parameter step in v direction by the sag.
virtual double DeviationStepU( double u, double v, double angle ) const; // \ru Вычисление шага по u по заданному углу отклонения. \en Calculation of the parameter step in u direction by the deviation angle.
virtual double DeviationStepV( double u, double v, double angle ) const; // \ru Вычисление шага по v по заданному углу отклонения. \en Calculation of the parameter step in v direction by the deviation angle.
/** \} */
/** \ru \name Общие функции поверхности
\en \name Common functions of surface
\{ */
virtual MbSplineSurface * NurbsSurface( double, double, double, double, bool bmatch = false ) const; // \ru NURBS копия поверхности. \en NURBS copy of a surface.
virtual MbSurface * Offset( double d, bool same ) const; // \ru Создание эквидистантной поверхности. \en Create an offset surface.
virtual MbCurve3D * CurveU( double v, MbRect1D *pRgn, bool bApprox = true ) const; // \ru Пространственная копия линии v = const. \en Spatial copy of 'v = const'-line.
virtual MbCurve3D * CurveV( double u, MbRect1D *pRgn, bool bApprox = true ) const; // \ru Пространственная копия линии u = const. \en Spatial copy of 'u = const'-line.
// \ru Определение разбивки параметрической области поверхности вертикалями и горизонталями. \en Determine splitting of parametric region of surface by vertical and horizontal lines.
virtual void GetTesselation( const MbStepData & stepData,
double u1, double u2, double v1, double v2,
SArray<double> & uu, SArray<double> & vv ) const;
virtual size_t GetUCount() const; // \ru Количество разбиений по параметру u для проверки событий. \en The number of splittings by u-parameter for a check of events.
virtual size_t GetVCount() const; // \ru Количество разбиений по параметру v для проверки событий. \en The number of splittings by v-parameter for a check of events.
virtual size_t GetUMeshCount() const; // \ru Выдать количество полигонов по u. \en Get the count of polygons by u.
virtual size_t GetVMeshCount() const; // \ru Выдать количество полигонов по v. \en Get the count of polygons by v.
//------------------------------------------------------------------------------
/** \brief \ru Создать кинематическую поверхность.
\en Create an evolution surface. \~
\details \ru Создать кинематическую поверхность.
\en Create an evolution surface. \~
\param[in] curve - \ru Образующая кривая
\en Generating curve \~
\param[in] spine - \ru Направляющая кривая
\en Guide curve \~
\param[in] samec - \ru Признак использования оригинала образующей кривой, а не копии
\en Attribute of usage of original of generating curve, not a copy \~
\param[in] sFunc - \ru Функция масштабирования образующей кривой.
\en The function of curve scaling. \~
\param[in] rFunc - \ru Функция вращения образующей кривой.
\en The function of curve rotation. \~
\return \ru Возвращает созданную поверхность.
\en Return the created surface. \~
\ingroup Surface_Modeling
*/
// ---
static MbSurface * Create( const MbCurve3D & curve, const MbSpine & spine, bool samec, bool sames,
MbFunction & _scaling, MbFunction & _winding );
protected :
void Init();
private:
void operator = ( const MbExplorationSurface & ); // \ru Не реализовано. \en Not implemented.
DECLARE_PERSISTENT_CLASS_NEW_DEL( MbExplorationSurface )
};
#endif // __SURF_EXTENSION_SURFACE_H