/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ /* vim: set ts=8 sts=2 et sw=2 tw=80: */ /* This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ #ifndef mozilla_layers_InputUtils_h #define mozilla_layers_InputUtils_h /** * Defines a set of utility functions for generating input events * to an APZC/APZCTM during APZ gtests. */ #include "APZTestCommon.h" /* The InputReceiver template parameter used in the helper functions below needs * to be a class that implements functions with the signatures: * APZEventResult ReceiveInputEvent(const InputData& aEvent); * void SetAllowedTouchBehavior(uint64_t aInputBlockId, * const nsTArray& aBehaviours); * The classes that currently implement these are APZCTreeManager and * TestAsyncPanZoomController. Using this template allows us to test individual * APZC instances in isolation and also an entire APZ tree, while using the same * code to dispatch input events. */ template void SetDefaultAllowedTouchBehavior(const RefPtr& aTarget, uint64_t aInputBlockId, int touchPoints = 1) { nsTArray defaultBehaviors; // use the default value where everything is allowed for (int i = 0; i < touchPoints; i++) { defaultBehaviors.AppendElement( mozilla::layers::AllowedTouchBehavior::HORIZONTAL_PAN | mozilla::layers::AllowedTouchBehavior::VERTICAL_PAN | mozilla::layers::AllowedTouchBehavior::PINCH_ZOOM | mozilla::layers::AllowedTouchBehavior::ANIMATING_ZOOM); } aTarget->SetAllowedTouchBehavior(aInputBlockId, defaultBehaviors); } inline MultiTouchInput CreateMultiTouchInput( MultiTouchInput::MultiTouchType aType, TimeStamp aTime) { return MultiTouchInput(aType, MillisecondsSinceStartup(aTime), aTime, 0); } template APZEventResult TouchDown(const RefPtr& aTarget, const ScreenIntPoint& aPoint, TimeStamp aTime) { MultiTouchInput mti = CreateMultiTouchInput(MultiTouchInput::MULTITOUCH_START, aTime); mti.mTouches.AppendElement(CreateSingleTouchData(0, aPoint)); return aTarget->ReceiveInputEvent(mti); } template APZEventResult TouchMove(const RefPtr& aTarget, const ScreenIntPoint& aPoint, TimeStamp aTime) { MultiTouchInput mti = CreateMultiTouchInput(MultiTouchInput::MULTITOUCH_MOVE, aTime); mti.mTouches.AppendElement(CreateSingleTouchData(0, aPoint)); return aTarget->ReceiveInputEvent(mti); } template APZEventResult TouchUp(const RefPtr& aTarget, const ScreenIntPoint& aPoint, TimeStamp aTime) { MultiTouchInput mti = CreateMultiTouchInput(MultiTouchInput::MULTITOUCH_END, aTime); mti.mTouches.AppendElement(CreateSingleTouchData(0, aPoint)); return aTarget->ReceiveInputEvent(mti); } template APZEventResult Wheel(const RefPtr& aTarget, const ScreenIntPoint& aPoint, const ScreenPoint& aDelta, TimeStamp aTime) { ScrollWheelInput input(aTime, 0, ScrollWheelInput::SCROLLMODE_INSTANT, ScrollWheelInput::SCROLLDELTA_PIXEL, aPoint, aDelta.x, aDelta.y, false, WheelDeltaAdjustmentStrategy::eNone); return aTarget->ReceiveInputEvent(input); } template APZEventResult SmoothWheel(const RefPtr& aTarget, const ScreenIntPoint& aPoint, const ScreenPoint& aDelta, TimeStamp aTime) { ScrollWheelInput input(aTime, 0, ScrollWheelInput::SCROLLMODE_SMOOTH, ScrollWheelInput::SCROLLDELTA_LINE, aPoint, aDelta.x, aDelta.y, false, WheelDeltaAdjustmentStrategy::eNone); return aTarget->ReceiveInputEvent(input); } template APZEventResult MouseDown(const RefPtr& aTarget, const ScreenIntPoint& aPoint, TimeStamp aTime) { MouseInput input(MouseInput::MOUSE_DOWN, MouseInput::ButtonType::PRIMARY_BUTTON, 0, 0, aPoint, aTime, 0); return aTarget->ReceiveInputEvent(input); } template APZEventResult MouseMove(const RefPtr& aTarget, const ScreenIntPoint& aPoint, TimeStamp aTime) { MouseInput input(MouseInput::MOUSE_MOVE, MouseInput::ButtonType::PRIMARY_BUTTON, 0, 0, aPoint, aTime, 0); return aTarget->ReceiveInputEvent(input); } template APZEventResult MouseUp(const RefPtr& aTarget, const ScreenIntPoint& aPoint, TimeStamp aTime) { MouseInput input(MouseInput::MOUSE_UP, MouseInput::ButtonType::PRIMARY_BUTTON, 0, 0, aPoint, aTime, 0); return aTarget->ReceiveInputEvent(input); } template APZEventResult PanGesture(PanGestureInput::PanGestureType aType, const RefPtr& aTarget, const ScreenIntPoint& aPoint, const ScreenPoint& aDelta, TimeStamp aTime, Modifiers aModifiers = MODIFIER_NONE, bool aSimulateMomentum = false) { PanGestureInput input(aType, aTime, aPoint, aDelta, aModifiers); input.mSimulateMomentum = aSimulateMomentum; if constexpr (std::is_same_v) { // In the case of TestAsyncPanZoomController we know for sure that the // event will be handled by APZ so set it explicitly. input.mHandledByAPZ = true; } return aTarget->ReceiveInputEvent(input); } template APZEventResult PanGestureWithModifiers(PanGestureInput::PanGestureType aType, Modifiers aModifiers, const RefPtr& aTarget, const ScreenIntPoint& aPoint, const ScreenPoint& aDelta, TimeStamp aTime) { return PanGesture(aType, aTarget, aPoint, aDelta, aTime, aModifiers); } #endif // mozilla_layers_InputUtils_h