1 #ifndef DALI_INTERNAL_GESTURE_RECOGNIZER_H
2 #define DALI_INTERNAL_GESTURE_RECOGNIZER_H
5 * Copyright (c) 2023 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/integration-api/events/touch-event-integ.h>
23 #include <dali/internal/event/events/gesture-event.h>
24 #include <dali/public-api/common/vector-wrapper.h>
25 #include <dali/public-api/events/gesture.h>
26 #include <dali/public-api/math/vector2.h>
27 #include <dali/public-api/object/ref-object.h>
38 struct GestureRequest;
42 class RecognizerObserver
45 virtual void Process(Scene& scene, const T& event) = 0;
47 virtual ~RecognizerObserver() = default;
52 * Abstract Base class for all adaptor gesture detectors.
54 * @note this may be replaced by gesture events sent directly from X.
56 class GestureRecognizer : public RefObject
60 * Called when it gets a touch event. The gesture recognizer should
61 * evaluate this event along with previously received events to determine
62 * whether the gesture they require has taken place.
63 * @param[in] event The latest touch event.
65 virtual void SendEvent(const Integration::TouchEvent& event) = 0;
68 * @brief This is canceling the ongoing gesture recognition process.
69 * If the gesture recognition was in progress, it will be stopped immediately after calling this function.
71 virtual void CancelEvent() = 0;
74 * Called when Core updates the gesture's detection requirements.
75 * @param[in] request The updated detection requirements.
77 virtual void Update(const GestureRequest& request) = 0;
80 * Returns the type of gesture detector.
81 * @return Type of gesture detector.
83 GestureType::Value GetType() const
89 * Called when we get a touch event.
90 * @param[in] scene The scene the touch event has occurred on
91 * @param[in] event The latest touch event
93 void SendEvent(Scene& scene, const Integration::TouchEvent& event)
96 if(event.GetPointCount() > 0)
98 const Integration::Point& point = event.points[0];
99 MouseButton::Type mouseButton = point.GetMouseButton();
100 if(mouseButton != MouseButton::INVALID)
102 Device::Class::Type type = point.GetDeviceClass();
103 if(type == Device::Class::Type::MOUSE)
105 mSourceType = GestureSourceType::MOUSE;
107 else if(type == Device::Class::Type::TOUCH)
109 mSourceType = GestureSourceType::TOUCH;
113 case MouseButton::PRIMARY:
115 mSourceData = GestureSourceData::MOUSE_PRIMARY;
118 case MouseButton::SECONDARY:
120 mSourceData = GestureSourceData::MOUSE_SECONDARY;
123 case MouseButton::TERTIARY:
125 mSourceData = GestureSourceData::MOUSE_TERTIARY;
130 mSourceData = GestureSourceData::INVALID;
141 * Protected Constructor. Should only be able to create derived class objects.
142 * @param[in] screenSize The size of the screen.
143 * @param[in] detectorType The type of gesture detector.
145 GestureRecognizer(Vector2 screenSize, GestureType::Value detectorType)
146 : mScreenSize(screenSize),
149 mSourceType(GestureSourceType::INVALID),
150 mSourceData(GestureSourceData::INVALID)
155 * Protected Constructor. Should only be able to create derived class objects.
157 * Use this constructor with the screen size is not used in the dereived class.
158 * @param[in] detectorType The type of gesture detector.
160 GestureRecognizer(GestureType::Value detectorType)
161 : GestureRecognizer(Vector2::ZERO, detectorType)
166 * Virtual destructor.
168 ~GestureRecognizer() override = default;
172 GestureType::Value mType;
174 GestureSourceType mSourceType; /// < Gesture input source type.
175 GestureSourceData mSourceData; /// < Gesture input source data.
178 using GestureRecognizerPtr = IntrusivePtr<GestureRecognizer>;
180 } // namespace Internal
184 #endif // DALI_INTERNAL_GESTURE_RECOGNIZER_H