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

Элементарная поверхность. Подробнее...

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

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

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

 VISITING_CLASS (MbElementarySurface)
Общие функции геометрического объекта
virtual MbeSpaceType IsA () const =0
 Получить тип объекта.
virtual MbeSpaceType Type () const
 Получить групповой тип объекта.
virtual MbSpaceItemDuplicate (MbRegDuplicate *=NULL) const =0
 Создать копию объекта.
virtual bool IsSame (const MbSpaceItem &other, double accuracy=LENGTH_EPSILON) const =0
 Определить, являются ли объекты равными.
virtual bool SetEqual (const MbSpaceItem &)=0
 Сделать объекты равным, если они подобны.
virtual void Transform (const MbMatrix3D &matr, MbRegTransform *=NULL)
 Преобразовать объект согласно матрице.
virtual void Move (const MbVector3D &to, MbRegTransform *=NULL)
 Сдвинуть объект вдоль вектора.
virtual void Rotate (const MbAxis3D &axis, double angle, MbRegTransform *=NULL)
 Повернуть объект вокруг оси на заданный угол.
virtual double DistanceToPoint (const MbCartPoint3D &to) const
 Определить расстояние до точки.
virtual void GetProperties (MbProperties &properties)=0
 Выдать свойства объекта.
virtual void SetProperties (const MbProperties &properties)=0
 Изменить свойства объекта.
virtual void GetBasisItems (RPArray< MbSpaceItem > &s)
 Дать базовые объекты.
virtual void GetBasisPoints (MbControlData3D &) const
 Выдать контрольные точки объекта.
virtual void SetBasisPoints (const MbControlData3D &)
 Изменить объект по контрольным точкам.
Функции описания области определения поверхности
virtual double GetUMin () const =0
 Вернуть минимальное значение параметра u.
virtual double GetVMin () const =0
 Вернуть минимальное значение параметра v.
virtual double GetUMax () const =0
 Вернуть максимальное значение параметра u.
virtual double GetVMax () const =0
 Вернуть максимальное значение параметра v.
virtual bool IsUClosed () const =0
 Определить, замкнута ли поверхность по параметру u.
virtual bool IsVClosed () const =0
 Определить, замкнута ли поверхность по параметру v.
Функции для работы в области определения поверхности

Функции PointOn, Derive... поверхностей корректируют параметры при выходе их за пределы прямоугольной области определения параметров.
Исключения составляют:
1. MbPlane (плоскость)
Функции PointOn, Derive... плоскости не корректируют параметры при выходе их за пределы прямоугольной области определения параметров.
2. MbSmoothSurface и её наследники (поверхности скругления или фаски)
Функции PointOn и Derive... поверхностей сопряжения не корректируют первый параметр при его выходе за пределы определения параметров.

virtual void PointOn (double &u, double &v, MbCartPoint3D &) const =0
 Вычислить точку на поверхности.
virtual void DeriveU (double &u, double &v, MbVector3D &) const =0
 Вычислить первую производную по u.
virtual void DeriveV (double &u, double &v, MbVector3D &) const =0
 Вычислить первую производную по v.
virtual void DeriveUU (double &u, double &v, MbVector3D &) const =0
 Вычислить вторую производную по u.
virtual void DeriveVV (double &u, double &v, MbVector3D &) const =0
 Вычислить вторую производную по v.
virtual void DeriveUV (double &u, double &v, MbVector3D &) const =0
 Вычислить вторую производную.
virtual void DeriveUUU (double &u, double &v, MbVector3D &) const =0
 Вычислить третью производную.
virtual void DeriveUUV (double &u, double &v, MbVector3D &) const =0
 Вычислить третью производную.
virtual void DeriveUVV (double &u, double &v, MbVector3D &) const =0
 Вычислить третью производную.
virtual void DeriveVVV (double &u, double &v, MbVector3D &) const =0
 Вычислить третью производную.
Функции доступа к группе данных для работы внутри и вне области определения параметров поверхности.
virtual void Explore (double &u, double &v, bool ext, MbCartPoint3D &pnt, MbVector3D &uDer, MbVector3D &vDer, MbVector3D *uuDer, MbVector3D *vvDer, MbVector3D *uvDer, MbVector3D *nor) const =0
 Вычислить значения точки и производных для заданных параметров.
Функции движения по поверхности
virtual double StepU (double u, double v, double sag) const =0
 Вычислить шаг параметра.
virtual double StepV (double u, double v, double sag) const =0
 Вычислить шаг параметра.
virtual double DeviationStepU (double u, double v, double angle) const =0
 Вычислить шаг параметра.
virtual double DeviationStepV (double u, double v, double angle) const =0
 Вычислить шаг параметра.
virtual double MetricStepU (double u, double v, double length) const =0
 Вычислить шаг параметра.
virtual double MetricStepV (double u, double v, double length) const =0
 Вычислить шаг параметра.
Общие функции поверхности
virtual MbeNewtonResult PointProjectionNewton (const MbCartPoint3D &p, size_t iterLimit, double &u, double &v, bool ext) const
 Нахождение проекции точки на поверхность. Для внутреннего использования.
virtual bool NearPointProjection (const MbCartPoint3D &p, double &u, double &v, bool ext, MbRect2D *uvRange=NULL) const
 Найти проекцию точки на поверхность.
virtual bool IsRectangular () const
 Определить, ортогональны ли производные по u и v.
virtual void SetLimit (double u1, double v1, double u2, double v2)=0
 Установить пределы поверхности. Для внутреннего использования.
Функции элементарных поверхностей
virtual bool GetPointProjection (const MbCartPoint3D &p, bool init, double &u, double &v, bool ext, MbRect2D *uvRange=NULL) const =0
 Ближайшая проекция точки на поверхность.
virtual void GetParamsToUnit (double u, double v, double &uParam, double &vParam) const
 Дать приращение параметра u и параметра v, соответствующее единичной длине в пространстве.
void AddTesselation (double step, size_t maxCount, double w1, double w2, SArray< double > &ww) const
 Добавить параметры в массив с заданным шагом.
const MbPlacement3DGetPlacement () const
 Локальная система координат.
void InitPlacement (MbPlacement3D &p)
 Установить локальную систему координат.
bool IsPositionNormal () const
 Является ли система координат ортонормированной.
bool IsPositionIsotropic () const
 Является ли система координат ортогональной и изотропной по осям.
bool IsPositionCircular () const
 Является ли система координат ортогональной с равными по длине осями X,Y.

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

 MbElementarySurface (const MbPlacement3D &)
 MbElementarySurface (const MbCartPoint3D &origin, const MbVector3D &axisZ, const MbVector3D &axisX)
 MbElementarySurface (const MbCartPoint3D &p0, const MbCartPoint3D &p1, const MbCartPoint3D &p2)
 MbElementarySurface (const MbElementarySurface &other)
void Init_ (const MbElementarySurface &)

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

MbPlacement3D position
 Локальная система координат.
double umin
 Минимальное значение первого параметра.
double vmin
 Минимальное значение второго параметра.
double umax
 Максимальное значение первого параметра.
double vmax
 Максимальное значение второго параметра.

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

Родительский класс поверхностей: MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface, MbTorusSurface. Элементарная поверхность описывается аналитическим выражением в локальной системе координат. В локальной системе координат аналитическое выражение радиуса-вектора поверхности имеет канонический вид.
Локальная система координат position может быть как правой, так и левой.


Методы

virtual MbSpaceItem& MbElementarySurface::Duplicate ( MbRegDuplicate iReg = NULL) const [pure virtual]

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

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

Замещает MbSurface.

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual bool MbElementarySurface::IsSame ( const MbSpaceItem other,
double  accuracy = LENGTH_EPSILON 
) const [pure virtual]

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

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

Замещает MbSurface.

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual bool MbElementarySurface::SetEqual ( const MbSpaceItem item) [pure virtual]

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

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

Замещает MbSurface.

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual void MbElementarySurface::Transform ( const MbMatrix3D matr,
MbRegTransform iReg = NULL 
) [virtual]

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

Аргументы:
[in]matr- Матрица преобразования.
[in]iReg- Регистратор.

Замещает MbSurface.

Переопределяется в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual void MbElementarySurface::Move ( const MbVector3D to,
MbRegTransform iReg = NULL 
) [virtual]

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

Аргументы:
[in]to- Вектор сдвига.
[in]iReg- Регистратор.

Замещает MbSurface.

virtual void MbElementarySurface::Rotate ( const MbAxis3D axis,
double  angle,
MbRegTransform iReg = NULL 
) [virtual]

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

Аргументы:
[in]axis- Ось поворота.
[in]angle- Угол поворота.
[in]iReg- Регистратор.

Замещает MbSurface.

virtual double MbElementarySurface::DistanceToPoint ( const MbCartPoint3D point) const [virtual]

Определить расстояние до точки.

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

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

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

virtual void MbElementarySurface::GetProperties ( MbProperties properties) [pure virtual]

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

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

Замещает MbSurface.

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual void MbElementarySurface::SetProperties ( const MbProperties properties) [pure virtual]

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

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

Замещает MbSurface.

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual bool MbElementarySurface::IsUClosed ( ) const [pure virtual]

Определить, замкнута ли гладко поверхность по u-параметру без учета граничного контура. Всегда false для MbCurveBoundSurface. Рекомендуется использовать IsUPeriodic.

Замещает MbSurface.

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual bool MbElementarySurface::IsVClosed ( ) const [pure virtual]

Определить, замкнута ли гладко поверхность по v-параметру без учета граничного контура. Всегда false для MbCurveBoundSurface. Рекомендуется использовать IsVPeriodic.

Замещает MbSurface.

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual void MbElementarySurface::PointOn ( double &  u,
double &  v,
MbCartPoint3D p 
) const [pure virtual]

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

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

Замещает MbSurface.

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual void MbElementarySurface::Explore ( double &  u,
double &  v,
bool  ext,
MbCartPoint3D pnt,
MbVector3D uDer,
MbVector3D vDer,
MbVector3D uuDer,
MbVector3D vvDer,
MbVector3D uvDer,
MbVector3D nor 
) const [pure virtual]

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

Аргументы:
[in]u- Параметр.
[in]v- Параметр.
[in]ext- В пределах области определения (false), на расширенной поверхности (true).
[out]pnt- Точка.
[out]uDer- Производная по u.
[out]vDer- Производная по v.
[out]uuDer- Вторая производная по u, если не ноль.
[out]vvDer- Вторая производная по v, если не ноль.
[out]uvDer- Вторая производная по u и по v, если не ноль.

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

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual double MbElementarySurface::StepU ( double  u,
double  v,
double  sag 
) const [pure virtual]

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

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

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

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual double MbElementarySurface::StepV ( double  u,
double  v,
double  sag 
) const [pure virtual]

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

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

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

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual double MbElementarySurface::DeviationStepU ( double  u,
double  v,
double  angle 
) const [pure virtual]

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

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

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

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual double MbElementarySurface::DeviationStepV ( double  u,
double  v,
double  angle 
) const [pure virtual]

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

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

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

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual double MbElementarySurface::MetricStepU ( double  u,
double  v,
double  length 
) const [pure virtual]

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

Аргументы:
[in]u- Параметр, определяющий точку на поверхности.
[in]v- Параметр, определяющий точку на поверхности.
[in]len- Заданная метрическая длина.
Возвращает:
Величина шага по параметру в заданной точке.

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

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual double MbElementarySurface::MetricStepV ( double  u,
double  v,
double  length 
) const [pure virtual]

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

Аргументы:
[in]u- Параметр, определяющий точку на поверхности.
[in]v- Параметр, определяющий точку на поверхности.
[in]len- Заданная метрическая длина.
Возвращает:
Величина шага по параметру в заданной точке.

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

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

virtual bool MbElementarySurface::NearPointProjection ( const MbCartPoint3D pnt,
double &  u,
double &  v,
bool  ext,
MbRect2D uvRange = NULL 
) const [virtual]

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

Аргументы:
[in]pnt- Заданная точка.
[in,out]u- На входе - начальное приближение, на выходе - параметр, соответствующий ближайшей проекции.
[in,out]v- На входе - начальное приближение, на выходе - параметр, соответствующий ближайшей проекции.
[in]ext- Флаг, определяющий, искать ли проекцию на продолжении поверхности (если true, то искать).
[in]uvRange- Диапазон изменения параметров, в котором надо найти решение.
Возвращает:
true - если найдена проекция, удовлетворяющая всем входным условиям.

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

virtual bool MbElementarySurface::GetPointProjection ( const MbCartPoint3D p,
bool  init,
double &  u,
double &  v,
bool  ext,
MbRect2D uvRange = NULL 
) const [pure virtual]

Ближайшая проекция точки на поверхность.

Аргументы:
[in]p- Проецируемая точка
[in]init- Если true, то входные параметры u, v считаются начальными приближениями
[in,out]u- Параметр проекции на поверхности
[in,out]v- Параметр проекции на поверхности
[in]ext- Признак поиска на продолжении поверхности
[in]uvRange- Область поиска проекции
Возвращает:
true в случае успеха операции

Замещается в MbConeSurface, MbCylinderSurface, MbPlane, MbSphereSurface и MbTorusSurface.

void MbElementarySurface::AddTesselation ( double  step,
size_t  maxCount,
double  w1,
double  w2,
SArray< double > &  ww 
) const

Добавить параметры от w1 до w2 в массив с заданным шагом.

Аргументы:
[in]step- Шаг
[in]maxCount- Максимальное количество ячеек.
[out]ww- Контейнер с параметрами

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