dali-toolkit/internal/controls/bloom-view/bloom-view-impl.h

   1 #ifndef __DALI_TOOLKIT_INTERNAL_BLOOM_VIEW_H__
   2 #define __DALI_TOOLKIT_INTERNAL_BLOOM_VIEW_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 <sstream>
  23 #include <cmath>
  24 #include <dali/public-api/actors/camera-actor.h>
  25 #include <dali/public-api/actors/image-actor.h>
  26 #include <dali/public-api/render-tasks/render-task.h>
  27
  28 // INTERNAL INCLUDES
  29 #include <dali-toolkit/public-api/controls/control-impl.h>
  30 #include <dali-toolkit/public-api/controls/gaussian-blur-view/gaussian-blur-view.h>
  31 #include <dali-toolkit/public-api/controls/image-view/image-view.h>
  32 #include <dali-toolkit/devel-api/controls/bloom-view/bloom-view.h>
  33
  34 namespace Dali
  35 {
  36
  37 namespace Toolkit
  38 {
  39
  40 class BloomView;
  41
  42 namespace Internal
  43 {
  44
  45 /**
  46  * BloomEffect implementation class
  47  */
  48 class BloomView : public Control
  49 {
  50 public:
  51   /**
  52    * @copydoc Dali::Toolkit::BloomView::BloomView
  53    */
  54   BloomView();
  55
  56   /**
  57    * @copydoc Dali::Toolkit::BloomView::BloomView
  58    */
  59   BloomView(const unsigned int numSamples, const float blurBellCurveWidth, const Pixel::Format renderTargetPixelFormat,
  60                    const float downsampleWidthScale, const float downsampleHeightScale);
  61
  62   /**
  63    * @copydoc Dali::Toolkit::BloomView::~BloomView
  64    */
  65   virtual ~BloomView();
  66
  67   /**
  68    * @copydoc Dali::Toolkit::BloomView::New
  69    */
  70   static Dali::Toolkit::BloomView New();
  71   static Dali::Toolkit::BloomView New( const unsigned int numSamples, const float blurBellCurveWidth, const Pixel::Format renderTargetPixelFormat,
  72                                               const float downsampleWidthScale, const float downsampleHeightScale);
  73
  74   void Add(Actor child);
  75   void Remove(Actor child);
  76
  77   void Activate();
  78   void Deactivate();
  79
  80   Property::Index GetBloomThresholdPropertyIndex() const {return mBloomThresholdPropertyIndex;}
  81   Property::Index GetBlurStrengthPropertyIndex() const {return mBlurStrengthPropertyIndex;}
  82   Property::Index GetBloomIntensityPropertyIndex() const {return mBloomIntensityPropertyIndex;}
  83   Property::Index GetBloomSaturationPropertyIndex() const {return mBloomSaturationPropertyIndex;}
  84   Property::Index GetImageIntensityPropertyIndex() const {return mImageIntensityPropertyIndex;}
  85   Property::Index GetImageSaturationPropertyIndex() const {return mImageSaturationPropertyIndex;}
  86
  87 private:
  88
  89   virtual void OnInitialize();
  90   virtual void OnSizeSet(const Vector3& targetSize);
  91
  92   void AllocateResources();
  93   void CreateRenderTasks();
  94   void RemoveRenderTasks();
  95
  96   void SetupProperties();
  97
  98
  99   /////////////////////////////////////////////////////////////
 100   unsigned int mBlurNumSamples;   // number of blur samples in each of horiz/vert directions
 101   float mBlurBellCurveWidth;      // constant used when calculating the gaussian weights
 102   Pixel::Format mPixelFormat;     // pixel format used by render targets
 103
 104   /////////////////////////////////////////////////////////////
 105   // downsampling is used for the separated blur passes to get increased blur with the same number of samples and also to make rendering quicker
 106   float mDownsampleWidthScale;
 107   float mDownsampleHeightScale;
 108   float mDownsampledWidth;
 109   float mDownsampledHeight;
 110
 111
 112   /////////////////////////////////////////////////////////////
 113   // for checking if we need to reallocate render targets
 114   Vector2 mTargetSize;
 115   Vector2 mLastSize;
 116
 117   /////////////////////////////////////////////////////////////
 118   // for creating a subtree for all user added child actors, so that we can have them exclusive to the mRenderChildrenTask and our other actors exclusive to our other tasks
 119   Actor mChildrenRoot;
 120
 121   /////////////////////////////////////////////////////////////
 122   // for mapping offscreen renders to render target sizes
 123   CameraActor mRenderFullSizeCamera;
 124   CameraActor mRenderDownsampledCamera;
 125
 126   /////////////////////////////////////////////////////////////
 127   // for rendering all user added children to offscreen target
 128   FrameBufferImage mRenderTargetForRenderingChildren;
 129   RenderTask mRenderChildrenTask;
 130
 131   /////////////////////////////////////////////////////////////
 132   // for extracting bright parts of image to an offscreen target
 133   FrameBufferImage mBloomExtractTarget; // for rendering bright parts of image into separate texture, also used as target for gaussian blur
 134   RenderTask mBloomExtractTask;
 135   Toolkit::ImageView mBloomExtractImageActor;
 136
 137   /////////////////////////////////////////////////////////////
 138   // for blurring extracted bloom
 139   Dali::Toolkit::GaussianBlurView mGaussianBlurView;
 140
 141   /////////////////////////////////////////////////////////////
 142   // for compositing bloom and children renders to offscreen target
 143   RenderTask mCompositeTask;
 144
 145   Toolkit::ImageView mCompositeImageActor;
 146
 147   /////////////////////////////////////////////////////////////
 148   // for holding blurred result
 149   FrameBufferImage mOutputRenderTarget;
 150   Toolkit::ImageView mTargetImageActor;
 151
 152   /////////////////////////////////////////////////////////////
 153   // Properties for setting by user, e.g. by animations
 154   Property::Index mBloomThresholdPropertyIndex;
 155   Property::Index mBlurStrengthPropertyIndex;
 156   Property::Index mBloomIntensityPropertyIndex;
 157   Property::Index mBloomSaturationPropertyIndex;
 158   Property::Index mImageIntensityPropertyIndex;
 159   Property::Index mImageSaturationPropertyIndex;
 160
 161   bool mActivated:1;
 162
 163 private:
 164
 165   // Undefined copy constructor.
 166   BloomView( const BloomView& );
 167
 168   // Undefined assignment operator.
 169   BloomView& operator=( const BloomView& );
 170 };
 171
 172 } // namespace Internal
 173
 174 // Helpers for public-api forwarding methods
 175 inline Toolkit::Internal::BloomView& GetImpl( Toolkit::BloomView& obj )
 176 {
 177   DALI_ASSERT_ALWAYS(obj);
 178   Dali::RefObject& handle = obj.GetImplementation();
 179   return static_cast<Toolkit::Internal::BloomView&>(handle);
 180 }
 181
 182 inline const Toolkit::Internal::BloomView& GetImpl( const Toolkit::BloomView& obj )
 183 {
 184   DALI_ASSERT_ALWAYS(obj);
 185   const Dali::RefObject& handle = obj.GetImplementation();
 186   return static_cast<const Toolkit::Internal::BloomView&>(handle);
 187 }
 188
 189 } // namespace Toolkit
 190
 191 } // namespace Dali
 192
 193 #endif // __DALI_TOOLKIT_INTERNAL_BLOOM_VIEW_H__