C3D Toolkit  Kernel - 117926, Vision - 2.7.0.28

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

#include <cur_contour.h>

+ Граф наследования:MbContour:
+ Граф связей класса MbContour:

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

 MbContour ()
 Пустой контур.
 
template<class Curves >
 MbContour (const Curves &, bool sameCurves)
 Конструктор по набору кривых.
 
Общие функции геометрического объекта.
MbePlaneType IsA () const override
 Получить тип объекта.
 
MbePlaneType Type () const override
 Получить групповой тип объекта.
 
MbPlaneItemDuplicate (MbRegDuplicate *=nullptr) const override
 Создать копию. Подробнее...
 
bool IsSimilar (const MbPlaneItem &) const override
 Определить, являются ли объекты подобными. Подробнее...
 
bool SetEqual (const MbPlaneItem &) override
 Сделать объекты равным. Подробнее...
 
bool IsSame (const MbPlaneItem &, double accuracy=LENGTH_EPSILON) const override
 Определить, являются ли объекты равными. Подробнее...
 
void Transform (const MbMatrix &, MbRegTransform *ireg=nullptr, const MbSurface *newSurface=nullptr) override
 Преобразовать согласно матрице. Подробнее...
 
void Move (const MbVector &, MbRegTransform *=nullptr, const MbSurface *newSurface=nullptr) override
 Сдвинуть вдоль вектора. Подробнее...
 
void Rotate (const MbCartPoint &, const MbDirection &angle, MbRegTransform *=nullptr, const MbSurface *newSurface=nullptr) override
 Повернуть вокруг точки. Подробнее...
 
MbCurveOffset (double rad) const override
 Построить эквидистантную кривую, смещённую на заданное расстояние. Подробнее...
 
void AddYourGabaritTo (MbRect &) const override
 Расширить присланный габаритный прямоугольник так, чтобы он включал в себя данный объект.
 
void CalculateGabarit (MbRect &) const override
 Определить габаритный прямоугольник кривой. Подробнее...
 
void CalculateLocalGabarit (const MbMatrix &into, MbRect &local) const override
 Рассчитать габарит в локальной системы координат. Подробнее...
 
const MbRectGetGabarit () const
 
const MbRectGetCube () const
 
void SetDirtyGabarit () const
 Сбросить рассчитанный габарит контура.
 
void CopyGabarit (const MbContour &c)
 Копировать габарит контура в контур (использовать только для передачи габарита в копию контура).
 
bool IsGabaritEmpty () const
 Пуст ли габарит контура?
 
double DistanceToPoint (const MbCartPoint &) const override
 Вычислить расстояние до точки.
 
MbeState Deformation (const MbRect &, const MbMatrix &) override
 Деформировать кривую. Подробнее...
 
bool IsInRectForDeform (const MbRect &) const override
 Определить видимость кривой в прямоугольнике.
 
void Refresh () override
 Перевести все временные (mutable) данные объекта в неопределённое (исходное) состояние.
 
void PrepareIntegralData (const bool forced) const override
 Рассчитать временные (mutable) данные объекта. Подробнее...
 
MbeState DeletePart (double t1, double t2, MbCurve *&part2) override
 Удалить часть кривой. Подробнее...
 
MbeState TrimmPart (double t1, double t2, MbCurve *&part2) override
 Оставить часть кривой. Подробнее...
 
MbCurveTrimmed (double t1, double t2, int sense) const override
 Построить усеченную кривую. Подробнее...
 
Функции описания области определения кривой.
double GetTMin () const override
 Получить минимальное значение параметра.
 
double GetTMax () const override
 Получить максимальное значение параметра.
 
bool IsClosed () const override
 Определить, является ли кривая замкнутой. Подробнее...
 
bool IsStraight (bool ignoreParams=false) const override
 Определить, является ли кривая прямолинейной.
 
bool IsSmoothConnected (double angleEps) const override
 Определить, являются ли стыки контура/кривой гладкими.
 
Функции для работы в области определения кривой.

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

void PointOn (double &, MbCartPoint &) const override
 Вычислить точку на кривой. Подробнее...
 
void FirstDer (double &, MbVector &) const override
 Вычислить первую производную.
 
void SecondDer (double &, MbVector &) const override
 Вычислить вторую производную.
 
void ThirdDer (double &, MbVector &) const override
 Вычислить третью производную.
 
Функции для работы внутри и вне области определения кривой.

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

void _PointOn (double, MbCartPoint &) const override
 Вычислить точку на кривой и её продолжении. Подробнее...
 
void _FirstDer (double, MbVector &) const override
 Вычислить первую производную на кривой и её продолжении.
 
void _SecondDer (double, MbVector &) const override
 Вычислить вторую производную на кривой и её продолжении.
 
void _ThirdDer (double, MbVector &) const override
 Вычислить третью производную на кривой и её продолжении.
 
Функции доступа к группе данных для работы внутри и вне области определения параметра кривой.
void Explore (double &t, bool ext, MbCartPoint &pnt, MbVector &fir, MbVector *sec, MbVector *thir) const override
 Вычислить значения точки и производных для заданного параметра. Подробнее...
 
Функции движения по кривой
double Step (double t, double sag) const override
 Вычислить шаг параметра. Подробнее...
 
double DeviationStep (double t, double angle) const override
 Вычислить шаг параметра. Подробнее...
 
Общие функции кривой
bool HasLength (double &) const override
 Вычислить метрическую длину кривой. Подробнее...
 
double GetMetricLength () const override
 Вычислить метрическую длину кривой. Подробнее...
 
double GetLengthEvaluation () const override
 Вычислить метрическую длину кривой. Подробнее...
 
double CalculateMetricLength () const override
 Вычислить метрическую длину кривой.
 
double GetParamLength () const
 
double CalculateParamLength ()
 
double GetArea (double sag=Math::deviateSag) const
 Вычисление площади контура, если контур замкнут.
 
MbNurbsNurbsCurve (const MbCurveIntoNurbsInfo &) const override
 Построить NURBS копию кривой. Подробнее...
 
MbContourNurbsContour () const override
 Аппроксимировать кривую контуром из NURBS-кривых.
 
void SetClosed ()
 Установить признак замкнутости контура.
 
void CheckClosed (double closedEps)
 Установить признак замкнутости контура.
 
void InitClosed (bool c)
 Установить признак замкнутости контура.
 
bool IsClosedContinuousC0 (double eps=5.0 *PARAM_NEAR) const
 Проверить замкнутость и непрерывность точек контура. Подробнее...
 
void CloseByLineSeg (bool calcInternalData)
 Замкнуть контур отрезком.
 
double CalculateLength (double t1, double t2) const override
 Вычислить метрическую длину кривой. Подробнее...
 
bool DistanceAlong (double &t, double len, int curveDir, double eps=Math::LengthEps, VERSION version=Math::DefaultMathVersion()) const override
 Сдвинуть параметр вдоль кривой. Подробнее...
 
void Clear (bool calculateParamLength=true)
 Cбросить переменные кэширования.
 
ptrdiff_t FindSegment (double &t, double &tSeg) const
 Найти сегмент контура. Подробнее...
 
size_t GetSegmentsCount () const
 Выдать количество сегментов контура.
 
const MbCurveGetSegment (size_t ind) const
 Выдать сегмент контура по индексу.
 
MbCurveSetSegment (size_t ind)
 Выдать сегмент контура по индексу.
 
MbeItemLocation PointRelative (const MbCartPoint &pnt, double eps=Math::LengthEps) const override
 Определить положение точки относительно кривой. Подробнее...
 
MbeLocation PointLocation (const MbCartPoint &pnt, double eps=Math::LengthEps) const override
 Положение точки относительно кривой.
 
double PointProjection (const MbCartPoint &) const override
 Найти проекцию точки на кривую.
 
bool NearPointProjection (const MbCartPoint &, double xEpsilon, double yEpsilon, double &t, bool ext, MbRect1D *tRange=nullptr) const override
 Найти проекцию точки на кривую. Подробнее...
 
double DistanceToBorder (const MbCartPoint &pnt, double eps=Math::paramRegion) const
 Параметрическое расстояние до ближайшей границы. Параметрическое расстояние до ближайшей границы.
. Подробнее...
 
void Trimm (double t1, double t2)
 Выделить часть контура.
 
MbResultType Extend (const MbCurveExtensionParameters &parameters, c3d::PlaneCurveSPtr &resCurve) const override
 Продлить кривую. Подробнее...
 
void PerpendicularPoint (const MbCartPoint &, SArray< double > &tFind) const override
 Найти перпендикуляры к кривой. Подробнее...
 
void TangentPoint (const MbCartPoint &, SArray< double > &tFind) const override
 Найти касательные к кривой. Подробнее...
 
void IntersectHorizontal (double y, SArray< double > &) const override
 Найти пересечения кривой с горизонтальной прямой. Подробнее...
 
void IntersectVertical (double x, SArray< double > &) const override
 Найти пересечения кривой с вертикальной прямой. Подробнее...
 
void SelfIntersect (SArray< MbCrossPoint > &, double metricEps=Math::LengthEps) const override
 Найти самопересечения кривой. Подробнее...
 
bool IsSelfIntersect (double metricEps, bool considerPartialCoincidence) const
 Есть ли самопересечения контура? Подробнее...
 
bool FilletTwoSegments (ptrdiff_t &index, double rad, bool &del1, bool &del2)
 Скругление двух соседних элементов с информацией об удалении
 
bool FilletTwoSegments (ptrdiff_t &index, double rad)
 Скругление двух соседних элементов
 
bool ChamferTwoSegments (ptrdiff_t &index, double len, double angle, bool type, bool firstSeg, bool &del1, bool &del2)
 Вставка фаски между двумя соседними элементами с информацией об удалении
 
bool ChamferTwoSegments (ptrdiff_t &index, double len, double angle, bool type, bool firstSeg=true)
 Вставка фаски между двумя соседними элементами
 
bool Fillet (double rad)
 Скругление контура
 
bool Chamfer (double len, double angle, bool type)
 Вставка фаски
 
MbeState RemoveFilletOrChamfer (const MbCartPoint &pnt)
 Удалить скругление или фаску контура Разбить контур на непересекающиеся сегменты.
 
bool InsertCrossPoints ()
 
void BreakSegment (ptrdiff_t &index, ptrdiff_t firtsIdx, SArray< MbCrossPoint > &cross, bool firstCurve=true)
 Разбиение сегментов контура в точках пересечения.
 
bool CheckConnection (double eps=Math::LengthEps) const
 Проверка непрерывности контура
 
bool CheckConnection (double xEps, double yEps) const
 Проверка непрерывности контура
 
void FilletTwoSegmentsZero (ptrdiff_t &index, int defaultSense, bool fullInsert)
 Скругление двух соседних элементов дугой нулевого радиуса.
 
void FilletZero (int defaultSense, bool fullInsert=false)
 Скругление контура дугой нулевого радиуса.
 
void ChamferTwoSegmentsZero (ptrdiff_t &index, double rad)
 Вставка фаски между двумя соседними элементами для построения эквидистанты.
 
void ChamferZero (double rad)
 Вставка фаски для построения эквидистанты.
 
void DeleteDegenerateSegments (double radius, MbCurve *curve, bool mode)
 Удаление вырожденных сегментов контура.
 
void Equid (double radLeft, double radRight, int side, bool mode, PArray< MbCurve > &equLeft, PArray< MbCurve > &equRight)
 Построение эквидистанты к контуру. Подробнее...
 
void CreateNewContours (RPArray< MbCurve > &)
 Построение новых контуров из эквидистанты.
 
double CalculateArea (double sag=Math::deviateSag) const
 Вычисление площади контура, если контур замкнут.
 
int GetSense () const
 Определение направления обхода контура, если контур замкнут.
 
void SetSense (int sense)
 Установить направление обхода контура.
 
void Inverse (MbRegTransform *=nullptr) override
 Изменить направления кривой на противоположное.
 
bool NormalizeReparametrization ()
 
size_t GetCount () const override
 Определить количество разбиений для прохода в операциях.
 
bool DistanceToPointIfLess (const MbCartPoint &toP, double &d) const override
 Вычислить расстояние до точки. Подробнее...
 
bool GetSpecificPoint (const MbCartPoint &from, double &dmax, MbCartPoint &pnt) const override
 Вернуть характерную точку кривой. Подробнее...
 
bool GetSegmentMiddlePoint (const MbCartPoint &from, MbCartPoint &midPoint) const
 Выдать среднюю точку сегмента контура.
 
bool GetLinearSegment (const MbCartPoint &from, double maxDist, MbCartPoint &p1, MbCartPoint &p2, double &d) const
 Выдать линейный сегмент контура.
 
MbArcGetArcSegment (const MbCartPoint &from, double maxDist, double &d) const
 Выдать дуговой сегмент контура.
 
bool GetSegmentLength (const MbCartPoint &from, double &length) const
 Выдать длину сегмента контура.
 
bool GetWeightCentre (MbCartPoint &) const override
 Вычислить центр тяжести кривой.
 
bool GetCentre (MbCartPoint &) const override
 Вычислить центр кривой.
 
ptrdiff_t FindNearestNode (const MbCartPoint &to) const
 Найти ближайший к точке узел контура.
 
ptrdiff_t FindNearestSegment (const MbCartPoint &to) const
 Найти ближайший к точке сегмент контура.
 
void OffsetCuspPoint (SArray< double > &tCusps, double dist) const override
 Найти особые точки эквидистантной кривой. Подробнее...
 
double GetRadius () const override
 Дать физический радиус скривой или ноль, если это невозможно. Подробнее...
 
bool GetAxisPoint (MbCartPoint &) const override
 Вычислить точку для построения оси. Подробнее...
 
void CombineNurbsSegments ()
 Объединить NURBS кривые в контуре.
 
void GetProperties (MbProperties &) override
 Выдать свойства объекта. Подробнее...
 
void SetProperties (const MbProperties &) override
 Изменить свойства объекта. Подробнее...
 
void GetBasisPoints (MbControlData &) const override
 Выдать контрольные точки объекта.
 
void SetBasisPoints (const MbControlData &) override
 Изменить объект по контрольным точкам.
 
bool IsContinuousDerivative (bool &contLength, bool &contDirect, c3d::DoubleVector *params=nullptr, double epsilon=EPSILON) const override
 Непрерывна ли первая производная кривой по длине и направлению? Отсутствуют ли разрывы производной по длине и направлению в стыках сегментов контура?
. Подробнее...
 
bool SetContinuousDerivativeLength (VERSION version, double epsilon=EPSILON) override
 Устранить разрывы производных по длине в стыках сегментов. Устранить разрывы производных по длине в стыках сегментов.
. Подробнее...
 
void GetAnalyticalFunctionsBounds (std::vector< double > &params) const override
 Получить границы участков кривой, которые описываются одной аналитической функцией.
 
void BreakPoints (std::vector< double > &vBreaks, double precision=ANGLE_REGION) const override
 \ ru Определение точек излома контура.
 
Функции работы с сегментами контура
bool Init (List< MbCurve > &)
 Инициализация по списку кривых.
 
void Init (const MbContour &)
 Инициализация по контуру.
 
template<class Curves >
bool Init (Curves &curves, bool sameCurves)
 Инициализация по массиву кривых. Подробнее...
 
template<class Points >
bool InitByPoints (const Points &)
 Инициализация по массиву точек (замкнутый контур).
 
bool InitAsRectangle (const MbCartPoint *)
 Инициализация как прямоугольника ( приходит 4 точки )
 
bool InitByRectangle (const MbRect &)
 Инициализация по прямоугольнику габарита.
 
bool AddSegment (MbCurve *)
 Добавить сегмент в контур.
 
bool AddSegmentOrDeleteCurve (MbCurve *)
 Добавить кривую как сегмент или удалить ее.
 
MbCurveAddSegment (const MbCurve *pBasis, double t1, double t2, int sense=1)
 Добавить (усеченную) копию сегмента в конец контура. Подробнее...
 
bool AddAtSegment (MbCurve *newSegment, size_t index)
 Вставить сегмент перед сегментом контура с индексом index.
 
bool AddAfterSegment (MbCurve *newSegment, size_t index)
 Вставить сегмент после сегмента контура с индексом index.
 
bool AddCurveWithRuledCheck (MbCurve &newCur, double absEps, bool toEndOnly=false, bool checkSame=true, VERSION version=Math::DefaultMathVersion())
 Добавить новый элемент в начало или конец контура. Подробнее...
 
void DeleteSegments ()
 Удалить все сегменты в контуре.
 
void DeleteSegment (size_t ind)
 Удалить сегмент в контуре.
 
void DetachSegments ()
 Отцепить все сегменты от контура без удаления.
 
MbCurveDetachSegment (size_t ind)
 Отцепить сегмент от контура и вернуть его.
 
template<class CurvesVector >
void DetachSegments (CurvesVector &segms)
 Отцепить все сегменты от контура без удаления.
 
void SetSegment (MbCurve &newSegment, size_t ind)
 Заменить сегмент в контуре.
 
void SegmentsAdd (MbCurve &newSegment, bool calculateParamLength=true)
 Добавить сегмент в контур без проверки.
 
void SegmentsInsert (size_t ind, MbCurve &newSegment)
 Вставить сегмент в контур перед индексом без проверки.
 
void SegmentsRemove (size_t ind)
 Удалить сегмент без проверки.
 
void SegmentsDetach (size_t ind)
 Отцепить сегмент без проверки.
 
void Calculate (bool calcArea=false)
 Рассчитать параметры: rect, paramLength, metricLength, closed.
 
void SegmentsReserve (size_t additionalSpace)
 Зарезервировать место под столько элементов.
 
void SegmentsAdjust ()
 Удалить лишнюю память.
 
template<class CurvesVector >
bool GetSegments (CurvesVector &segms) const
 Получить сегменты контура.
 
void SetMetricLength (double len) const
 
bool SetBegEndPoint (double t)
 Установить начальную (конечную) точку для замкнутого контура.
 
void ReplaceContoursAndPolylines ()
 Заменить сегменты контуры и сегменты полилинии.
 
void GetPolygon (double sag, SArray< MbCartPoint > &poly, double eps) const
 Дать точки полигона.
 
bool IsAnyCurvilinear () const
 Есть ли в контуре криволинейный сегмент.
 
bool IsSameSegments (const MbContour &, double accuracy=PARAM_PRECISION) const
 Содержат ли контура идентичные сегменты.
 
bool GetBegSegmentPoint (size_t i, MbCartPoint &) const
 Дать начальную точку i-го сегмента.
 
bool GetEndSegmentPoint (size_t i, MbCartPoint &) const
 Дать конечную точку i-го сегмента.
 
bool CornerNormal (double t, MbVector &norm) const
 Нормаль по параметру, учитывая стыки сегментов. Подробнее...
 
template<class Params >
void GetCornerParams (Params &params) const
 Параметры стыков сегментов. Подробнее...
 
bool GetTwoTangents (double t, MbVector &tan1, MbVector &tan2) const
 Вычисление двух касательных (для параметров стыков). Подробнее...
 
Функции работы с именами контура.
void GetSegmentsNames (SimpleNameArray &names) const
 Дать имена сегментов. Подробнее...
 
void SetSegmentsNames (const SimpleNameArray &names)
 Установить имена сегментов. Подробнее...
 
- Открытые члены унаследованные от MbCurve
virtual ~MbCurve ()
 Деструктор.
 
MbePlaneType Type () const override
 Получить групповой тип объекта.
 
MbePlaneType Family () const override
 Получить семейство объекта.
 
void Refresh () override
 Перевести все временные (mutable) данные объекта в неопределённое (исходное) состояние.
 
size_t size () const
 Количество объектов при трактовке объекта как вектора объектов.
 
const MbCurveoperator[] (size_t) const
 Оператор доступа.
 
virtual void AddYourGabaritMtr (MbRect &rect, const MbMatrix &matr) const
 Добавить габарит в прямоугольник. Подробнее...
 
bool IsVisibleInRect (const MbRect &rect, bool exact=false) const override
 Определить видимость объекта в прямоугольнике. Подробнее...
 
virtual bool IsCompleteInRect (const MbRect &rect) const
 Определить, виден ли объект полностью в прямоугольнике. Подробнее...
 
double DistanceToPoint (const MbCartPoint &toP) const override
 Вычислить расстояние до точки.
 
bool DistanceToPointIfLess (const MbCartPoint &toP, double &d) const override
 Вычислить расстояние до точки. Подробнее...
 
virtual double GetPeriod () const
 Вернуть период. Подробнее...
 
virtual bool IsPeriodic () const
 Определить, является ли замкнутая кривая периодической.
 
bool IsTouch (double eps=Math::LengthEps) 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
 Вычислить вектор главной нормали (нормализованный).
 
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 double Curvature (double t) const
 Вычислить кривизну кривой.
 
double CurvatureDerive (double t) const
 Вычислить производную кривизны по параметру.
 
double CurvatureRadius (double t) const
 Вычислить радиус кривизны кривой со знаком.
 
virtual bool IsBounded () const
 Определить, является ли кривая ограниченной.
 
virtual bool IsDegenerate (double eps=Math::LengthEps) const
 Определить, является ли кривая вырожденной.
 
double GetParamLength () const
 Вычислить параметрическую длину кривой.
 
virtual void ResetTCalc () 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=nullptr) const
 Построить NURBS копию кривой. Подробнее...
 
virtual MbCurveNurbsCurve (const MbNurbsParameters &tParameters) const
 Построить NURBS копию кривой. Подробнее...
 
MbeNewtonResult PointProjectionNewton (const MbCartPoint &p, double xEpsilon, double yEpsilon, size_t iterLimit, double &t, bool ext) 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 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 bool GoThroughPoint (MbCartPoint &pnt)
 Провести кривую через точку. Подробнее...
 
virtual bool GetMiddlePoint (MbCartPoint &) const
 Вычислить среднюю точку кривой.
 
virtual void GetStartPoint (MbCartPoint &) const
 Вычислить начальную точку кривой.
 
virtual void GetEndPoint (MbCartPoint &) const
 Вычислить конечную точку кривой.
 
virtual bool IsSimilarToCurve (const MbCurve &curve, double precision=PARAM_PRECISION) 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=nullptr) 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 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 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
 Вычислить длину вектора производной.
 
MbPropertyCreateProperty (MbePrompt name) const override
 Создать собственное свойство.
 
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 () const
 Регистрация объекта. Подробнее...
 
MbeRefType RefType () const override
 Получить регистрационный тип (для копирования, дублирования).
 
virtual void Rotate (const MbCartPoint &pnt, double angle, MbRegTransform *iReg=nullptr, const MbSurface *newSurface=nullptr)
 Повернуть вокруг точки. Подробнее...
 
- Открытые члены унаследованные от TapeBase
 TapeBase (RegistrableRec regs=noRegistrable)
 Конструктор.
 
 TapeBase (const TapeBase &)
 Конструктор копирования
 
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
refcount_t GetUseCount () const
 Выдать количество ссылок (выдать количество владельцев объекта).
 
refcount_t AddRef () const
 Увеличить количество ссылок на единицу.
 
refcount_t DecRef () const
 Уменьшить количество ссылок на единицу.
 
refcount_t Release () const
 Уменьшить количество ссылок на единицу и, если количество ссылок стало равным нулю, удалить себя.
 
- Открытые члены унаследованные от MbNestSyncItem
void Lock () const
 Включить блокировку (блокировка происходит только при наличии параллельности).
 
void Unlock () const
 Снять блокировку, если она была установлена.
 
CommonRecursiveMutexGetLock () const
 Выдать указатель на объект мьютекса. Возращает nullptr, если параллельности нет. Для использования в ScopedLock.
 

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

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

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

RPArray< MbCurvesegments
 Множество сегментов контура.
 
bool closed
 Признак замкнутости кривой.
 
double paramLength
 Параметрическая длина контура.
 
double metricLength
 Метрическая длина контура.
 
MbRect rect
 Габаритный прямоугольник.
 
c3d::DoublePair areaSign
 Площадь контура со знаком.
 
- Защищенные данные унаследованные от MbCurve
SimpleName name
 Имя кривой.
 

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

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

Контур представляет собой составную кривую, в которой начало каждого последующего сегмента стыкуется с концом предыдущего. Контур является замкнутым, если конец последнего сегмента стыкуется с началом первого сегмента.
Если сегменты составной кривой стыкуются не гладко, то составная кривая будет иметь изломы. В общем случае в местах стыковки сегментов производные составной кривой терпят разрыв по длине и направлению.
Начальное значение параметра составной кривой равно нулю. Параметрическая длина составной кривой равна сумме параметрических длин составляющих её сегментов.
При вычислении радиуса-вектора составной кривой сначала определяется сегмент, которому соответствует значение параметра составной кривой, и соответствующее значение собственного параметра этого сегмента. Далее вычисляется радиус-вектор сегмента, который и будет радиусом-вектором составной кривой.
В качестве сегментов составной кривой не используются другие составные кривые. Если составную кривую нужно построить на основе других составных кривых, то последние должны рассматриваться как совокупность составляющих их кривых, а не как единые кривые.
Двумерный контур используется для плоского моделирования, а также для описания двумерных связных областей, например, для описания области определения параметров поверхности.

Методы

◆ Duplicate()

MbPlaneItem& MbContour::Duplicate ( MbRegDuplicate iReg = nullptr) const
overridevirtual

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

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

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

Замещает MbPlaneItem.

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

◆ IsSimilar()

bool MbContour::IsSimilar ( const MbPlaneItem item) const
overridevirtual

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

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

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

Переопределяет метод предка MbPlaneItem.

◆ SetEqual()

bool MbContour::SetEqual ( const MbPlaneItem item)
overridevirtual

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

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

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

Замещает MbPlaneItem.

◆ IsSame()

bool MbContour::IsSame ( const MbPlaneItem item,
double  accuracy = LENGTH_EPSILON 
) const
overridevirtual

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

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

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

Замещает MbPlaneItem.

◆ Transform()

void MbContour::Transform ( const MbMatrix matr,
MbRegTransform iReg = nullptr,
const MbSurface newSurface = nullptr 
)
overridevirtual

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

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

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

Замещает MbPlaneItem.

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

◆ Move()

void MbContour::Move ( const MbVector to,
MbRegTransform iReg = nullptr,
const MbSurface newSurface = nullptr 
)
overridevirtual

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

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

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

Замещает MbPlaneItem.

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

◆ Rotate()

void MbContour::Rotate ( const MbCartPoint pnt,
const MbDirection angle,
MbRegTransform iReg = nullptr,
const MbSurface newSurface = nullptr 
)
overridevirtual

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

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

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

Замещает MbPlaneItem.

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

◆ Offset()

MbCurve* MbContour::Offset ( double  rad) const
overridevirtual

Построить эквидистантную кривую, смещённую на заданное расстояние.

Построить эквидистантную кривую, смещённую на заданное расстояние. Функция вставляет в копии контура дуги нулевого радиуса между стыками сегментов. Это нужно для обеспечения непрерывности контура для обоих направлений смещения. Но это может приводить к появлению самопересечений контура. Затем выполняет эквидистантное смещение всех сегментов. Данная функция имеет ограниченную область применения. В качестве альтернативы можно использовать функцию OffsetContour.

Аргументы
[in]rad- Величина эквидистантного смещения.
Возвращает
Возвращает эквидистантный контур, если получилось его построить, иначе - nullptr.

Переопределяет метод предка MbCurve.

◆ CalculateGabarit()

void MbContour::CalculateGabarit ( MbRect ) const
overridevirtual

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

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

Переопределяет метод предка MbCurve.

◆ CalculateLocalGabarit()

void MbContour::CalculateLocalGabarit ( const MbMatrix into,
MbRect local 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ Deformation()

MbeState MbContour::Deformation ( const MbRect rect,
const MbMatrix matr 
)
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ PrepareIntegralData()

void MbContour::PrepareIntegralData ( const bool  forced) const
overridevirtual

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

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

Переопределяет метод предка MbCurve.

◆ DeletePart()

MbeState MbContour::DeletePart ( double  t1,
double  t2,
MbCurve *&  part2 
)
overridevirtual

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

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

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

Замещает MbCurve.

◆ TrimmPart()

MbeState MbContour::TrimmPart ( double  t1,
double  t2,
MbCurve *&  part2 
)
overridevirtual

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

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

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

Замещает MbCurve.

◆ Trimmed()

MbCurve* MbContour::Trimmed ( double  t1,
double  t2,
int  sense 
) const
overridevirtual

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

Строит усеченную кривую, начало которой соответствует точке с параметром 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 - направление кривой меняется на обратное.
Возвращает
Построенная усеченная кривая.

Замещает MbCurve.

◆ IsClosed()

bool MbContour::IsClosed ( ) const
overridevirtual

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

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

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

Замещает MbCurve.

◆ PointOn()

void MbContour::PointOn ( double &  t,
MbCartPoint p 
) const
overridevirtual

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

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

Аргументы
[in]t- Параметр curve.
[out]p- Вычисленная точка на кривой.

Замещает MbCurve.

◆ _PointOn()

void MbContour::_PointOn ( double  t,
MbCartPoint p 
) const
overridevirtual

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

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

Аргументы
[in]t- Параметр curve.
[out]p- Вычисленная точка на кривой.

Переопределяет метод предка MbCurve.

◆ Explore()

void MbContour::Explore ( double &  t,
bool  ext,
MbCartPoint pnt,
MbVector fir,
MbVector sec,
MbVector thir 
) const
overridevirtual

Вычислить значения точки и производных для заданного параметра.

Значения точки и производных вычисляются в пределах области определения и на расширенной кривой.

Аргументы
[in]t- Параметр.
[in]ext- В пределах области определения (false), на расширенной кривой (true).
[out]pnt- Точка.
[out]fir- Производная.
[out]sec- Вторая производная по t, если не ноль.
[out]thir- Третья производная по t, если не ноль.

Переопределяет метод предка MbCurve.

◆ Step()

double MbContour::Step ( double  t,
double  sag 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ DeviationStep()

double MbContour::DeviationStep ( double  t,
double  ang 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ HasLength()

bool MbContour::HasLength ( double &  length) const
overridevirtual

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

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

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

Замещает MbCurve.

◆ GetMetricLength()

double MbContour::GetMetricLength ( ) const
overridevirtual

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

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

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

Замещает MbCurve.

◆ GetLengthEvaluation()

double MbContour::GetLengthEvaluation ( ) const
overridevirtual

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

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

Переопределяет метод предка MbCurve.

◆ NurbsCurve()

MbNurbs* MbContour::NurbsCurve ( const MbCurveIntoNurbsInfo nInfo) const
overridevirtual

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

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

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

Замещает MbCurve.

◆ IsClosedContinuousC0()

bool MbContour::IsClosedContinuousC0 ( double  eps = 5.0 *PARAM_NEAR) const

Проверить замкнутость и непрерывность точек контура.

Проверить замкнутость и непрерывность точек контура. Проверяется совпадение первой и последней точки контура, совпадение последней точки каждого сегмента с первой точкой следующего сегмента. Равенство точек проверяется по умолчанию грубо - с точностью, равной 5 * PARAM_NEAR.

Возвращает
true, если контур замкнутый и непрерывный.

◆ CalculateLength()

double MbContour::CalculateLength ( double  t1,
double  t2 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ DistanceAlong()

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

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

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

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

Переопределяет метод предка MbCurve.

◆ FindSegment()

ptrdiff_t MbContour::FindSegment ( double &  t,
double &  tSeg 
) const

Найти сегмент контура.

Найти сегмент контура по параметру контура.

Аргументы
[in,out]t- Параметр контура.
[out]tSeg- Параметр сегмента контура.
Возвращает
Возвращает номер сегмента в случае успешного выполнения или -1.

◆ PointRelative()

MbeItemLocation MbContour::PointRelative ( const MbCartPoint pnt,
double  eps = Math::LengthEps 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ NearPointProjection()

bool MbContour::NearPointProjection ( const MbCartPoint pnt,
double  xEpsilon,
double  yEpsilon,
double &  t,
bool  ext,
MbRect1D tRange = nullptr 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ DistanceToBorder()

double MbContour::DistanceToBorder ( const MbCartPoint pnt,
double  eps = Math::paramRegion 
) const

Параметрическое расстояние до ближайшей границы. Параметрическое расстояние до ближайшей границы.
.

Аргументы
[in]pnt- Тестируемая точка.
[in]eps- Точность.
Возвращает
Расстояние до ближайшей границы.

◆ Extend()

MbResultType MbContour::Extend ( const MbCurveExtensionParameters parameters,
c3d::PlaneCurveSPtr resCurve 
) const
overridevirtual

Продлить кривую.

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

Аргументы
[in]parameters- Параметры продления.
[out]resCurve- Продленная кривая или нулевой указатель, если продление невозможно.
Возвращает
Возвращает статус ошибки или rt_Success, если все хорошо. В разработке.

Переопределяет метод предка MbCurve.

◆ PerpendicularPoint()

void MbContour::PerpendicularPoint ( const MbCartPoint pnt,
SArray< double > &  tFind 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ TangentPoint()

void MbContour::TangentPoint ( const MbCartPoint pnt,
SArray< double > &  tFind 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ IntersectHorizontal()

void MbContour::IntersectHorizontal ( double  y,
SArray< double > &  cross 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ IntersectVertical()

void MbContour::IntersectVertical ( double  x,
SArray< double > &  cross 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ SelfIntersect()

void MbContour::SelfIntersect ( SArray< MbCrossPoint > &  ,
double  metricEps = Math::LengthEps 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ IsSelfIntersect()

bool MbContour::IsSelfIntersect ( double  metricEps,
bool  considerPartialCoincidence 
) const

Есть ли самопересечения контура?

Есть ли самопересечения контура?

Аргументы
[in]metricEps- Точность (по умолчанию рекомендуется использовать Math::LengthEps).
[in]considerPartialCoincidence- Считать частичное совпадение соседних сегментов самопересечением (true - по умолчанию).

◆ Equid()

void MbContour::Equid ( double  radLeft,
double  radRight,
int  side,
bool  mode,
PArray< MbCurve > &  equLeft,
PArray< MbCurve > &  equRight 
)

Построение эквидистанты к контуру.

Построение эквидистанты к контуру справа и слева. Имя каждого эквидистантного контура совпадает с именем исходного.

Аргументы
[in]radLeft- Радиус эквидистанты слева по направлению.
[in]radRight- Радиус эквидистанты справа по направлению.
[in]side- Признак, с какой стороны строить:
0 - слева по направлению,
1 - справа по направлению,
2 - с двух сторон.
[in]mode- Cпособ обхода углов:
true - дугой, false - срезом.
[out]equLeft- Массив контуров слева.
[out]equRight- Массив контуров справа.

◆ DistanceToPointIfLess()

bool MbContour::DistanceToPointIfLess ( const MbCartPoint to,
double &  d 
) const
overridevirtual

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

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

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

Замещает MbPlaneItem.

◆ GetSpecificPoint()

bool MbContour::GetSpecificPoint ( const MbCartPoint from,
double &  dmax,
MbCartPoint pnt 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ OffsetCuspPoint()

void MbContour::OffsetCuspPoint ( SArray< double > &  tCusps,
double  dist 
) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ GetRadius()

double MbContour::GetRadius ( ) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ GetAxisPoint()

bool MbContour::GetAxisPoint ( MbCartPoint p) const
overridevirtual

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

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

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

Переопределяет метод предка MbCurve.

◆ GetProperties()

void MbContour::GetProperties ( MbProperties properties)
overridevirtual

Выдать свойства объекта.

Выдать внутренние данные (свойства) объекта для их просмотра и модификации.

Аргументы
[in]properties- Контейнер для внутренних данных объекта.

Замещает MbPlaneItem.

◆ SetProperties()

void MbContour::SetProperties ( const MbProperties properties)
overridevirtual

Изменить свойства объекта.

Изменение внутренних данных (свойств) объекта выполняется копированием соответствующих значений из присланного объекта.

Аргументы
[in]properties- Контейнер для внутренних данных объекта.

Замещает MbPlaneItem.

◆ IsContinuousDerivative()

bool MbContour::IsContinuousDerivative ( bool &  contLength,
bool &  contDirect,
c3d::DoubleVector params = nullptr,
double  epsilon = EPSILON 
) const
overridevirtual

Непрерывна ли первая производная кривой по длине и направлению? Отсутствуют ли разрывы производной по длине и направлению в стыках сегментов контура?
.

Аргументы
[out]contLength- Непрерывность длины (да/нет).
[out]contDirect- Непрерывность направления (да/нет).
[in]epsilon- Погрешность вычисления.

Переопределяет метод предка MbCurve.

◆ SetContinuousDerivativeLength()

bool MbContour::SetContinuousDerivativeLength ( VERSION  version,
double  epsilon = EPSILON 
)
overridevirtual

Устранить разрывы производных по длине в стыках сегментов. Устранить разрывы производных по длине в стыках сегментов.
.

Аргументы
[in]epsilon- Погрешность вычисления.
[in]version- Версия математики.

Переопределяет метод предка MbCurve.

◆ Init()

template<class Curves >
bool MbContour::Init ( Curves &  curves,
bool  sameCurves 
)

Инициализация по массиву кривых.

Инициализация по массиву кривых.

Аргументы
[in]curves- Кривые.
[in]sameCurves- Использовать оригиналы кривых (true) или их копии (false).
Возвращает
Возвращает true, если кривые были добавлена.

◆ AddSegment()

MbCurve* MbContour::AddSegment ( const MbCurve pBasis,
double  t1,
double  t2,
int  sense = 1 
)

Добавить (усеченную) копию сегмента в конец контура.

Добавить (усеченную) копию сегмента в конец контура.

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

◆ AddCurveWithRuledCheck()

bool MbContour::AddCurveWithRuledCheck ( MbCurve newCur,
double  absEps,
bool  toEndOnly = false,
bool  checkSame = true,
VERSION  version = Math::DefaultMathVersion() 
)

Добавить новый элемент в начало или конец контура.

Добавить новый элемент в начало или конец контура.

Аргументы
[in]curve- Добавляемая кривая.
[in]absEps- Точность проверки совпадения концов кривых (1e-8 - 1e-4).
[in]toEndOnly- Добавлять кривую только в конец контура.
[in]checkSame- Проверять наличие такой же (добавляемой) кривой в контуре.
[in]version- Версия.
Возвращает
Возвращает true, если кривая была добавлена.

◆ CornerNormal()

bool MbContour::CornerNormal ( double  t,
MbVector norm 
) const

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

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

Аргументы
[in]t- Параметр на контуре
[out]norm- Единичный вектор нормали, если не попали на стык сегментов
если попали на стык сегментов - вектор, направленный, как сумма двух нормалей на сегментах в точке стыка, с длиной, равной 1, деленной на синус половинного угла между сегментами
Возвращает
true, если попали на стык сегментов

◆ GetCornerParams()

template<class Params >
void MbContour::GetCornerParams ( Params &  params) const

Параметры стыков сегментов.

Параметры стыков сегментов кроме минимального и максимального параметров контура.

Аргументы
[out]params- Набор параметров.

◆ GetTwoTangents()

bool MbContour::GetTwoTangents ( double  t,
MbVector tan1,
MbVector tan2 
) const

Вычисление двух касательных (для параметров стыков).

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

Аргументы
[in]t- Параметр.
[out]tan1- Первая касательная.
[out]tan2- Вторая касательная.

◆ GetSegmentsNames()

void MbContour::GetSegmentsNames ( SimpleNameArray names) const

Дать имена сегментов.

Дать имена сегментов контура.

Аргументы
[out]names- Имена сегментов.

◆ SetSegmentsNames()

void MbContour::SetSegmentsNames ( const SimpleNameArray names)

Установить имена сегментов.

Установить имена сегментов контура по массиву имен.

Аргументы
[in]names- Набор имен.

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