TouchpadGesturePhase

The phase of a touchpad gesture event.

All gestures are guaranteed to begin with an event of type clutter_touchpad_gesture_phase_begin, followed by a number of clutter_touchpad_gesture_phase_update (possibly 0).

A finished gesture may have 2 possible outcomes, an event with phase clutter_touchpad_gesture_phase_end will be emitted when the gesture is considered successful, this should be used as the hint to perform any permanent changes.

Cancelled gestures may be so for a variety of reasons, due to hardware, or due to the gesture recognition layers hinting the gesture did not finish resolutely (eg. a 3rd finger being added during a pinch gesture). In these cases, the last event with report the phase clutter_touchpad_gesture_phase_cancel, this should be used as a hint to undo any visible/permanent changes that were done throughout the progress of the gesture.

See also TouchpadPinchEvent and TouchpadPinchEvent.