Extern/C3d/Include/cr_hole_solid.h

////////////////////////////////////////////////////////////////////////////////
/** 
  \file
  \brief \ru Строитель оболочки отверстия, кармана, фигурного паза.
         \en Constructor of shell of hole, pocket, groove. \~

*/
////////////////////////////////////////////////////////////////////////////////

#ifndef __CR_HOLE_SOLID_H
#define __CR_HOLE_SOLID_H


#include <cr_swept_solid.h>
#include <op_shell_parameter.h>
#include <mb_placement3d.h>


//------------------------------------------------------------------------------
/** \brief \ru Строитель оболочки отверстия, кармана, фигурного паза.
           \en Constructor of shell of hole, pocket, groove. \~
  \details \ru Строитель оболочки отверстия, кармана, фигурного паза. \n
    Построение отверстия происходит следующим образом : 
      создается контур сверла в конструктивной плоскости,
      вращением контура строится сверло, затем оно вычитается из присланного тела.
    Построение кармана/бобышки происходит следующим образом : 
      создается прямоугольный контур в конструктивной плоскости,
      который затем выдавливается в зависимости от типа объекта
      либо в положительном направлении Z, либо в отрицательном,
      затем скругляются боковые ребра и ребра на дне,
      далее вычитается карман из присланного тела или приклеивается бобышка.
    Построение фигурного паза происходит следующим образом : 
      создается контур паза в конструктивной плоскости,
      выдавливанием контура строится паз, затем он вычитается из присланного тела.
           \en Constructor of shell of hole, pocket, groove. \n
    Construction of a hole is performed as follows: 
      a contour of a drill is created in the constructive plane,
      and a drill is constructed by revolution of the contour; then the drill is subtracted from the given solid.
    A pocket/boss is constructed as follows: 
      a rectangular contour is created in the constructive plane
      which is extruded then
      either in the positive direction of Z or in the negative one subject to the object type;
      then the side edges and edges on the bottom are filleted;
      then the obtained pocket is subtracted from the given solid or the obtained boss is attached to the solid.
    The groove is constructed as follows: 
      a contour of a groove is created in the constructive plane;
      the groove is constructed by extrusion of the contour; then it is subtracted from the given solid. \~
  \ingroup Model_Creators
*/ 
// ---
class MATH_CLASS MbHoleSolid : public MbCurveSweptSolid {
protected :
  MbPlacement3D placement;  ///< \ru Плоскость отверстия. \en Plane of the hole. 
  HoleValues  * parameters; ///< \ru Параметры отверстия. \en The hole parameters. 

private :
  // \ru Объявление конструктора копирования без реализации, чтобы не было копирования по умолчанию. \en Declaration without implementation of the copy-constructor to prevent copying by default. 
  MbHoleSolid( const MbHoleSolid & init ); 
  MbHoleSolid( const MbHoleSolid & init, MbRegDuplicate * ireg );
public :
  /// \ru Конструктор по параметрам. \en Constructor by parameters. 
  MbHoleSolid( const MbPlacement3D & pl, const HoleValues & p, 
               OperationType op, const MbSNameMaker & n ); 
  /// \ru Деструктор. \en Destructor. 
  virtual ~MbHoleSolid();

public :

  // \ru Переопределение функций базового класса \en The base class functions override 

  virtual MbeCreatorType  IsA() const; // \ru Тип элемента \en A type of element 
  virtual MbCreator & Duplicate( MbRegDuplicate * = NULL ) const ; // \ru Сделать копию \en Create a copy 
  virtual void        Transform( const MbMatrix3D & matr, MbRegTransform * = NULL );          // \ru Преобразовать элемент согласно матрице \en Transform element according to the matrix 
  virtual void        Move( const MbVector3D & to, MbRegTransform * = NULL );                 // \ru Сдвиг \en Translation 
  virtual void        Rotate( const MbAxis3D & axis, double angle, MbRegTransform * = NULL ); // \ru Повернуть вокруг оси \en Rotate around an axis 

  virtual void        GetProperties( MbProperties & properties ); // \ru Выдать свойства объекта \en Get properties of the object 
  virtual void        SetProperties( const MbProperties & properties ); // \ru Записать свойства объекта \en Set properties of the object 
  virtual MbePrompt   GetPropertyName(); // \ru Выдать заголовок свойства объекта \en Get a name of object property 
  virtual void        GetBasisItems ( RPArray<MbSpaceItem>   & s ); // \ru Дать базовые объекты \en Get the base objects 
  virtual void        GetBasisPoints( MbControlData3D & ) const; // \ru Выдать контрольные точки объекта. \en Get control points of object.
  virtual void        SetBasisPoints( const MbControlData3D & ); // \ru Изменить объект по контрольным точкам. \en Change the object by control points.

  virtual bool        IsSame( const MbCreator &, double accuracy ) const; // \ru Являются ли объекты равными? \en Determine whether an object is equal?
  virtual bool        IsSimilar( const MbCreator & ) const; // \ru Являются ли объекты подобными \en Whether the objects are similar 
  virtual bool        SetEqual ( const MbCreator & );       // \ru Сделать равным \en Make equal 

  // \ru Общие функции твердого тела \en Common functions of solid 

  virtual bool        CreateShell( MbFaceShell *& shell, MbeCopyMode sameShell, 
                                   RPArray<MbSpaceItem> * items = NULL ); // \ru Построение \en Construction 

  virtual MbFaceShell * InitShell( bool in ); 
  virtual void        InitBasis( RPArray<MbSpaceItem> & items ); 
  virtual bool        GetPlacement( MbPlacement3D & p ) const;

private :
          // \ru Объявление оператора присваивания без реализации, чтобы не было присваивания по умолчанию. \en The declaration of the assignment operator without implementation to prevent an assignment by default. 
          void        operator = ( const MbHoleSolid & ); // \ru Не реализовано!!! \en Not implemented!!! 

  DECLARE_PERSISTENT_CLASS_NEW_DEL( MbHoleSolid )
};

IMPL_PERSISTENT_OPS( MbHoleSolid )

//------------------------------------------------------------------------------
/** \brief \ru Создать оболочку с отверстием, карманом, или фигурным пазом.
           \en Create a shell with a hole, a pocket or a groove. \~
    \details \ru Для указанной оболочки построить оболочку с отверстием, карманом, или фигурным пазом. \n
    Одновременно с построением оболочки функция создаёт её строитель. \n
             \en For a given shell construct a shell with a hole, a pocket or a groove. \n
    The function simultaneously constructs the shell and creates its constructor. \n \~
  \param[in]  solid     - \ru Набор граней, к которым дополняется построение.
                          \en Face set the construction is complemented with respect to. \~
  \param[in]  sameShell - \ru Способ копирования граней.
                          \en The method of copying faces. \~
  \param[in]  place     - \ru Локальная система координат.
                          \en A local coordinate system. \~
  \param[in]  par       - \ru Параметры.
                          \en Parameters. \~
  \param[in]  ns        - \ru Именователь операции.
                          \en An object defining names generation in the operation. \~
  \param[out] res       - \ru Код результата операции выдавливания.
                          \en The extrusion operation result code. \~
  \param[out] shell     - \ru Построенный набор граней.
                          \en Constructed set of faces. \~
  \result \ru Возвращает строитель.
          \en Returns the constructor. \~
  \ingroup Model_Creators
*/
// ---
MATH_FUNC (MbCreator *) CreateHole(       MbFaceShell *   solid,
                                          MbeCopyMode     sameShell,
                                    const MbPlacement3D & place,
                                    const HoleValues &    par,
                                    const MbSNameMaker &  ns,
                                          MbResultType &  res,
                                          MbFaceShell *&  shell );


//------------------------------------------------------------------------------
/** \brief \ru Определить глубину отверстия "до указанной поверхности" при построении оболочки с отверстием.
           \en Determine the hole depth "to the specified surface" while creating a shell with a hole. \~
  \details \ru Определить глубину отверстия "до указанной поверхности" при построении оболочки с отверстием.
    Глубина отверстия "до поверхности" определяться расстоянием между 
    точкой привязки отверстия на поверхности расположения и 
    точкой пересечения оси отверстия с указанной поверхностью ограничения глубины.
           \en Determine the hole depth "to the specified surface" while creating a shell with a hole.
    The hole depth "to the surface" is defined by the distance between 
    the fasten point of the hole on the location surface and 
    a point of intersection of the hole axis with the given surface limiting the depth. \~
  \param[in]  face  - \ru Грань, до которой надо ограничить глубину.
                      \en A face terminating the depth. \~
  \param[in]  place - \ru Плоскость отверстия.
                      \en Plane of the hole. \~
  \param[in]  pars - \ru Параметры отверстия.
                     \en The hole parameters. \~
  \param[out] depth - \ru Глубина.
                      \en Depth. \~
  \return \ru true в случае , если расстояние было найдено \n false - если ось не пересекает грань
          \en True if the distance was found \n false - if the axis does not intersect the face \~
  \ingroup Algorithms_3D
*/
// ---
MATH_FUNC (bool) GetDepthToFace( const MbFace &        face, 
                                 const MbPlacement3D & place, 
                                       HoleValues &    pars, 
                                       double &        depth );


#endif // __CR_HOLE_SOLID_H