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

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

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

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

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

virtual ~MbPolyCurve ()
 Деструктор.
 VISITING_CLASS (MbPolyCurve)
Общие функции геометрического объекта.
virtual MbePlaneType IsA () const =0
 Получить тип объекта.
virtual MbePlaneType Type () const
 Получить групповой тип объекта.
virtual bool SetEqual (const MbPlaneItem &)=0
 Сделать объекты равным.
virtual bool IsSame (const MbPlaneItem &other, double accuracy=LENGTH_EPSILON) const =0
 Определить, являются ли объекты равными.
virtual void Transform (const MbMatrix &matr, MbRegTransform *ireg=NULL, const MbSurface *newSurface=NULL)=0
 Преобразовать согласно матрице.
virtual void Move (const MbVector &to, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)=0
 Сдвинуть вдоль вектора.
virtual void Rotate (const MbCartPoint &pnt, const MbDirection &angle, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)=0
 Повернуть вокруг точки.
virtual MbPlaneItemDuplicate (MbRegDuplicate *=NULL) const =0
 Создать копию.
virtual void AddYourGabaritTo (MbRect &r) const
 Расширить присланный габаритный прямоугольник так, чтобы он включал в себя данный объект.
virtual void Refresh ()
 Перевести все временные (mutable) данные объекта в неопределённое (исходное) состояние.
virtual void PrepareIntegralData (const bool forced) const
 Рассчитать временные (mutable) данные объекта.
Функции описания области определения кривой.
virtual double GetTMax () const =0
 Получить максимальное значение параметра.
virtual double GetTMin () const =0
 Получить минимальное значение параметра.
virtual bool IsClosed () const
 Определить, является ли кривая замкнутой.
Функции для работы в области определения кривой.

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

virtual void PointOn (double &t, MbCartPoint &pnt) const =0
 Вычислить точку на кривой.
virtual void FirstDer (double &t, MbVector &fd) const =0
 Вычислить первую производную.
virtual void SecondDer (double &t, MbVector &sd) const =0
 Вычислить вторую производную.
virtual void ThirdDer (double &t, MbVector &td) const =0
 Вычислить третью производную.
Функции доступа к группе данных для работы внутри и вне области определения параметра кривой.
virtual void Explore (double &t, bool ext, MbCartPoint &pnt, MbVector &fir, MbVector *sec, MbVector *thir) const =0
 Вычислить значения точки и производных для заданного параметра.
Общие функции кривой
virtual bool IsStraight () const
 Определить, является ли кривая прямолинейной.
virtual bool HasLength (double &length) const
 Вычислить метрическую длину кривой.
virtual void Inverse (MbRegTransform *iReg=NULL)=0
 Изменить направления кривой на противоположное.
virtual MbeState Deformation (const MbRect &, const MbMatrix &)
 Деформировать кривую.
virtual bool IsInRectForDeform (const MbRect &r) const
 Определить видимость кривой в прямоугольнике.
virtual size_t GetCount () const
 Определить количество разбиений для прохода в операциях.
virtual double GetMetricLength () const
 Вычислить метрическую длину кривой.
virtual double GetLengthEvaluation () const
 Вычислить метрическую длину кривой.
virtual bool GetSpecificPoint (const MbCartPoint &from, double &dmax, MbCartPoint &pnt) const
 Вернуть характерную точку кривой.
virtual void GetProperties (MbProperties &properties)=0
 Выдать свойства объекта.
virtual void SetProperties (const MbProperties &properties)=0
 Записать свойства объекта.
virtual void GetBasisPoints (MbControlData &) const
 Выдать базовые точки кривой.
virtual void SetBasisPoints (const MbControlData &)
 Изменить объект по контрольным точкам.
Общие функции полигональной кривой
virtual size_t GetPointsCount () const
 Выдать количество контрольных точек.
virtual void GetPoint (ptrdiff_t index, MbCartPoint &pnt) const
 Выдать характерную точку.
virtual ptrdiff_t GetNearPointIndex (const MbCartPoint &pnt) const
 Выдать индекс точки, ближайшей к заданной.
virtual void GetRuleInterval (ptrdiff_t index, double &t1, double &t2) const =0
 Вернуть интервал влияния точки кривой.
virtual void Rebuild ()=0
 Перестроить кривую.
virtual void SetClosed (bool cls)
 Установить признак замкнутости.
virtual void SetBegEndDerivesEqual ()
 Установить равные производные на краях.
virtual void ClosedBreak ()
 Сделать незамкнутой, оставив совпадающими начало и конец.
virtual void RemovePoint (ptrdiff_t index)
 Удалить характерную точку с заданным индексом.
virtual void RemovePoints ()
 Удалить все точки.
virtual void AddPoint (const MbCartPoint &pnt)
 Добавить точку в конец массива контрольных точек.
virtual bool ChangePointsValue (const SArray< MbCartPoint > &pntList)
 Изменить характерные точки.
virtual void AddAfter (const MbCartPoint &pnt, ptrdiff_t index)
 Вставить точку в массив контрольных точек.
virtual void InsertPoint (ptrdiff_t index, const MbCartPoint &pnt)=0
 Вставить точку в массив контрольных точек.
virtual void InsertPoint (double t, const MbCartPoint &pnt, double xEps, double yEps)=0
 Вставить точку в массив контрольных точек.
virtual void InsertPoint (double t, const MbCartPoint &pnt, const MbVector &v, double xEps, double yEps)
 Вставить точку в массив контрольных точек.
virtual void ChangePole (ptrdiff_t index, const MbCartPoint &pnt)
 Заменить полюс.
virtual void ChangePoint (ptrdiff_t index, const MbCartPoint &pnt)
 Заменить точку.
virtual bool CheckParam (double &t, ptrdiff_t &i0, ptrdiff_t &i1, double &t0, double &t1) const =0
 Перемместить параметр в область определения кривой.
virtual double GetParam (ptrdiff_t i) const =0
 Вернуть параметр, соответствующий точке с указанным индексом.
virtual size_t GetParamsCount () const =0
 Выдать количество параметров.
virtual void GetTList (SArray< double > &params) const
size_t GetPointListCount () const
 Выдать количество характерный точек.
ptrdiff_t GetPointListMaxIndex () const
 Выдать максимальный индекс массива контрольных точек.
void GetPointList (SArray< MbCartPoint > &pnts) const
 Вернуть массив контрольных точек.
const MbCartPointGetPointList (size_t i) const
 Вернуть характерную точку с заданным индексом.
MbCartPointSetPointList (size_t i)
 Вернуть характерную точку с заданным индексом.
void SetPointList (const SArray< MbCartPoint > &pnts)
 Заменить набор контрольных точек.
ptrdiff_t GetUppIndex () const
 Вернуть максимальный индекс массива контрольных точек.
size_t GetSegmentsCount () const
 Вернуть количество интервалов.
bool NurbsParam (double epsilon, double &pmin, double &pmax, ptrdiff_t &i1, double &t1, ptrdiff_t &i2, double &t2) const
 Дать информацию для функции NurbsCurve.

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

 MbPolyCurve ()
 Конструктор по умолчанию.
 MbPolyCurve (const MbPolyCurve &pCurve)
 Конструктор копирования.
virtual bool CanChangeClosed () const
 Определить, можно ли поменять признак замкнутости.
bool CompositeDistanceAlong (double &t, double len, int curveDir, double eps, const SArray< double > &tList) const
double SegmentCalculateLength (double w1, double w2, size_t n, double *x, double *w) const
bool SegmentDistanceAlong (double &t1, double ln, int curveDir, double eps, double stepMax, size_t n, double *x, double *w) const

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

SArray< MbCartPointpointList
 Множество контрольных точек.
ptrdiff_t uppIndex
 Количество участков кривой (равно количество контрольных точек минус единица).
bool closed
 Признак замкнутости кривой.
MbRect rect
 Габаритный прямоугольник.
double metricLength
 Метрическая длина сплайна.

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

Родительский класс кривых в двумерном пространстве, заданных контрольными точками: MbBezier, MbCubicSpline, MbHermit, MbNurbs, MbPolyline.


Методы

virtual bool MbPolyCurve::SetEqual ( const MbPlaneItem item) [pure virtual]

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

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

Замещает MbCurve.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

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

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

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

Замещает MbCurve.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

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

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

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

Замещает MbCurve.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

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

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

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

Замещает MbCurve.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

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

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

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

Замещает MbCurve.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

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

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

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

Замещает MbCurve.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

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

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

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

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

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

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

Замещает MbCurve.

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

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

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

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

Замещает MbCurve.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

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

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

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

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

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

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

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

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

Замещает MbCurve.

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

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

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

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

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

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

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

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

Замещает MbCurve.

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

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

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

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

virtual bool MbPolyCurve::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 MbPolyCurve::GetPoint ( ptrdiff_t  index,
MbCartPoint pnt 
) const [virtual]

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

Аргументы:
[in]index- Номер характерной точки.
[out]pnt- Характерная точка.

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

virtual void MbPolyCurve::GetRuleInterval ( ptrdiff_t  index,
double &  t1,
double &  t2 
) const [pure virtual]

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

Аргументы:
[in]index- Номер характерной точки.
[out]t1- Минимальный параметр интервала влияния.
[out]t2- Максимальный параметр интервала влияния.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

virtual bool MbPolyCurve::ChangePointsValue ( const SArray< MbCartPoint > &  pntList) [virtual]

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

Аргументы:
[in]pntList- Заданный массив контрольных точек.
Возвращает:
true - если точки были изменены.

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

virtual void MbPolyCurve::AddAfter ( const MbCartPoint pnt,
ptrdiff_t  index 
) [virtual]

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

Аргументы:
[in]pnt- Заданная точка.
[in]index- Индекс, после которого надо вставить точку.
virtual void MbPolyCurve::InsertPoint ( ptrdiff_t  index,
const MbCartPoint pnt 
) [pure virtual]

Вставить заданную точку по индексу.

Аргументы:
[in]pnt- Заданная точка.
[in]index- Индекс, по которому надо вставить точку.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

virtual void MbPolyCurve::InsertPoint ( double  t,
const MbCartPoint pnt,
double  xEps,
double  yEps 
) [pure virtual]

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

Аргументы:
[in]t- Параметр новой точки.
[in]pnt- Заданная точка.
[in]xEps- Точность по x.
[in]yEps- Точность по y.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

virtual void MbPolyCurve::InsertPoint ( double  t,
const MbCartPoint pnt,
const MbVector v,
double  xEps,
double  yEps 
) [virtual]

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

Аргументы:
[in]t- Параметр новой точки.
[in]pnt- Заданная точка.
[in]v- Производная в заданной точке.
[in]xEps- Точность по x.
[in]yEps- Точность по y.

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

virtual void MbPolyCurve::ChangePole ( ptrdiff_t  index,
const MbCartPoint pnt 
) [virtual]

В общем случае функция эквивалентна ChangePoint() и заменяет характерную точку с указанным индексом.

Аргументы:
[in]index- Индекс изменяемой точки.
[in]pnt- Заданная точка.

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

virtual void MbPolyCurve::ChangePoint ( ptrdiff_t  index,
const MbCartPoint pnt 
) [virtual]

Заменить точку.

Аргументы:
[in]index- Индекс изменяемой точки.
[in]pnt- Заданная точка.

Переопределяется в MbBezier, MbCubicSpline, MbHermit и MbNurbs.

virtual bool MbPolyCurve::CheckParam ( double &  t,
ptrdiff_t &  i0,
ptrdiff_t &  i1,
double &  t0,
double &  t1 
) const [pure virtual]

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

Аргументы:
[in,out]t- На входе - заданный параметр. На выходе - параметр в области определения кривой.
[out]i0- Индекс характерной точки слева от заданного параметра.
[out]i1- Индекс характерной точки справа от заданного параметра.
[out]t0- Параметр характерной точки слева от заданного параметра.
[out]t1- Параметр характерной точки справа от заданного параметра.
Возвращает:
true - если операция выполнена успешно.

Замещается в MbBezier, MbCubicSpline, MbHermit, MbNurbs и MbPolyline.

bool MbPolyCurve::NurbsParam ( double  epsilon,
double &  pmin,
double &  pmax,
ptrdiff_t &  i1,
double &  t1,
ptrdiff_t &  i2,
double &  t2 
) const

Дать информацию для функции NurbsCurve. Если отрезок кривой проходит через pmin у замкнутой кривой (например, [0.2, 1.1] для замкнутой кривой с параметризацией [0, 1]) то i1, i2 учитывают это и могут нумероваться не с 0, а с GetPointsCount(), т.е. через период.

Аргументы:
[in]epsilon- Заданная точность.
[in]pmin- Параметр начала аппроксимируемой части кривой.
[in]pmax- Параметр конца аппроксимируемой части кривой.
[in]i1- Индекс следующего за pmin значения параметра.
[in]t1- Индекс предшествующего pmax значения параметра.
[in]i2- Параметр следующей за pmin характерной точки.
[in]t2- Параметр предшествующей pmax характерной точки.

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