1 // Created on: 2011-08-01
2 // Created by: Sergey ZERCHANINOV
3 // Copyright (c) 2011-2014 OPEN CASCADE SAS
5 // This file is part of Open CASCADE Technology software library.
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.
13 // Alternatively, this file may be used under the terms of Open CASCADE
14 // commercial license or contractual agreement.
16 #ifndef _OpenGl_Group_Header
17 #define _OpenGl_Group_Header
19 #include <Graphic3d_Group.hxx>
20 #include <Graphic3d_Structure.hxx>
22 #include <NCollection_List.hxx>
23 #include <OpenGl_AspectLine.hxx>
24 #include <OpenGl_AspectFace.hxx>
25 #include <OpenGl_AspectMarker.hxx>
26 #include <OpenGl_AspectText.hxx>
27 #include <OpenGl_Element.hxx>
30 class OpenGl_Structure;
32 struct OpenGl_ElementNode
35 OpenGl_ElementNode* next;
39 //! Implementation of low-level graphic group.
40 class OpenGl_Group : public Graphic3d_Group
44 //! Create empty group.
45 //! Will throw exception if not created by OpenGl_Structure.
46 Standard_EXPORT OpenGl_Group (const Handle(Graphic3d_Structure)& theStruct);
48 Standard_EXPORT virtual void Clear (const Standard_Boolean theToUpdateStructureMgr) Standard_OVERRIDE;
50 //! Return line aspect.
51 virtual Handle(Graphic3d_AspectLine3d) LineAspect() const Standard_OVERRIDE
53 return myAspectLine != NULL
54 ? myAspectLine->Aspect()
55 : Handle(Graphic3d_AspectLine3d)();
58 //! Update line aspect.
59 Standard_EXPORT virtual void SetGroupPrimitivesAspect (const Handle(Graphic3d_AspectLine3d)& theAspect) Standard_OVERRIDE;
61 //! Append line aspect as an element.
62 Standard_EXPORT virtual void SetPrimitivesAspect (const Handle(Graphic3d_AspectLine3d)& theAspect) Standard_OVERRIDE;
64 //! Return marker aspect.
65 virtual Handle(Graphic3d_AspectMarker3d) MarkerAspect() const Standard_OVERRIDE
67 return myAspectMarker != NULL
68 ? myAspectMarker->Aspect()
69 : Handle(Graphic3d_AspectMarker3d)();
72 //! Update marker aspect.
73 Standard_EXPORT virtual void SetGroupPrimitivesAspect (const Handle(Graphic3d_AspectMarker3d)& theAspect) Standard_OVERRIDE;
75 //! Append marker aspect as an element.
76 Standard_EXPORT virtual void SetPrimitivesAspect (const Handle(Graphic3d_AspectMarker3d)& theAspect) Standard_OVERRIDE;
78 //! Return fill area aspect.
79 virtual Handle(Graphic3d_AspectFillArea3d) FillAreaAspect() const Standard_OVERRIDE
81 return myAspectFace != NULL
82 ? myAspectFace->Aspect()
83 : Handle(Graphic3d_AspectFillArea3d)();
86 //! Update face aspect.
87 Standard_EXPORT virtual void SetGroupPrimitivesAspect (const Handle(Graphic3d_AspectFillArea3d)& theAspect) Standard_OVERRIDE;
89 //! Append face aspect as an element.
90 Standard_EXPORT virtual void SetPrimitivesAspect (const Handle(Graphic3d_AspectFillArea3d)& theAspect) Standard_OVERRIDE;
92 //! Return marker aspect.
93 virtual Handle(Graphic3d_AspectText3d) TextAspect() const Standard_OVERRIDE
95 return myAspectText != NULL
96 ? myAspectText->Aspect()
97 : Handle(Graphic3d_AspectText3d)();
100 //! Update text aspect.
101 Standard_EXPORT virtual void SetGroupPrimitivesAspect (const Handle(Graphic3d_AspectText3d)& theAspect) Standard_OVERRIDE;
103 //! Append text aspect as an element.
104 Standard_EXPORT virtual void SetPrimitivesAspect (const Handle(Graphic3d_AspectText3d)& theAspect) Standard_OVERRIDE;
106 //! Update presentation aspects after their modification.
107 Standard_EXPORT virtual void SynchronizeAspects() Standard_OVERRIDE;
109 //! Add primitive array element
110 Standard_EXPORT virtual void AddPrimitiveArray (const Graphic3d_TypeOfPrimitiveArray theType,
111 const Handle(Graphic3d_IndexBuffer)& theIndices,
112 const Handle(Graphic3d_Buffer)& theAttribs,
113 const Handle(Graphic3d_BoundBuffer)& theBounds,
114 const Standard_Boolean theToEvalMinMax) Standard_OVERRIDE;
117 Standard_EXPORT virtual void Text (const Standard_CString theTextUtf,
118 const Graphic3d_Vertex& thePoint,
119 const Standard_Real theHeight,
120 const Standard_Real theAngle,
121 const Graphic3d_TextPath theTp,
122 const Graphic3d_HorizontalTextAlignment theHta,
123 const Graphic3d_VerticalTextAlignment theVta,
124 const Standard_Boolean theToEvalMinMax) Standard_OVERRIDE;
126 //! Add text element in 3D space.
127 Standard_EXPORT virtual void Text (const Standard_CString theTextUtf,
128 const gp_Ax2& theOrientation,
129 const Standard_Real theHeight,
130 const Standard_Real theAngle,
131 const Graphic3d_TextPath theTp,
132 const Graphic3d_HorizontalTextAlignment theHTA,
133 const Graphic3d_VerticalTextAlignment theVTA,
134 const Standard_Boolean theToEvalMinMax,
135 const Standard_Boolean theHasOwnAnchor = Standard_True) Standard_OVERRIDE;
137 //! Add flipping element
138 Standard_EXPORT virtual void SetFlippingOptions (const Standard_Boolean theIsEnabled,
139 const gp_Ax2& theRefPlane) Standard_OVERRIDE;
141 //! Add stencil test element
142 Standard_EXPORT virtual void SetStencilTestOptions (const Standard_Boolean theIsEnabled) Standard_OVERRIDE;
146 OpenGl_Structure* GlStruct() const { return (OpenGl_Structure* )(myStructure->CStructure().operator->()); }
148 Standard_EXPORT void AddElement (OpenGl_Element* theElem);
150 Standard_EXPORT virtual void Render (const Handle(OpenGl_Workspace)& theWorkspace) const;
151 Standard_EXPORT virtual void Release (const Handle(OpenGl_Context)& theGlCtx);
153 //! Returns first OpenGL element node of the group.
154 const OpenGl_ElementNode* FirstNode() const { return myFirst; }
156 //! Returns OpenGL face aspect.
157 const OpenGl_AspectFace* AspectFace() const { return myAspectFace; }
159 //! Is the group ray-tracable (contains ray-tracable elements)?
160 Standard_Boolean IsRaytracable() const { return myIsRaytracable; }
164 Standard_EXPORT virtual ~OpenGl_Group();
168 OpenGl_AspectLine* myAspectLine;
169 OpenGl_AspectFace* myAspectFace;
170 OpenGl_AspectMarker* myAspectMarker;
171 OpenGl_AspectText* myAspectText;
173 OpenGl_ElementNode* myFirst;
174 OpenGl_ElementNode* myLast;
176 Standard_Boolean myIsRaytracable;
180 DEFINE_STANDARD_RTTIEXT(OpenGl_Group,Graphic3d_Group) // Type definition
184 DEFINE_STANDARD_HANDLE(OpenGl_Group, Graphic3d_Group)
186 #endif // _OpenGl_Group_Header