0031336: Modeling data - extend BRepPrimAPI_MakeBox with planar shape creation

-Create a new package BRepPreviewAPI, inherited from BRepPrimAPI to create both, valid and degenerative shapes
-Create a new class BRepPreviewAPI_MakeBox for working with a box
    Preview can be vertex, edge, rectangle or box
-BRepPrim_GWedge: in the case of non-valid data, the exception does not happen in the constructor, but at the moment of access to the shape
-BRepPrimAPI_MakeBox: myWedge is now not private, but protected, because used in  BRepPreviewAPI_MakeBox which inherits from BRepPrimAPI_MakeBox
-Add tests for checking of a creation a preview in tests/geometry/preview (vertex, edge, rectangle, box)
-Update a command "box": add new parameters

src/BRepPrimAPI/BRepPrimAPI_MakeBox.hxx

@@ -40,12 +40,29 @@ class TopoDS_Face;
 //! -   defining the construction of a box,
 //! -   implementing the construction algorithm, and
 //! -   consulting the result.
+//! Constructs a box such that its sides are parallel to the axes of
+//! -   the global coordinate system, or
+//! -   the local coordinate system Axis. and
+//! -   with a corner at (0, 0, 0) and of size (dx, dy, dz), or
+//! -   with a corner at point P and of size (dx, dy, dz), or
+//! -   with corners at points P1 and P2.
+//! Exceptions
+//! Standard_DomainError if: dx, dy, dz are less than or equal to
+//! Precision::Confusion(), or
+//! -   the vector joining the points P1 and P2 has a
+//! component projected onto the global coordinate
+//! system less than or equal to Precision::Confusion().
+//! In these cases, the box would be flat.
+
 class BRepPrimAPI_MakeBox  : public BRepBuilderAPI_MakeShape
 {
 public:
 
   DEFINE_STANDARD_ALLOC
 
+    
+  //! Default constructor
+  BRepPrimAPI_MakeBox() {}
   
   //! Make a box with a corner at 0,0,0 and the other dx,dy,dz
   Standard_EXPORT BRepPrimAPI_MakeBox(const Standard_Real dx, const Standard_Real dy, const Standard_Real dz);
@@ -56,22 +73,27 @@ public:
   //! Make a box with corners P1,P2.
   Standard_EXPORT BRepPrimAPI_MakeBox(const gp_Pnt& P1, const gp_Pnt& P2);
   
-  //! Ax2 is the left corner and the axis.
-  //! Constructs a box such that its sides are parallel to the axes of
-  //! -   the global coordinate system, or
-  //! -   the local coordinate system Axis. and
-  //! -   with a corner at (0, 0, 0) and of size (dx, dy, dz), or
-  //! -   with a corner at point P and of size (dx, dy, dz), or
-  //! -   with corners at points P1 and P2.
-  //! Exceptions
-  //! Standard_DomainError if: dx, dy, dz are less than or equal to
-  //! Precision::Confusion(), or
-  //! -   the vector joining the points P1 and P2 has a
-  //! component projected onto the global coordinate
-  //! system less than or equal to Precision::Confusion().
-  //! In these cases, the box would be flat.
+  //! Make a box with Ax2 (the left corner and the axis) and size dx, dy, dz.
   Standard_EXPORT BRepPrimAPI_MakeBox(const gp_Ax2& Axes, const Standard_Real dx, const Standard_Real dy, const Standard_Real dz);
   
+  //! Init a box with a corner at 0,0,0 and the other theDX, theDY, theDZ
+  Standard_EXPORT void Init (const Standard_Real theDX, const Standard_Real theDY, const Standard_Real theDZ);
+  
+  //! Init a box with a corner at thePnt and size theDX, theDY, theDZ.
+  Standard_EXPORT void Init (const gp_Pnt& thePnt,
+                             const Standard_Real theDX,
+                             const Standard_Real theDY,
+                             const Standard_Real theDZ);
+  
+  //! Init a box with corners thePnt1, thePnt2.
+  Standard_EXPORT void Init (const gp_Pnt& thePnt1, const gp_Pnt& thePnt2);
+
+  //! Init a box with Ax2 (the left corner and the theAxes) and size theDX, theDY, theDZ.
+  Standard_EXPORT void Init (const gp_Ax2& theAxes,
+                             const Standard_Real theDX,
+                             const Standard_Real theDY,
+                             const Standard_Real theDZ);
+
   //! Returns the internal algorithm.
   Standard_EXPORT BRepPrim_Wedge& Wedge();
   
@@ -110,6 +132,7 @@ Standard_EXPORT operator TopoDS_Solid();
 protected:
 
 
+  BRepPrim_Wedge myWedge;
 
 
 
@@ -117,7 +140,6 @@ private:
 
 
 
-  BRepPrim_Wedge myWedge;
 
 
 };