src/SketchPlugin/SketchPlugin_MultiRotation.h

   1 // Copyright (C) 2014-20xx CEA/DEN, EDF R&D -->
   2
   3 // File:    SketchPlugin_MultiRotation.h
   4 // Created: 21 Apr 2015
   5 // Author:  Artem ZHIDKOV
   6
   7 #ifndef SketchPlugin_MultiRotation_H_
   8 #define SketchPlugin_MultiRotation_H_
   9
  10 #include "SketchPlugin.h"
  11 #include <SketchPlugin_Sketch.h>
  12 #include "SketchPlugin_ConstraintBase.h"
  13
  14 /** \class SketchPlugin_MultiRotation
  15  *  \ingroup Plugins
  16  *  \brief Feature for creation of a number of rotated copies of a list of objects
  17  *
  18  *  This constraint has two attributes:
  19  *  SketchPlugin_Constraint::ENTITY_A() for initial list of objects and
  20  *  SketchPlugin_Constraint::ENTITY_B() for the list of created objects
  21  *
  22  *  The list of created objects contains a number of copies of each object given in
  23  *  the NUMBER_OF_COPIES_ID() attribute plus 1 (the initial objects are stored into this
  24  *  attribute too). At the start of the list, there are collected N copies
  25  *  of first object from initial list, then N copies of second object etc.
  26  */
  27 class SketchPlugin_MultiRotation : public SketchPlugin_ConstraintBase
  28 {
  29  public:
  30   /// Multi-rotation kind
  31   inline static const std::string& ID()
  32   {
  33     static const std::string MY_CONSTRAINT_ROTATION_ID("SketchMultiRotation");
  34     return MY_CONSTRAINT_ROTATION_ID;
  35   }
  36   /// \brief Returns the kind of a feature
  37   SKETCHPLUGIN_EXPORT virtual const std::string& getKind()
  38   {
  39     static std::string MY_KIND = SketchPlugin_MultiRotation::ID();
  40     return MY_KIND;
  41   }
  42
  43   /// List of objects to be mirrored
  44   inline static const std::string& ROTATION_LIST_ID()
  45   {
  46     static const std::string MY_ROTATION_LIST_ID("MultiRotationList");
  47     return MY_ROTATION_LIST_ID;
  48   }
  49
  50   /// Center of rotation
  51   inline static const std::string& CENTER_ID()
  52   {
  53     static const std::string MY_CENTER_ID("MultiRotationCenter");
  54     return MY_CENTER_ID;
  55   }
  56   /// End point of translation
  57   inline static const std::string& ANGLE_ID()
  58   {
  59     static const std::string MY_ANGLE_ID("MultiRotationAngle");
  60     return MY_ANGLE_ID;
  61   }
  62   /// Number of translated objects
  63   inline static const std::string& NUMBER_OF_COPIES_ID()
  64   {
  65     static const std::string MY_NUMBER_OF_COPIES_ID("MultiRotationCopies");
  66     return MY_NUMBER_OF_COPIES_ID;
  67   }
  68
  69   /// \brief Creates a new part document if needed
  70   SKETCHPLUGIN_EXPORT virtual void execute();
  71
  72   /// \brief Request for initialization of data model of the feature: adding all attributes
  73   SKETCHPLUGIN_EXPORT virtual void initAttributes();
  74
  75   /// Called on change of any argument-attribute of this object
  76   /// \param theID identifier of changed attribute
  77   SKETCHPLUGIN_EXPORT virtual void attributeChanged(const std::string& theID);
  78
  79   /// Returns the AIS preview
  80   SKETCHPLUGIN_EXPORT virtual AISObjectPtr getAISObject(AISObjectPtr thePrevious);
  81
  82   /// \brief Use plugin manager for features creation
  83   SketchPlugin_MultiRotation();
  84
  85 private:
  86   ObjectPtr copyFeature(ObjectPtr theObject);
  87   void rotateFeature(ObjectPtr theInitial, ObjectPtr theTarget,
  88                      double theCenterX, double theCenterY, double theAngle);
  89 };
  90
  91 #endif