adaptors/x11/native-image-source-impl.h

   1 #ifndef __DALI_INTERNAL_NATIVE_IMAGE_SOURCE_H__
   2 #define __DALI_INTERNAL_NATIVE_IMAGE_SOURCE_H__
   3
   4 /*
   5  * Copyright (c) 2014 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 <Ecore_X.h>
  23
  24 // INTERNAL INCLUDES
  25 #include <native-image-source.h>
  26
  27 namespace Dali
  28 {
  29
  30 namespace Internal
  31 {
  32
  33 namespace Adaptor
  34 {
  35 class EglImageExtensions;
  36
  37 /**
  38  * Dali internal NativeImageSource.
  39  */
  40 class NativeImageSource
  41 {
  42 public:
  43
  44   /**
  45    * Create a new NativeImageSource internally.
  46    * Depending on hardware the width and height may have to be a power of two.
  47    * @param[in] width The width of the image.
  48    * @param[in] height The height of the image.
  49    * @param[in] depth color depth of the image.
  50    * @param[in] nativeImageSource contains either: pixmap of type X11 Pixmap , a Ecore_X_Pixmap or is empty
  51    * @return A smart-pointer to a newly allocated image.
  52    */
  53   static NativeImageSource* New(unsigned int width,
  54                           unsigned int height,
  55                           Dali::NativeImageSource::ColorDepth depth,
  56                           Any nativeImageSource);
  57   /**
  58    * @copydoc Dali::NativeImageSource::GetNativeImageSource()
  59    */
  60   Any GetNativeImageSource() const;
  61
  62   /**
  63    * @copydoc Dali::NativeImageSource::GetPixels()
  64    */
  65   bool GetPixels(std::vector<unsigned char> &pixbuf, unsigned int &width, unsigned int &height, Pixel::Format& pixelFormat ) const;
  66
  67   /**
  68    * @copydoc Dali::NativeImageSource::EncodeToFile(const std::string& )
  69    */
  70   bool EncodeToFile(const std::string& filename) const;
  71
  72   /**
  73    * @copydoc Dali::NativeImageSource::SetSource( Any source )
  74    */
  75   void SetSource( Any source );
  76
  77   /**
  78    * @copydoc Dali::NativeImageSource::IsColorDepthSupported( ColorDepth colorDepth )
  79    */
  80   bool IsColorDepthSupported( Dali::NativeImageSource::ColorDepth colorDepth );
  81
  82   /**
  83    * destructor
  84    */
  85   ~NativeImageSource();
  86
  87   /**
  88    * @copydoc Dali::NativeImageSource::GlExtensionCreate()
  89    */
  90   bool GlExtensionCreate();
  91
  92   /**
  93    * @copydoc Dali::NativeImageSource::GlExtensionDestroy()
  94    */
  95   void GlExtensionDestroy();
  96
  97   /**
  98    * @copydoc Dali::NativeImageSource::TargetTexture()
  99    */
 100   unsigned int TargetTexture();
 101
 102   /**
 103    * @copydoc Dali::NativeImageSource::PrepareTexture()
 104    */
 105   void PrepareTexture();
 106
 107   /**
 108    * @copydoc Dali::NativeImageSource::GetWidth()
 109    */
 110   unsigned int GetWidth() const
 111   {
 112     return mWidth;
 113   }
 114
 115   /**
 116    * @copydoc Dali::NativeImageSource::GetHeight()
 117    */
 118   unsigned int GetHeight() const
 119   {
 120     return mHeight;
 121   }
 122
 123   /**
 124    * @copydoc Dali::NativeImageSource::RequiresBlending()
 125    */
 126   bool RequiresBlending() const
 127   {
 128     return mBlendingRequired;
 129   }
 130
 131   /**
 132    * @copydoc Dali::NativeImageInterface::GetExtension()
 133    */
 134   NativeImageInterface::Extension* GetNativeImageInterfaceExtension()
 135   {
 136     return NULL;
 137   }
 138
 139 private:
 140
 141   /**
 142    * Private constructor; @see NativeImageSource::New()
 143    * @param[in] width The width of the image.
 144    * @param[in] height The height of the image.
 145    * @param[in] colour depth of the image.
 146    * @param[in] nativeImageSource contains either: pixmap of type X11 Pixmap , a Ecore_X_Pixmap or is empty
 147    */
 148   NativeImageSource(unsigned int width,
 149               unsigned  int height,
 150               Dali::NativeImageSource::ColorDepth depth,
 151               Any nativeImageSource);
 152
 153   /**
 154    * 2nd phase construction.
 155    */
 156   void Initialize();
 157
 158   /**
 159    * Uses X11 to get the default depth.
 160    * @param depth the PixelImage depth enum
 161    * @return default x11 pixel depth
 162    */
 163   int GetPixelDepth(Dali::NativeImageSource::ColorDepth depth) const;
 164
 165   /**
 166    * Gets the pixmap from the Any parameter
 167    * @param pixmap contains either: pixmap of type X11 Pixmap , a Ecore_X_Pixmap or is empty
 168    * @return pixmap x11 pixmap
 169    */
 170   Ecore_X_Pixmap GetPixmapFromAny(Any pixmap) const;
 171
 172   /**
 173    * Given an existing pixmap, the function uses X to find out
 174    * the width, heigth and depth of that pixmap.
 175    */
 176   void GetPixmapDetails();
 177
 178 private:
 179
 180   unsigned int mWidth;                        ///< image width
 181   unsigned int mHeight;                       ///< image heights
 182   bool mOwnPixmap;                            ///< Whether we created pixmap or not
 183   Ecore_X_Pixmap mPixmap;                     ///< From Xlib
 184   bool mBlendingRequired;                      ///< Whether blending is required
 185   Dali::NativeImageSource::ColorDepth mColorDepth;  ///< color depth of image
 186   void* mEglImageKHR;                         ///< From EGL extension
 187   EglImageExtensions* mEglImageExtensions;    ///< The EGL Image Extensions
 188 };
 189
 190 } // namespace Adaptor
 191
 192 } // namespace Internal
 193
 194 } // namespace Dali
 195
 196 #endif // __DALI_INTERNAL_NATIVE_IMAGE_SOURCE_H__