dali/internal/event/events/pan-gesture-processor.h

   1 #ifndef __DALI_INTERNAL_PAN_GESTURE_EVENT_PROCESSOR_H__
   2 #define __DALI_INTERNAL_PAN_GESTURE_EVENT_PROCESSOR_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 // INTERNAL INCLUDES
  22 #include <dali/public-api/render-tasks/render-task.h>
  23 #include <dali/internal/event/events/pan-gesture-detector-impl.h>
  24 #include <dali/internal/event/events/gesture-processor.h>
  25
  26 namespace Dali
  27 {
  28
  29 namespace Integration
  30 {
  31 class GestureManager;
  32 struct GestureEvent;
  33 struct PanGestureEvent;
  34 }
  35
  36 namespace Internal
  37 {
  38
  39 class Stage;
  40
  41 namespace SceneGraph
  42 {
  43 class PanGesture;
  44 }
  45
  46 /**
  47  * Pan Gesture Event Processing:
  48  *
  49  * When we receive a pinch gesture event, we do the following:
  50  * - Determine the hot actor underneath the current position of the pan gesture event.
  51  * - Determine whether this actor is, or is a child of, the actor(s) attached to any of the
  52  *   detectors.
  53  * - Emit the gesture when all the above conditions are met.
  54  *
  55  * The above is only checked when our gesture starts.  We continue sending the pan gesture to the
  56  * same actor and detector until the pan ends or is cancelled.
  57  */
  58 class PanGestureProcessor : public GestureProcessor
  59 {
  60 public:
  61
  62   /**
  63    * Create a pan gesture processor.
  64    * @param[in] stage The stage.
  65    * @param[in] gestureManager The gesture manager
  66    */
  67   PanGestureProcessor( Stage& stage, Integration::GestureManager& gestureManager );
  68
  69   /**
  70    * Non-virtual destructor; PanGestureProcessor is not a base class
  71    */
  72   ~PanGestureProcessor();
  73
  74 public: // To be called by GestureEventProcessor
  75
  76   /**
  77    * This method is called whenever a pinch gesture event occurs.
  78    * @param[in] panEvent The event that has occurred.
  79    */
  80   void Process( const Integration::PanGestureEvent& panEvent );
  81
  82   /**
  83    * Adds a gesture detector to this gesture processor.
  84    * If this is the first gesture detector being added, then this method registers the required
  85    * gesture with the adaptor.
  86    * @param[in]  gestureDetector  The gesture detector being added.
  87    */
  88   void AddGestureDetector( PanGestureDetector* gestureDetector );
  89
  90   /**
  91    * Removes the specified gesture detector from this gesture processor.  If, after removing this
  92    * gesture detector, there are no more gesture detectors registered, then this method unregisters
  93    * the gesture from the adaptor.
  94    * @param[in]  gestureDetector  The gesture detector being removed.
  95    */
  96   void RemoveGestureDetector( PanGestureDetector* gestureDetector );
  97
  98   /**
  99    * This method updates the gesture detection parameters.
 100    * @param[in]  gestureDetector  The gesture detector that has been updated.
 101    */
 102   void GestureDetectorUpdated( PanGestureDetector* gestureDetector );
 103
 104   /**
 105    * Sets the pan gesture properties stored in the scene object directly,
 106    * @param[in]  pan  The pan gesture to override the properties with.
 107    * @note If we are already processing a normal pan, then this call is ignored.
 108    */
 109   void SetPanGestureProperties( const PanGesture& pan );
 110
 111   /**
 112    * Called to provide pan-gesture profiling information.
 113    */
 114   void EnableProfiling();
 115
 116   /**
 117    * Called to set the prediction mode for pan gestures
 118    *
 119    * @param[in] mode The prediction mode
 120    *
 121    * Valid modes:
 122    * 0 - No prediction
 123    * 1 - Average Smoothing (no actual prediction)
 124    * 2 - Interpolation using last vsync time and event time
 125    * 3 - Same as 2 for now, in progress
 126    */
 127   void SetPredictionMode(int mode);
 128
 129   /**
 130    * @brief Sets the prediction amount of the pan gesture
 131    *
 132    * @param[in] amount The prediction amount, 0.0f being next vsync and each 1.0f on top is another vsync ahead, can be divisions of (0.5f)
 133    */
 134   void SetPredictionAmount(float amount);
 135
 136 private:
 137
 138   // Undefined
 139   PanGestureProcessor( const PanGestureProcessor& );
 140   PanGestureProcessor& operator=( const PanGestureProcessor& rhs );
 141
 142   /**
 143    * Iterates through our GestureDetectors and determines if we need to ask the adaptor to update
 144    * its detection policy.  If it does, it sends the appropriate gesture update request to adaptor.
 145    */
 146   void UpdateDetection();
 147
 148   /**
 149    * Creates a PanGesture and asks the specified detector to emit its detected signal.
 150    * @param[in]  actor             The actor that has been panned.
 151    * @param[in]  gestureDetectors  The gesture detector container that should emit the signal.
 152    * @param[in]  panEvent          The panEvent received from the adaptor.
 153    * @param[in]  localCurrent      Current position relative to the actor attached to the detector.
 154    * @param[in]  state             The state of the gesture.
 155    * @param[in]  renderTask        The renderTask to use.
 156    */
 157   void EmitPanSignal( Dali::Actor actor,
 158                       PanGestureDetectorContainer& gestureDetectors,
 159                       const Integration::PanGestureEvent& panEvent,
 160                       Vector2 localCurrent,
 161                       Gesture::State state,
 162                       Dali::RenderTask renderTask );
 163
 164   // GestureProcessor overrides
 165
 166   /**
 167    * @copydoc GestureProcessor::OnGesturedActorStageDisconnection()
 168    */
 169   void OnGesturedActorStageDisconnection();
 170
 171 private:
 172
 173   Stage& mStage;
 174   Integration::GestureManager& mGestureManager;
 175   PanGestureDetectorContainer mGestureDetectors;
 176   PanGestureDetectorContainer mCurrentPanEmitters;
 177   Dali::RenderTask mCurrentRenderTask;
 178   Vector2 mPossiblePanPosition;
 179
 180   unsigned int mMinTouchesRequired;
 181   unsigned int mMaxTouchesRequired;
 182
 183   Vector2 mLastVelocity;       ///< The last recorded velocity in local actor coordinates.
 184   Vector2 mLastScreenVelocity; ///< The last recorded velocity in screen coordinates.
 185
 186   struct PanEventFunctor;
 187
 188   SceneGraph::PanGesture* mSceneObject; ///< Not owned, but we write to it directly
 189 };
 190
 191 } // namespace Internal
 192
 193 } // namespace Dali
 194
 195 #endif // __DALI_INTERNAL_PAN_GESTURE_EVENT_PROCESSOR_H__