src/OpenGl/OpenGl_TextureBufferArb.hxx

   1 // Created by: Kirill GAVRILOV
   2 // Copyright (c) 2014 OPEN CASCADE SAS
   3 //
   4 // This file is part of Open CASCADE Technology software library.
   5 //
   6 // This library is free software; you can redistribute it and / or modify it
   7 // under the terms of the GNU Lesser General Public version 2.1 as published
   8 // by the Free Software Foundation, with special exception defined in the file
   9 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
  10 // distribution for complete text of the license and disclaimer of any warranty.
  11 //
  12 // Alternatively, this file may be used under the terms of Open CASCADE
  13 // commercial license or contractual agreement.
  14
  15 #ifndef _OpenGl_TextureBufferArb_H__
  16 #define _OpenGl_TextureBufferArb_H__
  17
  18 #include <OpenGl_VertexBuffer.hxx>
  19 #include <OpenGl_ArbTBO.hxx>
  20
  21 //! Texture Buffer Object.
  22 //! This is a special 1D texture that VBO-style initialized.
  23 //! The main differences from general 1D texture:
  24 //!  - no interpolation between field;
  25 //!  - greater sizes;
  26 //!  - special sampler object in GLSL shader to access data by index.
  27 //!
  28 //! Notice that though TBO is inherited from VBO this is to unify design
  29 //! user shouldn't cast it to base class and all really useful methods
  30 //! are declared in this class.
  31 class OpenGl_TextureBufferArb : public OpenGl_VertexBuffer
  32 {
  33
  34 public:
  35
  36   //! Helpful constants
  37   static const GLuint NO_TEXTURE = 0;
  38
  39 public:
  40
  41   //! Create uninitialized TBO.
  42   Standard_EXPORT OpenGl_TextureBufferArb();
  43
  44   //! Destroy object, will throw exception if GPU memory not released with Release() before.
  45   Standard_EXPORT virtual ~OpenGl_TextureBufferArb();
  46
  47   //! Override VBO target
  48   Standard_EXPORT virtual GLenum GetTarget() const;
  49
  50   //! Returns true if TBO is valid.
  51   //! Notice that no any real GL call is performed!
  52   bool IsValid() const
  53   {
  54     return OpenGl_VertexBuffer::IsValid()
  55         && myTextureId != NO_TEXTURE;
  56   }
  57
  58   //! Destroy object - will release GPU memory if any.
  59   Standard_EXPORT virtual void Release (const OpenGl_Context* theGlCtx);
  60
  61   //! Creates VBO and Texture names (ids) if not yet generated.
  62   //! Data should be initialized by another method.
  63   Standard_EXPORT bool Create (const Handle(OpenGl_Context)& theGlCtx);
  64
  65   //! Perform TBO initialization with specified data.
  66   //! Existing data will be deleted.
  67   Standard_EXPORT bool Init (const Handle(OpenGl_Context)& theGlCtx,
  68                              const GLuint   theComponentsNb,
  69                              const GLsizei  theElemsNb,
  70                              const GLfloat* theData);
  71
  72   //! Bind TBO to specified Texture Unit.
  73   Standard_EXPORT void BindTexture (const Handle(OpenGl_Context)& theGlCtx,
  74                                     const GLenum theTextureUnit = GL_TEXTURE0) const;
  75
  76   //! Unbind TBO.
  77   Standard_EXPORT void UnbindTexture (const Handle(OpenGl_Context)& theGlCtx,
  78                                       const GLenum theTextureUnit = GL_TEXTURE0) const;
  79
  80 protected:
  81
  82   GLuint myTextureId; //!< texture id
  83   GLenum myTexFormat; //!< internal texture format
  84
  85 public:
  86
  87   DEFINE_STANDARD_RTTI(OpenGl_TextureBufferArb) // Type definition
  88
  89 };
  90
  91 DEFINE_STANDARD_HANDLE(OpenGl_TextureBufferArb, OpenGl_VertexBuffer)
  92
  93 #endif // _OpenGl_TextureBufferArb_H__