8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-17C64C2F-9426-4B41-9F0A-23060289D644" xml:lang="en"><title>Multi-touch</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
12 <concept id="GUID-17C64C2F-9426-4B41-9F0A-23060289D644" xml:lang="en"><title>Multi-touch</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
13 <p>Multi-touch is an enhancement to the touch screen, which provides the user |
13 <p>Multi-touch is an enhancement to the touch screen, which provides |
14 with the ability to apply elaborate finger gestures onto the display as commands |
14 the user with the ability to apply elaborate finger gestures onto |
15 to the device.</p> |
15 the display as commands to the device.</p> |
16 <p>Multi-touch is implemented based on the size and type of interfaces. When |
16 <p>Multi-touch is implemented based on the size and type of interfaces. |
17 a finger or an object touches the display causing the light to scatter, the |
17 When a finger or an object touches the display causing the light to |
18 reflection is caught by the sensors. The response for the touch is sent back |
18 scatter, the reflection is caught by the sensors. The response for |
19 based on the type of reflection measured.</p> |
19 the touch is sent back based on the type of reflection measured.</p> |
20 <p>Only the devices with multi-touch support have 'Pinch Stroke' as a touch |
20 <p>Only the devices with multi-touch support have 'Pinch Stroke' as |
21 stroke.</p> |
21 a touch stroke.</p> |
22 <section id="GUID-7AECBBDD-8583-4555-A2F3-83404CBC64C1"><title>Pinch Stroke</title>Pinch |
22 <section id="GUID-7AECBBDD-8583-4555-A2F3-83404CBC64C1"><title>Pinch |
23 stroke is invoked by two separate but simultaneously active touch down events |
23 Stroke</title>Pinch stroke is invoked by two separate but simultaneously |
24 and dragging movements along the line that goes through both touch down points. |
24 active touch down events and dragging movements along the line that |
25 On release, the pinch in or pinch out state is maintained. Pinch stroke can |
25 goes through both touch down points. On release, the pinch in or pinch |
26 be utilized, for example, in Photo viewer to zoom in and zoom out.<fig id="GUID-93C93C51-1F0D-4ADE-8FEC-3223B9C9F60B"> |
26 out state is maintained. Pinch stroke can be utilized, for example, |
27 <image href="GUID-22498580-E902-4024-921C-F756A8CD58DF_d0e75600_href.png" placement="inline"/> |
27 in Photo viewer to zoom in and zoom out.<fig id="GUID-93C93C51-1F0D-4ADE-8FEC-3223B9C9F60B"> |
28 </fig><p>The following table lists the default touch-events for pinch-stroke:</p><table id="GUID-D5917E40-42B1-461B-8722-C7AD66482078-GENID-1-8-1-6-1-1-6-2-1-5-1-1-7-1-2-4-4"><title>Default touch events |
28 <image href="GUID-22498580-E902-4024-921C-F756A8CD58DF_d0e70545_href.png" placement="inline"/> |
29 for pinch-stroke</title> |
29 </fig><p>The following table lists the default touch-events for pinch-stroke:</p><table id="GUID-D5917E40-42B1-461B-8722-C7AD66482078-GENID-1-10-1-6-1-1-6-2-1-5-1-1-6-1-2-4-4"><title>Default |
|
30 touch events for pinch-stroke</title> |
30 <tgroup cols="3"><colspec colname="col1" colwidth="0.68*"/><colspec colname="col2" colwidth="1.00*"/><colspec colname="col3" colwidth="1.32*"/> |
31 <tgroup cols="3"><colspec colname="col1" colwidth="0.68*"/><colspec colname="col2" colwidth="1.00*"/><colspec colname="col3" colwidth="1.32*"/> |
31 <thead> |
32 <thead> |
32 <row> |
33 <row> |
33 <entry valign="top"><p>User action</p></entry> |
34 <entry valign="top"><p>User action</p></entry> |
34 <entry valign="top"><p>State change</p></entry> |
35 <entry valign="top"><p>State change</p></entry> |
38 <tbody> |
39 <tbody> |
39 <row> |
40 <row> |
40 <entry><p>First touch down</p></entry> |
41 <entry><p>First touch down</p></entry> |
41 <entry><p>No action.</p></entry> |
42 <entry><p>No action.</p></entry> |
42 <entry><p>Tactile: <ul> |
43 <entry><p>Tactile: <ul> |
43 <li><p>First touch down tactile feedback follows the context-based feedback. </p></li> |
44 <li><p>First touch down tactile feedback follows the context-based |
|
45 feedback. </p></li> |
44 <li><p>Audio feedback is provided with touch down.</p></li> |
46 <li><p>Audio feedback is provided with touch down.</p></li> |
45 </ul></p></entry> |
47 </ul></p></entry> |
46 </row> |
48 </row> |
47 <row> |
49 <row> |
48 <entry><p>Second simultaneous touch down</p></entry> |
50 <entry><p>Second simultaneous touch down</p></entry> |
49 <entry><p>Activates multi-touch mode for the content defined.</p></entry> |
51 <entry><p>Activates multi-touch mode for the content defined.</p></entry> |
50 <entry><p>Tactile: <ul> |
52 <entry><p>Tactile: <ul> |
51 <li><p>When second finger is touched down multi-touch recognition, two sensitive |
53 <li><p>When second finger is touched down multi-touch recognition, |
52 pulses effect is provided.</p></li> |
54 two sensitive pulses effect is provided.</p></li> |
53 <li><p>Audio feedback is provided with touch down.</p></li> |
55 <li><p>Audio feedback is provided with touch down.</p></li> |
54 </ul></p></entry> |
56 </ul></p></entry> |
55 </row> |
57 </row> |
56 <row> |
58 <row> |
57 <entry><p>Pinch in</p></entry> |
59 <entry><p>Pinch in</p></entry> |
58 <entry><p>Moving the touch points (directly) closer to each other is recognized |
60 <entry><p>Moving the touch points (directly) closer to each other |
59 as pinch in. Application can use it, for example, for zooming out a picture. |
61 is recognized as pinch in. Application can use it, for example, for |
60 The behavior should be in relation to the speed and size of the stroke.</p></entry> |
62 zooming out a picture. The behavior should be in relation to the speed |
61 <entry><p>Tactile: Smooth pinch effect is provided while moving the fingers. </p><p>No |
63 and size of the stroke.</p></entry> |
62 audio feedback is provided.</p></entry> |
64 <entry><p>Tactile: Smooth pinch effect is provided while moving the |
|
65 fingers. </p><p>No audio feedback is provided.</p></entry> |
63 </row> |
66 </row> |
64 <row> |
67 <row> |
65 <entry><p>Pinch out</p></entry> |
68 <entry><p>Pinch out</p></entry> |
66 <entry><p>Moving the touch points (directly) away from each other is recognized |
69 <entry><p>Moving the touch points (directly) away from each other |
67 as pinch out. Application can use it, for example, for zooming in a picture. |
70 is recognized as pinch out. Application can use it, for example, for |
68 The behavior should be in relation to the speed and size of the stroke.</p></entry> |
71 zooming in a picture. The behavior should be in relation to the speed |
69 <entry><p>Tactile: Smooth pinch effect is provided while moving the fingers. </p><p>No |
72 and size of the stroke.</p></entry> |
70 audio feedback is provided.</p></entry> |
73 <entry><p>Tactile: Smooth pinch effect is provided while moving the |
|
74 fingers. </p><p>No audio feedback is provided.</p></entry> |
71 </row> |
75 </row> |
72 <row> |
76 <row> |
73 <entry><p>Touch release</p></entry> |
77 <entry><p>Touch release</p></entry> |
74 <entry><p>Releasing one or both fingers stops the pinch.</p></entry> |
78 <entry><p>Releasing one or both fingers stops the pinch.</p></entry> |
75 <entry><p>No tactile or audio feedback given.</p></entry> |
79 <entry><p>No tactile or audio feedback given.</p></entry> |
76 </row> |
80 </row> |
77 </tbody> |
81 </tbody> |
78 </tgroup> |
82 </tgroup> |
79 </table></section> |
83 </table></section> |
|
84 <section id="GUID-C9D46D3B-B1D0-45C7-8A9F-FCF82653D78F"><title>Using multi-touch in applications</title>For multi-touch, |
|
85 use classes <xref href="GUID-668CEA36-3933-3BBE-A980-CAB62617B4FD.dita"><apiname>TRawEvent</apiname></xref> and <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita"><apiname>TAdvancedPointerEvent</apiname></xref> (which extends <xref href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita"><apiname>TPointerEvent</apiname></xref>). For more information, |
|
86 see <xref href="GUID-A12A66ED-2C8F-5CE6-8F3E-332B045A35B4.dita">Advanced |
|
87 pointers</xref> section.</section> |
80 </conbody></concept> |
88 </conbody></concept> |