Custom Gesture Designer

From RAD Studio
Jump to: navigation, search

Go Up to View Menu


To open the Custom Gesture Designer, do one of the following:

  • Click Create on the Custom Gestures dialog box. The Custom Gesture Designer opens with a blank gesture field.
  • Select one of your Recorded Gestures on the Custom Gestures dialog box and click Edit. The Custom Gesture Designer opens with the selected gesture in the edit field.

Allows you to draw, name, test, and record new gestures, and to edit existing recorded gestures. You can also add and delete points on the gesture line, and zoom in and out on the gesture. See Using Gesturing in Your Applications for further information about enabling your applications to use gestures.

Item Description

Name

Lists "Untitled" before you record a new gesture that you create on this dialog box. Enter a name here for a new gesture. To save the gesture you have created, click the Record gesture button. All your recorded gestures for an application are saved in the .dfm file and are listed on the Custom Gestures dialog box.

Sensitivity

Controls the allowable variation in the input of the gesture - that is, adjusts the required levels of deviation and margin of error that the gesture engine uses in verifying the selected gesture at run time. You can set the sensitivity for each gesture that you create. Setting higher sensitivity for a gesture means that the user must match the gesture more precisely than if the sensitivity is set lower. Default = 80%.

Unidirectional (single start point)

Indicates that the gesture in the edit field has one start point. All the Standard gestures are unidirectional. See TStandardGesture Enumeration.
Default = On.

Note: Gestures that have two start points are in the Vcl.Controls.TInteractiveGestureOptionenumeration - for example, igRotate and igTwoFingerTapRotate.

Points

Lists the X/Y coordinates of all the points on the line comprising the gesture you draw in the edit field. The X and Y axis begin and end at the endpoints of the gesture itself. You can add or delete points at the selection point using toolbar buttons. To change the shape of the gesture, you can:

  • Click-and-drag the line in the edit field.
  • Select a coordinate in the X or Y column and change the value.

<gesture edit field>

The large edit field on the Custom Gesture Designer allows you to draw custom gestures for your applications. You can edit the line of the gesture by click-and-drag or by changing X/Y coordinates in the Points list.

InsertPoint.png Insert point

Adds a new point on a straight line between the selection point (center of the red circle) and the previous point on the line (going back toward the point of origin). Adding points to a line increases the accuracy needed to replicate the gesture.

DeletePoint.png Delete point

Deletes a single point from the line of the gesture at the selection point (the center of the red circle), and draws a straight line between the next line on the gesture (going forward to the endpoint) and the previous point on the line.

ZoomIn.png Zoom in

Enlarges the view of the gesture for viewing and editing purposes.

ZoomOut.png Zoom out

Reduces the size of the gesture for viewing and editing purposes.

PlaySimulation.png Play simulation of gesture

Shows you the motion required to make the gesture in the edit field. A bold blue line starts at the start point of the gesture and moves to the end point.

RecordGesture.png Record gesture

Records the gesture drawn in the edit field using the name in the Name field. Gestures are associated with the current application and are saved in the .dfm file.

TestGestureCOLOR.png Test gesture

Allows you to test or practice entering the custom gesture. Displays the Test Gesture entry box with an animated round blue cursor demonstrating the movement required to make the gesture. The relative starting point to use for the gesture is also indicated. The following message is displayed:

Draw the gesture here using a mouse or touch screen

If you attempt to replicate the gesture, but your rendition falls outside the margin of deviation too many times (determined by the Sensitivity setting), the following message is displayed:

Gesture not recognized 

When you draw a gesture that matches the model, the following message appears:

Gesture recognized

ShowSensitivityCircles.png Show point sensitivity circles

Displays the sensitivity range for each point on the line as a pale green circle around each point. Larger sensitivity circles (lower Sensitivity settings) make it much easier for a user to replicate the gesture.

  • Reducing the Sensitivity for the gesture makes the sensitivity circles larger.
  • Increasing the Sensitivity makes the circles smaller.

ShowConflictDetails.png Show conflict details

When enabled, a conflict exists between the gesture you have drawn and another existing gesture. When you draw a gesture that has conflicts, a message appears:

Warning: <n> potential conflicts. Click here for details

Click the warning message and then the OK button. The Gesture Conflicts dialog box displays the name of the gesture that is similar to the one you drew, along with the percentage of likeness.

  • Increasing the Sensitivity on the Custom Gesture Designer can eliminate some conflicts.
  • Reducing the Sensitivity can cause additional conflicts.

See Also