| # -*- coding: utf-8 -*- |
| # |
| # Copyright (c) 2012 The Chromium OS Authors. All rights reserved. |
| # Use of this source code is governed by a BSD-style license that can be |
| # found in the LICENSE file. |
| |
| """This configuration file defines the gestures to perform.""" |
| |
| import validators |
| |
| from firmware_constants import DEV, GV, RC, VAL |
| from validators import (CountPacketsValidator, |
| CountTrackingIDValidator, |
| DrumrollValidator, |
| LinearityValidator, |
| NoGapValidator, |
| NoLevelJumpValidator, |
| NoReversedMotionValidator, |
| PhysicalClickValidator, |
| PinchValidator, |
| RangeValidator, |
| ReportRateValidator, |
| StationaryFingerValidator, |
| ) |
| |
| |
| # Define which score aggregator is to be used. A score aggregator collects |
| # the scores from every tests and calculates the final score for the touch |
| # firmware test suite. |
| score_aggregator = 'fuzzy.average' |
| |
| |
| # Define some common criteria |
| # |
| # Notes about show_spec_v2 below: |
| # Some of the following criteria may need to be determined at run time. |
| # Use lambda to do lazy evaluation because the show_spec_v2 may not be |
| # assigned its value yet when this module is imported. |
| count_packets_criteria = '>= 3, ~ -3' |
| drumroll_criteria = '<= 2.0' |
| # linearity_criteria is used for strictly straight line drawn with a ruler. |
| linearity_criteria = '<= 0.8, ~ +2.4' |
| # relaxed_linearity_criteria is used for lines drawn with thumb edge or |
| # fat fingers which are allowed to be curvy to some extent. |
| relaxed_linearity_criteria = '<= 1.5, ~ +3.0' |
| no_gap_criteria = '<= 1.8, ~ +1.0' |
| no_level_jump_criteria = '<= 10, ~ +30' |
| no_reversed_motion_criteria = '<= 5, ~ +30' |
| pinch_criteria = '>= 200, ~ -100' |
| range_criteria = '<= 0.05, ~ +0.05' |
| min_report_rate = 60 |
| report_rate_criteria = '>= %d' % min_report_rate |
| stationary_finger_criteria = (lambda: '<= 1.25, ~ +1.25' |
| if validators.show_spec_v2 else '<= 20, ~ +20') |
| relaxed_stationary_finger_criteria = '<= 100, ~ +100' |
| |
| MIN_MOVING_DISTANCE = 20 |
| |
| |
| # Define filenames and paths |
| docroot = '/tmp' |
| report_basename = 'touch_firmware_report' |
| html_ext = '.html' |
| ENVIRONMENT_REPORT_HTML_NAME = 'REPORT_HTML_NAME' |
| log_root_dir = '/var/tmp/touch_firmware_test' |
| fw_prefix = 'fw_' |
| device_description_dir = 'tests/device' |
| |
| |
| # Define parameters for GUI |
| score_colors = ((0.9, 'blue'), (0.8, 'orange'), (0.0, 'red')) |
| num_chars_per_row = 28 |
| |
| |
| # Define the validators that are shown only when there are failures. |
| validators_hidden_when_no_failures = ['PinchValidator', |
| 'CountTrackingIDValidator', |
| 'CountPacketsValidator'] |
| |
| |
| # Define the path to find the robot gestures library path |
| robot_lib_path = '/usr/local/lib*' |
| python_package = 'python*' |
| gestures_sub_path = 'site-packages/gestures' |
| |
| |
| # Define the gesture names |
| ONE_FINGER_TRACKING = 'one_finger_tracking' |
| ONE_FINGER_TO_EDGE = 'one_finger_to_edge' |
| TWO_FINGER_TRACKING = 'two_finger_tracking' |
| FINGER_CROSSING = 'finger_crossing' |
| ONE_FINGER_SWIPE = 'one_finger_swipe' |
| TWO_FINGER_SWIPE = 'two_finger_swipe' |
| PINCH_TO_ZOOM = 'pinch_to_zoom' |
| ONE_FINGER_TAP = 'one_finger_tap' |
| TWO_FINGER_TAP = 'two_finger_tap' |
| ONE_FINGER_PHYSICAL_CLICK = 'one_finger_physical_click' |
| TWO_FINGER_PHYSICAL_CLICK = 'two_fingers_physical_click' |
| THREE_FINGER_PHYSICAL_CLICK = 'three_fingers_physical_click' |
| FOUR_FINGER_PHYSICAL_CLICK = 'four_fingers_physical_click' |
| FIVE_FINGER_PHYSICAL_CLICK = 'five_fingers_physical_click' |
| STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS = \ |
| 'stationary_finger_not_affected_by_2nd_finger_taps' |
| FAT_FINGER_MOVE_WITH_RESTING_FINGER = 'fat_finger_move_with_resting_finger' |
| DRAG_EDGE_THUMB = 'drag_edge_thumb' |
| TWO_CLOSE_FINGERS_TRACKING = 'two_close_fingers_tracking' |
| RESTING_FINGER_PLUS_2ND_FINGER_MOVE = 'resting_finger_plus_2nd_finger_move' |
| TWO_FAT_FINGERS_TRACKING = 'two_fat_fingers_tracking' |
| FIRST_FINGER_TRACKING_AND_SECOND_FINGER_TAPS = \ |
| 'first_finger_tracking_and_second_finger_taps' |
| DRUMROLL = 'drumroll' |
| RAPID_TAPS = 'rapid_taps_20' |
| # This following gesture is for pressure calibration. |
| PRESSURE_CALIBRATION = 'pressure_calibration' |
| |
| # This denotes the list of the numbers of fingers for physical click tests. |
| # It corresponds to ONE/TWO/THREE/FOUR/FIVE_FINGER_PHYSICAL_CLICK defined above. |
| fingers_physical_click = [1, 2, 3, 4, 5] |
| |
| |
| # Define the complete list |
| gesture_names_complete = { |
| DEV.TOUCHPAD: [ |
| ONE_FINGER_TRACKING, |
| ONE_FINGER_TO_EDGE, |
| TWO_FINGER_TRACKING, |
| FINGER_CROSSING, |
| ONE_FINGER_SWIPE, |
| TWO_FINGER_SWIPE, |
| PINCH_TO_ZOOM, |
| ONE_FINGER_TAP, |
| TWO_FINGER_TAP, |
| ONE_FINGER_PHYSICAL_CLICK, |
| TWO_FINGER_PHYSICAL_CLICK, |
| THREE_FINGER_PHYSICAL_CLICK, |
| FOUR_FINGER_PHYSICAL_CLICK, |
| FIVE_FINGER_PHYSICAL_CLICK, |
| STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS, |
| FAT_FINGER_MOVE_WITH_RESTING_FINGER, |
| DRAG_EDGE_THUMB, |
| TWO_CLOSE_FINGERS_TRACKING, |
| RESTING_FINGER_PLUS_2ND_FINGER_MOVE, |
| TWO_FAT_FINGERS_TRACKING, |
| FIRST_FINGER_TRACKING_AND_SECOND_FINGER_TAPS, |
| DRUMROLL, |
| RAPID_TAPS, |
| ], |
| DEV.TOUCHSCREEN: [ |
| ONE_FINGER_TRACKING, |
| ONE_FINGER_TO_EDGE, |
| TWO_FINGER_TRACKING, |
| FINGER_CROSSING, |
| ONE_FINGER_SWIPE, |
| TWO_FINGER_SWIPE, |
| PINCH_TO_ZOOM, |
| ONE_FINGER_TAP, |
| TWO_FINGER_TAP, |
| STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS, |
| FAT_FINGER_MOVE_WITH_RESTING_FINGER, |
| DRAG_EDGE_THUMB, |
| TWO_CLOSE_FINGERS_TRACKING, |
| RESTING_FINGER_PLUS_2ND_FINGER_MOVE, |
| TWO_FAT_FINGERS_TRACKING, |
| FIRST_FINGER_TRACKING_AND_SECOND_FINGER_TAPS, |
| DRUMROLL, |
| RAPID_TAPS, |
| ], |
| } |
| |
| |
| # Define what gestures the robot can perform. |
| # This also defines the order for the robot to perform the gestures. |
| # Basically, two-fingers gestures follow one-finger gestures. |
| robot_capability_list = [ |
| ONE_FINGER_TRACKING, |
| ONE_FINGER_TO_EDGE, |
| ONE_FINGER_SWIPE, |
| ONE_FINGER_TAP, |
| ONE_FINGER_PHYSICAL_CLICK, |
| RAPID_TAPS, |
| TWO_FINGER_TRACKING, |
| TWO_FINGER_SWIPE, |
| TWO_FINGER_TAP, |
| TWO_FINGER_PHYSICAL_CLICK, |
| ] |
| |
| |
| def get_gesture_names_for_robot(device): |
| """Get the gesture names that a robot can do for a specified device.""" |
| return [gesture for gesture in robot_capability_list |
| if gesture in gesture_names_complete[device]] |
| |
| |
| # Define the list of one-finger and two-finger gestures to test using the robot. |
| gesture_names_robot = { |
| DEV.TOUCHPAD: get_gesture_names_for_robot(DEV.TOUCHPAD), |
| DEV.TOUCHSCREEN: get_gesture_names_for_robot(DEV.TOUCHSCREEN), |
| } |
| |
| |
| # Define the gestures to test using the robot with finger interaction. |
| gesture_names_robot_interaction = { |
| DEV.TOUCHPAD: gesture_names_robot[DEV.TOUCHPAD] + [ |
| FINGER_CROSSING, |
| STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS, |
| RESTING_FINGER_PLUS_2ND_FINGER_MOVE, |
| ], |
| DEV.TOUCHSCREEN: gesture_names_robot[DEV.TOUCHSCREEN] + [ |
| FINGER_CROSSING, |
| STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS, |
| RESTING_FINGER_PLUS_2ND_FINGER_MOVE, |
| ], |
| } |
| |
| |
| # Define the manual list which is gesture_names_complete - gesture_names_robot |
| gesture_names_manual = {} |
| for dev in DEV.DEVICE_TYPE_LIST: |
| complete_gesture_list = gesture_names_complete[dev] |
| manual_set = set(complete_gesture_list) - set(gesture_names_robot[dev]) |
| gesture_names_manual[dev] = [gesture for gesture in complete_gesture_list |
| if gesture in manual_set] |
| |
| |
| # Define the gesture for pressure calibration |
| gesture_names_calibration = [PRESSURE_CALIBRATION,] |
| |
| |
| # Define those gestures that the robot needs to pause so the user |
| # could adjust the robot or do finger interaction. |
| msg_step1 = 'Step 1: Place a metal finger on the %s of the touch surface now.' |
| msg_step2 = 'Step 2: Press SPACE when ready.' |
| msg_step3 = 'Step 3: Remember to lift the metal finger when robot has finished!' |
| gesture_names_robot_pause = { |
| TWO_FINGER_TRACKING: { |
| RC.PAUSE_TYPE: RC.PER_GESTURE, |
| RC.PROMPT: ( |
| 'Gesture: %s' % TWO_FINGER_TRACKING, |
| 'Step 1: Install two fingers for the robot now.', |
| msg_step2, |
| '', |
| ) |
| }, |
| |
| FINGER_CROSSING: { |
| RC.PAUSE_TYPE: RC.PER_VARIATION, |
| RC.PROMPT: ( |
| 'Gesture: %s' % FINGER_CROSSING, |
| msg_step1 % 'center', |
| msg_step2, |
| msg_step3, |
| ) |
| }, |
| |
| STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS: { |
| RC.PAUSE_TYPE: RC.PER_VARIATION, |
| RC.PROMPT: ( |
| 'Gesture: %s' % STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS, |
| msg_step1 % 'center', |
| msg_step2, |
| msg_step3, |
| ) |
| }, |
| |
| RESTING_FINGER_PLUS_2ND_FINGER_MOVE: { |
| RC.PAUSE_TYPE: RC.PER_VARIATION, |
| RC.PROMPT: ( |
| 'Gesture: %s' % RESTING_FINGER_PLUS_2ND_FINGER_MOVE, |
| msg_step1 % 'bottom left corner', |
| msg_step2, |
| msg_step3, |
| ) |
| }, |
| } |
| |
| |
| # Define the relative segment weights of a validator. |
| # For example, LinearityMiddleValidator : LinearityBothEndsValidator = 7 : 3 |
| segment_weights = {VAL.BEGIN: 0.15, |
| VAL.MIDDLE: 0.7, |
| VAL.END: 0.15, |
| VAL.BOTH_ENDS: 0.15 + 0.15, |
| VAL.WHOLE: 0.15 + 0.7 + 0.15, |
| } |
| |
| |
| # Define the validator score weights |
| weight_rare = 1 |
| weight_common = 2 |
| weight_critical = 3 |
| validator_weights = {'CountPacketsValidator': weight_common, |
| 'CountTrackingIDValidator': weight_critical, |
| 'DrumrollValidator': weight_rare, |
| 'LinearityValidator': weight_common, |
| 'NoGapValidator': weight_common, |
| 'NoLevelJumpValidator': weight_rare, |
| 'NoReversedMotionValidator': weight_common, |
| 'PhysicalClickValidator': weight_critical, |
| 'PinchValidator': weight_common, |
| 'RangeValidator': weight_common, |
| 'ReportRateValidator': weight_common, |
| 'StationaryFingerValidator': weight_common, |
| } |
| |
| |
| # Define the gesture list that the user needs to perform in the test suite. |
| def get_gesture_dict(): |
| """Define the dictionary for all gestures.""" |
| gesture_dict = { |
| ONE_FINGER_TRACKING: |
| Gesture( |
| name=ONE_FINGER_TRACKING, |
| variations=((GV.LR, GV.RL, GV.TB, GV.BT, GV.BLTR, GV.TRBL), |
| (GV.SLOW, GV.NORMAL), |
| ), |
| prompt='Take {2} to draw a straight, {0} line {1} using a ruler.', |
| subprompt={ |
| GV.LR: ('horizontal', 'from left to right',), |
| GV.RL: ('horizontal', 'from right to left',), |
| GV.TB: ('vertical', 'from top to bottom',), |
| GV.BT: ('vertical', 'from bottom to top',), |
| GV.BLTR: ('diagonal', 'from bottom left to top right',), |
| GV.TRBL: ('diagonal', 'from top right to bottom left',), |
| GV.SLOW: ('3 seconds',), |
| GV.NORMAL: ('1 second',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 1'), |
| LinearityValidator(linearity_criteria, finger=0, |
| segments=VAL.MIDDLE), |
| LinearityValidator(linearity_criteria, finger=0, |
| segments=VAL.BOTH_ENDS), |
| NoGapValidator(no_gap_criteria, slot=0), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0, |
| segments=VAL.MIDDLE), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0, |
| segments=VAL.BOTH_ENDS), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| ONE_FINGER_TO_EDGE: |
| Gesture( |
| name=ONE_FINGER_TO_EDGE, |
| variations=((GV.CL, GV.CR, GV.CT, GV.CB), |
| (GV.SLOW,), |
| ), |
| prompt='Take {2} to draw a striaght {0} line {1}.', |
| subprompt={ |
| GV.CL: ('horizontal', 'from the center off left edge',), |
| GV.CR: ('horizontal', 'from the center off right edge',), |
| GV.CT: ('vertical', 'from the center off top edge',), |
| GV.CB: ('vertical', 'from the center off bottom edge',), |
| GV.SLOW: ('2 seconds',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 1'), |
| LinearityValidator(linearity_criteria, finger=0, |
| segments=VAL.MIDDLE), |
| LinearityValidator(linearity_criteria, finger=0, |
| segments=VAL.BOTH_ENDS), |
| NoGapValidator(no_gap_criteria, slot=0), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0), |
| RangeValidator(range_criteria), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| TWO_FINGER_TRACKING: |
| Gesture( |
| name=TWO_FINGER_TRACKING, |
| variations=((GV.LR, GV.RL, GV.TB, GV.BT, GV.BLTR, GV.TRBL), |
| (GV.SLOW, GV.NORMAL), |
| ), |
| prompt='Take {2} to draw a {0} line {1} using a ruler ' |
| 'with TWO fingers at the same time.', |
| subprompt={ |
| GV.LR: ('horizontal', 'from left to right',), |
| GV.RL: ('horizontal', 'from right to left',), |
| GV.TB: ('vertical', 'from top to bottom',), |
| GV.BT: ('vertical', 'from bottom to top',), |
| GV.BLTR: ('diagonal', 'from bottom left to top right',), |
| GV.TRBL: ('diagonal', 'from top right to bottom left',), |
| GV.SLOW: ('3 seconds',), |
| GV.NORMAL: ('1 second',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| LinearityValidator(linearity_criteria, finger=0, |
| segments=VAL.MIDDLE), |
| LinearityValidator(linearity_criteria, finger=0, |
| segments=VAL.BOTH_ENDS), |
| LinearityValidator(linearity_criteria, finger=1, |
| segments=VAL.MIDDLE), |
| LinearityValidator(linearity_criteria, finger=1, |
| segments=VAL.BOTH_ENDS), |
| NoGapValidator(no_gap_criteria, slot=0), |
| NoGapValidator(no_gap_criteria, slot=1), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=1), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| FINGER_CROSSING: |
| Gesture( |
| # also covers stationary_finger_not_affected_by_2nd_moving_finger |
| name=FINGER_CROSSING, |
| variations=((GV.LR, GV.RL, GV.TB, GV.BT, GV.BLTR, GV.TRBL), |
| (GV.SLOW, GV.NORMAL), |
| ), |
| prompt='Place one stationary finger near the center of the ' |
| 'touch surface, then take {2} to draw a straight line ' |
| '{0} {1} with a second finger', |
| subprompt={ |
| GV.LR: ('from left to right', 'above the stationary finger'), |
| GV.RL: ('from right to left', 'below the stationary finger'), |
| GV.TB: ('from top to bottom', |
| 'on the right to the stationary finger'), |
| GV.BT: ('from bottom to top', |
| 'on the left to the stationary finger'), |
| GV.BLTR: ('from the bottom left to the top right', |
| 'above the stationary finger',), |
| GV.TRBL: ('from the top right to the bottom left', |
| 'below the stationary finger'), |
| GV.SLOW: ('3 seconds',), |
| GV.NORMAL: ('1 second',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| NoGapValidator(no_gap_criteria, slot=1), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=1), |
| ReportRateValidator(report_rate_criteria, finger=1), |
| StationaryFingerValidator(stationary_finger_criteria, slot=0), |
| ), |
| ), |
| |
| ONE_FINGER_SWIPE: |
| Gesture( |
| name=ONE_FINGER_SWIPE, |
| variations=(GV.BLTR, GV.TRBL), |
| prompt='Use ONE finger to quickly swipe {0}.', |
| subprompt={ |
| GV.BLTR: ('from the bottom left to the top right',), |
| GV.TRBL: ('from the top right to the bottom left',), |
| }, |
| validators=( |
| CountPacketsValidator(count_packets_criteria, slot=0), |
| CountTrackingIDValidator('== 1'), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| TWO_FINGER_SWIPE: |
| Gesture( |
| name=TWO_FINGER_SWIPE, |
| variations=(GV.TB, GV.BT), |
| prompt='Use TWO fingers to quickly swipe {0}.', |
| subprompt={ |
| GV.TB: ('from top to bottom',), |
| GV.BT: ('from bottom to top',), |
| }, |
| validators=( |
| CountPacketsValidator(count_packets_criteria, slot=0), |
| CountPacketsValidator(count_packets_criteria, slot=1), |
| CountTrackingIDValidator('== 2'), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=1), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| PINCH_TO_ZOOM: |
| Gesture( |
| name=PINCH_TO_ZOOM, |
| variations=(GV.ZOOM_IN, GV.ZOOM_OUT), |
| prompt='Using two fingers, preform a "{0}" pinch by bringing' |
| 'your fingers {1}.', |
| subprompt={ |
| GV.ZOOM_IN: ('zoom in', 'farther apart'), |
| GV.ZOOM_OUT: ('zoom out', 'closer together'), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| PinchValidator(pinch_criteria), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| ONE_FINGER_TAP: |
| Gesture( |
| name=ONE_FINGER_TAP, |
| variations=(GV.TL, GV.TR, GV.BL, GV.BR, GV.TS, GV.BS, GV.LS, GV.RS, |
| GV.CENTER), |
| prompt='Use one finger to tap on the {0} of the touch surface.', |
| subprompt={ |
| GV.TL: ('top left corner',), |
| GV.TR: ('top right corner',), |
| GV.BL: ('bottom left corner',), |
| GV.BR: ('bottom right corner',), |
| GV.TS: ('top edge',), |
| GV.BS: ('bottom side',), |
| GV.LS: ('left hand side',), |
| GV.RS: ('right hand side',), |
| GV.CENTER: ('center',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 1'), |
| StationaryFingerValidator(stationary_finger_criteria, slot=0), |
| ), |
| ), |
| |
| TWO_FINGER_TAP: |
| Gesture( |
| name=TWO_FINGER_TAP, |
| variations=(GV.HORIZONTAL, GV.VERTICAL, GV.DIAGONAL), |
| prompt='Use two fingers aligned {0} to tap the center of the ' |
| 'touch surface.', |
| subprompt={ |
| GV.HORIZONTAL: ('horizontally',), |
| GV.VERTICAL: ('vertically',), |
| GV.DIAGONAL: ('diagonally',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| StationaryFingerValidator(stationary_finger_criteria, slot=0), |
| StationaryFingerValidator(stationary_finger_criteria, slot=1), |
| ), |
| ), |
| |
| ONE_FINGER_PHYSICAL_CLICK: |
| Gesture( |
| name=ONE_FINGER_PHYSICAL_CLICK, |
| variations=(GV.CENTER, GV.BL, GV.BS, GV.BR), |
| prompt='Use one finger to physically click the {0} of the ' |
| 'touch surface.', |
| subprompt={ |
| GV.CENTER: ('center',), |
| GV.BL: ('bottom left corner',), |
| GV.BS: ('bottom side',), |
| GV.BR: ('bottom right corner',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 1'), |
| PhysicalClickValidator('== 1', fingers=1), |
| StationaryFingerValidator(stationary_finger_criteria, slot=0), |
| ), |
| ), |
| |
| TWO_FINGER_PHYSICAL_CLICK: |
| Gesture( |
| name=TWO_FINGER_PHYSICAL_CLICK, |
| variations=None, |
| prompt='Use two fingers physically click the center of the ' |
| 'touch surface.', |
| subprompt=None, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| PhysicalClickValidator('== 1', fingers=2), |
| StationaryFingerValidator(relaxed_stationary_finger_criteria, |
| slot=0), |
| StationaryFingerValidator(relaxed_stationary_finger_criteria, |
| slot=1), |
| ), |
| ), |
| |
| THREE_FINGER_PHYSICAL_CLICK: |
| Gesture( |
| name=THREE_FINGER_PHYSICAL_CLICK, |
| variations=None, |
| prompt='Use three fingers to physically click ' |
| 'the center of the touch surface.', |
| subprompt=None, |
| validators=( |
| CountTrackingIDValidator('== 3'), |
| PhysicalClickValidator('== 1', fingers=3), |
| ), |
| ), |
| |
| FOUR_FINGER_PHYSICAL_CLICK: |
| Gesture( |
| name=FOUR_FINGER_PHYSICAL_CLICK, |
| variations=None, |
| prompt='Use four fingers to physically click ' |
| 'the center of the touch surface.', |
| subprompt=None, |
| validators=( |
| CountTrackingIDValidator('== 4'), |
| PhysicalClickValidator('== 1', fingers=4), |
| ), |
| ), |
| |
| FIVE_FINGER_PHYSICAL_CLICK: |
| Gesture( |
| name=FIVE_FINGER_PHYSICAL_CLICK, |
| variations=None, |
| prompt='Use five fingers to physically click ' |
| 'the center of the touch surface.', |
| subprompt=None, |
| validators=( |
| CountTrackingIDValidator('== 5'), |
| PhysicalClickValidator('== 1', fingers=5), |
| ), |
| ), |
| |
| STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS: |
| Gesture( |
| name=STATIONARY_FINGER_NOT_AFFECTED_BY_2ND_FINGER_TAPS, |
| variations=(GV.AROUND,), |
| prompt='Place your one stationary finger in the middle of the ' |
| 'touch surface, and use a second finger to tap ' |
| 'all around it', |
| subprompt=None, |
| validators=( |
| CountTrackingIDValidator('>= 2'), |
| StationaryFingerValidator(stationary_finger_criteria, slot=0), |
| ), |
| ), |
| |
| FAT_FINGER_MOVE_WITH_RESTING_FINGER: |
| Gesture( |
| name=FAT_FINGER_MOVE_WITH_RESTING_FINGER, |
| variations=(GV.LR, GV.RL, GV.TB, GV.BT), |
| prompt='With a stationary finger on the {0} of the touch surface, ' |
| 'draw a straight line with a FAT finger {1} {2} it.', |
| subprompt={ |
| GV.LR: ('center', 'from left to right', 'below'), |
| GV.RL: ('bottom edge', 'from right to left', 'above'), |
| GV.TB: ('center', 'from top to bottom', 'on the right to'), |
| GV.BT: ('center', 'from bottom to top', 'on the left to'), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| LinearityValidator(relaxed_linearity_criteria, finger=1, |
| segments=VAL.MIDDLE), |
| LinearityValidator(relaxed_linearity_criteria, finger=1, |
| segments=VAL.BOTH_ENDS), |
| NoGapValidator(no_gap_criteria, slot=1), |
| NoLevelJumpValidator(no_level_jump_criteria, slots=[1,]), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=1), |
| ReportRateValidator(report_rate_criteria, finger=1), |
| StationaryFingerValidator(stationary_finger_criteria, slot=0), |
| ), |
| ), |
| |
| DRAG_EDGE_THUMB: |
| Gesture( |
| name=DRAG_EDGE_THUMB, |
| variations=(GV.LR, GV.RL, GV.TB, GV.BT), |
| prompt='Drag the edge of your thumb {0} in a straight line ' |
| 'across the touch surface', |
| subprompt={ |
| GV.LR: ('horizontally from left to right',), |
| GV.RL: ('horizontally from right to left',), |
| GV.TB: ('vertically from top to bottom',), |
| GV.BT: ('vertically from bottom to top',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 1'), |
| LinearityValidator(relaxed_linearity_criteria, finger=0, |
| segments=VAL.MIDDLE), |
| LinearityValidator(relaxed_linearity_criteria, finger=0, |
| segments=VAL.BOTH_ENDS), |
| NoGapValidator(no_gap_criteria, slot=0), |
| NoLevelJumpValidator(no_level_jump_criteria, slots=[0,]), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| TWO_CLOSE_FINGERS_TRACKING: |
| Gesture( |
| # TODO(josephsih): make a special two-finger pen to perform this |
| # gesture so that the finger distance remains the same every time |
| # this test is conducted. |
| name=TWO_CLOSE_FINGERS_TRACKING, |
| variations=(GV.LR, GV.TB, GV.TLBR), |
| prompt='With two fingers close together (lightly touching each ' |
| 'other) in a two finger scrolling gesture, draw a {0} ' |
| 'line {1}.', |
| subprompt={ |
| GV.LR: ('horizontal', 'from left to right',), |
| GV.TB: ('vertical', 'from top to bottom',), |
| GV.TLBR: ('diagonal', 'from the top left to the bottom right',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| LinearityValidator(relaxed_linearity_criteria, finger=0, |
| segments=VAL.MIDDLE), |
| LinearityValidator(relaxed_linearity_criteria, finger=0, |
| segments=VAL.BOTH_ENDS), |
| LinearityValidator(relaxed_linearity_criteria, finger=1, |
| segments=VAL.MIDDLE), |
| LinearityValidator(relaxed_linearity_criteria, finger=1, |
| segments=VAL.BOTH_ENDS), |
| NoLevelJumpValidator(no_level_jump_criteria, slots=[0,]), |
| NoGapValidator(no_gap_criteria, slot=0), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| RESTING_FINGER_PLUS_2ND_FINGER_MOVE: |
| Gesture( |
| name=RESTING_FINGER_PLUS_2ND_FINGER_MOVE, |
| variations=((GV.TLBR, GV.BRTL), |
| (GV.SLOW,), |
| ), |
| prompt='With a stationary finger in the bottom left corner, take ' |
| '{1} to draw a straight line {0} with a second finger.', |
| subprompt={ |
| GV.TLBR: ('from the top left to the bottom right',), |
| GV.BRTL: ('from the bottom right to the top left',), |
| GV.SLOW: ('3 seconds',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| LinearityValidator(relaxed_linearity_criteria, finger=1, |
| segments=VAL.MIDDLE), |
| LinearityValidator(relaxed_linearity_criteria, finger=1, |
| segments=VAL.BOTH_ENDS), |
| NoGapValidator(no_gap_criteria, slot=1), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=1), |
| ReportRateValidator(report_rate_criteria, finger=1), |
| StationaryFingerValidator(stationary_finger_criteria, slot=0), |
| ), |
| ), |
| |
| TWO_FAT_FINGERS_TRACKING: |
| Gesture( |
| name=TWO_FAT_FINGERS_TRACKING, |
| variations=(GV.LR, GV.RL), |
| prompt='Use two FAT fingers separated by about 1cm to draw ' |
| 'a straight line {0}.', |
| subprompt={ |
| GV.LR: ('from left to right',), |
| GV.RL: ('from right to left',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 2'), |
| LinearityValidator(relaxed_linearity_criteria, finger=0, |
| segments=VAL.MIDDLE), |
| LinearityValidator(relaxed_linearity_criteria, finger=0, |
| segments=VAL.BOTH_ENDS), |
| LinearityValidator(relaxed_linearity_criteria, finger=1, |
| segments=VAL.MIDDLE), |
| LinearityValidator(relaxed_linearity_criteria, finger=1, |
| segments=VAL.BOTH_ENDS), |
| NoGapValidator(no_gap_criteria, slot=0), |
| NoGapValidator(no_gap_criteria, slot=1), |
| NoLevelJumpValidator(no_level_jump_criteria, slots=[0,]), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=1), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| FIRST_FINGER_TRACKING_AND_SECOND_FINGER_TAPS: |
| Gesture( |
| name=FIRST_FINGER_TRACKING_AND_SECOND_FINGER_TAPS, |
| variations=(GV.TLBR, GV.BRTL), |
| prompt='While drawing a straight line {0} slowly (~3 seconds), ' |
| 'tap the bottom left corner with a second finger ' |
| 'gently 3 times.', |
| subprompt={ |
| GV.TLBR: ('from top left to bottom right',), |
| GV.BRTL: ('from bottom right to top left',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 4'), |
| LinearityValidator(relaxed_linearity_criteria, finger=0, |
| segments=VAL.MIDDLE), |
| LinearityValidator(relaxed_linearity_criteria, finger=0, |
| segments=VAL.BOTH_ENDS), |
| NoGapValidator(no_gap_criteria, slot=0), |
| NoReversedMotionValidator(no_reversed_motion_criteria, slots=0), |
| ReportRateValidator(report_rate_criteria), |
| ), |
| ), |
| |
| DRUMROLL: |
| Gesture( |
| name=DRUMROLL, |
| variations=(GV.FAST, ), |
| prompt='Use the index and middle finger of one hand to make a ' |
| '"drum roll" {0} by alternately tapping each finger ' |
| 'for 5 seconds.', |
| subprompt={ |
| GV.FAST: ('as fast as possible',), |
| }, |
| validators=( |
| CountTrackingIDValidator('>= 5'), |
| DrumrollValidator(drumroll_criteria), |
| ), |
| timeout = 2000, |
| ), |
| |
| RAPID_TAPS: |
| Gesture( |
| name=RAPID_TAPS, |
| variations=(GV.TL, GV.BR, GV.CENTER), |
| prompt='Tap the {0} of the touch surface 20 times quickly', |
| subprompt={ |
| GV.TL: ('top left corner',), |
| GV.TS: ('top edge',), |
| GV.TR: ('top right corner',), |
| GV.LS: ('left edge',), |
| GV.CENTER: ('center',), |
| GV.RS: ('right edge',), |
| GV.BL: ('bottom left corner',), |
| GV.BS: ('bottom edge',), |
| GV.BR: ('bottom right corner',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 20'), |
| ), |
| timeout = 2000, |
| ), |
| |
| PRESSURE_CALIBRATION: |
| Gesture( |
| name=PRESSURE_CALIBRATION, |
| variations=(GV.SIZE0, GV.SIZE1, GV.SIZE2, GV.SIZE3, GV.SIZE4, |
| GV.SIZE5, GV.SIZE6, ), |
| prompt='Draw circles continuously for 5 seconds ' |
| 'using the metal finger of size {0}.', |
| subprompt={ |
| GV.SIZE0: ('0 (the smallest size)',), |
| GV.SIZE1: ('1',), |
| GV.SIZE2: ('2',), |
| GV.SIZE3: ('3',), |
| GV.SIZE4: ('4',), |
| GV.SIZE5: ('5',), |
| GV.SIZE6: ('6 (the largest size)',), |
| }, |
| validators=( |
| CountTrackingIDValidator('== 1'), |
| ), |
| ), |
| } |
| return gesture_dict |
| |
| |
| class FileName: |
| """A dummy class to hold the attributes in a test file name.""" |
| pass |
| filename = FileName() |
| filename.sep = '-' |
| filename.ext = 'dat' |
| |
| |
| class Gesture: |
| """A class defines the structure of Gesture.""" |
| # define the default timeout (in milli-seconds) when performing a gesture. |
| # A gesture is considered done when finger is lifted for this time interval. |
| TIMEOUT = int(1000/80*10) |
| |
| def __init__(self, name=None, variations=None, prompt=None, subprompt=None, |
| validators=None, timeout=TIMEOUT): |
| self.name = name |
| self.variations = variations |
| self.prompt = prompt |
| self.subprompt = subprompt |
| self.validators = validators |
| self.timeout = timeout |
