Dario Sassi
1083 lines
77 KiB
C++
1083 lines
77 KiB
C++
////////////////////////////////////////////////////////////////////////////////
|
||
/**
|
||
\file
|
||
\brief \ru Методы построения трехмерных кривых.
|
||
\en Functions for three-dimensional curves construction. \~
|
||
\details \ru На базе кривых строятся рёбра. Рёбра используются в твёрдотельной и каркасной модели.
|
||
Кроме того, кривые используются для построения поверхностей, а также могут служить
|
||
вспомогательными элементами модели.
|
||
\en Edges are created on the basis of curves. Edges are used in solid and wireframe model.
|
||
In addition curves are used for construction of surfaces as well as can be used
|
||
as auxiliary elements of a model. \~
|
||
|
||
*/
|
||
////////////////////////////////////////////////////////////////////////////////
|
||
|
||
#ifndef __ACTION_SURFACE_CURVE_H
|
||
#define __ACTION_SURFACE_CURVE_H
|
||
|
||
|
||
#include <templ_s_array.h>
|
||
#include <mb_cart_point3d.h>
|
||
#include <mb_vector3d.h>
|
||
#include <space_item.h>
|
||
#include <mb_nurbs_function.h>
|
||
#include <mb_point_mating.h>
|
||
#include <mb_operation_result.h>
|
||
|
||
|
||
class MATH_CLASS MbAxis3D;
|
||
class MATH_CLASS MbCurve;
|
||
class MATH_CLASS MbCurve3D;
|
||
class MATH_CLASS MbContour3D;
|
||
class MATH_CLASS MbSurfaceCurve;
|
||
class MATH_CLASS MbSurface;
|
||
class MATH_CLASS MbElementarySurface;
|
||
class MATH_CLASS MbFace;
|
||
class MATH_CLASS MbSolid;
|
||
class MATH_CLASS MbWireFrame;
|
||
class MATH_CLASS MbSNameMaker;
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Рассчитать вершины ломаной.
|
||
\en Compute the vertices of a polyline. \~
|
||
\details \ru Рассчитать вершины ломаной point1 и point2, соединяющей точки origin1 и origin2,
|
||
сдвинутые в направлениях direction1 и direction2 на расстояния length1 и length2,
|
||
которую можно скруглить радиусами radius1 и radius2. \n
|
||
\en Compute the vertices 'point1' and 'point2' of a polyline connecting points 'origin1' and 'origin2'
|
||
translated in the directions 'direction1' and 'direction2' by distances 'length1' and 'length2'
|
||
which can be rounded with radius 'radius1' and 'radius2'. \n \~
|
||
\param[in] origin1 - \ru Первая точка.
|
||
\en The first point. \~
|
||
\param[in] direction1 - \ru Направление сдвига первой точки.
|
||
\en The direction of the first point translation. \~
|
||
\param[in] length1 - \ru Величина сдвига первой точки.
|
||
\en The distance of the first point translation. \~
|
||
\param[in] radius1 - \ru Радиус скругления для первой точки.
|
||
\en The rounding radius for the first point. \~
|
||
\param[in] origin2 - \ru Вторая точка.
|
||
\en The second point. \~
|
||
\param[in] direction2 - \ru Направления сдвига для второй точки.
|
||
\en The direction of the second point translation. \~
|
||
\param[in] length2 - \ru Величина сдвига для второй точки.
|
||
\en The distance of the second point translation. \~
|
||
\param[in] radius2 - \ru Радиус скругления для второй точки.
|
||
\en The rounding radius for the second point. \~
|
||
\param[out] result1 - \ru Первая точка ломаной.
|
||
\en The first point of the polyline. \~
|
||
\param[out] result2 - \ru Вторая точка ломаной.
|
||
\en The second point of the polyline. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) CalculatePipePoints( const MbCartPoint3D & origin1,
|
||
const MbVector3D & direction1,
|
||
double length1, double radius1,
|
||
const MbCartPoint3D & origin2,
|
||
const MbVector3D & direction2,
|
||
double length2, double radius2,
|
||
MbCartPoint3D & result1, MbCartPoint3D & result2 );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать эквидистантную кривую.
|
||
\en Create an offset curve. \~
|
||
\details \ru Создать эквидистантную кривую по плоской кривой. \n
|
||
\en Create an offset curve from a planar curve. \n \~
|
||
\param[in] curve - \ru Исходная кривая.
|
||
\en The initial curve. \~
|
||
\param[in] d - \ru Величина эквидистанты.
|
||
\en The offset distance. \~
|
||
\param[out] result - \ru Эквидистантная кривая.
|
||
\en The offset curve. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) OffsetPlaneCurve( const MbCurve3D & curve,
|
||
double d,
|
||
MbCurve3D *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать эквидистантную кривую.
|
||
\en Create an offset curve. \~
|
||
\details \ru Создать эквидистантную кривую по трехмерной кривой и вектору направления. \n
|
||
\en Create an offset curve from a three-dimensional curve and a direction vector. \n \~
|
||
\param[in] initCurve - \ru Постранственная кривая, к которой строится эквидистантная.
|
||
\en A space curve for which to construct the offset curve. \~
|
||
\param[in] offsetVect - \ru Вектор, задающий смещение в точке кривой.
|
||
\en The displacement vector at a point of the curve. \~
|
||
\param[in] useFillet - \ru Если true, то разрывы заполнять скруглением, иначе продолженными кривыми.
|
||
\en If 'true', the gaps are to be filled with fillet, otherwise with the extended curves. \~
|
||
\param[in] keepRadius - \ru Если true, то в существующих скруглениях сохранять радиусы.
|
||
\en If 'true', the existent fillet radii are to be kept. \~
|
||
\param[in] bluntAngle - \ru Если true, то в притуплять острые углы.
|
||
\en If 'true', sharp corners are to be blunt. \~
|
||
\param[in] fromBeg - \ru Вектор смещения привязан к началу.
|
||
\en The translation vector is associated with the beginning. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) OffsetCurve( const MbCurve3D & initCurve,
|
||
const MbVector3D & offsetVect,
|
||
const bool useFillet,
|
||
const bool keepRadius,
|
||
const bool bluntAngle,
|
||
const bool fromBeg,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать эквидистантную кривую.
|
||
\en Create an offset curve. \~
|
||
\details \ru Создать эквидистантную кривую по поверхностной кривой и значению смещения. \n
|
||
\en Create an offset curve from a curve on a surface and a shift value. \n \~
|
||
\param[in] curve - \ru Кривая на поверхности грани face.
|
||
\en A curve on face 'face' surface. \~
|
||
\param[in] face - \ru Грань, на которой строится эквидистанта.
|
||
\en The edge on which to build the offset curve. \~
|
||
\param[in] dirAxis - \ru Направление смещения с точкой приложения.
|
||
\en The offset direction with a point of application. \~
|
||
\param[in] dist - \ru Величина смещения.
|
||
\en The offset distance. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) OffsetCurve( const MbCurve3D & curve,
|
||
const MbFace & face,
|
||
const MbAxis3D & dirAxis,
|
||
double dist,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать проекцию кривой на поверхность.
|
||
\en Create a curve projection onto the surface. \~
|
||
\details \ru Создать проекцию кривой curve на поверхность surface (направление проецирования direction может быть NULL). \n
|
||
\en Create the projection of a curve onto surface 'surface' (the projection direction 'direction' can be NULL). \n \~
|
||
\param[in] surface - \ru Поверхность для проецирования.
|
||
\en The surface to project onto. \~
|
||
\param[in] curve - \ru Проецируемая кривая.
|
||
\en The curve to project. \~
|
||
\param[in] direction - \ru Направление проецирования (если не указано то проецирование по нормали).
|
||
\en The projection direction (if not specified, the projection along the normal). \~
|
||
\param[in] createExact - \ru Создавать проекционную кривую при необходимости.
|
||
\en Create a projection curve if necessary. \~
|
||
\param[in] truncateByBounds - \ru Усекать границами поверхности.
|
||
\en Truncate by the surface bounds. \~
|
||
\param[in] version - \ru Версия исполнения.
|
||
\en The version. \~
|
||
\param[out] result - \ru Множество кривых на поверхности.
|
||
\en An array of curves on the surface. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) CurveProjection( const MbSurface & surface,
|
||
const MbCurve3D & curve,
|
||
MbVector3D * direction,
|
||
bool createExact,
|
||
bool truncateByBounds,
|
||
RPArray<MbCurve3D> & result,
|
||
VERSION version = Math::DefaultMathVersion() );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать пространственную кривую по двум плоским проекциям.
|
||
\en Create a space curve from two planar projections. \~
|
||
\details \ru Создать пространственную кривую по двум плоским проекциям. \n
|
||
\en Create a space curve from two planar projections. \n \~
|
||
\param[in] place1 - \ru Локальная система координат 1.
|
||
\en A local coordinate system 1. \~
|
||
\param[in] curve1 - \ru Двумерная кривая 1.
|
||
\en A two-dimensional curve 1. \~
|
||
\param[in] place2 - \ru Локальная система координат 2.
|
||
\en A local coordinate system 2. \~
|
||
\param[in] curve2 - \ru Двумерная кривая 2.
|
||
\en A two-dimensional curve 2. \~
|
||
\param[out] result - \ru Множество трехмерных кривых.
|
||
\en The array of three-dimensional curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) CurveByTwoProjections( const MbPlacement3D & place1,
|
||
const MbCurve & curve1,
|
||
const MbPlacement3D & place2,
|
||
const MbCurve & curve2,
|
||
RPArray<MbCurve3D> & result,
|
||
VERSION version = Math::DefaultMathVersion() );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать проекционную кривую по нормали или по направлению.
|
||
\en Create a projection curve from a normal or from a direction. \~
|
||
\details \ru Создать проекционную кривую по нормали или по направлению. \n
|
||
Если проекция на конструктивную плоскость (плоскость без границ),
|
||
то создать на ее основе грань и прислать, а за ее удалением следит приславший. \n
|
||
\en Create a projection curve from a normal or from a direction. \n
|
||
If the projection is onto the constructive plane (a plane without bounds),
|
||
create a face on the basis of this projection. \n \~
|
||
\param[in] curve - \ru Проецируемая кривая.
|
||
\en The curve to project. \~
|
||
\param[in] faces - \ru Связный набор граней.
|
||
\en A connected set of faces. \~
|
||
\param[in] dir - \ru Вектор направления (если его нет, проекция по нормали).
|
||
\en The direction vector (if it is absent, the normal projection). \~
|
||
\param[in] createExact - \ru Создавать проекционную кривую при необходимости.
|
||
\en Create a projection curve if necessary. \~
|
||
\param[in] truncateByBounds - \ru Усечь границами.
|
||
\en Truncate by bounds. \~
|
||
\param[in] snMaker - \ru Именователь с версией.
|
||
\en An object defining the names with the version. \~
|
||
\param[out] result - \ru Проекционные кривые.
|
||
\en The projection curves. \~
|
||
\param[out] resultIndices - \ru Индексы соответствия (номера граней в исходном массиве).
|
||
\en The indices of faces in the initial array. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) ProjectionCurve( const MbCurve3D & curve,
|
||
const RPArray<MbFace> & faces,
|
||
const MbVector3D * dir,
|
||
const bool createExact,
|
||
const bool truncateByBounds,
|
||
const MbSNameMaker & snMaker,
|
||
RPArray<MbCurve3D> & result,
|
||
SArray<uintptr_t> * resultIndices );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать проекционный проволочный каркас по нормали или по направлению.
|
||
\en Create a projection wireframe from a normal or from a direction. \~
|
||
\details \ru Создать проекционный проволочный каркас по нормали или по направлению. \n
|
||
Если проекция на конструктивную плоскость (плоскость без границ),
|
||
то создать на ее основе грань и прислать, а за ее удалением следит приславший. \n
|
||
\en Create a projection curve from a normal or from a direction. \n
|
||
If the projection is onto the constructive plane (a plane without bounds),
|
||
create a face on the basis of this projection. \n \~
|
||
\param[in] wireFrame - \ru Проецируемый проволочный каркас.
|
||
\en The wireframe to project. \~
|
||
\param[in] sameWireFrame - \ru Использовать тот же экземпляр проволочного каркаса, или создать копию.
|
||
\en Flag whether to use the same wireframe or make a copy of it. \~
|
||
\param[in] solid - \ru Тело.
|
||
\en Solid. \~
|
||
\param[in] same - \ru Использовать ли тот же экземпляр журнала тела или создать копию.
|
||
\en Flag whether to use the same creators of the body or make a copy. \~
|
||
\param[in] faceIndices - \ru Номера граней в первой оболочке.
|
||
\en The numbers of faces in the first shell. \~
|
||
\param[in] dir - \ru Вектор направления (если его нет, проекция по нормали).
|
||
\en The direction vector (if it is absent, the normal projection). \~
|
||
\param[in] createExact - \ru Создавать проекционную кривую при необходимости.
|
||
\en Create a projection curve if necessary. \~
|
||
\param[in] truncateByBounds - \ru Усечь границами.
|
||
\en Truncate by bounds. \~
|
||
\param[in] snMaker - \ru Именователь с версией.
|
||
\en An object defining the names with the version. \~
|
||
\param[out] resFrame - \ru Результирующий проволочный каркас, в котором в атрибутах ребер лежат имена соответствующих граней.
|
||
\en The resulting wireframe, the attributes of the edges contain the names of corresponding faces. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) ProjectionCurve( const MbWireFrame & wireFrame,
|
||
const bool sameWireFrame,
|
||
const MbSolid & solid,
|
||
const bool same,
|
||
const SArray<size_t> & faceIndices,
|
||
const MbVector3D * dir,
|
||
const bool createExact,
|
||
const bool truncateByBounds,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& resFrame );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Устранить наложение сегментов проекционной кривой.
|
||
\en Eliminate the projection curve segments overlay. \~
|
||
\details \ru Устранить наложение сегментов проекционной кривой (вспомогательная функция для функции ProjectionCurve). \n
|
||
\en Eliminate the projection curve segments overlay (an auxiliary function for function ProjectionCurve). \n \~
|
||
\param[in,out] curves - \ru Множество кривых.
|
||
\en An array of curves. \~
|
||
\param[in,out] indices - \ru Множество индексов, синхронный с массивом кривых.
|
||
\en An array of indices synchronized with the array of curves. \~
|
||
\return \ru Возвращает true, если что-то изменилось в наборе кривых.
|
||
\en Returns true if something has modified in the curve set. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (bool) EliminateProjectionCurveOverlay( RPArray<MbCurve3D> & curves,
|
||
SArray<uintptr_t> * indices );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать массив линий очерка поверхности.
|
||
\en Create an array of isocline curves of the surface. \~
|
||
\details \ru Создать массив линий очерка поверхности с обрезкой по области определения. \n
|
||
\en Create an array of isocline curves of the surface with truncation by the definition domain. \n \~
|
||
\param[in] surface - \ru Поверхность.
|
||
\en The surface. \~
|
||
\param[in] eye - \ru Вектор взгляда.
|
||
\en The direction of view. \~
|
||
\param[in] perspective - \ru Является ли проекция перспективной.
|
||
\en Whether the projection is perspective. \~
|
||
\param[in] removeOnSurfaceBounds - \ru Удалить линии очерка, совпадающие с границами поверхности.
|
||
\en Remove the isocline curves coincident with the surface bounds. \~
|
||
\param[out] result - \ru Выходной массив линий очерка.
|
||
\en The output array of isocline curves. \~
|
||
\param[in] version - \ru Версия построения.
|
||
\en The version. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Mapping
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) SilhouetteCurve( const MbSurface & surface,
|
||
const MbVector3D & eye,
|
||
bool perspective,
|
||
bool removeOnSurfaceBounds,
|
||
RPArray<MbCurve3D> & result,
|
||
VERSION version = Math::DefaultMathVersion() );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать массив линий очерка грани.
|
||
\en Create an array of isocline curves of the face. \~
|
||
\details \ru Создать массив линий очерка грани с обрезкой по области определения. \n
|
||
\en Create an array of isocline curves of the face with truncation by the definition domain. \n \~
|
||
\param[in] face - \ru Грани.
|
||
\en The face. \~
|
||
\param[in] eye - \ru Вектор взгляда.
|
||
\en The direction of view. \~
|
||
\param[in] perspective - \ru Является ли проекция перспективной.
|
||
\en Whether the projection is perspective. \~
|
||
\param[out] result - \ru Выходной массив линий очерка.
|
||
\en The output array of isocline curves. \~
|
||
\param[in] version - \ru Версия построения.
|
||
\en The version. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Mapping
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) SilhouetteCurve( const MbFace & face,
|
||
const MbVector3D & eye,
|
||
bool perspective,
|
||
RPArray<MbCurve3D> & result,
|
||
VERSION version = Math::DefaultMathVersion() );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать массив линий очерка поверхности при вращательном движении вокруг оси.
|
||
\en Create an array of isocline curves of the rotated surface. \~
|
||
\details \ru Создать массив линий очерка поверхности с обрезкой по области определения. \n
|
||
\en Create an array of isocline curves of the surface with truncation by the definition domain. \n \~
|
||
\param[in] surface - \ru Поверхность.
|
||
\en The surface. \~
|
||
\param[in] axis - \ru Ось кругового взгляда (ось токарного сечения).
|
||
\en The axis of lathe section. \~
|
||
\param[in] removeOnSurfaceBounds - \ru Удалить линии очерка, совпадающие с границами поверхности.
|
||
\en Remove the isocline curves coincident with the surface bounds. \~
|
||
\param[out] result - \ru Выходной массив линий очерка.
|
||
\en The output array of isocline curves. \~
|
||
\param[in] version - \ru Версия построения.
|
||
\en The version. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Mapping
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) SilhouetteCurve( const MbSurface & surface,
|
||
const MbAxis3D & axis,
|
||
bool removeOnSurfaceBounds,
|
||
RPArray<MbCurve3D> & curves,
|
||
VERSION version = Math::DefaultMathVersion() );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать массив линий очерка грани при вращательном движении вокруг оси.
|
||
\en Create an array of isocline curves of the rotated face. \~
|
||
\details \ru Создать массив линий очерка грани с обрезкой по области определения. \n
|
||
\en Create an array of isocline curves of the face with truncation by the definition domain. \n \~
|
||
\param[in] face - \ru Грани.
|
||
\en The face. \~
|
||
\param[in] axis - \ru Ось кругового взгляда (ось токарного сечения).
|
||
\en The axis of lathe section. \~
|
||
\param[out] result - \ru Выходной массив линий очерка.
|
||
\en The output array of isocline curves. \~
|
||
\param[in] version - \ru Версия построения.
|
||
\en The version. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Mapping
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) SilhouetteCurve( const MbFace & face,
|
||
const MbAxis3D & axis,
|
||
RPArray<MbCurve3D> & curves,
|
||
VERSION version = Math::DefaultMathVersion() );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать кривые пересечения двух поверхностей.
|
||
\en Create the intersection curves of two surfaces. \~
|
||
\details \ru Создать кривые пересечения двух поверхностей. Результат - массив кривых пересечения поверхностей. \n
|
||
\en Create the intersection curves of two surfaces. The result is an array of intersection curves of surfaces. \n \~
|
||
\param[in] surface1 - \ru Первая поверхность.
|
||
\en The first surface. \~
|
||
\param[in] surface2 - \ru Вторая поверхность.
|
||
\en The second surface. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\warning \ru Лучше использовать IntersectionCurve на гранях, т.к. границы поверхностей могут бы неточные, \n
|
||
что приведет к неточному положению концов кривых пересечения в результате операции. \n
|
||
В гранях же границы поверхности точные, т.к. хранятся в виде кривых пересечения,
|
||
а не виде двумерных кривых. \n
|
||
\en It is better to use IntersectionCurve on faces since the surfaces bounds can be inexact, \n
|
||
and it will result in inexact position of intersection curves ends. \n
|
||
But the surface bounds in faces are exact since they are stored in the form of intersection curves,
|
||
not in the form of two-dimensional curves. \n \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) IntersectionCurve( const MbSurface & surface1,
|
||
const MbSurface & surface2,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать кривые пересечения двух граней.
|
||
\en Create intersection curves of two faces. \~
|
||
\details \ru Создать кривые пересечения двух граней. Результат - массив кривых пересечения поверхностей. \n
|
||
\en Create intersection curves of two faces. The result is an array of intersection curves of surfaces. \n \~
|
||
\param[in] face1 - \ru Первая грань оболочки.
|
||
\en The first face of the shell. \~
|
||
\param[in] face2 - \ru Вторая грани оболочки.
|
||
\en The second face of the shell. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) IntersectionCurve( MbFace & face1,
|
||
MbFace & face2,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать кривые пересечения граней двух оболочек.
|
||
\en Create intersection curves of two shells faces. \~
|
||
\details \ru Создать кривые пересечения граней двух оболочек. Результат - массив кривых пересечения поверхностей. \n
|
||
\en Create intersection curves of two shells faces. The result is an array of intersection curves of surfaces. \n \~
|
||
\param[in] solid1 - \ru Первая оболочка.
|
||
\en The first shell. \~
|
||
\param[in] faceIndices1 - \ru Номера граней в первой оболочке.
|
||
\en The numbers of faces in the first shell. \~
|
||
\param[in] solid2 - \ru Вторая оболочка.
|
||
\en The second shell. \~
|
||
\param[in] faceIndices2 - \ru Номера граней во второй оболочке.
|
||
\en The numbers of faces in the second shell. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) IntersectionCurve( const MbSolid & solid1, const SArray<size_t> & faceIndices1,
|
||
const MbSolid & solid2, const SArray<size_t> & faceIndices2,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать кривые пересечения граней двух оболочек.
|
||
\en Create intersection curves of two shells faces. \~
|
||
\details \ru Создать кривые пересечения граней двух оболочек. Результат - массив кривых пересечения поверхностей. \n
|
||
\en Create intersection curves of two shells faces. The result is an array of intersection curves of surfaces. \n \~
|
||
\param[in] solid1 - \ru Первая оболочка.
|
||
\en The first shell. \~
|
||
\param[in] faceIndices1 - \ru Номера граней в первой оболочке.
|
||
\en The numbers of faces in the first shell. \~
|
||
\param[in] same1 - \ru Использовать ли тот же журнал построителей первого тела или сделать копию.
|
||
\en Flag whether to use the same creators of the first body or make a copy. \~
|
||
\param[in] solid2 - \ru Вторая оболочка.
|
||
\en The second shell. \~
|
||
\param[in] faceIndices2 - \ru Номера граней во второй оболочке.
|
||
\en The numbers of faces in the second shell. \~
|
||
\param[in] same2 - \ru Использовать ли тот же самый журнал построителей второго тела или сделать копию.
|
||
\en Flag whether to use the same creators of the second body or make a copy. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) IntersectionCurve( const MbSolid & solid1, const SArray<size_t> & faceIndices1, const bool same1,
|
||
const MbSolid & solid2, const SArray<size_t> & faceIndices2, const bool same2,
|
||
const MbSNameMaker & snMaker, MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать линию пересечения поверхностей.
|
||
\en Create an intersection curve of surfaces. \~
|
||
\details \ru Создать линию пересечения поверхностей surf1 и surf2 по известным началу и концу линии пересечения. \n
|
||
\en Create an intersection curve of surfaces 'surf1' and 'surf2' from the specified start point and end point of the intersection curve. \n \~
|
||
\param[in] surface1 - \ru Первая поверхность.
|
||
\en The first surface. \~
|
||
\param[in] ext1 - \ru На расширенной первой поверхности.
|
||
\en Whether to create on the extended surface. \~
|
||
\param[in] uv1beg - \ru Начальная точка на первой поверхности.
|
||
\en The start point on the first surface. \~
|
||
\param[in] uv1end - \ru Конечная точка на первой поверхности.
|
||
\en The end point on the first surface. \~
|
||
\param[in] surface2 - \ru Вторая поверхность.
|
||
\en The second surface. \~
|
||
\param[in] ext2 - \ru На расширенной второй поверхности.
|
||
\en Whether to create on the extended second surface. \~
|
||
\param[in] uv2beg - \ru Начальная точка на второй поверхности.
|
||
\en The start point on the second surface. \~
|
||
\param[in] uv2end - \ru Конечная точка на второй поверхности.
|
||
\en The end point on the second surface. \~
|
||
\param[in] dir - \ru Начальное направление создания линии пересечения.
|
||
\en The start direction for intersection curve creation. \~
|
||
\param[out] result1 - \ru Двумерная кривая на первой поверхности.
|
||
\en The two-dimensional curve on the first surface. \~
|
||
\param[out] result2 - \ru Двумерная кривая на второй поверхности.
|
||
\en The two-dimensional curve on the second surface. \~
|
||
\param[out] label - \ru Тип полученной кривой пересечения.
|
||
\en The resultant intersection curve type. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) IntersectionCurve( const MbSurface & surface1, bool ext1,
|
||
const MbCartPoint & uv1beg,
|
||
const MbCartPoint & uv1end,
|
||
const MbSurface & surface2, bool ext2,
|
||
const MbCartPoint & uv2beg,
|
||
const MbCartPoint & uv2end,
|
||
const MbVector3D & dir,
|
||
MbCurve *& result1,
|
||
MbCurve *& result2,
|
||
MbeCurveBuildType & label );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать линию пересечения поверхностей.
|
||
\en Create an intersection curve of surfaces. \~
|
||
\details \ru Создать линию пересечения поверхностей surf1 и surf2 по известным началу и концу линии пересечения и вспомогательной кривой. \n
|
||
\en Create an intersection curve of surfaces 'surf1' and 'surf2' from the specified start point and end point of the intersection curve
|
||
and guide curve that approximates the desired curve. \n \~
|
||
\param[in] surface1 - \ru Первая поверхность.
|
||
\en The first surface. \~
|
||
\param[in] ext1 - \ru На расширенной первой поверхности.
|
||
\en Whether to create on the extended surface. \~
|
||
\param[in] uv1beg - \ru Начальная точка на первой поверхности.
|
||
\en The start point on the first surface. \~
|
||
\param[in] uv1end - \ru Конечная точка на первой поверхности.
|
||
\en The end point on the first surface. \~
|
||
\param[in] surface2 - \ru Вторая поверхность.
|
||
\en The second surface. \~
|
||
\param[in] ext2 - \ru На расширенной второй поверхности.
|
||
\en Whether to create on the extended second surface. \~
|
||
\param[in] uv2beg - \ru Начальная точка на второй поверхности.
|
||
\en The start point on the second surface. \~
|
||
\param[in] uv2end - \ru Конечная точка на второй поверхности.
|
||
\en The end point on the second surface. \~
|
||
\param[in] guideCurve - \ru Направляющая кривая, приближенно описывающая искомую кривую.
|
||
\en The guide curve that approximates the desired curve. \~
|
||
\param[in] useRedetermination - \ru Флаг, определяющий нужно ли уточнять шаг построения следующей точки по сравнению с функцией DeviationStep.
|
||
\en The flag that determines whether it is necessary to specify the next point build step as compared to the DeviationStep function. \~
|
||
\param[in] checkPoles - \ru Флаг необходимости проверки и корректировки полюсных точек.
|
||
\en The flag that determines whether it is necessary to check and correct pole points. \~
|
||
\param[out] result1 - \ru Двумерная кривая на первой поверхности.
|
||
\en The two-dimensional curve on the first surface. \~
|
||
\param[out] result2 - \ru Двумерная кривая на второй поверхности.
|
||
\en The two-dimensional curve on the second surface. \~
|
||
\param[out] label - \ru Тип полученной кривой пересечения.
|
||
\en The resultant intersection curve type. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC( MbResultType ) IntersectionCurve( const MbSurface & surf1, bool ext1,
|
||
const MbCartPoint & uv1beg,
|
||
const MbCartPoint & uv1end,
|
||
const MbSurface & surf2, bool ext2,
|
||
const MbCartPoint & uv2beg,
|
||
const MbCartPoint & uv2end,
|
||
const MbCurve3D * guideCurve,
|
||
bool useRedetermination,
|
||
bool checkPoles,
|
||
MbCurve *& pCurve1,
|
||
MbCurve *& pCurve2,
|
||
MbeCurveBuildType & label );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать пространственный сплайн через точки и с сопряжениями.
|
||
\en Create a spatial spline through points and with the given derivatives. \~
|
||
\details \ru Создать пространственный сплайн через точки и с сопряжениями. \n
|
||
Примечания: \n
|
||
Если есть сопряжения, то количество сопряжений должно быть равно количеству точек. \n
|
||
Отсутствующие сопряжения должны быть представлены нулевыми указателями в массиве \n
|
||
\en Create a spatial spline through points and with the given derivatives. \n
|
||
Notes: \n
|
||
If derivatives are specified, the number of derivatives should be equal to the number of points. \n
|
||
Missing derivatives should be represented by null pointers in the array \n \~
|
||
\param[in] points - \ru Точки.
|
||
\en Points. \~
|
||
\param[in] paramType - \ru Тип параметризации.
|
||
\en The parametrization type. \~
|
||
\param[in] degree - \ru Порядок сплайна.
|
||
\en A spline degree. \~
|
||
\param[in] closed - \ru Замкнутость сплайна.
|
||
\en The spline closedness. \~
|
||
\param[in] transitions - \ru Заданные сопряжения.
|
||
\en The specified derivatives. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) SpaceSplineThrough( const SArray<MbCartPoint3D> & points,
|
||
MbeSplineParamType paramType,
|
||
size_t degree,
|
||
bool closed,
|
||
RPArray< MbPntMatingData<MbVector3D> > & transitions,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать пространственный сплайн по точкам и с сопряжениями.
|
||
\en Create a spatial spline from points and derivatives. \~
|
||
\details \ru Создать пространственный сплайн по точкам и с сопряжениями. \n
|
||
\en Create a spatial spline from points and derivatives. \n \~
|
||
\param[in] points - \ru Множество точек.
|
||
\en An array of points. \~
|
||
\param[in] degree - \ru Порядок сплайна.
|
||
\en A spline degree. \~
|
||
\param[in] closed - \ru Строить замкнутый сплайн.
|
||
\en Create a closed spline. \~
|
||
\param[in] weights - \ru Множество весов точек.
|
||
\en An array of points weights. \~
|
||
\param[in] knots - \ru Узловой вектор сплайна.
|
||
\en A knot vector of the spline. \~
|
||
\param[in] begData - \ru Сопряжение в начале.
|
||
\en The start derivative. \~
|
||
\param[in] endData - \ru Сопряжение в конце.
|
||
\en The end derivative. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) SpaceSplineBy( const SArray<MbCartPoint3D> & points,
|
||
size_t degree,
|
||
bool closed,
|
||
const SArray<double> * weights,
|
||
const SArray<double> * knots,
|
||
MbPntMatingData<MbVector3D> * begData,
|
||
MbPntMatingData<MbVector3D> * endData,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать кривую на поверхности.
|
||
\en Create a curve on a surface. \~
|
||
\details \ru Создать кривую на поверхности. \n
|
||
Примечания: \n
|
||
1. Если есть сопряжения, то количество сопряжений должно быть равно количеству точек. \n
|
||
Отсутствующие сопряжения должны быть представлены нулевыми указателями в массиве \n
|
||
2. Если сплайн строится через точки, то сопряжения могуть быть заданы произвольно. \n
|
||
2. Если сплайн строится по полюсам и он незамкнут, то сопряжения могут быть только на концах. \n
|
||
3. Если сплайн строится по полюсам и он замкнут, то сопряжения должны отсутствовать. \n
|
||
4. Множество весов должен быть пуст или синхронизирован с массивом точек по количеству
|
||
(с опцией throughPoints веса игнорируются). \n
|
||
\en Create a curve on a surface. \n
|
||
Notes: \n
|
||
1. If derivatives are specified, the number of derivatives should be equal to the number of points. \n
|
||
Missing derivatives should be represented by null pointers in the array \n
|
||
2. If the spline is created from points, arbitrary derivatives can be defined. \n
|
||
2. If the spline is created from poles and it is open, only the end derivatives can be specified. \n
|
||
3. If the spline is constructed from poles and it is closed, the derivatives cannot be specified. \n
|
||
4. An array of weights should be empty or synchronized with the point array by size
|
||
(with option throughPoints weights are ignored). \n \~
|
||
\param[in] surface - \ru Поверхность.
|
||
\en The surface. \~
|
||
\param[in] throughPoints - \ru Провести сплайн через точки.
|
||
\en Create a spline through points. \~
|
||
\param[in] paramPnts - \ru Множество параметрических точек.
|
||
\en An array of parametric points. \~
|
||
\param[in] paramWts - \ru Множество весов параметрических точек.
|
||
\en An array of parametric point weights. \~
|
||
\param[in] paramClosed - \ru Строить замкнутый параметрический сплайн.
|
||
\en Create a closed parametric spline. \~
|
||
\param[in] spaceTransitions - \ru Сопряжения в точках.
|
||
\en Derivatives in the points. \~
|
||
\param[in] snMaker - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) SurfaceSpline( const MbSurface & surface,
|
||
bool throughPoints,
|
||
SArray<MbCartPoint> & paramPnts,
|
||
SArray<double> & paramWts,
|
||
bool paramClosed,
|
||
RPArray< MbPntMatingData<MbVector3D> > & spaceTransitions,
|
||
const MbSNameMaker & snMaker,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать изопараметрическую кривую.
|
||
\en Create an isoparametric curve. \~
|
||
\details \ru Создать изопараметрическую кривую на поверхности surface. \n
|
||
\en Create an isoparametric curve on surface 'surface'. \n \~
|
||
\param[in] surface - \ru Поверхность.
|
||
\en The surface. \~
|
||
\param[in] x - \ru Значение по первому параметру.
|
||
\en A value of the first parameter. \~
|
||
\param[in] isU - \ru Первый параметр есть U.
|
||
\en Whether the first parameter is U. \~
|
||
\param[in] yRange - \ru Диапазон по второму параметру (если не задан, используются параметрические границы поверхности).
|
||
\en A range of the second parameter (if not defined, the parametric bounds of the surface are used). \~
|
||
\param[out] result - \ru Изопараметрическая кривая.
|
||
\en The isoparametric curve. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) IsoparametricCurve( const MbSurface & surface,
|
||
double x, bool isU, const MbRect1D * yRange,
|
||
MbCurve3D *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать кривую - мостик, соединяющую кривые curve1 и curve2.
|
||
\en Create a transition curve connecting curves 'curve1' and 'curve2'. \~
|
||
\details \ru Создать кривую - мостик, соединяющую кривые curve1 и curve2 кубическим сплайном Эрмита. \n
|
||
\en Create a transition curve connecting curves 'curve1' and 'curve2' by a cubic Hermite spline. \n \~
|
||
\param[in] curve1 - \ru Сопрягаемая кривая 1.
|
||
\en A curve 1 to be connected. \~
|
||
\param[in] t1 - \ru Параметр точки на сопрягаемой кривой 1.
|
||
\en A point parameter on the curve 1. \~
|
||
\param[in] sense1 - \ru Начало мостика совпадает с направлением кривой curve1 (true).
|
||
\en The beginning of the transition curve is equal to the direction of 'curve1' (true). \~
|
||
\param[in] curve2 - \ru Сопрягаемая кривая 2.
|
||
\en A curve 2 to be connected. \~
|
||
\param[in] t2 - \ru Параметр точки на сопрягаемой кривой 2.
|
||
\en A point parameter on the curve 2. \~
|
||
\param[in] sense2 - \ru Конец мостика совпадает с направлением кривой curve2 (true).
|
||
\en The end of the transition curve is equal to the direction of 'curve2' (true). \~
|
||
\param[in] names - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) BridgeCurve( const MbCurve3D & curve1, double t1, bool sense1,
|
||
const MbCurve3D & curve2, double t2, bool sense2,
|
||
const MbSNameMaker & names,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать составную кривую плавного соединения концов двух кривых.
|
||
\en Create a composite curve smoothly connecting two curves ends. \~
|
||
\details \ru Создать составную кривую плавного соединения концов двух кривых. \n
|
||
Полученная кривая состоит из трёхмерной дуги радиуса radius1,
|
||
отрезка (в определенных случаях отрезок отсутствует),
|
||
трёхмерной дуги радиуса radius2.
|
||
\en Create a composite curve smoothly connecting two curves ends. \n
|
||
The constructed curve consists of a three-dimensional arc of radius 'radius1',
|
||
a segment (in specific cases a segment is absent),
|
||
a three-dimensional arc of radius 'radius2'. \~
|
||
\param[in] curve1 - \ru Соединяемая кривая 1.
|
||
\en A curve 1 to be connected. \~
|
||
\param[in] isBegin1 - \ru Начало соединяемой кривой 1 (true).
|
||
\en The beginning of the curve 1 (true). \~
|
||
\param[in] radius1 - \ru Радиус сопряжения у соединяемой кривой 1.
|
||
\en The conjugation raidus of curve 1. \~
|
||
\param[in] curve2 - \ru Соединяемая кривая 2.
|
||
\en A curve 2 to be connected. \~
|
||
\param[in] isBegin2 - \ru Начало соединяемой кривой 2 (true).
|
||
\en The beginning of the curve 2 (true). \~
|
||
\param[in] radius2 - \ru Радиус сопряжения у соединяемой кривой 2.
|
||
\en The conjugation raidus of curve 2. \~
|
||
\param[in] names - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) ConnectingCurve( const MbCurve3D & curve1, bool isBegin1, double radius1,
|
||
const MbCurve3D & curve2, bool isBegin2, double radius2,
|
||
const MbSNameMaker & names,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать соединительную NURBS кривую для кривых curve1 и curve2.
|
||
\en Create a connecting NURBS curve for curves 'curve1' and 'curve2'. \~
|
||
\details \ru Создать соединительную NURBS кривую для кривых curve1 и curve2. \n
|
||
t1 и t2 - параметры кривых curve1 и curve2, в точках которых начинается и заканчивается соединение.\n
|
||
\en Create a connecting NURBS curve for curves 'curve1' and 'curve2'. \n
|
||
t1 and t2 are parameters of curves 'curve1' and 'curve2' which correspond to the start point and the end point of the connecting curve.\n \~
|
||
\param[in] curve1 - \ru Соединяемая кривая 1.
|
||
\en A curve 1 to be connected. \~
|
||
\param[in] t1 - \ru Параметр точки на кривой 1.
|
||
\en A point parameter on curve 1. \~
|
||
\param[in] mating1 - \ru Тип соединения кривой 1.
|
||
\en The connection type for curve 1. \~
|
||
\param[in] curve2 - \ru Соединяемая кривая 2.
|
||
\en A curve 2 to be connected. \~
|
||
\param[in] t2 - \ru Параметр точки на кривой 2.
|
||
\en A point parameter on curve 2. \~
|
||
\param[in] mating2 - \ru Тип соединения кривой 2.
|
||
\en The connection type for curve 2. \~
|
||
\param[in] tension1 - \ru Параметр "натяжение" соединительной кривой на стыке с кривой 1 ( 0<= tension1 <=1).
|
||
\en The "tension" parameter of the connecting curve at the intersection with the curve 1 (0 <= tension1 <=1). \~
|
||
\param[in] tension2 - \ru Параметр "натяжение" соединительной кривой на стыке с кривой 2( 0<= tension2 <=1).
|
||
\en The "tension" parameter of the connecting curve at the intersection with the curve 2 (0 <= tension2 <=1). \~
|
||
\param[in] names - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
//---
|
||
MATH_FUNC (MbResultType) ConnectingSpline( const MbCurve3D & curve1, double t1, MbeMatingType mating1,
|
||
const MbCurve3D & curve2, double t2, MbeMatingType mating2,
|
||
double tension1, double tension2,
|
||
const MbSNameMaker & names,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать кривую для плавного соединения (скругления) кривых.
|
||
\en Create a fillet curve for curves. \~
|
||
\details \ru Создать кривую для плавного соединения (скругления) кривых. \n
|
||
Для плавного сопряжения кривых curve1 и curve2 строится кривая filletCurve. \n
|
||
При входе t1 и t2 - начальные приближения, определяющие сектор построения скругления,
|
||
w1 и w2 - не используются. \n
|
||
При входе type - тип скругления (обычное или на поверхности). \n
|
||
На выходе t1 и t2 - будут равны параметрам касания кривых curve1 и curve2 с кривой filletCurve. \n
|
||
На выходе t1 и w1 - определяют параметры сохраняемого участка при обрезке кривой curve1. \n
|
||
На выходе t2 и w2 - определяют параметры сохраняемого участка при обрезке кривой curve2. \n
|
||
Параметр radius - радиус дуги или цилиндра. \n
|
||
Если радиус radius не задан (равен нулю), то он вычисляется из условия,
|
||
что начало кривой сопряжения будет находится в точке с параметором t1,
|
||
t1 и t2 - параметры кривых curve1 и curve2, в соответствующих точках которых начинается и заканчивается скругление. \n
|
||
Параметр sense - прямое или обратное направление кривой скругления. \n
|
||
Кривая filletCurve - это кривая сопряжения, дуга (когда surface == NULL) или кривая на поверхности цилиндра surface. \n
|
||
Поверхность surface - это цилиндрическая поверхность, на которой строится кривая сопряжения в общем случае.
|
||
Для управления жизненным циклом поверхномти следует миспользовать методы ::AddRefItem(surface) и ::ReleaseItem(surface). \n
|
||
\en Create a fillet curve for curves. \n
|
||
Curve 'filletCurve' is created for smooth connection of curves 'curve1' and 'curve2'. \n
|
||
On input t1 and t2 are the initial estimations which determine a sector for fillet construction,
|
||
w1 and w2 are not used. \n
|
||
On input 'type' is a fillet type (ordinary or on a surface). \n
|
||
On output t1 and t2 are the parameters of touching of curves 'curve1' and 'curve2' with curve 'filletCurve'. \n
|
||
On output t1 and w1 determines parameters of a part to be kept while trimming curve1. \n
|
||
On output t2 and w2 determines parameters of a part to be kept while trimming curve2. \n
|
||
Parameter 'radius' is a radius of an arc or a cylinder. \n
|
||
If radius 'radius' is not defined (equal to zero), it is computed from the condition
|
||
that the fillet curve start is at the point with parameter t1,
|
||
t1 and t2 are parameters of curves 'curve1' and 'curve2' which correspond to the start point and the end point of the fillet. \n
|
||
Parameter 'sense' determines forward or backward orientation of the fillet curve. \n
|
||
Curve filletCurve is a fillet curve, an arc (when 'surface' == NULL) or a curve on a cylindric surface 'surface'. \n
|
||
Surface 'surface' is a cylindric surface on which the fillet curve is constructed in general case.
|
||
Use ::AddRefItem(surface) and ::ReleaseItem(surface) methods to manage the surface lifecycle. \n \~
|
||
\param[in] curve1 - \ru Соединяемая кривая 1.
|
||
\en A curve 1 to be connected. \~
|
||
\param[in/out] t1 - \ru Параметр точки на кривой 1 соединения с кривой соединения.
|
||
\en A point parameter on curve 1 of connection with fillet curve. \~
|
||
\param[out] w1 - \ru Параметр края на кривой 1.
|
||
\en The parameter of curve 1 end point. \~
|
||
\param[in] curve2 - \ru Соединяемая кривая 2.
|
||
\en A curve 2 to be connected. \~
|
||
\param[in/out] t2 - \ru Параметр точки на кривой 2 соединения с кривой соединения.
|
||
\en A point parameter on curve 2 of connection with fillet curve. \~
|
||
\param[out] w2 - \ru Параметр края на кривой 2.
|
||
\en The parameter of curve 2 end point. \~
|
||
\param[in/out] radius - \ru Радиус дуги или цилиндра.
|
||
\en The radius of an arc or a cylinder. \~
|
||
\param[in] sense - \ru Прямое (true) или обратное (false) направление кривой скругления.
|
||
\en The forward (true) or the backward (false) direction of the fillet curve. \~
|
||
\param[out] unchanged - \ru Не изменился радиус соединения (true) или изменился (false).
|
||
\en The fillet radius has not changed (true) or has changed (false). \~
|
||
\param[in] type - \ru Тип скругления.
|
||
\en The fillet type. \~
|
||
\param[in] names - \ru Именователь кривых каркаса.
|
||
\en An object defining the frame curves names. \~
|
||
\param[out] surface - \ru Поверхность, которая будет создана и на которой базируется соединительная кривая, (может быть возращён NULL).
|
||
\en A surface on which the fillet curve is based on, it will be created by the method (can be NULL). \~
|
||
\param[out] result - \ru Каркас с построенными кривыми.
|
||
\en The frame with the constructed curves. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) FilletCurve( const MbCurve3D & curve1, double & t1, double & w1,
|
||
const MbCurve3D & curve2, double & t2, double & w2,
|
||
double & radius, bool sense, bool & unchanged,
|
||
const MbeConnectingType type,
|
||
const MbSNameMaker & names,
|
||
MbElementarySurface *& surface,
|
||
MbWireFrame *& result );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Определить изменение радиуса при перемещении средней точки кривой скругления.
|
||
\en Determine the radius variation while translating the middle point of the fillet curve. \~
|
||
\details \ru Определить изменение радиуса при перемещении средней точки кривой скругления \n
|
||
от центра на расстояние len (с учётом знака len). \n
|
||
\en Determine the radius variation while translating the middle point of the fillet curve \n
|
||
from the centre on distance 'len' (signed). \n \~
|
||
\param[in] filletCurve - \ru Кривая скругления.
|
||
\en The fillet curve. \~
|
||
\param[in] radius - \ru Радиус скругления.
|
||
\en The radius of fillet. \~
|
||
\param[in] sense - \ru Направления смещения средней точки кривой скругления.
|
||
\en A direction of the middle point of the fillet curve translation. \~
|
||
\param[in] len - \ru Величина смещения средней точки кривой скругления.
|
||
\en A value of translation of the fillet curve middle point. \~
|
||
\param[in] curve1 - \ru Первая сопрягаемая кривая.
|
||
\en The first curve to fillet. \~
|
||
\param[in] t1 - \ru Параметр начала кривой скругления на первой сопрягаемой кривой.
|
||
\en The parameter of fillet curve start point on the first curve. \~
|
||
\param[in] curve2 - \ru Вторая сопрягаемая кривая.
|
||
\en The second curve to fillet. \~
|
||
\param[in] t2 - \ru Параметр конца кривой скругления на второй сопрягаемой кривой.
|
||
\en The parameter of fillet curve end point on the second curve. \~
|
||
\ingroup Algorithms_3D
|
||
*/
|
||
// ---
|
||
MATH_FUNC (double) GetFilletRadiusDelta( const MbCurve3D & filletCurve,
|
||
double radius, bool sense, double len,
|
||
const MbCurve3D & curve1, double t1,
|
||
const MbCurve3D & curve2, double t2 );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Определить изменение радиуса при перемещении средней точки кривой скругления.
|
||
\en Determine the radius variation while translating the middle point of the fillet curve. \~
|
||
\details \ru Определить изменение радиуса при перемещении средней точки кривой скругления \n
|
||
от центра на расстояние len (с учётом знака len). \n
|
||
\en Determine the radius variation while translating the middle point of the fillet curve \n
|
||
from the centre on distance 'len' (signed). \n \~
|
||
\param[in] filletCurve - \ru Кривая скругления.
|
||
\en The fillet curve. \~
|
||
\param[in] radius - \ru Радиус скругления.
|
||
\en The radius of fillet. \~
|
||
\param[in] sense - \ru Направления смещения средней точки кривой скругления.
|
||
\en A direction of the middle point of the fillet curve translation. \~
|
||
\param[in] len - \ru Величина смещения средней точки кривой скругления.
|
||
\en A value of translation of the fillet curve middle point. \~
|
||
\ingroup Algorithms_3D
|
||
*/
|
||
// ---
|
||
MATH_FUNC (double) GetFilletRadiusDelta( const MbCurve3D & filletCurve,
|
||
double radius, bool sense, double len );
|
||
|
||
|
||
//------------------------------------------------------------------------------
|
||
/** \brief \ru Создать кривую для плавного соединения (скругления) всех кривых контура.
|
||
\en Create a curve for fillet of all the curves of a contour. \~
|
||
\details \ru Создать кривую для плавного соединения (скругления) всех кривых контура contour. \n
|
||
type - тип скругления (обычное или на поверхности). \n
|
||
radiuses - радиусы скругления, i-й радиус соответствует стыку i-го и i+1-го сегмента. \n
|
||
Если две кривых в контуре гладко стыкуются, в этом стыке скругление не делается, радиус игнорируется. \n
|
||
\en Create a curve for fillet of all the curves of a contour 'contour'. \n
|
||
'type' is a fillet type (ordinary or on a surface). \n
|
||
'radiuses' are the fillet radii, the i-th radius corresponds to the joint of the i-th and the i+1-th segments. \n
|
||
If two curves in contours are smoothly connected, the fillet is not created at this joint, the radius is ignored. \n \~
|
||
\param[in] contour - \ru Исходный контур.
|
||
\en The initial contour. \~
|
||
\param[in] radiuses - \ru Множество радиусов скругления.
|
||
\en An array of fillet radii. \~
|
||
\param[out] result - \ru Контур со скруглениями. Имя сегмента скругления - Hash32SN() имен исходных сегменов.
|
||
\en The contour with the fillets. The name of the fillet segment - Hash32SN() of initial segments names. \~
|
||
\param[in] type - \ru Тип выполняемых скруглений.
|
||
\en The type of fillets. \~
|
||
\return \ru Возвращает код результата операции.
|
||
\en Returns operation result code. \~
|
||
\ingroup Curve3D_Modeling
|
||
*/
|
||
// ---
|
||
MATH_FUNC (MbResultType) CreateContourFillets( const MbContour3D & contour,
|
||
SArray<double> & radiuses,
|
||
MbCurve3D *& result,
|
||
const MbeConnectingType type );
|
||
|
||
|
||
#endif // __ACTION_SURFACE_CURVE_H
|