User Tools
software:gui-designer:gestures
Differences
This shows you the differences between two versions of the page.
|
software:gui-designer:gestures [2012/12/21 04:14] jarrod [Pinch Zoom] |
software:gui-designer:gestures [2016/12/13 21:35] (current) jarrod [Attaching Gestures] |
||
|---|---|---|---|
| Line 5: | Line 5: | ||
| ===== Attaching Gestures ===== | ===== Attaching Gestures ===== | ||
| - | Gestures can currently be attached to Pages, Subpages and Image objects. We also plan to eventually allow gestures to be applied to buttons, text, sliders, etc.\\ | + | Gestures can currently be attached to Pages, Subpages and Image objects.\\ |
| The use of Images and Subpages with attached Gestures allows you to create only certain areas of the interface which react to a gesture.\\ | The use of Images and Subpages with attached Gestures allows you to create only certain areas of the interface which react to a gesture.\\ | ||
| \\ | \\ | ||
| Line 23: | Line 23: | ||
| - Presses | - Presses | ||
| - Swipes | - Swipes | ||
| - | Instant gestures happen immediately, with all actions happening in order of begin, then end. There is no 'change' event for Instant Gestures. | + | Instant gestures happen immediately, with all actions happening immediately as soon as the gesture is detected, but still in order of begin, then end. There is no 'change' event for Instant Gestures. The end actions will be triggered immediately after the begin actions. |
| ==== Continuous ==== | ==== Continuous ==== | ||
| Line 34: | Line 33: | ||
| ==== Taps ==== | ==== Taps ==== | ||
| - | Taps are a quick press and release on the touchscreen, in a single motion. They can be defined with between 1 and 10 #finger touches. Tap gestures can also specify the number of taps, like a double click on a mouse. The number of taps can range from 1 to any number. | + | Taps are a quick press and release on the touchscreen, in a single motion. They can be defined with between 1 and 10 finger touches. Tap gestures can also specify the number of taps, like a double click on a mouse. The number of taps can range from 1 to any number. But if you have a gesture assigned for two taps and one for three taps, both gestures will be triggered when performing a triple tap on the device.\\ |
| + | There are some [[software:gui-designer:tokens|tokens]] created by default which can be used in dynamic commands: | ||
| + | * ''[startx]'' and ''[x]'' = X position of the gesture. | ||
| + | * ''[starty]'' and ''[y]'' = Y position of the gesture. | ||
| ==== Presses ==== | ==== Presses ==== | ||
| - | Press gestures are a way to define multi-touch press actions. You can define the number of 'finger touches', just like with a Tap gesture. Press gestures fire as soon as the object is pressed. | + | Press gestures are a way to define multi-touch press actions. You can define the number of 'finger touches', just like with a Tap gesture. Press gestures fire as soon as the object is pressed.\\ |
| + | There are some [[software:gui-designer:tokens|tokens]] created by default which can be used in dynamic commands: | ||
| + | * ''[startx]'' and ''[x]'' = X position of the gesture. | ||
| + | * ''[starty]'' and ''[y]'' = Y position of the gesture. | ||
| ==== Swipes ==== | ==== Swipes ==== | ||
| - | Swipe gestures allow for quick swipes in up/down/left or right directions. The number of finger touches can be defined, from 1 to 10. A swipe gesture fires as soon as its detected. There is no beginning and end of a swipe. Swipes are great for quick volume control or lighting control. | + | Swipe gestures allow for quick swipes in up/down/left or right directions. The number of finger touches can be defined, from 1 to 10. A swipe gesture fires as soon as its detected. There is no beginning and end of a swipe. Swipes are great for quick volume control or lighting control.\\ |
| + | There are some [[software:gui-designer:tokens|tokens]] created by default which can be used in dynamic commands: | ||
| + | * ''[startx]'' = start X position of the gesture. | ||
| + | * ''[starty]'' = start Y position of the gesture. | ||
| + | * ''[x]'' = X position at the end of the gesture. | ||
| + | * ''[y]'' = Y position at the end of the gesture. | ||
| ==== Pinch Zoom ==== | ==== Pinch Zoom ==== | ||
| Line 60: | Line 70: | ||
| ==== Rotate ==== | ==== Rotate ==== | ||
| - | The rotate gesture uses two fingers and allows you to perform actions based on rotating two fingers like turning a knob on a control panel. Rotate could be used for precise volume control as an example. There are some tokens created by default which can be used in dynamic commands: | + | The rotate gesture uses two fingers and allows you to perform actions based on rotating two fingers like turning a knob on a control panel. Rotate could be used for precise volume control as an example. There are some [[software:gui-designer:tokens|tokens]] created by default which can be used in dynamic commands: |
| * ''[rotation]'' = angle in radians since the start of the gesture. This starts at 0 and increases as you rotate clockwise, decreases when rotating anti-clockwise. Use the rtod() math function to convert the radian value to degrees when required. | * ''[rotation]'' = angle in radians since the start of the gesture. This starts at 0 and increases as you rotate clockwise, decreases when rotating anti-clockwise. Use the rtod() math function to convert the radian value to degrees when required. | ||
| * ''[velocity]'' = rotation rate expressed in radians per second. | * ''[velocity]'' = rotation rate expressed in radians per second. | ||
| Line 72: | Line 82: | ||
| ==== Pan ==== | ==== Pan ==== | ||
| - | The pan gesture allows you to track finger movement on an object. This is similar to panning around a webpage is safari on an iPad. There are some tokens created by default which can be used in dynamic commands: | + | The pan gesture allows you to track finger movement on an object. This is similar to panning around a webpage is safari on an iPad. There are some [[software:gui-designer:tokens|tokens]] created by default which can be used in dynamic commands: |
| * ''[startx]'' = start X position of the centroid of the gesture. This is the X position at the point of the finger at the start of the gesture. | * ''[startx]'' = start X position of the centroid of the gesture. This is the X position at the point of the finger at the start of the gesture. | ||
| * ''[starty]'' = start Y position of the centroid of the gesture. This is the Y position at the point of the finger at the start of the gesture. | * ''[starty]'' = start Y position of the centroid of the gesture. This is the Y position at the point of the finger at the start of the gesture. | ||
| Line 79: | Line 89: | ||
| * ''[deltax]'' = the difference between the [startx] and [x] at any time in the gesture. | * ''[deltax]'' = the difference between the [startx] and [x] at any time in the gesture. | ||
| * ''[deltay]'' = the difference between the [starty] and [y] at any time in the gesture. | * ''[deltay]'' = the difference between the [starty] and [y] at any time in the gesture. | ||
| + | * ''[velocityx]'' = rate at which the fingers are moving horizontally. | ||
| + | * ''[velocityy]'' = rate at which the fingers are moving vertically. | ||
software/gui-designer/gestures.1356063292.txt.gz · Last modified: 2012/12/21 04:14 by jarrod
