1 #ifndef DALI_INTERNAL_LONG_PRESS_GESTURE_EVENT_PROCESSOR_H
2 #define DALI_INTERNAL_LONG_PRESS_GESTURE_EVENT_PROCESSOR_H
5 * Copyright (c) 2019 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.
22 #include <dali/internal/event/events/long-press-gesture/long-press-gesture-detector-impl.h>
23 #include <dali/internal/event/events/gesture-processor.h>
24 #include <dali/internal/event/render-tasks/render-task-impl.h>
36 struct LongPressGestureEvent;
39 * Long Press Gesture Event Processing:
41 * When we receive a long press gesture event, we do the following:
42 * - Find the actor that requires a long-press at the long press position.
43 * - Emit the gesture if the event satisfies the detector conditions.
45 class LongPressGestureProcessor : public GestureProcessor, public RecognizerObserver<LongPressGestureEvent>
50 * Create a long press gesture processor.
52 LongPressGestureProcessor();
55 * Non-virtual destructor; LongPressGestureProcessor is not a base class
57 ~LongPressGestureProcessor();
59 public: // To be called by GestureEventProcessor
62 * This method is called whenever a long press gesture event occurs.
63 * @param[in] scene The scene the long press gesture event occurs in.
64 * @param[in] longPressEvent The event that has occurred.
66 void Process( Scene& scene, const LongPressGestureEvent& longPressEvent );
69 * Adds a gesture detector to this gesture processor.
70 * If this is the first gesture detector being added, then this method registers the required
71 * gesture with the adaptor.
72 * @param[in] gestureDetector The gesture detector being added.
73 * @param[in] scene The scene the long press gesture event occurs in.
75 void AddGestureDetector( LongPressGestureDetector* gestureDetector, Scene& scene );
78 * Removes the specified gesture detector from this gesture processor. If, after removing this
79 * gesture detector, there are no more gesture detectors registered, then this method unregisters
80 * the gesture from the adaptor.
81 * @param[in] gestureDetector The gesture detector being removed.
83 void RemoveGestureDetector( LongPressGestureDetector* gestureDetector );
86 * This method updates the gesture detection parameters.
87 * @param[in] gestureDetector The gesture detector that has been updated.
89 void GestureDetectorUpdated(LongPressGestureDetector* gestureDetector);
92 * @brief This method sets the minimum holding time required to be recognized as a long press gesture
94 * @param[in] value The time value in milliseconds
96 void SetMinimumHoldingTime( uint32_t time );
99 * @return The minimum holding time required to be recognized as a long press gesture in milliseconds
101 uint32_t GetMinimumHoldingTime() const;
106 LongPressGestureProcessor( const LongPressGestureProcessor& );
107 LongPressGestureProcessor& operator=( const LongPressGestureProcessor& rhs );
112 * Iterates through our GestureDetectors and determines if we need to ask the adaptor to update
113 * its detection policy. If it does, it sends the appropriate gesture update request to adaptor.
115 void UpdateDetection();
117 // GestureProcessor overrides
120 * @copydoc GestureProcessor::OnGesturedActorStageDisconnection()
122 void OnGesturedActorStageDisconnection();
125 * @copydoc GestureProcessor::CheckGestureDetector()
127 bool CheckGestureDetector( GestureDetector* detector, Actor* actor );
130 * @copydoc GestureProcessor::EmitGestureSignal()
132 void EmitGestureSignal( Actor* actor, const GestureDetectorContainer& gestureDetectors, Vector2 actorCoordinates );
136 LongPressGestureDetectorContainer mLongPressGestureDetectors;
138 GestureDetectorContainer mCurrentEmitters;
139 RenderTaskPtr mCurrentRenderTask;
141 uint32_t mMinTouchesRequired;
142 uint32_t mMaxTouchesRequired;
144 const LongPressGestureEvent* mCurrentLongPressEvent; ///< Pointer to current longPressEvent, used when calling ProcessAndEmit()
146 uint32_t mMinimumHoldingTime;
149 } // namespace Internal
153 #endif // DALI_INTERNAL_LONG_PRESS_GESTURE_EVENT_PROCESSOR_H