(Touch → Spatial → Rotate → Five Point Rotate Gesture “5-Finger-Rotate”)

The f-finger-Rotate gesture is designed to provide object rotation functionality using any number of touch points. It is considered to be one of the three fundamental object manipulation gestures.

When five touch points are recognized on a touch object the relative orientation of the touch points are tracked and grouped into a cluster. This change in the orientation of the cluster is mapped directly to the rotation of the touch object.

<Gesture id="5-finger-rotate" type="rotate">
    <match>
        <action>
            <initial>
                <cluster point_number="5"/>
            </initial>
        </action>
    </match>
    <analysis>
        <algorithm>
            <library module="rotate"/>
            <returns>
                <property id="rotate_dtheta" result="dtheta"/>
            </returns>
        </algorithm>
    </analysis>    
    <mapping>
        <update dispatch_type="continuous">
            <gesture_event type="rotate">
                <property ref="rotate_dtheta" target="rotate"/>
            </gesture_event>
        </update>
    </mapping>
</Gesture>