dali/internal/graphics/gles/egl-implementation.h

   1 #ifndef DALI_INTERNAL_EGL_IMPLEMENTATION_H
   2 #define DALI_INTERNAL_EGL_IMPLEMENTATION_H
   3
   4 /*
   5  * Copyright (c) 2019 Samsung Electronics Co., Ltd.
   6  *
   7  * Licensed under the Apache License, Version 2.0 (the "License");
   8  * you may not use this file except in compliance with the License.
   9  * You may obtain a copy of the License at
  10  *
  11  * http://www.apache.org/licenses/LICENSE-2.0
  12  *
  13  * Unless required by applicable law or agreed to in writing, software
  14  * distributed under the License is distributed on an "AS IS" BASIS,
  15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16  * See the License for the specific language governing permissions and
  17  * limitations under the License.
  18  *
  19  */
  20
  21 // EXTERNAL INCLUDES
  22 #include <EGL/egl.h>
  23 #include <EGL/eglext.h>
  24 #include <dali/public-api/common/dali-vector.h>
  25 #include <dali/public-api/common/vector-wrapper.h>
  26 #include <dali/integration-api/core-enumerations.h>
  27
  28 // INTERNAL INCLUDES
  29 #include <dali/integration-api/egl-interface.h>
  30
  31 namespace Dali
  32 {
  33
  34 namespace Internal
  35 {
  36 namespace Adaptor
  37 {
  38
  39 /**
  40  * EglImplementation class provides an EGL implementation.
  41  */
  42 class EglImplementation : public EglInterface
  43 {
  44 public:
  45
  46   /**
  47    * Constructor
  48    * @param[in] multiSamplingLevel The Multi-sampling level required
  49    * @param[in] depthBufferRequired Whether the depth buffer is required
  50    * @param[in] stencilBufferRequired Whether the stencil buffer is required
  51    */
  52   EglImplementation( int multiSamplingLevel,
  53                      Integration::DepthBufferAvailable depthBufferRequired,
  54                      Integration::StencilBufferAvailable stencilBufferRequired );
  55
  56   /**
  57    * Destructor
  58    */
  59   virtual ~EglImplementation();
  60
  61 public:
  62
  63   /**
  64    * (Called from  ECoreX::RenderSurface, not RenderThread, so not in i/f, hence, not virtual)
  65    * Initialize GL
  66    * @param display The display
  67    * @param isOwnSurface whether the surface is own or not
  68    * @return true on success, false on failure
  69    */
  70   bool InitializeGles( EGLNativeDisplayType display, bool isOwnSurface = true );
  71
  72   /**
  73     * Create the OpenGL context for the shared resource.
  74     * @return true if successful
  75     */
  76   virtual bool CreateContext();
  77
  78   /**
  79     * Create the OpenGL context for the window.
  80     * @return true if successful
  81     */
  82   bool CreateWindowContext( EGLContext& mEglContext );
  83
  84   /**
  85     * Destroy the OpenGL context.
  86     */
  87   void DestroyContext( EGLContext& eglContext );
  88
  89   /**
  90     * Destroy the OpenGL surface.
  91     */
  92   void DestroySurface( EGLSurface& eglSurface );
  93
  94   /**
  95    * Make the OpenGL context current
  96    */
  97   virtual void MakeContextCurrent( EGLSurface eglSurface, EGLContext eglContext );
  98
  99   /**
 100    * clear the OpenGL context
 101    */
 102   void MakeContextNull();
 103
 104   /**
 105    * @brief Make the OpenGL surface current
 106    *
 107    * @param pixmap The pixmap to replace the current surface
 108    * @param eglSurface The eglSurface to replace the current OpenGL surface.
 109    */
 110   void MakeCurrent( EGLNativePixmapType pixmap, EGLSurface eglSurface );
 111
 112   /**
 113    * Terminate GL
 114    */
 115   virtual void TerminateGles();
 116
 117   /**
 118    * Checks if GL is initialised
 119    * @return true if it is
 120    */
 121   bool IsGlesInitialized() const;
 122
 123   /**
 124    * Performs an OpenGL swap buffers command
 125    */
 126   virtual void SwapBuffers( EGLSurface& eglSurface );
 127
 128   /**
 129    * Performs an OpenGL copy buffers command
 130    */
 131   virtual void CopyBuffers( EGLSurface& eglSurface );
 132
 133   /**
 134    * Performs an EGL wait GL command
 135    */
 136   virtual void WaitGL();
 137
 138   /**
 139    * Choose config of egl
 140    * @param isWindowType whether the config for window or pixmap
 141    * @param colorDepth Bit per pixel value (ex. 32 or 24)
 142    * @return true if the eglChooseConfig is succeed.
 143   */
 144   bool ChooseConfig( bool isWindowType, ColorDepth depth );
 145
 146   /**
 147     * Create an OpenGL surface using a window
 148     * @param window The window to create the surface on
 149     * @param colorDepth Bit per pixel value (ex. 32 or 24)
 150     * @return Handle to an on-screen EGL window surface (the requester has an ownership of this egl surface)
 151     */
 152   EGLSurface CreateSurfaceWindow( EGLNativeWindowType window, ColorDepth depth );
 153
 154   /**
 155    * Create the OpenGL surface using a pixmap
 156    * @param pixmap The pixmap to create the surface on
 157    * @param colorDepth Bit per pixel value (ex. 32 or 24)
 158    * @return Handle to an off-screen EGL pixmap surface (the requester has an ownership of this egl surface)
 159    */
 160   EGLSurface CreateSurfacePixmap( EGLNativePixmapType pixmap, ColorDepth depth );
 161
 162   /**
 163    * Replaces the render surface
 164    * @param[in] window, the window to create the new surface on
 165    * @return true if the context was lost due to a change in display
 166    *         between old surface and new surface
 167    */
 168   bool ReplaceSurfaceWindow( EGLNativeWindowType window, EGLSurface& eglSurface, EGLContext& eglContext );
 169
 170   /**
 171    * Replaces the render surface
 172    * @param[in] pixmap, the pixmap to replace the new surface on
 173    * @param[out] eglSurface, the eglSurface is created using a pixmap.
 174    * @return true if the context was lost due to a change in x-display
 175    *         between old surface and new surface
 176    */
 177   bool ReplaceSurfacePixmap( EGLNativePixmapType pixmap, EGLSurface& eglSurface );
 178
 179   /**
 180    * Sets gles version
 181    */
 182   void SetGlesVersion( const int32_t glesVersion );
 183
 184   /**
 185    * returns the display with which this object was initialized
 186    * @return the EGL Display.
 187    */
 188   EGLDisplay GetDisplay() const;
 189
 190   /**
 191    * Returns the EGL context
 192    * @return the EGL context.
 193    */
 194   EGLContext GetContext() const;
 195
 196   /**
 197    * Returns the gles version
 198    * @return the gles version
 199    */
 200   int32_t GetGlesVersion() const;
 201
 202   /**
 203    * Returns whether the surfaceless context is supported
 204    * @return true if the surfaceless context is supported
 205    */
 206   bool IsSurfacelessContextSupported() const;
 207
 208 private:
 209
 210   Vector<EGLint>       mContextAttribs;
 211
 212   EGLNativeDisplayType mEglNativeDisplay;
 213
 214   EGLNativeWindowType  mEglNativeWindow;
 215
 216   EGLNativePixmapType  mCurrentEglNativePixmap;
 217
 218   EGLDisplay           mEglDisplay;
 219   EGLConfig            mEglConfig;
 220   EGLContext           mEglContext;                            ///< The resource context holding assets such as textures to be shared
 221
 222   typedef std::vector<EGLContext> EglWindowContextContainer;
 223   EglWindowContextContainer mEglWindowContexts;                ///< The EGL context for the window
 224
 225   EGLSurface           mCurrentEglSurface;
 226   EGLContext           mCurrentEglContext;
 227
 228   typedef std::vector<EGLSurface> EglWindowSurfaceContainer;
 229   EglWindowSurfaceContainer mEglWindowSurfaces;                ///< The EGL surface for the window
 230
 231   int32_t              mMultiSamplingLevel;
 232   int32_t              mGlesVersion;
 233
 234   ColorDepth           mColorDepth;
 235
 236   bool                 mGlesInitialized;
 237   bool                 mIsOwnSurface;
 238   bool                 mIsWindow;
 239   bool                 mDepthBufferRequired;
 240   bool                 mStencilBufferRequired;
 241   bool                 mIsSurfacelessContextSupported;
 242   bool                 mIsKhrCreateContextSupported;
 243 };
 244
 245 } // namespace Adaptor
 246
 247 } // namespace Internal
 248
 249 } // namespace Dali
 250
 251 #endif // DALI_INTERNAL_EGL_IMPLEMENTATION_H