C3D Toolkit  Kernel - 105122, Vision - 0.181114.105122

Кривая в двумерном пространстве. Подробнее...

Граф наследования:MbCurve:
[см. легенду]
Граф связей класса MbCurve:
[см. легенду]

Открытые члены

virtual ~MbCurve ()
 Деструктор.
 
virtual MbePlaneType IsA () const =0
 Получить тип объекта.
 
virtual MbePlaneType Type () const
 Получить групповой тип объекта.
 
virtual MbePlaneType Family () const
 Получить семейство объекта.
 
virtual MbPlaneItemDuplicate (MbRegDuplicate *=NULL) const =0
 Создать копию. Подробнее...
 
virtual void Transform (const MbMatrix &, MbRegTransform *ireg=NULL, const MbSurface *newSurface=NULL)=0
 Преобразовать согласно матрице. Подробнее...
 
virtual void Move (const MbVector &, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)=0
 Сдвинуть вдоль вектора. Подробнее...
 
virtual void Rotate (const MbCartPoint &pnt, const MbDirection &angle, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)=0
 Повернуть вокруг точки. Подробнее...
 
virtual bool SetEqual (const MbPlaneItem &)=0
 Сделать объекты равным. Подробнее...
 
virtual bool IsSame (const MbPlaneItem &other, double accuracy=LENGTH_EPSILON) const =0
 Определить, являются ли объекты равными. Подробнее...
 
virtual void Refresh ()
 Перевести все временные (mutable) данные объекта в неопределённое (исходное) состояние.
 
virtual void PrepareIntegralData (const bool forced) const
 Рассчитать временные (mutable) данные объекта. Подробнее...
 
virtual void AddYourGabaritTo (MbRect &) const =0
 Расширить присланный габаритный прямоугольник так, чтобы он включал в себя данный объект.
 
size_t size () const
 Размер кривой трактуемой как в виде вектора кривых.
 
const MbCurveoperator[] (size_t) const
 Оператор доступа.
 
Общие функции двумерного объекта.
virtual void AddYourGabaritMtr (MbRect &rect, const MbMatrix &matr) const
 Добавить габарит в прямоугольник. Подробнее...
 
virtual void CalculateGabarit (MbRect &) const
 Определить габаритный прямоугольник кривой. Подробнее...
 
virtual void CalculateLocalGabarit (const MbMatrix &into, MbRect &local) const
 Рассчитать габарит в локальной системы координат. Подробнее...
 
virtual bool IsVisibleInRect (const MbRect &rect, bool exact=false) const
 Определить видимость объекта в прямоугольнике. Подробнее...
 
virtual bool IsCompleteInRect (const MbRect &rect) const
 Определить, виден ли объект полностью в прямоугольнике. Подробнее...
 
virtual double DistanceToPoint (const MbCartPoint &toP) const
 Вычислить расстояние до точки.
 
virtual bool DistanceToPointIfLess (const MbCartPoint &toP, double &d) const
 Вычислить расстояние до точки. Подробнее...
 
Функции описания области определения кривой.
virtual double GetTMax () const =0
 Получить максимальное значение параметра.
 
virtual double GetTMin () const =0
 Получить минимальное значение параметра.
 
virtual bool IsClosed () const =0
 Определить, является ли кривая замкнутой. Подробнее...
 
virtual double GetPeriod () const
 Вернуть период. Подробнее...
 
virtual bool IsPeriodic () const
 Определить, является ли замкнутая кривая периодической.
 
bool IsTouch (double eps=Math::LengthEps) const
 Определить, замкнута ли кривая фактически независимо от гладкости замыкания. Подробнее...
 
Функции для работы в области определения кривой.

Функции PointOn, FirstDer, SecondDer, ThirdDer,... корректируют параметр при выходе его за пределы области определения. Исключение составляет MbLine (прямая).

virtual void PointOn (double &t, MbCartPoint &p) const =0
 Вычислить точку на кривой. Подробнее...
 
virtual void FirstDer (double &t, MbVector &v) const =0
 Вычислить первую производную.
 
virtual void SecondDer (double &t, MbVector &v) const =0
 Вычислить вторую производную.
 
virtual void ThirdDer (double &t, MbVector &v) const =0
 Вычислить третью производную.
 
void Tangent (double &t, MbVector &v) const
 Вычислить касательный вектор (нормализованный).
 
void Tangent (double &t, MbDirection &d) const
 Вычислить касательный вектор (нормализованный).
 
void Normal (double &t, MbVector &v) const
 Вычислить вектор главной нормали (нормализованный).
 
void Normal (double &t, MbDirection &d) const
 Вычислить вектор главной нормали (нормализованный).
 
Функции для работы внутри и вне области определения кривой.

Функции _PointOn, _FirstDer, _SecondDer, _ThirdDer,... не корректируют параметр при выходе за пределы области определения. При выходе за область определения незамкнутая кривая, в общем случае, продолжается по касательной, которую она имеет на соответствующем конце. Исключение составляют дуги эллипса и окружности - они продолжаются в соответствии со своими уравнениями.

virtual void _PointOn (double t, MbCartPoint &p) const
 Вычислить точку на кривой и её продолжении. Подробнее...
 
virtual void _FirstDer (double t, MbVector &v) const
 Вычислить первую производную на кривой и её продолжении.
 
virtual void _SecondDer (double t, MbVector &v) const
 Вычислить вторую производную на кривой и её продолжении.
 
virtual void _ThirdDer (double t, MbVector &v) const
 Вычислить третью производную на кривой и её продолжении.
 
void _Tangent (double t, MbVector &v) const
 Вычислить касательный вектор (нормализованный).
 
void _Tangent (double t, MbDirection &d) const
 Вычислить касательный вектор (нормализованный).
 
void _Normal (double t, MbVector &v) const
 Вычислить вектор главной нормали (нормализованный) на кривой и её продолжении.
 
void _Normal (double t, MbDirection &d) const
 Вычислить вектор главной нормали (нормализованный) на кривой и её продолжении.
 
virtual void Explore (double &t, bool ext, MbCartPoint &pnt, MbVector &fir, MbVector *sec, MbVector *thir) const
 Вычислить значения точки и производных для заданного параметра. Подробнее...
 
Функции движения по кривой
virtual double Step (double t, double sag) const
 Вычислить шаг параметра. Подробнее...
 
virtual double DeviationStep (double t, double ang) const
 Вычислить шаг параметра. Подробнее...
 
Общие функции кривой
virtual double Curvature (double t) const
 Вычислить кривизну кривой.
 
double CurvatureDerive (double t) const
 Вычислить производную кривизны по параметру.
 
double CurvatureRadius (double t) const
 Вычислить радиус кривизны кривой со знаком.
 
virtual bool HasLength (double &length) const =0
 Вычислить метрическую длину кривой. Подробнее...
 
virtual bool IsBounded () const
 Определить, является ли кривая ограниченной.
 
virtual bool IsStraight () const
 Определить, является ли кривая прямолинейной.
 
virtual bool IsDegenerate (double eps=Math::LengthEps) const
 Определить, является ли кривая вырожденной.
 
virtual bool IsSmoothConnected (double angleEps) const
 Определить, являются ли стыки контура/кривой гладкими.
 
double GetParamLength () const
 Вычислить параметрическую длину кривой.
 
virtual double CalculateMetricLength () const
 Вычислить метрическую длину кривой.
 
virtual double CalculateLength (double t1, double t2) const
 Вычислить метрическую длину кривой. Подробнее...
 
virtual double GetMetricLength () const =0
 Вычислить метрическую длину кривой. Подробнее...
 
virtual bool DistanceAlong (double &t, double len, int curveDir, double eps=Math::LengthEps, VERSION version=Math::DefaultMathVersion()) const
 Сдвинуть параметр вдоль кривой. Подробнее...
 
virtual void ResetTCalc () const
 Сбросить текущее значение параметра.
 
virtual void Inverse (MbRegTransform *iReg=NULL)=0
 Изменить направления кривой на противоположное.
 
virtual MbCurveOffset (double rad) const
 Построить кривую, смещённую на заданное расстояние.
 
virtual bool BeginApprox (double sag, double &tbeg, double &tend, MbCartPoint &pnt, bool &existNextPoint) const
 Начать аппроксимацию для отрисовки. Подробнее...
 
virtual bool GetNextPoint (double sag, double tend, double &tcur, MbCartPoint &pnt) const
 Вычислить очередную точку. Подробнее...
 
virtual void CalculatePolygon (double sag, MbPolygon &poligon) const
 Рассчитать массив точек для отрисовки. Подробнее...
 
MbNurbsNurbsCurve (const MbCurveIntoNurbsInfo *nInfo=NULL) const
 Построить NURBS копию кривой. Подробнее...
 
virtual MbNurbsNurbsCurve (const MbCurveIntoNurbsInfo &nInfo) const =0
 Построить NURBS копию кривой. Подробнее...
 
virtual MbCurveNurbsCurve (const MbNurbsParameters &tParameters) const
 Построить NURBS копию кривой. Подробнее...
 
virtual MbCurveTrimmed (double t1, double t2, int sense) const =0
 Построить усеченную кривую. Подробнее...
 
virtual MbContourNurbsContour () const
 Аппроксимировать кривую контуром из NURBS-кривых.
 
virtual MbeState Deformation (const MbRect &rect, const MbMatrix &matr)
 Деформировать кривую. Подробнее...
 
virtual bool IsInRectForDeform (const MbRect &) const
 Определить видимость кривой в прямоугольнике.
 
virtual MbeState DeletePart (double t1, double t2, MbCurve *&part2)=0
 Удалить часть кривой. Подробнее...
 
virtual MbeState TrimmPart (double t1, double t2, MbCurve *&part2)=0
 Оставить часть кривой. Подробнее...
 
virtual MbeItemLocation PointRelative (const MbCartPoint &pnt, double eps=Math::LengthEps) const
 Определить положение точки относительно кривой. Подробнее...
 
virtual MbeLocation PointLocation (const MbCartPoint &pnt, double eps=Math::LengthEps) const
 Положение точки относительно кривой.
 
virtual double PointProjection (const MbCartPoint &pnt) const
 Найти проекцию точки на кривую.
 
MbeNewtonResult PointProjectionNewton (const MbCartPoint &p, double xEpsilon, double yEpsilon, size_t iterLimit, double &t, bool ext) const
 Найти проекцию точки на кривую. Подробнее...
 
virtual bool NearPointProjection (const MbCartPoint &pnt, double xEpsilon, double yEpsilon, double &t, bool ext, MbRect1D *tRange=NULL) const
 Найти проекцию точки на кривую. Подробнее...
 
void PointProjection (const MbCartPoint &pnt, MbCartPoint &on) const
 Вычислить проекцию точки на кривую. Подробнее...
 
void BasePointProjection (const MbCartPoint &pnt, MbCartPoint &on) const
 Вычислить проекцию точки на кривую. Подробнее...
 
void PointProjectionAndAngle (MbCartPoint &on, double &angle) const
 Вычислить проекцию точки на кривую. Подробнее...
 
bool DirectPointProjection (const MbCartPoint &pnt, const MbDirection &dir, MbCartPoint &pp) const
 Вычислить проекцию точки на кривую. Подробнее...
 
virtual bool SmallestPerpendicular (const MbCartPoint &pnt, double &tProj) const
 Найти ближайший перпендикуляр к кривой. Подробнее...
 
virtual void TangentPoint (const MbCartPoint &pnt, SArray< double > &tFind) const
 Найти касательные к кривой. Подробнее...
 
virtual void PerpendicularPoint (const MbCartPoint &pnt, SArray< double > &tFind) const
 Найти перпендикуляры к кривой. Подробнее...
 
virtual void IntersectHorizontal (double y, SArray< double > &cross) const
 Найти пересечения кривой с горизонтальной прямой. Подробнее...
 
virtual void IntersectVertical (double x, SArray< double > &cross) const
 Найти пересечения кривой с вертикальной прямой. Подробнее...
 
virtual void Isoclinal (const MbVector &angle, SArray< double > &tFind) const
 Построить изоклины. Подробнее...
 
void HorzIsoclinal (SArray< double > &tFind) const
 Построить горизонтальные изоклины. Подробнее...
 
void VertIsoclinal (SArray< double > &tFind) const
 Построить вертикальные изоклины. Подробнее...
 
void LowestPoint (MbCartPoint &lowestPoint, double &tLowest) const
 Найти нижнюю точку кривой и соответствующий ей параметр.
 
virtual void SelfIntersect (SArray< MbCrossPoint > &crossPnt) const
 Найти самопересечения кривой. Подробнее...
 
virtual void OffsetCuspPoint (SArray< double > &tCusps, double dist) const
 Найти особые точки эквидистантной кривой. Подробнее...
 
virtual bool GoThroughPoint (MbCartPoint &pnt)
 Провести кривую через точку. Подробнее...
 
virtual bool GetMiddlePoint (MbCartPoint &) const
 Вычислить среднюю точку кривой.
 
virtual void GetStartPoint (MbCartPoint &) const
 Вычислить начальную точку кривой.
 
virtual void GetEndPoint (MbCartPoint &) const
 Вычислить конечную точку кривой.
 
virtual bool GetCentre (MbCartPoint &) const
 Вычислить центр кривой.
 
virtual double GetRadius () const
 Дать физический радиус скривой или ноль, если это невозможно. Подробнее...
 
virtual bool GetAxisPoint (MbCartPoint &p) const
 Вычислить точку для построения оси. Подробнее...
 
virtual bool IsSimilarToCurve (const MbCurve &curve, double precision=PARAM_PRECISION) const
 Определить, подобны ли кривые для объединения (слива).
 
virtual size_t GetCount () const
 Определить количество разбиений для прохода в операциях.
 
void GetPointsByEvenParamDelta (size_t n, std::vector< MbCartPoint > &pnts) const
 Выдать n точек кривой с равными интервалами по параметру.
 
void GetPointsByEvenParamDelta (size_t n, SArray< MbCartPoint > &pnts) const
 
virtual void GetPointsByEvenLengthDelta (size_t n, std::vector< MbCartPoint > &pnts) const
 Выдать n точек кривой с равными интервалами по длине дуги.
 
void GetPointsByEvenLengthDelta (size_t n, SArray< MbCartPoint > &pnts) const
 
virtual double LengthBetween2Points (MbCartPoint &p1, MbCartPoint &p2, MbCartPoint *pc=NULL) const
 Вычислить минимальную длину кривой между двумя точками на ней. Подробнее...
 
virtual bool GetWeightCentre (MbCartPoint &) const
 Вычислить центр тяжести кривой.
 
bool IsPointOn (const MbCartPoint &, double eps=Math::LengthEps) const
 Проверить лежит ли точка на кривой с точностью eps.
 
bool IsParamOn (double t, double eps=Math::paramEpsilon) const
 Проверить лежит ли параметр в диапазоне кривой с точностью eps.
 
void CorrectCyclicParameter (double &t, double eps=Math::paramRegion) const
 Корректировать параметр для замкнутых кривых. Подробнее...
 
void CorrectParameter (double &t) const
 Корректировать параметр. Подробнее...
 
MbCurveInverseDuplicate () const
 Сделать копию с измененным направлением.
 
bool IsInverseSame (const MbCurve &curve, double accuracy=LENGTH_EPSILON) const
 Определить, являются ли кривая инверсно такой же.
 
virtual bool IsReparamSame (const MbCurve &curve, double &factor) const
 Определить, является ли кривая репараметризованно такой же. Подробнее...
 
MbCartPoint GetLimitPoint (ptrdiff_t number) const
 Вычислить граничную точку. Подробнее...
 
void GetLimitPoint (ptrdiff_t number, MbCartPoint &pnt) const
 Вычислить граничную точку. Подробнее...
 
void GetLimitTangent (ptrdiff_t number, MbVector &v) const
 Вычислить касательный вектор в граничной точке. Подробнее...
 
void GetLimitPointAndTangent (ptrdiff_t number, MbCartPoint &pnt, MbVector &v) const
 Вычислить касательный вектор и точку на конце кривой. Подробнее...
 
bool AreLimitPointsEqual () const
 Равны ли граничные точки? Подробнее...
 
virtual bool GetSpecificPoint (const MbCartPoint &from, double &dmax, MbCartPoint &pnt) const
 Вернуть характерную точку кривой. Подробнее...
 
virtual const MbCurveGetBasisCurve () const
 Вернуть базовую кривую, если есть, или себя.
 
virtual MbCurveSetBasisCurve ()
 Вернуть базовую кривую, если есть, или себя.
 
virtual double GetParamDelta () const
 Вернуть отступ по параметру кривой.
 
virtual const MbCurveGetSubstrate () const
 Выдать подложку или себя.
 
virtual MbCurveSetSubstrate ()
 Выдать подложку или себя.
 
virtual int SubstrateCurveDirection () const
 Вернуть направление подложки относительно кривой или наоборот.
 
virtual void SubstrateToCurve (double &) const
 Преобразовать параметр подложки в параметр кривой.
 
virtual void CurveToSubstrate (double &) const
 Преобразовать параметр кривой в параметр подложки.
 
virtual double GetLengthEvaluation () const
 Вычислить метрическую длину кривой. Подробнее...
 
virtual double GetParamToUnit () const
 Вернуть приращение параметра, соответствующее единичной длине в пространстве.
 
virtual double GetParamToUnit (double t) const
 Вернуть приращение параметра, соответствующее единичной длине в пространстве в зависимости от параметра.
 
virtual double GetTEpsilon (double epsilon) const
 Вернуть минимально различимую величину параметра с заданной точностью.
 
virtual double GetTEpsilon (double t, double epsilon) const
 Вернуть минимально различимую величину параметра с заданной точностью в зависимости от параметра.
 
virtual double GetTRegion (double epsilon) const
 Вернуть минимально различимую величину параметра с заданной точностью.
 
virtual double GetTRegion (double t, double epsilon) const
 Вернуть минимально различимую величину параметра с заданной точностью в зависимости от параметра.
 
double GetTMid () const
 Вернуть середину параметрического диапазона кривой.
 
double GetTRange () const
 Вернуть параметрическую длину кривой.
 
MbCartPoint PointOn (double &t) const
 Вычислить точку на кривой.
 
MbVector FirstDer (double &t) const
 Вычислить первую производную.
 
MbDirection Tangent (double &t) const
 Вычислить касательный вектор (нормализованный).
 
MbDirection Normal (double &t) const
 Вычислить нормальный вектор.
 
double DerLength (double &t) const
 Вычислить длину вектора производной.
 
virtual MbPropertyCreateProperty (MbePrompt name) const
 Создать собственное свойство.
 
virtual void GetProperties (MbProperties &properties)=0
 Выдать свойства объекта.
 
virtual void SetProperties (const MbProperties &properties)=0
 Записать свойства объекта.
 
virtual void GetBasisPoints (MbControlData &) const =0
 Выдать базовые точки кривой.
 
virtual void SetBasisPoints (const MbControlData &)=0
 Изменить объект по контрольным точкам.
 
bool IsSpaceNear (const MbCurve &curve, double eps, bool ext, double devSag=5.0 *Math::deviateSag) const
 Определить, близки ли две кривые метрически. Подробнее...
 
bool IsSpaceNear (const MbCurve &curve, double xEps, double yEps, bool ext, double xNear, double yNear, double devSag=5.0 *Math::deviateSag) const
 Определить, близки ли две кривые метрически. Подробнее...
 
SimpleName GetCurveName () const
 Имя кривой.
 
void SetCurveName (SimpleName newName)
 Установить имя кривой.
 
- Открытые члены унаследованные от MbPlaneItem
virtual ~MbPlaneItem ()
 Деструктор.
 
void PrepareWrite ()
 Регистрация объекта. Подробнее...
 
virtual MbeRefType RefType () const
 Получить регистрационный тип (для копирования, дублирования).
 
void Rotate (const MbCartPoint &pnt, double angle, MbRegTransform *iReg=NULL, const MbSurface *newSurface=NULL)
 Повернуть вокруг точки. Подробнее...
 
virtual bool IsSimilar (const MbPlaneItem &item) const
 Определить, являются ли объекты подобными. Подробнее...
 
- Открытые члены унаследованные от TapeBase
 TapeBase (RegistrableRec regs=noRegistrable)
 Конструктор.
 
 TapeBase (const TapeBase &other)
 Конструктор копирования
 
virtual ~TapeBase ()
 Деструктор.
 
RegistrableRec GetRegistrable () const
 Является ли потоковый класс регистрируемым.
 
void SetRegistrable (RegistrableRec regs=registrable) const
 Установить состояние регистрации потокового класса.
 
virtual ClassDescriptor GetClassDescriptor (const VersionContainer &) const =0
 Получить дескриптор класса
 
virtual const char * GetPureName (const VersionContainer &) const
 Получить имя класса.
 
virtual bool IsFamilyRegistrable () const
 Принадлежит ли объект к регистрируемому семейству.
 
- Открытые члены унаследованные от MbRefItem
 MbRefItem ()
 Конструктор без параметров.
 
refcount_t GetUseCount () const
 Выдать количество ссылок (выдать количество владельцев объекта).
 
refcount_t AddRef () const
 Увеличить количество ссылок на единицу.
 
refcount_t DecRef () const
 Уменьшить количество ссылок на единицу.
 
refcount_t Release () const
 Уменьшить количество ссылок на единицу и, если количество ссылок стало равным нулю, удалить себя.
 

Защищенные члены

 MbCurve ()
 Конструктор по умолчанию.
 
 MbCurve (const MbCurve &other)
 Конструктор копирования.
 
- Защищенные члены унаследованные от MbPlaneItem
 MbPlaneItem ()
 Конструктор.
 

Защищенные данные

SimpleName name
 Имя кривой.
 

Подробное описание

Кривая в двумерном пространстве.

Кривая в двумерном пространстве представляет собой векторную функцию скалярного параметра, заданную на конечной одномерной области. Кривая представляет собой непрерывное отображение некоторого участка числовой оси в двумерное пространство.
Двумерная кривая используется:
для плоского моделирования,
для описания области определения параметров поверхности,
для построения кривых на поверхностях,
для построения кривых пересечения поверхностей.

Методы

◆ Duplicate()

virtual MbPlaneItem& MbCurve::Duplicate ( MbRegDuplicate iReg = NULL) const
pure virtual

Создать копию.

Создать копию объекта с использованием регистратора. Регистратор используется для предотвращения многократного копирования объекта. Если объект содержит ссылки на другие объекты, то вложенные объекты так же копируются. Допустимо не передавать регистратор в функцию. Тогда будет создана новая копия объекта. При копировании одиночного объекта или набора не связанных между собой объектов допустимо не использовать регистратор. Регистратор необходимо использовать, если надо последовательно копировать несколько взаимосвязанных объектов. Возможно, что связь объектов обусловлена наличием в них ссылок на общие объекты. Тогда, при копировании без использования регистратора, можно получить набор копий, содержащих ссылки на разные копии одного и того же вложенного объекта, что ведет к потере связи между копиями.

Аргументы
[in]iReg- Регистратор.
Возвращает
Копия объекта.

Замещает MbPlaneItem.

Замещается в MbNurbs, MbArc, MbBezier, MbHermit, MbCubicSpline, MbProjCurve, MbCosinusoid, MbPolyline, MbContourWithBreaks, MbLineSegment, MbContour, MbReparamCurve, MbTrimmedCurve, MbLine, MbCharacterCurve, MbOffsetCurve, MbPointCurve и MbPolyCurve.

◆ Transform()

virtual void MbCurve::Transform ( const MbMatrix matr,
MbRegTransform iReg = NULL,
const MbSurface newSurface = NULL 
)
pure virtual

Преобразовать согласно матрице.

Преобразовать исходный объект согласно матрице c использованием регистратора. Если объект содержит ссылки на другие геометрические объекты, то вложенные объекты так же преобразуются согласно матрице. Регистратор служит для предотвращения многократного преобразования объекта. Допустимо использовать функцию без регистратора, если надо преобразовать одиночный объект. Если надо преобразовать набор взаимосвязанных объектов, необходимо использовать регистратор для предотвращения повторного преобразования вложенных объектов, поскольку не исключена ситуация, когда несколько объектов из набора содержат ссылки на один или несколько общих объектов, подлежащих трансформации.

Аргументы
[in]matr- Матрица преобразования.
[in]iReg- Регистратор.
[in]surface- Новая базовая поверхность объекта при условии, что matr - матрица преобразования из старой поверхности в новую. Для трансформации проекционной кривой. Не учитывается, если поверхность плоская.

Замещает MbPlaneItem.

Замещается в MbNurbs, MbArc, MbBezier, MbHermit, MbCubicSpline, MbProjCurve, MbCosinusoid, MbPolyline, MbContour, MbLineSegment, MbContourWithBreaks, MbCharacterCurve, MbTrimmedCurve, MbReparamCurve, MbOffsetCurve, MbLine, MbPointCurve и MbPolyCurve.

◆ Move()

virtual void MbCurve::Move ( const MbVector to,
MbRegTransform iReg = NULL,
const MbSurface newSurface = NULL 
)
pure virtual

Сдвинуть вдоль вектора.

Сдвинуть геометрический объект вдоль вектора с использованием регистратора. Если объект содержит ссылки на другие геометрические объекты, то к вложенным объектам так же применяется операция сдвига. Регистратор служит для предотвращения многократного преобразования объекта. Допустимо использовать функцию без регистратора, если надо преобразовать одиночный объект. Если надо преобразовать набор взаимосвязанных объектов, необходимо использовать регистратор для предотвращения повторного преобразования вложенных объектов, поскольку не исключена ситуация, когда несколько объектов из набора содержат ссылки на один или несколько общих объектов, подлежащих сдвигу.

Аргументы
[in]to- Вектор сдвига.
[in]iReg- Регистратор.
[in]surface- Новая базовая поверхность объекта при условии, что matr - матрица преобразования из старой поверхности в новую. Для трансформации проекционной кривой. Не учитывается, если поверхность плоская.

Замещает MbPlaneItem.

Замещается в MbNurbs, MbArc, MbBezier, MbHermit, MbCubicSpline, MbProjCurve, MbCosinusoid, MbPolyline, MbContour, MbLineSegment, MbContourWithBreaks, MbCharacterCurve, MbTrimmedCurve, MbReparamCurve, MbOffsetCurve, MbLine, MbPointCurve и MbPolyCurve.

◆ Rotate()

virtual void MbCurve::Rotate ( const MbCartPoint pnt,
const MbDirection angle,
MbRegTransform iReg = NULL,
const MbSurface newSurface = NULL 
)
pure virtual

Повернуть вокруг точки.

Повернуть объект вокруг точки на заданный угол с использованием регистратора. Если объект содержит ссылки на другие геометрические объекты, то к вложенным объектам так же применяется операция поворота. Регистратор служит для предотвращения многократного преобразования объекта. Допустимо использовать функцию без регистратора, если надо преобразовать одиночный объект. Если надо преобразовать набор взаимосвязанных объектов, необходимо использовать регистратор для предотвращения повторного преобразования вложенных объектов, поскольку не исключена ситуация, когда несколько объектов из набора содержат ссылки на один или несколько общих объектов, подлежащих повороту.

Аргументы
[in]pnt- Неподвижная точка.
[in]angle- Угол поворота.
[in]iReg- Регистратор.
[in]surface- Новая базовая поверхность объекта при условии, что matr - матрица преобразования из старой поверхности в новую. Для трансформации проекционной кривой. Не учитывается, если поверхность плоская.

Замещает MbPlaneItem.

Замещается в MbNurbs, MbArc, MbBezier, MbHermit, MbCubicSpline, MbProjCurve, MbCosinusoid, MbPolyline, MbContour, MbLineSegment, MbContourWithBreaks, MbCharacterCurve, MbTrimmedCurve, MbReparamCurve, MbOffsetCurve, MbLine, MbPointCurve и MbPolyCurve.

◆ SetEqual()

virtual bool MbCurve::SetEqual ( const MbPlaneItem item)
pure virtual

Сделать объекты равным.

Равными можно сделать только подобные объекты. Подобный объект приравнивается присланному путем изменения численных данных.

Аргументы
[in]item- Объект для инициализации.
Возвращает
Сделан ли объект равным присланному.

Замещает MbPlaneItem.

Замещается в MbNurbs, MbArc, MbBezier, MbHermit, MbCubicSpline, MbProjCurve, MbCosinusoid, MbPolyline, MbContour, MbLineSegment, MbCharacterCurve, MbReparamCurve, MbTrimmedCurve, MbOffsetCurve, MbLine, MbPointCurve и MbPolyCurve.

◆ IsSame()

virtual bool MbCurve::IsSame ( const MbPlaneItem item,
double  accuracy = LENGTH_EPSILON 
) const
pure virtual

Определить, являются ли объекты равными.

Равными считаются однотипные объекты, все данные которых одинаковы (равны).

Аргументы
[in]item- Объект для сравнения.
[in]accuracy- Точность сравнения.
Возвращает
Равны ли объекты.

Замещает MbPlaneItem.

Замещается в MbNurbs, MbArc, MbBezier, MbHermit, MbCubicSpline, MbProjCurve, MbCosinusoid, MbPolyline, MbContour, MbLineSegment, MbReparamCurve, MbOffsetCurve, MbTrimmedCurve, MbCharacterCurve, MbPointCurve, MbLine и MbPolyCurve.

◆ PrepareIntegralData()

virtual void MbCurve::PrepareIntegralData ( const bool  forced) const
virtual

Рассчитать временные (mutable) данные объекта.

Рассчитать временные данные объекта в зависимости от параметра forced. Если параметр forced равен false, рассчитываются только ещё не насчитанные данные. Если параметр forced равен true, перерасчитываются все временные данные объекта. Принудительный перерасчёт.

Переопределяется в MbArc, MbReparamCurve, MbOffsetCurve, MbProjCurve, MbContour, MbCosinusoid, MbTrimmedCurve, MbCharacterCurve и MbPolyCurve.

◆ AddYourGabaritMtr()

virtual void MbCurve::AddYourGabaritMtr ( MbRect rect,
const MbMatrix matr 
) const
virtual

Добавить габарит в прямоугольник.

Добавить в прямоугольник свой габарит с учетом матрицы трансформации. Если матрица не единичная, то происходит трансформация копии объекта по матрице и затем к прямоугольнику добавляется габарит трансформированного объекта. После использования копия уничтожается.

Аргументы
[out]rect- Прямоугольник с информацией по габаритам.
[in]matr- Матрица трансформации.

Переопределяется в MbLine.

◆ CalculateGabarit()

virtual void MbCurve::CalculateGabarit ( MbRect ) const
virtual

Определить габаритный прямоугольник кривой.

Для получения габарита объекта присланный прямоугольник делается пустым. Затем вычисляются габариты объекта и сохраняются в прямоугольнике rect.

Переопределяется в MbNurbs, MbArc, MbBezier, MbHermit, MbPolyline, MbProjCurve, MbCosinusoid, MbContour, MbLineSegment, MbReparamCurve и MbLine.

◆ CalculateLocalGabarit()

virtual void MbCurve::CalculateLocalGabarit ( const MbMatrix into,
MbRect local 
) const
virtual

Рассчитать габарит в локальной системы координат.

Для получения габарита объекта относительно локальной системы координат, присланный прямоугольник делается пустым. Затем вычисляются габариты объекта в локальной системе координат и сохраняются в прямоугольнике rect.

Аргументы
[in]matr- Матрица перехода от текущей для объекта системы координат к локальной системе координат.
[out]rect- Прямоугольник с информацией по габаритам.

Переопределяется в MbPolyline, MbProjCurve, MbContour, MbLineSegment, MbLine и MbPointCurve.

◆ IsVisibleInRect()

virtual bool MbCurve::IsVisibleInRect ( const MbRect rect,
bool  exact = false 
) const
virtual

Определить видимость объекта в прямоугольнике.

Определить, виден ли объект в заданном прямоугольнике. Есть возможность выполнить быструю проверку или более тщательную при соответствующем значении второго параметра.

Аргументы
[in]rect- Заданный двумерный прямоугольник.
[in]exact- Выполнять ли более тщательную проверку?
Возвращает
true - объект полностью или частично содержится в прямоугольнике, иначе - false.

Замещает MbPlaneItem.

Переопределяется в MbArc, MbCosinusoid, MbLineSegment, MbReparamCurve, MbLine и MbPointCurve.

◆ IsCompleteInRect()

virtual bool MbCurve::IsCompleteInRect ( const MbRect rect) const
virtual

Определить, виден ли объект полностью в прямоугольнике.

Объект полностью содержится в заданном прямоугольнике, если его габаритный прямоугольник вложен в заданный.

Аргументы
[in]rect- Прямоугольник, вложенность в который проверяется.
Возвращает
true - объект полностью содержится в прямоугольнике, иначе - false.

Переопределяется в MbArc, MbReparamCurve и MbLineSegment.

◆ DistanceToPointIfLess()

virtual bool MbCurve::DistanceToPointIfLess ( const MbCartPoint to,
double &  d 
) const
virtual

Вычислить расстояние до точки.

Вычислить расстояние от объекта до заданной точки вблизи объекта. Расстояние вычисляется и записывается в переменную d, если оно меньше исходного значения d. Может быть получен выигрыш по времени выполнения по сравнению с функцией DistanceToPoint, за счет того, что сначала проверяется расстояние от точки до габаритного куба, и только если это расстояние не больше заданного, выполняются дальнейшие вычисления.

Аргументы
[in]to- Tочка.
[in,out]d- На входе - заданная величина отступа от объекта. На выходе - расстояние от точки до объекта, если операция выполнена успешно.
Возвращает
true, если расстояние от точки до объекта меньше заданного, иначе - false. Рассчитать расстояние до точки и изменить его присланное значение, если расстояние окажется меньше присланного значения.

Замещает MbPlaneItem.

Переопределяется в MbNurbs, MbBezier, MbArc, MbContour, MbPolyline и MbReparamCurve.

◆ IsClosed()

virtual bool MbCurve::IsClosed ( ) const
pure virtual

Определить, является ли кривая замкнутой.

Определить, является ли кривая замкнутой.
Замкнутой считается кривая, если она циклична:

  • начальная и конечная точка кривой совпадают,
  • производные в начальной и конечной точке совпадают;
    если по своей природе кривая допускает изломы (контур, ломаная), то допускается не совпадение производных; у кривой Безье производные должны совпадать по направлению, но могут не совпадать по модулю.
Возвращает
true, если кривая замкнута.

Замещается в MbNurbs, MbArc, MbLine, MbProjCurve, MbContour, MbCosinusoid, MbLineSegment, MbReparamCurve, MbOffsetCurve, MbTrimmedCurve, MbCharacterCurve, MbPointCurve и MbPolyCurve.

◆ GetPeriod()

virtual double MbCurve::GetPeriod ( ) const
virtual

Вернуть период.

Вернуть значение периода, если может быть кривая замкнута. Для незамкнутой кривой вернуть нуль.

Возвращает
Значение периода для замкнутой кривой или нуль - для незамкнутой.

Переопределяется в MbArc, MbProjCurve, MbReparamCurve, MbOffsetCurve и MbTrimmedCurve.

◆ IsTouch()

bool MbCurve::IsTouch ( double  eps = Math::LengthEps) const
inline

Определить, замкнута ли кривая фактически независимо от гладкости замыкания.

Определить, замкнута ли кривая фактически независимо от гладкости замыкания.

◆ Step()

virtual double MbCurve::Step ( double  t,
double  sag 
) const
virtual

Вычислить шаг параметра.

Вычислить шаг параметра для аппроксимации кривой по величине прогиба кривой. Вычисление шага проходит с учетом радиуса кривизны. Шаг аппроксимации кривой выбирается таким образом, чтобы отклонение кривой от её полигона не превышало заданную величину прогиба.

Аргументы
[in]t- Параметр, определяющий точку на кривой, в которой надо вычислить шаг.
[in]sag- Максимально допустимая величина прогиба.
Возвращает
Величина шага по параметру в заданной точке.

Переопределяется в MbNurbs, MbArc, MbBezier, MbHermit, MbCubicSpline, MbProjCurve, MbPolyline, MbContour, MbLine, MbLineSegment, MbReparamCurve, MbCosinusoid, MbOffsetCurve, MbTrimmedCurve, MbPointCurve и MbCharacterCurve.

◆ DeviationStep()

virtual double MbCurve::DeviationStep ( double  t,
double  ang 
) const
virtual

Вычислить шаг параметра.

Вычислить шаг параметра для аппроксимации кривой по углу отклонения касательной. Шаг аппроксимации кривой выбирается таким образом, чтобы угловое отклонение касательной кривой в следующей точке не превышало заданную величину ang.

Аргументы
[in]t- Параметр, определяющий точку на кривой, в которой надо вычислить шаг.
[in]ang- Максимально допустимый угол отклонения касательной.
Возвращает
Величина шага по параметру в заданной точке.

Переопределяется в MbNurbs, MbArc, MbBezier, MbHermit, MbCubicSpline, MbProjCurve, MbPolyline, MbContour, MbLine, MbLineSegment, MbReparamCurve, MbCosinusoid, MbOffsetCurve, MbTrimmedCurve, MbPointCurve и MbCharacterCurve.

◆ HasLength()

virtual bool MbCurve::HasLength ( double &  length) const
pure virtual

Вычислить метрическую длину кривой.

Вычислить метрическую длину кривой и записать ее в переменную length.

Аргументы
[in,out]length- Вычисленная длина кривой.
Возвращает
true - если длина кривой отлична от нуля. Иначе возвращает false.

Замещается в MbArc, MbProjCurve, MbLineSegment, MbContour, MbOffsetCurve, MbReparamCurve, MbLine, MbTrimmedCurve, MbPointCurve, MbCosinusoid, MbCharacterCurve и MbPolyCurve.

◆ CalculateLength()

virtual double MbCurve::CalculateLength ( double  t1,
double  t2 
) const
virtual

Вычислить метрическую длину кривой.

Вычислить метрическую длину разомкнутой кривой от параметра t1 до t2. Должно выполнятся условие t1 < t2.

Аргументы
[in]t1- Начальный параметр отрезка кривой.
[in]t2- Конечный параметр отрезка кривой.
Возвращает
Длина кривой.

Переопределяется в MbNurbs, MbArc, MbContour, MbProjCurve, MbPolyline, MbLineSegment и MbReparamCurve.

◆ GetMetricLength()

virtual double MbCurve::GetMetricLength ( ) const
pure virtual

Вычислить метрическую длину кривой.

Если длина кривой уже была вычислена и запомнена в объекте, эта функция возвращает готовый результат, не выполняя повторных вычислений. Иначе длина вычисляется с помощью функции CalculateMetricLength().

Возвращает
Длина кривой.

Замещается в MbArc, MbProjCurve, MbLineSegment, MbContour, MbOffsetCurve, MbReparamCurve, MbPointCurve, MbTrimmedCurve, MbLine, MbCosinusoid, MbCharacterCurve и MbPolyCurve.

◆ DistanceAlong()

virtual bool MbCurve::DistanceAlong ( double &  t,
double  len,
int  curveDir,
double  eps = Math::LengthEps,
VERSION  version = Math::DefaultMathVersion() 
) const
virtual

Сдвинуть параметр вдоль кривой.

Сдвинуть параметр вдоль кривой на заданное расстояние в заданном направлении. Новое значение параметра сохраняется в переменной t. Если кривая не замкнута и длина ее части от точки с параметром t до конца в заданном направлении меньше, чем нужное смещение, то вычисления происходят на продолжении кривой, если можно построить продолжение.

Аргументы
[in,out]t- На входе - исходное значение параметра. На выходе - новое значение параметра.
[in]len- Величина смещения вдоль кривой.
[in]curveDir- Направление смещения. Если curveDir - неотрицательно, то смещение направлено в сторону увеличения параметра. Иначе - в сторону уменьшения параметра.
[in]eps- Точность вычислений.
[in]version- Версия.
Возвращает
true - если операция выполнена успешно, иначе false.

Переопределяется в MbNurbs, MbArc, MbBezier, MbCubicSpline, MbHermit, MbContour, MbPolyline, MbReparamCurve, MbLineSegment, MbOffsetCurve и MbLine.

◆ BeginApprox()

virtual bool MbCurve::BeginApprox ( double  sag,
double &  tbeg,
double &  tend,
MbCartPoint pnt,
bool &  existNextPoint 
) const
virtual

Начать аппроксимацию для отрисовки.

В функции проверяются и при необходимости корректируются параметры начала и конца аппроксимируемой части кривой. Вычисляется первая точка, соответствующая начальному параметру. Определяется, можно ли вычислить следующую точку. Следующие точки вычисляются функцией GetNextPoint.

Аргументы
[in]sag- Максимальная величина прогиба.
[in,out]tbeg- Параметр, соответствующий началу аппроксимируемой части кривой.
[in,out]tend- Параметр, соответствующий концу аппроксимируемой части кривой.
[in,out]pnt- Вычисленная точка.
[in,out]existNextPoint- Флаг, показывающий, надо ли вычислять следующую точку (true) или вычисленная точка соответствует концу аппроксимируемой кривой (false).
Возвращает
true - если операция выполнена успешно, иначе false.

◆ GetNextPoint()

virtual bool MbCurve::GetNextPoint ( double  sag,
double  tend,
double &  tcur,
MbCartPoint pnt 
) const
virtual

Вычислить очередную точку.

Функция используется для расчета аппроксимации кривой, после вызова функции BeginApprox. В ней определяется параметр для вычисления следующей точки полигона, вычисляется точка и определяется, является ли она конечной.

Аргументы
[in]sag- Максимальная величина прогиба.
[in]tend- Параметр, соответствующий концу аппроксимируемой части кривой.
[in,out]tcur- На входе - значение параметра в последней вычисленной точке. На выходе - параметр, соответствующий новой вычисленной точке.
[in,out]pnt- Вычисленная точка.
Возвращает
true - если необходимы дальнейшие вычисления. false - если вычисленная точка соответствует концу аппроксимируемой кривой.

◆ CalculatePolygon()

virtual void MbCurve::CalculatePolygon ( double  sag,
MbPolygon poligon 
) const
virtual

Рассчитать массив точек для отрисовки.

Выдать массив отрисовочных точек с заданной стрелкой прогиба. Если кривая представляет собой контур, то узловые точки контура дублируются.

Аргументы
[in]sag- Максимальная величина прогиба.
[in,out]poligon- Полигон рассчитанных точек на кривой.

Переопределяется в MbNurbs.

◆ NurbsCurve() [1/3]

MbNurbs* MbCurve::NurbsCurve ( const MbCurveIntoNurbsInfo nInfo = NULL) const

Построить NURBS копию кривой.

Строит NURBS кривую, аппроксимирующую заданную. По возможности, строит точную кривую, возможно с кратными узлами. Количество узлов для NURBS определяется в зависимости от кривой.

Аргументы
[in,out]nurbs- Построенная NURBS кривая.
[in]nInfo- Параметры преобразования кривой в NURBS.
Возвращает
Построенная NURBS кривая или NULL при неуспешном построении.

◆ NurbsCurve() [2/3]

virtual MbNurbs* MbCurve::NurbsCurve ( const MbCurveIntoNurbsInfo nInfo) const
pure virtual

Построить NURBS копию кривой.

Строит NURBS кривую, аппроксимирующую заданную в диапазоне параметров [t1, t2] с заданным направлением. По возможности, строит точную кривую, возможно с кратными узлами. Количество узлов для NURBS определяется в зависимости от кривой.

Аргументы
[in,out]nurbs- Построенная NURBS кривая.
[in]t1- Параметр, соответствующий началу аппроксимируемой части кривой.
[in]t2- Параметр, соответствующий концу аппроксимируемой части кривой.
[in]sense- Совпадает ли направление возрастания параметра вдоль NURBS кривой с направлением на исходной кривой. sense > 0 - направление совпадает.
[in]nInfo- Параметры преобразования кривой в NURBS.
Возвращает
Построенная NURBS кривая или NULL при неуспешном построении.

Замещается в MbNurbs, MbArc, MbBezier, MbCubicSpline, MbProjCurve, MbHermit, MbLine, MbContour, MbPolyline, MbTrimmedCurve, MbLineSegment, MbOffsetCurve, MbReparamCurve, MbPointCurve, MbCosinusoid и MbCharacterCurve.

◆ NurbsCurve() [3/3]

virtual MbCurve* MbCurve::NurbsCurve ( const MbNurbsParameters tParameters) const
virtual

Построить NURBS копию кривой.

Строит NURBS кривую, аппроксимирующую исходную с заданными параметрами. В параметрах можно задать степень и количество узлов сплайна, диапазон изменения параметра кривой. Если в параметрах не задан флаг точной аппроксимации, то строит NURBS без кратных узлов.

Аргументы
[in]tParameters- Параметры построения NURBS копии кривой.
Возвращает
Построенная NURBS кривая или NULL при неуспешном построении.

Переопределяется в MbNurbs, MbArc, MbBezier, MbCubicSpline, MbHermit, MbLine, MbPolyline, MbTrimmedCurve, MbLineSegment, MbReparamCurve и MbPointCurve.

◆ Trimmed()

virtual MbCurve* MbCurve::Trimmed ( double  t1,
double  t2,
int  sense 
) const
pure virtual

Построить усеченную кривую.

Строит усеченную кривую, начало которой соответствует точке с параметром t1 и конец - точке с параметром t2. Можно изменить направление полученной кривой относительно исходной с помощью параметра sense. Если кривая замкнута, можно получить усеченную кривую, проходящую через начало кривой.
В случае замкнутой кривой (или для дуги - исключение) три параметра sense, t1 и t2 однозначно определяют результат. В случае разомкнутой кривой параметр sense и параметрами усечения должны соответствовать друг другу:
1) если sense == 1, то t1 < t2,
2) если sense == -1, то t1 > t2.
Если есть несоответствие между sense и параметрами усечения, то приоритетным параметром считается sense. Если параметры t1 и t2 равны и кривая замкнута, в результате должны получить замкнутую кривую.

Аргументы
[in]t1- Параметр, соответствующий началу усеченной кривой.
[in]t2- Параметр, соответствующий концу усеченной кривой.
[in]sense- Направление усеченной кривой относительно исходной.
sense = 1 - направление кривой сохраняется. sense = -1 - направление кривой меняется на обратное.
Возвращает
Построенная усеченная кривая.

Замещается в MbNurbs, MbArc, MbBezier, MbCubicSpline, MbProjCurve, MbHermit, MbPolyline, MbTrimmedCurve, MbLineSegment, MbOffsetCurve, MbLine, MbPointCurve, MbCosinusoid, MbContour, MbCharacterCurve и MbReparamCurve.

◆ Deformation()

virtual MbeState MbCurve::Deformation ( const MbRect rect,
const MbMatrix matr 
)
virtual

Деформировать кривую.

Если габаритный прямоугольник кривой пересекаться с заданным, то кривая трансформируется в соответствии с матрицей с помощью функции Transform.

Аргументы
[in]rect- Прямоугольник, в котором проверяется видимость кривой.
[in]matr- Матрица деформации.
Возвращает
Состояние кривой после деформации.

Переопределяется в MbNurbs, MbArc, MbBezier, MbLineSegment, MbOffsetCurve, MbReparamCurve, MbContour и MbPolyCurve.

◆ DeletePart()

virtual MbeState MbCurve::DeletePart ( double  t1,
double  t2,
MbCurve *&  part2 
)
pure virtual

Удалить часть кривой.

Удалить часть кривой между параметрами t1 и t2. Если после удаления кривая распалась на две части, то исходный объект соответствует начальной части кривой, а в параметре part2 содержится конечная часть кривой. Если осталась односвязной, то изменяется только исходный объект.

Аргументы
[in]t1- Начальный параметр усечения.
[in]t2- Конечный параметр усечения.
[in,out]part2- Конечная часть кривой после удаления, если исходная кривая распалась на части. Может являться единственной частью кривой после удаления, \ если не смогли изменить саму кривую (например, для прямой MbLine), в этом случае возвращаемый результат dp_Degenerated.
Возвращает
Состояние кривой после модификации.

Замещается в MbNurbs, MbArc, MbBezier, MbCubicSpline, MbPolyline, MbProjCurve, MbHermit, MbTrimmedCurve, MbLineSegment, MbOffsetCurve, MbReparamCurve, MbPointCurve, MbLine, MbCosinusoid, MbContour и MbCharacterCurve.

◆ TrimmPart()

virtual MbeState MbCurve::TrimmPart ( double  t1,
double  t2,
MbCurve *&  part2 
)
pure virtual

Оставить часть кривой.

Оставить часть кривой между параметрами t1 и t2.
В случае успеха операции возвращаемое значение равно dp_Changed и кривая удовлетворяет следующим условиям:

  • если исходная кривая замкнута, то начальная точка усеченной кривой должна соответствовать параметру t1, конечная - параметру t2,
  • если исходная кривая не замкнута, то начальная точка усеченной кривой должна соответствовать минимальному параметру из t1 и t2, конечная - максимальному.
Аргументы
[in]t1- Начальный параметр усечения.
[in]t2- Конечный параметр усечения.
[in,out]part2- Может заполниться результатом усечения, если не смогли изменить саму кривую. В этом случае возвращаемый результат dp_Degenerated. Иначе = NULL.
Возвращает
Состояние кривой после модификации:
dp_Degenerated - кривая выродилась, может быть три варианта: кривая не была изменена, так как в результате преобразования она бы выродилась, или не была изменена, а результат усечения - part2,
dp_NoChanged - кривая не изменилась,
dp_Changed - кривая изменилась.
Предупреждения
Функция предназначена для внутреннего использования.

Замещается в MbNurbs, MbArc, MbBezier, MbCubicSpline, MbPolyline, MbProjCurve, MbHermit, MbTrimmedCurve, MbLineSegment, MbOffsetCurve, MbReparamCurve, MbPointCurve, MbLine, MbCosinusoid, MbContour и MbCharacterCurve.

◆ PointRelative()

virtual MbeItemLocation MbCurve::PointRelative ( const MbCartPoint pnt,
double  eps = Math::LengthEps 
) const
virtual

Определить положение точки относительно кривой.

Определяется, как расположена точка относительно кривой, если двигаться по кривой в положительном направлении.

Аргументы
[in]pnt- Заданная точка.
[in]eps- Точность определения.
Возвращает
iloc_InItem = 1 - если точка находится слева от кривой,
iloc_OnItem = 0 - если точка находится на кривой,
iloc_OutOfItem = -1 - если точка находится справа от кривой.

Переопределяется в MbArc, MbContour, MbPolyline, MbLineSegment, MbReparamCurve, MbLine, MbTrimmedCurve и MbPointCurve.

◆ PointProjectionNewton()

MbeNewtonResult MbCurve::PointProjectionNewton ( const MbCartPoint p,
double  xEpsilon,
double  yEpsilon,
size_t  iterLimit,
double &  t,
bool  ext 
) const

Найти проекцию точки на кривую.

Найти проекцию точки на кривую или ее продолжение методом Ньютона по заданному начальному приближению.

Аргументы
[in]p- Заданная точка.
[in]xEpsilon- Точность определения проекции по оси x.
[in]yEpsilon- Точность определения проекции по оси y.
[in]iterLimit- Максимальное количество итераций.
[in]t- На входе - начальное приближение, на выходе - параметр кривой, соответствующий ближайшей проекции.
[in]ext- Флаг, определяющий, искать ли проекцию на продолжении кривой (если true, то искать).
Возвращает
Результат выполнения итерационного метода.

◆ NearPointProjection()

virtual bool MbCurve::NearPointProjection ( const MbCartPoint pnt,
double  xEpsilon,
double  yEpsilon,
double &  t,
bool  ext,
MbRect1D tRange = NULL 
) const
virtual

Найти проекцию точки на кривую.

Найти ближайшую проекцию точки на кривую или ее продолжение по заданному начальному приближению. Если задан диапазон изменения параметра tRange - то надо найти проекцию в заданном диапазоне. Диапазон параметра может выходить за область определения параметра кривой. Используется метод Ньютона.

Заметки
Математическое ядро обеспечивает потокобезопасную реализацию функции для своих объектов.
Аргументы
[in]pnt- Заданная точка.
[in]xEpsilon- Точность определения проекции по оси x.
[in]yEpsilon- Точность определения проекции по оси y.
[in,out]t- На входе - начальное приближение, на выходе - параметр кривой, соответствующий ближайшей проекции.
[in]ext- Флаг, определяющий, искать ли проекцию на продолжении кривой (если true, то искать).
[in]tRange- Диапазон изменения параметра, в котором надо найти решение.
Возвращает
true - если найдена проекция, удовлетворяющая всем входным условиям.

Переопределяется в MbNurbs, MbArc, MbContour, MbHermit, MbProjCurve, MbReparamCurve, MbLineSegment, MbLine, MbPointCurve и MbCosinusoid.

◆ PointProjection()

void MbCurve::PointProjection ( const MbCartPoint pnt,
MbCartPoint on 
) const
inline

Вычислить проекцию точки на кривую.

Вычислить точку на кривой, соответствующую проекции заданной точки на эту кривую.

Аргументы
[in]pnt- Заданная точка.
[in,out]on- Искомая точка - проекция.

◆ BasePointProjection()

void MbCurve::BasePointProjection ( const MbCartPoint pnt,
MbCartPoint on 
) const

Вычислить проекцию точки на кривую.

Вычислить точку на кривой, соответствующую проекции заданной точки на эту кривую. Если кривая - усеченная, то вычисляется проекция на базовую кривую.

Аргументы
[in]pnt- Заданная точка.
[in,out]on- Искомая точка - проекция.

◆ PointProjectionAndAngle()

void MbCurve::PointProjectionAndAngle ( MbCartPoint on,
double &  angle 
) const
inline

Вычислить проекцию точки на кривую.

Вычислить точку на кривой, соответствующую проекции заданной точки на эту кривую. Дополнительно возвращает угол наклона касательной к оси 0X в точке проекции.

Аргументы
[in,out]on- На входе - исходная точка. На выходе - точка-проекция на кривой.
[in,out]angle- Вычисленный угол наклона касательной к оси 0X.

◆ DirectPointProjection()

bool MbCurve::DirectPointProjection ( const MbCartPoint pnt,
const MbDirection dir,
MbCartPoint pp 
) const

Вычислить проекцию точки на кривую.

Вычислить ближайшую точку пересечения кривой с лучом, выходящим из заданной точки pnt по направлению dir. Рассматриваются точки, лежащие за начальной точкой луча pnt на расстоянии, превосходящем Math::paramEpsilon.

Аргументы
[in]pnt- Заданная точка.
[in]dir- Заданное направление.
[in,out]pp- Искомая точка на кривой.

◆ SmallestPerpendicular()

virtual bool MbCurve::SmallestPerpendicular ( const MbCartPoint pnt,
double &  tProj 
) const
virtual

Найти ближайший перпендикуляр к кривой.

Найти ближайший перпендикуляр к кривой, опущенный из заданной точки. В этой функции не рассматриваются перпендикуляры, опущенные на продолжение кривой.

Аргументы
[in]pnt- Заданная точка.
[in,out]tProj- Параметр на кривой, соответствующий точке на кривой, через которую проходит перпендикуляр.
Возвращает
true, если искомый перпендикуляр построен.

Переопределяется в MbArc и MbReparamCurve.

◆ TangentPoint()

virtual void MbCurve::TangentPoint ( const MbCartPoint pnt,
SArray< double > &  tFind 
) const
virtual

Найти касательные к кривой.

Найти все касательные к кривой, которые можно провести из заданной точки. Точка может лежать на кривой. В данной функции рассматривается кривая без продолжений.

Аргументы
[in]pnt- Заданная точка.
[in,out]tFind- Массив параметров кривой, соответствующих точкам касания.

Переопределяется в MbNurbs, MbArc, MbBezier, MbContour и MbReparamCurve.

◆ PerpendicularPoint()

virtual void MbCurve::PerpendicularPoint ( const MbCartPoint pnt,
SArray< double > &  tFind 
) const
virtual

Найти перпендикуляры к кривой.

Найти все перпендикуляры к кривой, которые можно провести из заданной точки. В данной функции рассматривается кривая без продолжений.

Аргументы
[in]pnt- Заданная точка.
[in,out]tFind- Массив параметров кривой, соответствующих точкам на кривой, через которые проходят перпендикуляры.

Переопределяется в MbArc, MbContour, MbReparamCurve, MbLineSegment и MbLine.

◆ IntersectHorizontal()

virtual void MbCurve::IntersectHorizontal ( double  y,
SArray< double > &  cross 
) const
virtual

Найти пересечения кривой с горизонтальной прямой.

Найти пересечения кривой с горизонтальной прямой.

Аргументы
[in]y- Ордината точек горизонтальной прямой.
[in,out]cross- Массив параметров кривой, соответствующих точкам пересечения.

Переопределяется в MbArc, MbCubicSpline, MbContour, MbPolyline, MbReparamCurve, MbLine, MbLineSegment, MbPointCurve и MbCosinusoid.

◆ IntersectVertical()

virtual void MbCurve::IntersectVertical ( double  x,
SArray< double > &  cross 
) const
virtual

Найти пересечения кривой с вертикальной прямой.

Найти пересечения кривой с вертикальной прямой.

Аргументы
[in]x- Абсцисса точек вертикальной прямой.
[in,out]cross- Массив параметров кривой, соответствующих точкам пересечения.

Переопределяется в MbArc, MbCubicSpline, MbContour, MbPolyline, MbReparamCurve, MbLine, MbLineSegment, MbPointCurve и MbCosinusoid.

◆ Isoclinal()

virtual void MbCurve::Isoclinal ( const MbVector angle,
SArray< double > &  tFind 
) const
virtual

Построить изоклины.

Построить прямые, проходящие под углом к оси 0X и касательные к кривой.

Аргументы
[in]angle- Вектор, определяющий угол наклона прямой к оси OX.
[in,out]tFind- Массив параметров кривой, соответствующих точкам касания.

Переопределяется в MbArc, MbPolyline и MbTrimmedCurve.

◆ HorzIsoclinal()

void MbCurve::HorzIsoclinal ( SArray< double > &  tFind) const

Построить горизонтальные изоклины.

Построить горизонтальные прямые, касательные к кривой.

Аргументы
[in,out]tFind- Массив параметров кривой, соответствующих точкам касания.

◆ VertIsoclinal()

void MbCurve::VertIsoclinal ( SArray< double > &  tFind) const

Построить вертикальные изоклины.

Построить вертикальные прямые, касательные к кривой.

Аргументы
[in,out]tFind- Массив параметров кривой, соответствующих точкам касания.

◆ SelfIntersect()

virtual void MbCurve::SelfIntersect ( SArray< MbCrossPoint > &  crossPnt) const
virtual

Найти самопересечения кривой.

Найти точки самопересечения кривой и соответствующие им параметры.

Аргументы
[in,out]crossPnt- Массив точек самопересечения.

Переопределяется в MbContour, MbPolyline и MbReparamCurve.

◆ OffsetCuspPoint()

virtual void MbCurve::OffsetCuspPoint ( SArray< double > &  tCusps,
double  dist 
) const
virtual

Найти особые точки эквидистантной кривой.

Особыми точками эквидистантной кривой будем считать точки, в которых радиус кривизны исходной кривой равен величине смещения эквидистантной кривой.

Аргументы
[in,out]tCusps- Массив параметров особых точек.
[in]dist- Смещение эквидистантной кривой.

Переопределяется в MbNurbs, MbBezier, MbContour, MbReparamCurve и MbOffsetCurve.

◆ GoThroughPoint()

virtual bool MbCurve::GoThroughPoint ( MbCartPoint pnt)
virtual

Провести кривую через точку.

Изменить кривую так, чтобы она проходила через заданную точку. Изменения не должны затрагивать всю кривую. Если у кривой присутствуют какие-либо базовые объекты, связь с ними не должна потеряться при модификации. Если построить искомую кривую невозможно, исходная кривая не изменяется, возвращается false.

Аргументы
[in]pnt- Заданная точка.
Возвращает
true, если модификация выполнена, иначе - false.

Переопределяется в MbNurbs, MbPolyline и MbReparamCurve.

◆ GetRadius()

virtual double MbCurve::GetRadius ( ) const
virtual

Дать физический радиус скривой или ноль, если это невозможно.

В общем случае на запрос радиуса возвращается 0. Число, отличное от 0, можно получить лишь в том случае, если кривая является дугой окружности или эквивалентна дуге окружности.

Возвращает
Значение радиуса, если есть, или 0.0.

Переопределяется в MbNurbs, MbArc, MbContour, MbReparamCurve и MbTrimmedCurve.

◆ GetAxisPoint()

virtual bool MbCurve::GetAxisPoint ( MbCartPoint p) const
virtual

Вычислить точку для построения оси.

Вычисляет точку для построения оси, если кривая может быть построена вращением точки вокруг некоторой оси.

Возвращает
true, если такая ось существует.

Переопределяется в MbNurbs, MbArc, MbContour, MbReparamCurve, MbTrimmedCurve и MbOffsetCurve.

◆ LengthBetween2Points()

virtual double MbCurve::LengthBetween2Points ( MbCartPoint p1,
MbCartPoint p2,
MbCartPoint pc = NULL 
) const
virtual

Вычислить минимальную длину кривой между двумя точками на ней.

Если кривая не замкнутая, то длина кривой между точками определяется однозначно. Если кривая замкнута, то из двух возможных путей выбирается самый короткий. Для замкнутой кривой можно определить желаемую часть с помощью задания контрольной точки pc. Тогда выбирается та часть кривой, к которой ближе находится контрольная точка.

Аргументы
[in]p1- Первая точка.
[in]p2- Вторая точка.
[in]pc- Контрольная точка.
Возвращает
Длина части кривой между точками.

Переопределяется в MbReparamCurve, MbLineSegment и MbLine.

◆ CorrectCyclicParameter()

void MbCurve::CorrectCyclicParameter ( double &  t,
double  eps = Math::paramRegion 
) const

Корректировать параметр для замкнутых кривых.

Если кривая замкнута, то функция загоняет параметр t в диапазон параметров кривой. Кроме того, если параметр t отличается от одного из граничных параметров меньше, чем на eps, он делается равным граничному параметру.

Аргументы
[in,out]t- На входе - заданное значение параметра, на выходе - скорректированное.
[in]eps- Точность попадания на край диапазона.

◆ CorrectParameter()

void MbCurve::CorrectParameter ( double &  t) const

Корректировать параметр.

Функция загоняет параметр t в диапазон параметров кривой.

Аргументы
[in,out]t- На входе - заданное значение параметра, на выходе - скорректированное.

◆ IsReparamSame()

virtual bool MbCurve::IsReparamSame ( const MbCurve curve,
double &  factor 
) const
virtual

Определить, является ли кривая репараметризованно такой же.

Определить, является ли кривая репараметризованно такой же.

Аргументы
[in]curve- Кривая для сравнения.
[out]factor- Коэффициент сжатия параметрической области при переходе к указанной кривой.

Переопределяется в MbNurbs.

◆ GetLimitPoint() [1/2]

MbCartPoint MbCurve::GetLimitPoint ( ptrdiff_t  number) const
inline

Вычислить граничную точку.

Вычислить граничную точку.

Аргументы
[in]number- Номер граничной точки. Значение 1 соответствует начальной точке кривой, 2 - конечной.
Возвращает
Вычисленная точка.

◆ GetLimitPoint() [2/2]

void MbCurve::GetLimitPoint ( ptrdiff_t  number,
MbCartPoint pnt 
) const
inline

Вычислить граничную точку.

Вычислить граничную точку.

Аргументы
[in]number- Номер граничной точки. Значение 1 соответствует начальной точке кривой, 2 - конечной.
[in,out]pnt- Вычисленная точка.

◆ GetLimitTangent()

void MbCurve::GetLimitTangent ( ptrdiff_t  number,
MbVector v 
) const
inline

Вычислить касательный вектор в граничной точке.

Вычислить нормализованный касательный вектор в граничной точке.

Аргументы
[in]number- Номер граничной точки. Значение 1 соответствует начальной точке кривой, 2 - конечной.
[in,out]v- Касательный вектор.

◆ GetLimitPointAndTangent()

void MbCurve::GetLimitPointAndTangent ( ptrdiff_t  number,
MbCartPoint pnt,
MbVector v 
) const
inline

Вычислить касательный вектор и точку на конце кривой.

Вычислить нормализованный касательный вектор и точку на конце кривой.

Аргументы
[in]number- Номер граничной точки. Значение 1 соответствует начальной точке кривой, 2 - конечной.
[in,out]pnt- Вычисленная точка.
[in,out]v- Касательный вектор.

◆ AreLimitPointsEqual()

bool MbCurve::AreLimitPointsEqual ( ) const
inline

Равны ли граничные точки?

Равны ли граничные точки кривой?

Возвращает
true, если точки равны.

◆ GetSpecificPoint()

virtual bool MbCurve::GetSpecificPoint ( const MbCartPoint from,
double &  dmax,
MbCartPoint pnt 
) const
virtual

Вернуть характерную точку кривой.

Вернуть характерную точку кривой, если расстояние от нее до заданной точки from меньше, чем dmax. Характерными точками ограниченной кривой являются начальная точка и конечная точка.

Аргументы
[in]from- Контрольная точка.
[in,out]dmax- На входе - максимальное расстояние для поиска характерной точки. На выходе - расстояние от точки from до найденной характерной точки.
[in,out]pnt- Касательный вектор.
Возвращает
true - если характерная точка найдена.

Переопределяется в MbArc, MbContour, MbReparamCurve, MbLineSegment, MbTrimmedCurve и MbPolyCurve.

◆ GetLengthEvaluation()

virtual double MbCurve::GetLengthEvaluation ( ) const
virtual

Вычислить метрическую длину кривой.

Длина кривой вычисляется неточно, на основе аппроксимации ломаной. Если нужна более точно вычисленная длина кривой, надо пользоваться функцией CalculateMetricLength().

Переопределяется в MbArc, MbProjCurve, MbPolyline, MbLineSegment, MbContour, MbOffsetCurve, MbReparamCurve, MbTrimmedCurve, MbPolyCurve и MbCharacterCurve.

◆ IsSpaceNear() [1/2]

bool MbCurve::IsSpaceNear ( const MbCurve curve,
double  eps,
bool  ext,
double  devSag = 5.0 *Math::deviateSag 
) const

Определить, близки ли две кривые метрически.

Близость кривых определяется, исходя из равенства их конечных точек и расстояния произвольной точки одной кривой от другой кривой. Параметрически кривые могут отличаться.

Аргументы
[in]curve- Кривая, с которой производится сравнение.
[in]eps- Максимально допустимое расстояние между ближайшими точками двух кривых.
[in]ext- Флаг определяет, будет ли при необходимости продолжена кривая curve. Если ext = true, то кривая может быть продолжена.
[in]devSag- Максимальная величина прогиба.

◆ IsSpaceNear() [2/2]

bool MbCurve::IsSpaceNear ( const MbCurve curve,
double  xEps,
double  yEps,
bool  ext,
double  xNear,
double  yNear,
double  devSag = 5.0 *Math::deviateSag 
) const

Определить, близки ли две кривые метрически.

Близость кривых определяется, исходя из равенства их конечных точек и расстояния произвольной точки одной кривой от другой кривой. Параметрически кривые могут отличаться.

Аргументы
[in]curve- Кривая, с которой производится сравнение.
[in]xEps- Точность определения проекции по оси x.
[in]yEps- Точность определения проекции по оси y.
[in]ext- Флаг определяет, будет ли при необходимости продолжена кривая curve. Если ext = true, то кривая может быть продолжена.
[in]xNear- Максимально допустимое расстояние между ближайшими точками двух кривых по X.
[in]yNear- Максимально допустимое расстояние между ближайшими точками двух кривых по Y.
[in]devSag- Максимальная величина прогиба.

Объявления и описания членов класса находятся в файле: