Gesture command

Performs a multi-touch operation called pinch and zoom.

For this gesture, the start and end coordinates must be defined. It is also possible to define the duration of the gesture. The start and end coordinates specify the touch sequence path for a single finger. The other finger is symmetrical.

For example:

  • Zoom: If the start coordinate is (50%,50%) and the end coordinate is (60%,40%), then one finger will move from (50%,50%) to (60%,40%) and the other from (50%,50%) to (40%,60%).

  • Pinch: If the start coordinate is (60%,40%) and the end coordinate is (50%,50%), then one finger will move from (60%,40%) to (50%,50%) and the other from (40%,60%) to (50%,50%).

Parameters

Name Type Possible values Description

Device ID*

Device

 

The device for this command. By default, this is the device under test (DUT).

Start coordinates*

String

 

The start, touch-down, event coordinates.

Format: "x,y" or "x%,y%"

The coordinate value can be in pixels or in percentage of screen size (0-100). For percentage, use the % sign.

Example: 50%, 50%

Consider using the percentage value because it does not rely on the screen resolution.

End coordinates*

String

 

The end, touch up, event coordinates.

Format: "x,y" or "x%,y%"

Coordinate value can be in pixels or in percentage of screen size (0-100). For percentage, use the % sign.

Example: 50%, 50%

Consider using the percentage value because it does not rely on the screen resolution.

Operation

String

Zoom | Pinch

The gesture operation type, where:

  • Zoom performs a pinch open operation from the start coordinates to the end coordinates.

  • Pinch performs a pinch close operation from the start coordinates to the end coordinates.

Duration

Number

  The duration, in seconds, for performing the operation.

Comment

String

 

Adds a comment to the script.

On-fail Result*

Condition

Ignore | Break | Continue | Abort | Catch

The behavior when the command fails.

* Mandatory parameter