1 // Created on: 2011-07-13
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_PrimitiveArray_Header
17 #define OpenGl_PrimitiveArray_Header
19 #include <OpenGl_IndexBuffer.hxx>
21 #include <Aspect_InteriorStyle.hxx>
22 #include <Aspect_TypeOfMarker.hxx>
23 #include <Graphic3d_TypeOfPrimitiveArray.hxx>
24 #include <Graphic3d_IndexBuffer.hxx>
25 #include <Graphic3d_BoundBuffer.hxx>
27 #include <OpenGl_Element.hxx>
29 class OpenGl_GraphicDriver;
31 //! Class for rendering of arbitrary primitive array.
32 class OpenGl_PrimitiveArray : public OpenGl_Element
35 //! OpenGL does not provide a constant for "none" draw mode.
36 //! So we define our own one that does not conflict with GL constants and utilizes common GL invalid value.
43 Standard_EXPORT OpenGl_PrimitiveArray (const OpenGl_GraphicDriver* theDriver);
45 //! Default constructor
46 Standard_EXPORT OpenGl_PrimitiveArray (const OpenGl_GraphicDriver* theDriver,
47 const Graphic3d_TypeOfPrimitiveArray theType,
48 const Handle(Graphic3d_IndexBuffer)& theIndices,
49 const Handle(Graphic3d_Buffer)& theAttribs,
50 const Handle(Graphic3d_BoundBuffer)& theBounds);
53 Standard_EXPORT virtual ~OpenGl_PrimitiveArray();
55 //! Render primitives to the window
56 Standard_EXPORT virtual void Render (const Handle(OpenGl_Workspace)& theWorkspace) const Standard_OVERRIDE;
58 //! Release OpenGL resources (VBOs)
59 Standard_EXPORT virtual void Release (OpenGl_Context* theContext) Standard_OVERRIDE;
61 //! Return true if VBOs initialization has been performed.
62 //! VBO initialization is performed during first Render() call.
63 //! Notice that this flag does not indicate VBOs validity.
64 Standard_Boolean IsInitialized() const { return myIsVboInit; }
66 //! Invalidate VBO content without destruction.
67 void Invalidate() const { myIsVboInit = Standard_False; }
69 //! @return primitive type (GL_LINES, GL_TRIANGLES and others)
70 GLint DrawMode() const { return myDrawMode; }
72 //! Return TRUE if primitive type generates shaded triangulation.
73 virtual Standard_Boolean IsFillDrawMode() const Standard_OVERRIDE { return myIsFillType; }
75 //! @return indices array
76 const Handle(Graphic3d_IndexBuffer)& Indices() const { return myIndices; }
78 //! @return attributes array
79 const Handle(Graphic3d_Buffer)& Attributes() const { return myAttribs; }
81 //! @return bounds array
82 const Handle(Graphic3d_BoundBuffer)& Bounds() const { return myBounds; }
84 //! Returns unique ID of primitive array.
85 Standard_Size GetUID() const { return myUID; }
87 //! Initialize indices, attributes and bounds with new data.
88 Standard_EXPORT void InitBuffers (const Handle(OpenGl_Context)& theContext,
89 const Graphic3d_TypeOfPrimitiveArray theType,
90 const Handle(Graphic3d_IndexBuffer)& theIndices,
91 const Handle(Graphic3d_Buffer)& theAttribs,
92 const Handle(Graphic3d_BoundBuffer)& theBounds);
96 //! Returns index VBO.
97 const Handle(OpenGl_VertexBuffer)& IndexVbo() const { return myVboIndices; }
99 //! Returns attributes VBO.
100 const Handle(OpenGl_VertexBuffer)& AttributesVbo() const { return myVboAttribs; }
104 //! VBO initialization procedures
105 //! @param theCtx bound GL context
106 //! @param theToKeepData when true, myAttribs will not be nullified after VBO creation
107 Standard_EXPORT Standard_Boolean buildVBO (const Handle(OpenGl_Context)& theCtx,
108 const Standard_Boolean theToKeepData) const;
110 //! Patch VBO sub-date within invalidated range.
111 Standard_EXPORT void updateVBO (const Handle(OpenGl_Context)& theCtx) const;
113 //! Release GL memory.
114 Standard_EXPORT void clearMemoryGL (const Handle(OpenGl_Context)& theGlCtx) const;
118 //! Initialize normal (OpenGL-provided) VBO
119 Standard_Boolean initNormalVbo (const Handle(OpenGl_Context)& theCtx) const;
121 //! Main procedure to draw array
122 void drawArray (const Handle(OpenGl_Workspace)& theWorkspace,
123 const Graphic3d_Vec4* theFaceColors,
124 const Standard_Boolean theHasVertColor) const;
126 //! Auxiliary procedures
127 void drawEdges (const Handle(OpenGl_Workspace)& theWorkspace) const;
129 void drawMarkers (const Handle(OpenGl_Workspace)& theWorkspace) const;
131 //! Sets OpenGL draw mode according to the input type of primitive array.
132 //! If buffer of attributes is empty, draw mode is set to NONE to avoid invalid array rendering.
133 //! @param theType type of primitive array.
134 void setDrawMode (const Graphic3d_TypeOfPrimitiveArray theType);
136 //! Rebuilds the array of vertex attributes so that it can be drawn without indices.
137 Standard_Boolean processIndices (const Handle(OpenGl_Context)& theContext) const;
141 mutable Handle(OpenGl_VertexBuffer) myVboIndices;
142 mutable Handle(OpenGl_VertexBuffer) myVboAttribs;
144 mutable Handle(Graphic3d_IndexBuffer) myIndices;
145 mutable Handle(Graphic3d_Buffer) myAttribs;
146 mutable Handle(Graphic3d_BoundBuffer) myBounds;
148 mutable Standard_Boolean myIsFillType;
149 mutable Standard_Boolean myIsVboInit;
151 Standard_Size myUID; //!< Unique ID of primitive array.
155 DEFINE_STANDARD_ALLOC
159 #endif //OpenGl_PrimitiveArray_Header