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