OnTouchDelta

Use the sub-routine OnTouchDelta in VBScript to perform an action each time the user manipulates the project screen or screen object.

Syntax

  Sub OnTouchDelta(x,y,deltaX,deltaY,deltaScale,deltaExpansion,deltaRotation,cumulativeX,cumulativeY,cumulativeScale,cumulativeExpansion,cumulativeRotation,inertiaEnabled)      …  End Sub  
x
The current x-coordinate (in pixels from the left of the screen) of the first touch point.
y
The current y-coordinate (in pixels from the top of the screen) of the first touch point.
deltaX
The change (in pixels) between the previous x-coordinate and the current x-coordinate of the first touch point.
deltaY
The change (in pixels) between the previous y-coordinate and the current y-coordinate of the first touch point.
deltaScale
The change (as a percentage) in the distance between the first and second touch points.
deltaExpansion
The change (in pixels) in the distance between the first and second touch points.
deltaRotation
The change in the angle of rotation (in radians) indicated by the first and second touch points.
cumulativeX
The total change (in pixels) between the starting x-coordinate and the current x-coordinate of the first touch point.
cumulativeY
The total change (in pixels) between the starting y-coordinate and the current y-coordinate of the first touch point.
cumulativeScale
The total change (as a percentage) in the distance between the first and second touch points, from the start of the manipulation.
cumulativeExpansion
The total change (in pixels) in the distance between the first and second touch points, from the start of the manipulation.
cumulativeRotation
The total change in the angle of rotation (in radians) indicated by the first and second touch points, from the start of the manipulation.
inertiaEnabled
A boolean value indicating whether inertia is enabled for the project screen or screen object.

Returned value

This is a sub-routine (as opposed to a function) in VBScript, so it does not return any value.

Notes

This sub-routine is based on the method ManipulationDelta in the Windows API. For more information, go to “Windows Touch Input” on the Microsoft Developer Network website at: msdn.microsoft.com/library/dd317321.aspx

The sub-routine is executed once for each discrete movement in the current manipulation. Changes in position require one touch point. Changes in size and/or rotation require two touch points.

You are not required to use the received parameters in your code. They simply make the raw touch input data available to you, for you to use (or not) as you deem necessary.

OnTouchDelta