C3D Kernel  104598
Открытые члены | Защищенные члены
Класс MbCharacterCurve

Двумерная кривая, координатные функции которой заданы в символьном виде. Подробнее...

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

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

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

 MbCharacterCurve (MbFunction &x, MbFunction &y, MbeLocalSystemType cs, const MbPlacement &place, double tmin_, double tmax_)
 VISITING_CLASS (MbCharacterCurve)
virtual MbePlaneType IsA () const
 Получить тип объекта.
virtual MbPlaneItemDuplicate (MbRegDuplicate *=NULL) const
 Создать копию.
virtual bool IsSame (const MbPlaneItem &other, double accuracy=LENGTH_EPSILON) const
 Определить, являются ли объекты равными.
virtual bool SetEqual (const MbPlaneItem &)
 Сделать объекты равным.
virtual void Transform (const MbMatrix &, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)
 Преобразовать согласно матрице.
virtual void Move (const MbVector &, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)
 Сдвинуть вдоль вектора.
virtual void Rotate (const MbCartPoint &pnt, const MbDirection &angle, MbRegTransform *=NULL, const MbSurface *newSurface=NULL)
 Повернуть вокруг точки.
virtual void AddYourGabaritTo (MbRect &) const
 Расширить присланный габаритный прямоугольник так, чтобы он включал в себя данный объект.
virtual void PrepareIntegralData (const bool forced) const
 Рассчитать временные (mutable) данные объекта.
virtual double GetTMin () const
 Получить минимальное значение параметра.
virtual double GetTMax () const
 Получить максимальное значение параметра.
virtual bool IsClosed () const
 Определить, является ли кривая замкнутой.
virtual void PointOn (double &t, MbCartPoint &) const
 Вычислить точку на кривой.
virtual void FirstDer (double &t, MbVector &) const
 Вычислить первую производную.
virtual void SecondDer (double &t, MbVector &) const
 Вычислить вторую производную.
virtual void ThirdDer (double &t, MbVector &) const
 Вычислить третью производную.
virtual void Explore (double &t, bool ext, MbCartPoint &pnt, MbVector &fir, MbVector *sec, MbVector *thir) const
 Вычислить значения точки и производных для заданного параметра.
virtual double Step (double t, double sag) const
 Вычислить шаг параметра.
virtual double DeviationStep (double t, double ang) const
 Вычислить шаг параметра.
virtual bool HasLength (double &length) const
 Вычислить метрическую длину кривой.
virtual double GetMetricLength () const
 Вычислить метрическую длину кривой.
virtual double GetLengthEvaluation () const
 Вычислить метрическую длину кривой.
virtual void Inverse (MbRegTransform *iReg=NULL)
 Изменить направления кривой на противоположное.
virtual MbNurbsNurbsCurve (const MbCurveIntoNurbsInfo &) const
 Построить NURBS копию кривой.
virtual MbCurveTrimmed (double t1, double t2, int sense) const
 Построить усеченную кривую.
virtual MbeState DeletePart (double t1, double t2, MbCurve *&part2)
 Удалить часть кривой.
virtual MbeState TrimmPart (double t1, double t2, MbCurve *&part2)
 Оставить часть кривой.
virtual void GetBasisPoints (MbControlData &) const
 Выдать базовые точки кривой.
virtual void SetBasisPoints (const MbControlData &)
 Изменить объект по контрольным точкам.
virtual void GetProperties (MbProperties &)
 Выдать свойства объекта.
virtual void SetProperties (const MbProperties &)
 Записать свойства объекта.
void CheckParam (double &t) const
void CalculateParam (double t, MbCartPoint &point, MbVector &firstDer, MbVector &secondDer, MbVector &thirdDer) const
const MbFunctionGetX () const
const MbFunctionGetY () const
const MbMatrixGetMatrix () const
const MbPlacementGetPlacement () const
MbeLocalSystemType GetCoordinateType () const
void GetSpecialParams (std::vector< double > &params) const

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

 MbCharacterCurve (const MbCharacterCurve &)
double ApproximationStep (double t, bool isAngle, double sag) const
void ConvertParamsInd (size_t componentIndex, const std::vector< double > &tComponent, std::vector< double > &tCrv) const
void ConvertParams (const double tCrv, double(&tComponents)[2], double(&proportionFactors)[2]) const

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

Координатные функции кривой заданы в виде пользовательских функций общего параметра t. Кождая ккордината кривой описана своей функцией в виде строкового выражения. Параметр кривой, он же параметр координатных функций, изменяется на отрезке [tmin tmax].
Все пользовательские функции заданы в локальной системе координат position. Система координат может быть декартовой или полярной. Радиус-вектор кривой в методе PointOn(double&t,MbCartPoint3D&r) описывается векторной функцией:
r(t) = position.origin + (position.axisX xFunction(t)) + (position.axisY yFunction(t)).


Методы

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

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

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

Замещает MbCurve.

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

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

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

Замещает MbCurve.

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

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

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

Замещает MbCurve.

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

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

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

Замещает MbCurve.

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

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

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

Замещает MbCurve.

virtual void MbCharacterCurve::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.

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

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

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

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

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

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

Замещает MbCurve.

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

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

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

Замещает MbCurve.

virtual void MbCharacterCurve::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 MbCharacterCurve::Step ( double  t,
double  sag 
) const [virtual]

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

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

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

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

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

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

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

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

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

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

Замещает MbCurve.

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

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

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

Замещает MbCurve.

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

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

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

virtual MbNurbs* MbCharacterCurve::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.

virtual MbCurve* MbCharacterCurve::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 MbeState MbCharacterCurve::DeletePart ( double  t1,
double  t2,
MbCurve *&  part2 
) [virtual]

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

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

Замещает MbCurve.

virtual MbeState MbCharacterCurve::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.


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