1 #ifndef __DALI_INTERNAL_ECORE_X_RENDER_SURFACE_H__
2 #define __DALI_INTERNAL_ECORE_X_RENDER_SURFACE_H__
5 * Copyright (c) 2014 Samsung Electronics Co., Ltd.
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
11 * http://www.apache.org/licenses/LICENSE-2.0
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.
23 #include <boost/thread.hpp>
25 #include <dali/public-api/common/dali-common.h>
28 #include <render-surface-impl.h>
29 #include <ecore-x-types.h>
30 #include <gl/egl-implementation.h>
46 * Ecore X11 implementation of render surface.
47 * @todo change namespace to ECore_X11 as the class
48 * is no longer pure X11.
50 class DALI_IMPORT_API RenderSurface : public Internal::Adaptor::RenderSurface
54 * Uses an X11 surface to render to.
55 * @param [in] type the type of surface passed in
56 * @param [in] positionSize the position and size of the surface
57 * @param [in] surface can be a X-window or X-pixmap (type must be unsigned int).
58 * @param [in] display connection to X-server if the surface is a X window or pixmap (type must be void * to X display struct)
59 * @param [in] name optional name of surface passed in
60 * @param [in] isTransparent if it is true, surface has 32 bit color depth, otherwise, 24 bit
62 RenderSurface( SurfaceType type,
63 Dali::PositionSize positionSize,
66 const std::string& name,
67 bool isTransparent = false);
71 * Will delete the display, if it has ownership.
72 * Will delete the window/pixmap if it has owner ship
74 virtual ~RenderSurface();
78 * Second stage construction
79 * Creates the surface (window, pixmap or native buffer)
81 void Init( Any surface );
86 * @return the Ecore X window handle
88 Ecore_X_Window GetXWindow();
91 * @return the Main X display
93 XDisplay* GetMainDisplay();
96 * Sets the render notification trigger to call when render thread is completed a frame
97 * @param renderNotification to use
99 void SetRenderNotification( TriggerEvent* renderNotification );
102 * Get the surface as an Ecore_X_drawable
104 virtual Ecore_X_Drawable GetDrawable();
106 public: // from Dali::RenderSurface
109 * @copydoc Dali::RenderSurface::GetType()
111 virtual Dali::RenderSurface::SurfaceType GetType() = 0;
114 * @copydoc Dali::RenderSurface::GetSurface()
116 virtual Any GetSurface() = 0;
119 * @copydoc Dali::RenderSurface::GetDisplay()
121 virtual Any GetDisplay();
124 * @copydoc Dali::RenderSurface::GetPositionSize()
126 virtual PositionSize GetPositionSize() const;
128 public: // from Internal::Adaptor::RenderSurface
131 * @copydoc Dali::Internal::Adaptor::RenderSurface::CreateEglSurface()
133 virtual void CreateEglSurface( EglInterface& egl ) = 0;
136 * @copydoc Dali::Internal::Adaptor::RenderSurface::DestroyEglSurface()
138 virtual void DestroyEglSurface( EglInterface& egl ) = 0;
141 * @copydoc Dali::Internal::Adaptor::RenderSurface::ReplaceEGLSurface()
143 virtual bool ReplaceEGLSurface( EglInterface& egl ) = 0;
146 * @copydoc Dali::Internal::Adaptor::RenderSurface::MoveResize()
148 virtual void MoveResize( Dali::PositionSize positionSize);
151 * @copydoc Dali::Internal::Adaptor::RenderSurface::GetDpi()
153 virtual void GetDpi( unsigned int& dpiHorizontal, unsigned int& dpiVertical ) const;
156 * @copydoc Dali::Internal::Adaptor::RenderSurface::Map()
161 * @copydoc Dali::Internal::Adaptor::RenderSurface::TransferDisplayOwner()
163 virtual void TransferDisplayOwner( Internal::Adaptor::RenderSurface& newSurface );
166 * @copydoc Dali::Internal::Adaptor::RenderSurface::ConsumeEvents()
168 virtual void ConsumeEvents();
171 * @copydoc Dali::Internal::Adaptor::RenderSurface::SetViewMode()
173 void SetViewMode( ViewMode );
176 * @copydoc Dali::Internal::Adaptor::RenderSurface::PreRender()
178 virtual bool PreRender( EglInterface& egl, Integration::GlAbstraction& glAbstraction ) = 0;
181 * @copydoc Dali::Internal::Adaptor::RenderSurface::PostRender()
183 virtual void PostRender( EglInterface& egl, Integration::GlAbstraction& glAbstraction, unsigned int timeDelta, bool replacingSurface ) = 0;
188 * Sets the display, if display parameter is empty it opens a new display
191 void SetDisplay( Any display );
194 * Get the surface id if the surface parameter is not empty
195 * @param surface Any containing a surface id, or can be empty
196 * @return surface id, or zero if surface is empty
198 unsigned int GetSurfaceId( Any surface ) const;
205 virtual void CreateXRenderable() = 0;
208 * Use an existing render surface
209 * @param surfaceId the id of the surface
211 virtual void UseExistingRenderable( unsigned int surfaceId ) = 0;
215 XDisplay* mMainDisplay; ///< X-connection for rendering
216 Ecore_X_Window mRootWindow; ///< X-Root window
217 SurfaceType mType; ///< type of renderable
218 PositionSize mPosition; ///< Position
219 std::string mTitle; ///< Title of window which shows from "xinfo -topvwins" command
220 ColorDepth mColorDepth; ///< Color depth of surface (32 bit or 24 bit)
221 TriggerEvent* mRenderNotification; ///< Render notification trigger
223 bool mOwnSurface; ///< Whether we own the surface (responsible for deleting it)
224 bool mOwnDisplay; ///< Whether we own the display (responsible for deleting it)
229 } // namespace Adaptor
231 } // namespace internal
235 #endif // __DALI_INTERNAL_ECORE_X_RENDER_SURFACE_H__