C3D Kernel  104065
Открытые члены | Защищенные члены | Защищенные данные

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

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

Полный список членов класса

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

 MbContour (const MbCurve &init, bool same)
 MbContour (const RPArray< MbCurve > &init, bool same)
 MbContour (const std::vector< SPtr< MbCurve > > &init, bool same)
 VISITING_CLASS (MbContour)
Общие функции геометрического объекта.
virtual MbePlaneType IsA () const
 Получить тип объекта.
virtual MbePlaneType Type () const
 Получить групповой тип объекта.
virtual MbPlaneItemDuplicate (MbRegDuplicate *=NULL) const
 Создать копию.
virtual bool IsSimilar (const MbPlaneItem &) const
 Определить, являются ли объекты подобными.
virtual bool SetEqual (const MbPlaneItem &)
 Сделать объекты равным.
virtual bool IsSame (const MbPlaneItem &other, double accuracy=LENGTH_EPSILON) const
 Определить, являются ли объекты равными.
virtual void Transform (const MbMatrix &matr, MbRegTransform *ireg=NULL, const MbSurface *newSurface=NULL)
 Преобразовать согласно матрице.
virtual void Move (const MbVector &to, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)
 Сдвинуть вдоль вектора.
virtual void Rotate (const MbCartPoint &pnt, const MbDirection &angle, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)
 Повернуть вокруг точки.
virtual MbCurveOffset (double rad) const
 Построить кривую, смещённую на заданное расстояние.
virtual void AddYourGabaritTo (MbRect &) const
 Расширить присланный габаритный прямоугольник так, чтобы он включал в себя данный объект.
virtual void CalculateGabarit (MbRect &) const
 Определить габаритный прямоугольник кривой.
virtual void CalculateLocalGabarit (const MbMatrix &into, MbRect &local) const
 Рассчитать габарит в локальной системы координат.
const MbRectGetGabarit () const
const MbRectGetCube () const
void SetDirtyGabarit () const
void CopyGabarit (const MbContour &c)
bool IsGabaritEmpty () const
virtual double DistanceToPoint (const MbCartPoint &) const
 Вычислить расстояние до точки.
virtual MbeState Deformation (const MbRect &, const MbMatrix &)
 Деформировать кривую.
virtual bool IsInRectForDeform (const MbRect &r) const
 Определить видимость кривой в прямоугольнике.
virtual void Refresh ()
 Перевести все временные (mutable) данные объекта в неопределённое (исходное) состояние.
virtual void PrepareIntegralData (const bool forced) const
 Рассчитать временные (mutable) данные объекта.
virtual MbeState DeletePart (double t1, double t2, MbCurve *&part2)
 Удалить часть кривой.
virtual MbeState TrimmPart (double t1, double t2, MbCurve *&part2)
 Оставить часть кривой.
virtual MbCurveTrimmed (double t1, double t2, int sense) const
 Построить усеченную кривую.
Функции описания области определения кривой.
virtual double GetTMin () const
 Получить минимальное значение параметра.
virtual double GetTMax () const
 Получить максимальное значение параметра.
virtual bool IsClosed () const
 Определить, является ли кривая замкнутой.
virtual bool IsStraight () const
 Определить, является ли кривая прямолинейной.
virtual bool IsSmoothConnected (double angleEps) 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
 Вычислить третью производную.
Функции для работы внутри и вне области определения кривой.

Функции _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
 Вычислить третью производную на кривой и её продолжении.
Функции доступа к группе данных для работы внутри и вне области определения параметра кривой.
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 angle) const
 Вычислить шаг параметра.
Общие функции кривой
virtual bool HasLength (double &length) const
 Вычислить метрическую длину кривой.
virtual double GetMetricLength () const
 Вычислить метрическую длину кривой.
virtual double GetLengthEvaluation () const
 Вычислить метрическую длину кривой.
virtual double CalculateMetricLength () const
 Вычислить метрическую длину кривой.
double GetParamLength () const
 Вычислить параметрическую длину кривой.
double CalculateParamLength ()
double GetArea (double sag=Math::deviateSag) const
virtual MbNurbsNurbsCurve (const MbCurveIntoNurbsInfo &) const
 Построить NURBS копию кривой.
virtual MbContourNurbsContour () const
 Аппроксимировать кривую контуром из NURBS-кривых.
void SetClosed ()
void CheckClosed (double eps)
void InitClosed (bool c)
bool IsClosedContinuousC0 (double eps=5.0 *PARAM_NEAR) const
 Проверить замкнутость и непрерывность точек контура.
void CloseByLineSeg (bool calcData)
virtual double CalculateLength (double t1, double t2) const
 Вычислить метрическую длину кривой.
virtual bool DistanceAlong (double &t, double len, int curveDir, double eps=Math::LengthEps, VERSION version=Math::DefaultMathVersion()) const
 Сдвинуть параметр вдоль кривой.
void Clear (bool calculateParamLength=true)
ptrdiff_t FindSegment (double &t, double &tSeg) const
size_t GetSegmentsCount () const
const MbCurveGetSegment (size_t ind) const
MbCurveSetSegment (size_t ind)
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
 Найти проекцию точки на кривую.
virtual bool NearPointProjection (const MbCartPoint &pnt, double xEpsilon, double yEpsilon, double &t, bool ext, MbRect1D *tRange=NULL) const
 Найти проекцию точки на кривую.
double DistanceToBorder (const MbCartPoint &pnt) const
void Trimm (double t1, double t2)
virtual void PerpendicularPoint (const MbCartPoint &pnt, SArray< double > &tFind) const
 Найти перпендикуляры к кривой.
virtual void TangentPoint (const MbCartPoint &pnt, SArray< double > &tFind) const
 Найти касательные к кривой.
virtual void IntersectHorizontal (double y, SArray< double > &) const
 Найти пересечения кривой с горизонтальной прямой.
virtual void IntersectVertical (double x, SArray< double > &) const
 Найти пересечения кривой с вертикальной прямой.
virtual void SelfIntersect (SArray< MbCrossPoint > &) const
 Найти самопересечения кривой.
bool IsSelfIntersect (bool bStrict=true) 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 > &contours)
double CalculateArea (double sag=Math::deviateSag) const
int GetSense () const
void SetSense (int sense)
virtual void Inverse (MbRegTransform *iReg=NULL)
 Изменить направления кривой на противоположное.
virtual size_t GetCount () const
 Определить количество разбиений для прохода в операциях.
virtual bool DistanceToPointIfLess (const MbCartPoint &toP, double &d) const
 Вычислить расстояние до точки.
virtual bool GetSpecificPoint (const MbCartPoint &from, double &dmax, MbCartPoint &pnt) const
 Вернуть характерную точку кривой.
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
virtual bool GetWeightCentre (MbCartPoint &) const
 Вычислить центр тяжести кривой.
virtual bool GetCentre (MbCartPoint &) const
 Вычислить центр кривой.
ptrdiff_t FindNearestNode (const MbCartPoint &to) const
ptrdiff_t FindNearestSegment (const MbCartPoint &to) const
virtual void OffsetCuspPoint (SArray< double > &tCusps, double dist) const
 Найти особые точки эквидистантной кривой.
virtual double GetRadius () const
 Дать физический радиус скривой или ноль, если это невозможно.
virtual bool GetAxisPoint (MbCartPoint &p) const
 Вычислить точку для построения оси.
void CombineNurbsSegments ()
virtual void GetProperties (MbProperties &properties)
 Выдать свойства объекта.
virtual void SetProperties (const MbProperties &properties)
 Записать свойства объекта.
virtual void GetBasisPoints (MbControlData &) const
 Выдать базовые точки кривой.
virtual void SetBasisPoints (const MbControlData &)
 Изменить объект по контрольным точкам.
Функции работы с сегментами контура
bool Init (List< MbCurve > &curves)
void Init (const MbContour &other)
template<class PointsVector >
bool Init (const PointsVector &points)
bool InitAsRectangle (const MbCartPoint *points)
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)
bool AddAfterSegment (MbCurve *newSegment, size_t 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 SetDegenerated ()
void DetachSegments ()
MbCurveDetachSegment (size_t ind)
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)
void SegmentsReserve (size_t additionalSpace)
void SegmentsAdjust ()
void GetSegments (RPArray< MbCurve > &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 &cntr) const
bool GetBegSegmentPoint (size_t i, MbCartPoint &p) const
bool GetEndSegmentPoint (size_t i, MbCartPoint &p) const
bool CornerNormal (double t, MbVector &norm) const
 Нормаль по параметру, учитывая стыки сегментов.
void GetCornerParams (SArray< double > &params) const
 Параметры стыков сегментов.
bool GetTwoTangents (double t, MbVector &tan1, MbVector &tan2) const
 Вычисление двух касательных (для параметров стыков).
Функции работы с именами контура.
void GetSegmentsNames (SimpleNameArray &names) const
 Дать имена сегментов.
void SetSegmentsNames (const SimpleNameArray &names)
 Установить имена сегментов.

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

 MbContour (const MbContour *, MbRegDuplicate *)

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

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

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

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


Методы

virtual MbPlaneItem& MbContour::Duplicate ( MbRegDuplicate iReg = NULL) const [virtual]

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

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

Замещает MbCurve.

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

virtual bool MbContour::IsSimilar ( const MbPlaneItem item) const [virtual]

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

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

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

virtual bool MbContour::SetEqual ( const MbPlaneItem item) [virtual]

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

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

Замещает MbCurve.

virtual bool MbContour::IsSame ( const MbPlaneItem item,
double  accuracy = LENGTH_EPSILON 
) const [virtual]

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

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

Замещает MbCurve.

virtual void MbContour::Transform ( const MbMatrix matr,
MbRegTransform iReg = NULL,
const MbSurface newSurface = NULL 
) [virtual]

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

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

Замещает MbCurve.

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

virtual void MbContour::Move ( const MbVector to,
MbRegTransform iReg = NULL,
const MbSurface newSurface = NULL 
) [virtual]

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

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

Замещает MbCurve.

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

virtual void MbContour::Rotate ( const MbCartPoint pnt,
const MbDirection angle,
MbRegTransform iReg = NULL,
const MbSurface newSurface = NULL 
) [virtual]

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

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

Замещает MbCurve.

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

virtual void MbContour::CalculateGabarit ( MbRect ) const [virtual]

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

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

virtual void MbContour::CalculateLocalGabarit ( const MbMatrix into,
MbRect local 
) const [virtual]

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

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

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

virtual MbeState MbContour::Deformation ( const MbRect rect,
const MbMatrix matr 
) [virtual]

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

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

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

virtual void MbContour::PrepareIntegralData ( const bool  forced) const [virtual]

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

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

virtual MbeState MbContour::DeletePart ( double  t1,
double  t2,
MbCurve *&  part2 
) [virtual]

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

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

Замещает MbCurve.

virtual MbeState MbContour::TrimmPart ( double  t1,
double  t2,
MbCurve *&  part2 
) [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 - кривая изменилась.
Предупреждения:
Функция предназначена для внутреннего использования.

Замещает MbCurve.

virtual MbCurve* MbContour::Trimmed ( double  t1,
double  t2,
int  sense 
) const [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 - направление кривой меняется на обратное.
Возвращает:
Построенная усеченная кривая.

Замещает MbCurve.

virtual bool MbContour::IsClosed ( ) const [virtual]

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

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

Замещает MbCurve.

virtual void MbContour::PointOn ( double &  t,
MbCartPoint p 
) const [virtual]

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

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

Замещает MbCurve.

virtual void MbContour::_PointOn ( double  t,
MbCartPoint p 
) const [virtual]

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

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

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

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

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

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

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

virtual double MbContour::Step ( double  t,
double  sag 
) const [virtual]

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

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

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

virtual double MbContour::DeviationStep ( double  t,
double  ang 
) const [virtual]

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

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

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

virtual bool MbContour::HasLength ( double &  length) const [virtual]

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

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

Замещает MbCurve.

virtual double MbContour::GetMetricLength ( ) const [virtual]

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

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

Замещает MbCurve.

virtual double MbContour::GetLengthEvaluation ( ) const [virtual]

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

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

virtual MbNurbs* MbContour::NurbsCurve ( const MbCurveIntoNurbsInfo nInfo) const [virtual]

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

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

Замещает MbCurve.

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

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

Возвращает:
true, если контур замкнутый и непрерывный.
virtual double MbContour::CalculateLength ( double  t1,
double  t2 
) const [virtual]

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

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

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

virtual bool MbContour::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.

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

virtual MbeItemLocation MbContour::PointRelative ( const MbCartPoint pnt,
double  eps = Math::LengthEps 
) const [virtual]

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

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

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

virtual bool MbContour::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 - если найдена проекция, удовлетворяющая всем входным условиям.

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

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

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

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

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

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

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

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

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

virtual void MbContour::IntersectHorizontal ( double  y,
SArray< double > &  cross 
) const [virtual]

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

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

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

virtual void MbContour::IntersectVertical ( double  x,
SArray< double > &  cross 
) const [virtual]

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

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

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

virtual void MbContour::SelfIntersect ( SArray< MbCrossPoint > &  crossPnt) const [virtual]

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

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

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

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- Массив контуров справа.
virtual bool MbContour::DistanceToPointIfLess ( const MbCartPoint to,
double &  d 
) const [virtual]

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

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

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

virtual bool MbContour::GetSpecificPoint ( const MbCartPoint from,
double &  dmax,
MbCartPoint pnt 
) const [virtual]

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

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

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

virtual void MbContour::OffsetCuspPoint ( SArray< double > &  tCusps,
double  dist 
) const [virtual]

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

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

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

virtual double MbContour::GetRadius ( ) const [virtual]

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

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

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

virtual bool MbContour::GetAxisPoint ( MbCartPoint p) const [virtual]

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

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

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

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

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

Аргументы:
[in]t- Параметр на контуре
[out]norm- Единичный вектор нормали, если не попали на стык сегментов
если попали на стык сегментов - вектор, направленный, как сумма двух нормалей на сегментах в точке стыка, с длиной, равной 1, деленной на синус половинного угла между сегментами
Возвращает:
true, если попали на стык сегментов
void MbContour::GetCornerParams ( SArray< double > &  params) const

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

Аргументы:
[out]params- Набор параметров.
bool MbContour::GetTwoTangents ( double  t,
MbVector tan1,
MbVector tan2 
) const

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

Аргументы:
[in]t- Параметр.
[out]tan1- Первая касательная.
[out]tan2- Вторая касательная.
void MbContour::GetSegmentsNames ( SimpleNameArray names) const

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

Аргументы:
[out]names- Имена сегментов.
void MbContour::SetSegmentsNames ( const SimpleNameArray names)

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

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

Объявления и описания членов класса находятся в файле:
 Указатель Классы Пространства имен Файлы Функции Переменные Определения типов Перечисления Элементы перечислений Друзья Макросы