Module: MobyBehaviour::QT::Multitouch

Includes:
Behaviour
Defined in:
lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/multitouch.rb

Overview

description

Behaviours for multitouch operations.

behaviour

QtMultitouch

requires

testability-driver-qt-sut-plugin

input_type

touch

sut_type

qt

sut_version

*

objects

*

Instance Method Summary collapse

Methods included from Behaviour

#command_params

Instance Method Details

#one_point_rotate(radius, start_angle, rotate_direction, distance, speed, center_point = nil) ⇒ Object

description

Causes rotation motion on the object. The rotation will be so that one point is stationary while other moves to create a rotation motion (like a hinge).

arguments

radius

Integer
 description: Radius of the of the rotation in degrees (distance between the points)
 example: 100

start_angle

Integer
 description: Starting angle of the rotation. Integer from 0-360
 example: 90
Symbol
 description: Starting angle of the rotation. Symbol :Horizontal or :Vertical
 example: :Horizontal

rotate_direction

Symbol
 description: Rotation direction :Clockwise or :CounterClockwise. 
 example: :CounterClockwise

distance

Integer
 description: Distance of the rotation in degrees
 example: 360

speed

Integer
 description: Speed in seconds
 example: 3

center_point

Hash
 description: Optional X and Y coordinates (relative to the object e.g. top left of the object is 0.0). 
              In one point rotation the other end point will remain stationary (the rotation is done around that point)
              and that will be the given point. If not given the point will be the center of the object.
 example: {:x => 50, :y => 100}

returns

NilClass

description: -
example: -

exceptions

ArgumentError

description:  In case the given parameters are not valid.

info

See [link=“#QtMultitouch:rotate”]rotate method for more details



279
280
281
282
283
284
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/multitouch.rb', line 279

def one_point_rotate(radius, start_angle, rotate_direction, distance, speed, center_point = nil)
 params = {:type => :one_point, :radius => radius, :rotate_direction => rotate_direction, :distance => distance, :speed => speed, :direction => start_angle}
 params.merge!(center_point) if center_point 
 rotate(params)
   self
end

#pinch_zoom(params) ⇒ Object

description

Causes a pinch zoom gesture on the object. The type of the pinch is based on the given parameters. The parameters make it possible to define various kinds of pinch zoom operations.

The image shows how the different parameters will be used to make the pinch gesture. The image show a zoom in type gesture (:type => :in). Direction is the angle of the first part of the pinch gesture against the y axel (0 degrees is up). Distance variables do not have to be the same. This means that you can set the gesture so that one finger moves a longer distance than the other (or even set one distance to 0). The :differential parameter determines the how close the nearest points in the pinch gesture are (:in start points and :out end points). The center points can be set using the :x and :y setting. The values are relative to the object and if not set then the center point of the object is used. n

img=“images/pinch.png”]Pinch zoom parameters[/img

arguments

params

Hash 
 description:
  A Hash table contains all of the parameters required to make the pinch zoom. 
  See [link="#pinch_options_table"]Pinch options table[/link] for valid keys. 
  example: pinch_zoom({:type => :in, :speed => 2, :distance_1 => 100, :distance_2 => 100, :direction => :Vertical, :differential => 10})

tables

pinch_options_table

title: Pinch options table
|Key|Type|Description|Accepted values|Example|Required|
|:type|Symbol|Zoom in or out|:in,:out|:type => :in|Yes|
|:speed|Integer|Speed of the gesture in seconds|Positive Integer|:speed => 2|Yes|
|:distance_1|Integer|Distance of the first finger zoom gesture|Positive integer|:distance_1 => 100|Yes|
|:distance_2|Integer|Distance of the second finger zoom gesture|Positive integer|:distance_2 => 100|Yes|
|:differential|Integer|The difference from where the zoom starts or ends|Positive integer|:differential => 10|Yes|
|:x|Integer|X coordinate of the center point for the pinch (relative to the object). Optional defaults to center point but if set y must also be set.|Positive Integer| :x => 120|No|
|:y|Integer|Y coordinate of the center point for the pinch (relative to the object). Optional defaults to center point but if set x must also be set.|Positive Integer|:y => 200|No|

returns

NilClass

description: -
example: -

exceptions

ArgumentError

description:  In case the given parameters are not valid.



192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/multitouch.rb', line 192

def pinch_zoom( params )

 begin
   verify_pinch_params!(params)

   #convert speed to millis
   time = params[:speed].to_f
   speed = time*1000
   params[:speed] = speed.to_i
   if params[:x].kind_of?(Integer) and params[:y].kind_of?(Integer)
  params[:useCoordinates] = 'true' 
  params[:x] = attribute('x_absolute').to_i + params[:x]
  params[:y] = attribute('y_absolute').to_i + params[:y]
   end
   command = command_params #in qt_behaviour           
   command.command_name('PinchZoom')
   command.command_params(params)

   @sut.execute_command( command )

   #wait untill the pinch is finished
   do_sleep(time)

 rescue Exception => e      
   $logger.behaviour "FAIL;Failed pinch_zoom with params \"#{ params.inspect }\".;#{ identity };pinch_zoom;"
   raise e        
 end      

 $logger.behaviour "PASS;Operation pinch_zoom succeeded with params \"#{ params.inspect }\".;#{ identity };pinch_zoom;"

 self

end

#pinch_zoom_in(speed, distance, direction, differential = 10) ⇒ Object

description

Performs a pinch zoom in operation. The distance of the operation is is for both fingers. So a distance of 100 will be performed by both end points (fingers).

arguments

speed

Integer
 description: Speed of the operation in seconds
 example: 3

distance

Integer
 description: Distance of the pinch zoom
 example: 100

direction

Integer
 description: Direction of the pinch zoom in degrees 0-180
 example: 90
Symbol
 description: Direction of the pinch zoom either :Horizontal or :Vertical
 example: :Horizontal

differential

Integer
 description: The difference from where the zoom starts or ends (how far apart are the fingers when starting the zoom)
 example: 10

returns

NilClass

description: -
example: -

exceptions

ArgumentError

description:  In case the given parameters are not valid.

info

See method pinch_zoom



90
91
92
93
94
95
96
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/multitouch.rb', line 90

def pinch_zoom_in(speed, distance, direction, differential = 10)

	pinch_zoom({:type => :in, :speed => speed, :distance_1 => distance, :distance_2 => distance, :direction => direction, :differential => differential})

   self

end

#pinch_zoom_out(speed, distance, direction, differential = 10) ⇒ Object

description

Performs a pinch zoom out operation. The distance of the operation is is for both fingers. So a distance of 100 will be performed by both fingers.

arguments

speed

Integer
 description: Speed of the operation in seconds
 example: 3

distance

Integer
 description: Distance of the pinch zoom
 example: 100

direction

Integer
 description: Direction of the pinch zoom in degrees 0-180
 example: 90
Symbol
 description: Direction of the pinch zoom either :Horizontal or :Vertical
 example: :Horizontal

differential

Integer
 description: The difference from where the zoom starts or ends (how far apart are the fingers when starting the zoom)
 example: 10

returns

NilClass

description: -
example: -

exceptions

ArgumentError

description:  In case the given parameters are not valid.

info

See method pinch_zoom



139
140
141
142
143
144
145
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/multitouch.rb', line 139

def pinch_zoom_out(speed, distance, direction, differential = 10)

	pinch_zoom({:type => :out, :speed => speed, :distance_1 => distance, :distance_2 => distance, :direction => direction, :differential => differential})

   self

end

#rotate(params) ⇒ Object

description

Causes a rotate motion on the screen using two fingers (e.g. like turning a knob). Similar gesture to pinch zooming except the angle changes. n n

img=“images/rotate.png”]Rotation parameters[/img

n The image shows how the different parameters will be used to make the rotation gestures in both one point and two point rotations. In one point rotation the other end remains stationary while the other moves around it based on the given radius. In two point rotation the movement is done by both ends. Note the direction paramters as the :direction parameter defines the starting angle for the gesture and :rotation_direction defines the actual rotation direction (clockwise or counter clockwise). When performing two point rotation note that the radius is in fact a radius not the diameter. Distance is given in degrees from 0-360. Center point can be set using :x and :y and if not set the center point of the object will be used.

arguments

params

Hash
 description: A hash of the parameters that define the rotation. See [link="#rotate_options_table"]Rotate options table[/link] for valid keys

 example: {:type => :one_point, :radius => 100, :rotate_direction => :Clockwise, :distance => 45, :speed => 2, :direction => 35, :x => 2, y => 35}

tables

rotate_options_table

title: Rotate options table
|Key|Type|Description|Accepted values|Example|Required|
|:type|Symbol|Rotation type|:one_point,:two_point|:type => :one_point|Yes|
|:radius|Integer|Radius of the rotatation in pixels|Any positive Integer|:radius => 100|Yes|
|:rotation_direction|Symbol|Rotation direction|:Clockwise, :CounterClockwise|:rotate_direction => :Clockwise|Yes|
|:distance|Integer|Rotation distance in degrees|0-360|:distance => 90|Yes|
|:speed|Integer|Speed of the gesture in seconds|Positive Integer|:speed => 2|Yes|
|:direction|Integer/Symbol|The start angle of the rotation.|0-360 or :Horizontal, :Vertical|:direction => 35|Yes|
|:x|Integer|X coordinate of the center point for the pinch (relative to the object). Optional defaults to center point but if set y must also be set.|Positive Integer|:x => 50|No|
|:y|Integer|Y coordinate of the center point for the pinch (relative to the object). Optional defaults to center point but if set x must also be set.|Positive Integer|:y => 120|No|

returns

NilClass

description: -
example: -

exceptions

ArgumentError

description:  In case the given parameters are not valid.



391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/multitouch.rb', line 391

def rotate(params)

 begin

   verify_rotate_params!(params)

   time = params[:speed].to_f

   params[:speed] = (time * 1000).to_i 


   if params[:x].kind_of?(Integer) and params[:y].kind_of?(Integer)
    params[:useCoordinates] = 'true' 
    params[:x] = attribute('x_absolute').to_i + params[:x]
    params[:y] = attribute('y_absolute').to_i + params[:y]
   end

   command = command_params #in qt_behaviour           
   command.command_name('Rotate')
   command.command_params(params)
   
   @sut.execute_command( command )
   
   #wait untill the operation to finish
   do_sleep( time )
 rescue Exception => e      
   $logger.behaviour "FAIL;Failed rotate with params \"#{ params.inspect }\".;#{ identity };rotate;"
   raise e        
 end      

 $logger.behaviour "PASS;Operation rotate succeeded with params \"#{ params.inspect }\".;#{ identity };rotate;"

 self

end

#two_point_rotate(radius, start_angle, rotate_direction, distance, speed, center_point = nil) ⇒ Object

description

Causes ratation motion on the object. The rotation will be so that both ends move to create a rotation motion around a point.

arguments

radius

Integer
 description: Radius of the of the rotation in degrees (distance between the points)
 example: 100

start_angle

Integer
 description: Starting angle of the rotation. Integer from 0-360
 example: 90
Symbol
 description: Starting angle of the rotation. Symbol :Horizontal or :Vertical
 example: :Horizontal

rotate_direction

Symbol
 description: Rotation direction :Clockwise or :CounterClockwise. 
 example: :CounterClockwise

distance

Integer
 description: Distance of the rotation in degrees
 example: 360

speed

Integer
 description: Speed in seconds
 example: 3

center_point

Hash
 description: Optional X and Y coordinates (relative to the object e.g. top left of the object is 0.0). 
              In two point rotation both end points will rotate around a center point which will be
              the given point. If not given the point will be the center of the object.
 example: {:x => 50, :y => 100}

returns

NilClass

description: -
example: -

exceptions

ArgumentError

description:  In case the given parameters are not valid.

info

See method rotate



338
339
340
341
342
343
 
# File 'lib/testability-driver-plugins/testability-driver-qt-sut-plugin/behaviours/multitouch.rb', line 338

def two_point_rotate(radius, start_angle, rotate_direction, distance, speed, center_point = nil)
 params = {:type => :two_point, :radius => radius, :rotate_direction => rotate_direction, :distance => distance, :speed => speed, :direction => start_angle}
 params.merge!(center_point) if center_point 
 rotate(params)
   self
end