src/OpenGl/OpenGl_Group.hxx

   1 // Created on: 2011-08-01
   2 // Created by: Sergey ZERCHANINOV
   3 // Copyright (c) 2011-2014 OPEN CASCADE SAS
   4 //
   5 // This file is part of Open CASCADE Technology software library.
   6 //
   7 // This library is free software; you can redistribute it and/or modify it under
   8 // the terms of the GNU Lesser General Public License version 2.1 as published
   9 // by the Free Software Foundation, with special exception defined in the file
  10 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
  11 // distribution for complete text of the license and disclaimer of any warranty.
  12 //
  13 // Alternatively, this file may be used under the terms of Open CASCADE
  14 // commercial license or contractual agreement.
  15
  16 #ifndef _OpenGl_Group_Header
  17 #define _OpenGl_Group_Header
  18
  19 #include <InterfaceGraphic_Graphic3d.hxx>
  20 #include <Graphic3d_Group.hxx>
  21 #include <Graphic3d_Structure.hxx>
  22
  23 #include <NCollection_List.hxx>
  24 #include <OpenGl_AspectLine.hxx>
  25 #include <OpenGl_AspectFace.hxx>
  26 #include <OpenGl_AspectMarker.hxx>
  27 #include <OpenGl_AspectText.hxx>
  28 #include <OpenGl_Element.hxx>
  29
  30 class OpenGl_Group;
  31 class OpenGl_Structure;
  32
  33 struct OpenGl_ElementNode
  34 {
  35   OpenGl_Element*     elem;
  36   OpenGl_ElementNode* next;
  37   DEFINE_STANDARD_ALLOC
  38 };
  39
  40 //! Implementation of low-level graphic group.
  41 class OpenGl_Group : public Graphic3d_Group
  42 {
  43 public:
  44
  45   //! Create empty group.
  46   //! Will throw exception if not created by OpenGl_Structure.
  47   Standard_EXPORT OpenGl_Group (const Handle(Graphic3d_Structure)& theStruct);
  48
  49   Standard_EXPORT virtual void Clear (const Standard_Boolean theToUpdateStructureMgr);
  50
  51   //! Update line aspect
  52   Standard_EXPORT virtual void UpdateAspectLine   (const Standard_Boolean theIsGlobal);
  53
  54   //! Update fill aspect
  55   Standard_EXPORT virtual void UpdateAspectFace   (const Standard_Boolean theIsGlobal);
  56
  57   //! Update marker aspect
  58   Standard_EXPORT virtual void UpdateAspectMarker (const Standard_Boolean theIsGlobal);
  59
  60   //! Update text aspect
  61   Standard_EXPORT virtual void UpdateAspectText   (const Standard_Boolean theIsGlobal);
  62
  63   //! Add primitive array element
  64   Standard_EXPORT virtual void AddPrimitiveArray (const Graphic3d_TypeOfPrimitiveArray theType,
  65                                                   const Handle(Graphic3d_IndexBuffer)& theIndices,
  66                                                   const Handle(Graphic3d_Buffer)&      theAttribs,
  67                                                   const Handle(Graphic3d_BoundBuffer)& theBounds,
  68                                                   const Standard_Boolean               theToEvalMinMax);
  69
  70   //! Add text element
  71   Standard_EXPORT virtual void Text (const Standard_CString                  theTextUtf,
  72                                      const Graphic3d_Vertex&                 thePoint,
  73                                      const Standard_Real                     theHeight,
  74                                      const Quantity_PlaneAngle               theAngle,
  75                                      const Graphic3d_TextPath                theTp,
  76                                      const Graphic3d_HorizontalTextAlignment theHta,
  77                                      const Graphic3d_VerticalTextAlignment   theVta,
  78                                      const Standard_Boolean                  theToEvalMinMax);
  79
  80   //! Add text element in 3D space.
  81   Standard_EXPORT virtual void Text (const Standard_CString                  theTextUtf,
  82                                      const gp_Ax2&                           theOrientation,
  83                                      const Standard_Real                     theHeight,
  84                                      const Quantity_PlaneAngle               theAngle,
  85                                      const Graphic3d_TextPath                theTp,
  86                                      const Graphic3d_HorizontalTextAlignment theHTA,
  87                                      const Graphic3d_VerticalTextAlignment   theVTA,
  88                                      const Standard_Boolean                  theToEvalMinMax) Standard_OVERRIDE;
  89
  90   //! Add flipping element
  91   Standard_EXPORT virtual void SetFlippingOptions (const Standard_Boolean theIsEnabled,
  92                                                    const gp_Ax2&          theRefPlane);
  93
  94   //! Add stencil test element
  95   Standard_EXPORT virtual void SetStencilTestOptions (const Standard_Boolean theIsEnabled);
  96
  97 public:
  98
  99   OpenGl_Structure* GlStruct() const { return (OpenGl_Structure* )(myStructure->CStructure().operator->()); }
 100
 101   Standard_EXPORT void AddElement (OpenGl_Element* theElem);
 102
 103   Standard_EXPORT virtual void Render  (const Handle(OpenGl_Workspace)& theWorkspace) const;
 104   Standard_EXPORT virtual void Release (const Handle(OpenGl_Context)&   theGlCtx);
 105
 106   //! Returns first OpenGL element node of the group.
 107   const OpenGl_ElementNode* FirstNode() const { return myFirst; }
 108
 109   //! Returns OpenGL face aspect.
 110   const OpenGl_AspectFace* AspectFace() const { return myAspectFace; }
 111
 112   //! Is the group ray-tracable (contains ray-tracable elements)?
 113   Standard_Boolean IsRaytracable() const { return myIsRaytracable; }
 114
 115   //! Accessor to line aspect (to be removed)
 116   CALL_DEF_CONTEXTLINE& ChangeContextLine() { return ContextLine; }
 117
 118 protected:
 119
 120   Standard_EXPORT virtual ~OpenGl_Group();
 121
 122 protected:
 123
 124   OpenGl_AspectLine*     myAspectLine;
 125   OpenGl_AspectFace*     myAspectFace;
 126   OpenGl_AspectMarker*   myAspectMarker;
 127   OpenGl_AspectText*     myAspectText;
 128
 129   OpenGl_ElementNode*    myFirst;
 130   OpenGl_ElementNode*    myLast;
 131
 132   Standard_Boolean       myIsRaytracable;
 133
 134 public:
 135
 136   DEFINE_STANDARD_RTTI(OpenGl_Group, Graphic3d_Group) // Type definition
 137
 138 };
 139
 140 DEFINE_STANDARD_HANDLE(OpenGl_Group, Graphic3d_Group)
 141
 142 #endif // _OpenGl_Group_Header