1 <?xml version="1.0" encoding="utf-8"?> |
1 <?xml version="1.0" encoding="UTF-8"?> |
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
2 <!--Arbortext, Inc., 1988-2008, v.4002--> |
3 <!-- This component and the accompanying materials are made available under the terms of the License |
3 <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" |
4 "Eclipse Public License v1.0" which accompanies this distribution, |
4 "concept.dtd"> |
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
5 <concept id="GUID-C60DC070-572B-5960-B394-550426FDB909" xml:lang="en"> |
6 <!-- Initial Contributors: |
6 <title> Advanced Pointer Tutorial</title> |
7 Nokia Corporation - initial contribution. |
7 <shortdesc>This tutorial provides step-by-step instructions and sample |
8 Contributors: |
8 code to help you write applications using advanced pointers. </shortdesc> |
9 --> |
9 <prolog> |
10 <!DOCTYPE concept |
10 <metadata><keywords></keywords></metadata> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 </prolog> |
12 <concept id="GUID-C60DC070-572B-5960-B394-550426FDB909" xml:lang="en"><title> Advanced |
12 <conbody> |
13 Pointer Tutorial</title><shortdesc>This tutorial provides step-by-step instructions and sample code |
13 <p> <b>Variant</b>: <xref |
14 to help you write applications using advanced pointers. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">ScreenPlay</xref |
15 <p> <b>Variant</b>: <xref href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">ScreenPlay</xref>. <b>Target |
15 >. <b>Target audience</b>: Application developers. </p> |
16 audience</b>: Application developers. </p> |
16 <section><title>Required background </title> <p>This topic builds |
17 <section><title>Required background </title> <p>This topic builds on the material |
17 on the material in the following topics: </p> <ul> |
18 in the following topics: </p> <ul> |
18 <li id="GUID-C4209FBD-3860-5F4B-8458-87D22D483953"><p><xref |
19 <li id="GUID-C4209FBD-3860-5F4B-8458-87D22D483953"><p><xref href="GUID-9C269F45-F160-5A4B-ABF8-896D2A538E3B.dita">Advanced |
19 href="GUID-9C269F45-F160-5A4B-ABF8-896D2A538E3B.dita">Advanced Pointer |
20 Pointer Overview</xref> </p> </li> |
20 Overview</xref> </p> </li> |
21 <li id="GUID-9D3C3B31-F43A-5201-A1EC-A1F2848CFF43"><p><xref href="GUID-9AD75103-CD56-5279-B639-5CA2BBF979B5.dita">Advanced |
21 <li id="GUID-9D3C3B31-F43A-5201-A1EC-A1F2848CFF43"><p><xref |
22 Pointer States and Event Communication</xref> </p> </li> |
22 href="GUID-9AD75103-CD56-5279-B639-5CA2BBF979B5.dita">Advanced Pointer |
|
23 States and Event Communication</xref> </p> </li> |
23 </ul> </section> |
24 </ul> </section> |
24 <section><title>Using advanced pointers</title> <p>This topic covers the following: </p> <ul> |
25 <section><title>Using advanced pointers</title> <p>This topic covers |
25 <li id="GUID-C3AD43AA-09C0-5BA2-8496-5B87D40C89F5"><p><xref href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-8CBE862B-0C1D-5088-89B7-9B3EC898E4FC">Enabling multi-touch for a window</xref> </p> </li> |
26 the following: </p> <ul> |
26 <li id="GUID-177323F2-55C6-56D9-B3D2-A8DDACF69E10"><p><xref href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-C026DAB9-C11C-5D29-A1EA-6730E914250F">Getting Z coordinates from TPointerEvent</xref> </p> </li> |
27 <li id="GUID-C3AD43AA-09C0-5BA2-8496-5B87D40C89F5"><p><xref |
27 <li id="GUID-91CEA92C-A692-5853-96F0-625A76B7DC8D"><p><xref href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-B7057F69-191F-5AA4-8C61-EBECE66D92F6"> Pinch zooming</xref> </p> </li> |
28 href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-8CBE862B-0C1D-5088-89B7-9B3EC898E4FC" |
|
29 >Enabling multiple pointers in a window</xref> </p> </li> |
|
30 <li id="GUID-177323F2-55C6-56D9-B3D2-A8DDACF69E10"><p><xref |
|
31 href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-C026DAB9-C11C-5D29-A1EA-6730E914250F" |
|
32 >Getting Z coordinates from TPointerEvent</xref> </p> </li> |
|
33 <li id="GUID-91CEA92C-A692-5853-96F0-625A76B7DC8D"><p><xref |
|
34 href="GUID-C60DC070-572B-5960-B394-550426FDB909.dita#GUID-C60DC070-572B-5960-B394-550426FDB909/GUID-B7057F69-191F-5AA4-8C61-EBECE66D92F6" |
|
35 > Pinch zooming</xref> </p> </li> |
28 </ul> </section> |
36 </ul> </section> |
29 <section id="GUID-8CBE862B-0C1D-5088-89B7-9B3EC898E4FC"><title>Enabling multi-touch |
37 <section id="GUID-8CBE862B-0C1D-5088-89B7-9B3EC898E4FC"><title>Enabling |
30 in a window</title> <ol id="GUID-210D17A8-4869-5F9B-B71C-672101AC591C"> |
38 multiple pointers in a window</title> <ol |
31 <li id="GUID-81A2AC5C-7837-5216-8F47-FC5959C27522"><p> <xref href="GUID-637F82AF-0CF9-3C85-834D-7C1A0866DF87.dita"><apiname>RWindow</apiname></xref> provides |
39 id="GUID-210D17A8-4869-5F9B-B71C-672101AC591C"> |
32 a handle to a standard window. Call <codeph>RWindow</codeph> to create an |
40 <li id="GUID-81A2AC5C-7837-5216-8F47-FC5959C27522"><p> <xref |
33 instance of a window. </p> <codeblock id="GUID-0E31C3F6-3719-5F16-9F74-C405850604B8" xml:space="preserve"> |
41 href="GUID-637F82AF-0CF9-3C85-834D-7C1A0866DF87.dita"><apiname>RWindow</apiname |
|
42 ></xref> provides a handle to a standard window. Call <codeph>RWindow</codeph |
|
43 > to create an instance of a window. </p> <codeblock |
|
44 id="GUID-0E31C3F6-3719-5F16-9F74-C405850604B8" xml:space="preserve" |
|
45 > |
34 RWindow window(ws); |
46 RWindow window(ws); |
35 |
47 |
36 User::LeaveIfError(window.Construct(wg, reinterpret_cast<TUint32>(&wg) + 1)); |
48 User::LeaveIfError(window.Construct(wg, reinterpret_cast<TUint32>(&wg) + 1)); |
37 </codeblock> </li> |
49 </codeblock> </li> |
38 <li id="GUID-B67D3702-1A8F-5C6A-AB0F-FEA7C4D04A07"><p>Call <xref href="GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79.dita#GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79/GUID-05293539-F1B0-3C7D-BB14-3FD42F23D5C8"><apiname>RWindow::EnableAdvancedPointers()</apiname></xref> to |
50 <li id="GUID-B67D3702-1A8F-5C6A-AB0F-FEA7C4D04A07"><p>Call <xref |
39 enable advanced pointers. Then call <xref href="GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34.dita#GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34/GUID-4E02165A-DFCC-3D18-BB18-18726B28E90A"><apiname>RWindowBase::Activate()</apiname></xref> to |
51 href="GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79.dita#GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79/GUID-05293539-F1B0-3C7D-BB14-3FD42F23D5C8" |
40 display the window and enable the window to receive events. <xref href="GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79.dita"><apiname>RWindow</apiname></xref> inherits |
52 ><apiname>RWindow::EnableAdvancedPointers()</apiname></xref> to enable |
41 from <xref href="GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34.dita"><apiname>RWindowBase</apiname></xref>, so you can call the <codeph>Activate()</codeph> function |
53 advanced pointers. Then call <xref |
42 on <codeph>RWindow</codeph>. </p> <codeblock id="GUID-DB2FB570-2BB0-5C5F-9E4F-076D6A0E469E" xml:space="preserve"> |
54 href="GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34.dita#GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34/GUID-4E02165A-DFCC-3D18-BB18-18726B28E90A" |
|
55 ><apiname>RWindowBase::Activate()</apiname></xref> to display the |
|
56 window and enable the window to receive events. <xref |
|
57 href="GUID-683603DD-F3D3-3193-BEB3-8236C7DE7F79.dita"><apiname>RWindow</apiname |
|
58 ></xref> inherits from <xref |
|
59 href="GUID-1460DD8F-9AA1-3B99-8FFD-F309959CCA34.dita"><apiname>RWindowBase</apiname |
|
60 ></xref>, so you can call the <codeph>Activate()</codeph> function |
|
61 on <codeph>RWindow</codeph>. </p> <codeblock |
|
62 id="GUID-DB2FB570-2BB0-5C5F-9E4F-076D6A0E469E" xml:space="preserve" |
|
63 > |
43 window.EnableAdvancedPointers(); |
64 window.EnableAdvancedPointers(); |
44 window.Activate(); |
65 window.Activate(); |
45 </codeblock> <p>When an application needs to receive advanced pointer events |
66 </codeblock> <p>When an application needs to receive advanced pointer |
46 in a window, it must call <codeph>RWindowBase::EnableAdvancedPointers()</codeph> for |
67 events in a window, it must call <codeph>RWindowBase::EnableAdvancedPointers()</codeph |
47 the window <i>before</i> it is activated. </p> <p>If advanced pointers are |
68 > for the window <i>before</i> it is activated. </p> <p>If advanced |
48 not enabled for a window, it receives only standard <xref href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita"><apiname>TPointerEvent</apiname></xref> information |
69 pointers are not enabled f<?Pub Caret?>or a window, it receives only |
49 from a single pointer with no pressure and proximity data. The single pointer |
70 standard <xref href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita" |
50 environment rules describe the way in which pointer events coming from many |
71 ><apiname>TPointerEvent</apiname></xref> information from a single |
51 pointers in the multi-pointer model are transformed into events of one pointer. |
72 pointer with no pressure and proximity data. The single pointer environment |
52 They are necessary to ensure that old single-pointer applications work in |
73 rules describe the way in which pointer events coming from many pointers |
53 a multi-touch environment intuitively and as expected by the user. </p> <p>However, |
74 in the multiple pointer model are transformed into events of one pointer. |
54 the new <codeph>TPointerEvent</codeph> types, <xref href="GUID-239D0A8B-2759-321D-AD48-976E80192239.dita"><apiname>EEnterCloseProximity</apiname></xref>, <xref href="GUID-8C6264B4-5E19-33A7-92B0-BB79C871BEC7.dita"><apiname>EExitCloseProximity</apiname></xref>, <xref href="GUID-F02DB96E-1541-3223-9B7B-79D45840DB7B.dita"><apiname>EEnterHighPressure</apiname></xref> and <xref href="GUID-15B5991C-B075-3110-B0A4-540EC282AA56.dita"><apiname>EExitHighPressure</apiname></xref>, are delivered to all windows, |
75 They are necessary to ensure that old single-pointer applications |
55 even to those that do not enable advanced pointers. </p> </li> |
76 work in a multiple pointer environment intuitively and as expected |
|
77 by the user. </p> <p>However, the new <codeph>TPointerEvent</codeph |
|
78 > types, <xref href="GUID-239D0A8B-2759-321D-AD48-976E80192239.dita" |
|
79 ><apiname>EEnterCloseProximity</apiname></xref>, <xref |
|
80 href="GUID-8C6264B4-5E19-33A7-92B0-BB79C871BEC7.dita"><apiname>EExitCloseProximity</apiname |
|
81 ></xref>, <xref href="GUID-F02DB96E-1541-3223-9B7B-79D45840DB7B.dita" |
|
82 ><apiname>EEnterHighPressure</apiname></xref> and <xref |
|
83 href="GUID-15B5991C-B075-3110-B0A4-540EC282AA56.dita"><apiname>EExitHighPressure</apiname |
|
84 ></xref>, are delivered to all windows, even to those that do not |
|
85 enable advanced pointers. </p> </li> |
56 </ol> </section> |
86 </ol> </section> |
57 <section id="GUID-C026DAB9-C11C-5D29-A1EA-6730E914250F"><title>Getting Z coordinates |
87 <section id="GUID-C026DAB9-C11C-5D29-A1EA-6730E914250F"><title>Getting |
58 from TPointerEvent</title> <ol id="GUID-4CC2271D-1798-51B3-9A9D-E7E0B9A33DAE"> |
88 Z coordinates from TPointerEvent</title> <ol |
59 <li id="GUID-184B5B63-4EFC-55CD-8D1F-E015EEBACBE2"><p>Call <xref href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita#GUID-1FFA0073-3D83-388E-A824-08C31F90CC54/GUID-E961DA4D-AD38-31F0-88DD-A07D36346DCB"><apiname>TPointerEvent::AdvancedPointerEvent()</apiname></xref> on |
89 id="GUID-4CC2271D-1798-51B3-9A9D-E7E0B9A33DAE"> |
60 a <codeph>TPointerEvent</codeph> to return a pointer to a <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita"><apiname>TAdvancedPointerEvent</apiname></xref>. </p> <codeblock id="GUID-6E81680A-3070-546B-B575-49EA9E34FAF9" xml:space="preserve"> |
90 <li id="GUID-184B5B63-4EFC-55CD-8D1F-E015EEBACBE2"><p>Call <xref |
|
91 href="GUID-1FFA0073-3D83-388E-A824-08C31F90CC54.dita#GUID-1FFA0073-3D83-388E-A824-08C31F90CC54/GUID-E961DA4D-AD38-31F0-88DD-A07D36346DCB" |
|
92 ><apiname>TPointerEvent::AdvancedPointerEvent()</apiname></xref> on |
|
93 a <codeph>TPointerEvent</codeph> to return a pointer to a <xref |
|
94 href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita"><apiname>TAdvancedPointerEvent</apiname |
|
95 ></xref>. </p> <codeblock id="GUID-6E81680A-3070-546B-B575-49EA9E34FAF9" |
|
96 xml:space="preserve"> |
61 TZType aZType; |
97 TZType aZType; |
62 TPointerEvent& aPointerEvent; |
98 TPointerEvent& aPointerEvent; |
63 TInt* aZ; |
99 TInt* aZ; |
64 TInt* aPoint3D; |
100 TInt* aPoint3D; |
65 |
101 |
66 TAdvancedPointerEvent *advancedP = aPointerEvent.AdvancedPointerEvent(); |
102 TAdvancedPointerEvent *advancedP = aPointerEvent.AdvancedPointerEvent(); |
67 </codeblock> <p> <codeph>TPointerEvent</codeph> is a struct that contains |
103 </codeblock> <p> <codeph>TPointerEvent</codeph> is a struct that contains |
68 details of a pointer event. <codeph>TZType</codeph> is a struct provided by |
104 details of a pointer event. <codeph>TZType</codeph> is a struct provided |
69 the programmer containing members to hold proximity, pressure, and "proximity |
105 by the programmer containing members to hold proximity, pressure, |
70 and pressure" data. </p> </li> |
106 and "proximity and pressure" data. </p> </li> |
71 <li id="GUID-ABA8FA09-5F57-51BC-8CAE-43649B5ED6D3"><p>Now we need to test |
107 <li id="GUID-ABA8FA09-5F57-51BC-8CAE-43649B5ED6D3"><p>Now we need |
72 whether the pointer event contains advanced pointer data. If it is not an |
108 to test whether the pointer event contains advanced pointer data. |
73 advanced pointer, the code leaves. </p> <p>If it is an advanced pointer, we |
109 If it is not an advanced pointer, the code leaves. </p> <p>If it is |
74 call functions to detect proximity, pressure, "proximity and pressure" data |
110 an advanced pointer, we call functions to detect proximity, pressure, |
75 and coordinates. </p> <codeblock id="GUID-DF109643-2564-51A0-B0F6-33BF4DA1F6E3" xml:space="preserve"> |
111 "proximity and pressure" data and coordinates. </p> <codeblock |
|
112 id="GUID-DF109643-2564-51A0-B0F6-33BF4DA1F6E3" xml:space="preserve" |
|
113 > |
76 if(!advancedP) |
114 if(!advancedP) |
77 { |
115 { |
78 // The TPointerEvent isn't an instance of TAdvancedPointerEvent |
116 // The TPointerEvent isn't an instance of TAdvancedPointerEvent |
79 User::Leave(KErrArgument); |
117 User::Leave(KErrArgument); |
80 } |
118 } |
81 |
119 |
82 switch(aZType) |
120 switch(aZType) |
83 { |
121 { |
84 case EZTypeProximity: |
122 case EZTypeProximity: |
85 aZ = advancedP->Proximity(); |
123 aZ = advancedP->Proximity(); |
86 aPoint3D = advancedP->Proximity3D(); |
124 aPoint3D = advancedP->Proximity3D(); |
87 break; |
125 break; |
88 case EZTypePressure: |
126 case EZTypePressure: |
89 aZ = advancedP->Pressure(); |
127 aZ = advancedP->Pressure(); |
90 aPoint3D = advancedP->Pressure3D(); |
128 aPoint3D = advancedP->Pressure3D(); |
91 break; |
129 break; |
92 case EZTypeProximityAndPressure: |
130 case EZTypeProximityAndPressure: |
93 aZ = advancedP->ProximityAndPressure(); |
131 aZ = advancedP->ProximityAndPressure(); |
94 aPoint3D = advancedP->ProximityAndPressure3D(); |
132 aPoint3D = advancedP->ProximityAndPressure3D(); |
95 break; |
133 break; |
96 default: |
134 default: |
97 User::Leave(KErrArgument); |
135 User::Leave(KErrArgument); |
98 break; |
136 break; |
99 } |
137 } |
100 </codeblock> <ul> |
138 </codeblock> <ul> |
101 <li id="GUID-40C01884-AC86-5882-935D-2EC2E27C9004"><p> <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-0ED4B1CC-0655-3246-8645-AAC9E0C27298"><apiname>TAdvancedPointerEvent::Proximity()</apiname></xref> returns |
139 <li id="GUID-40C01884-AC86-5882-935D-2EC2E27C9004"><p> <xref |
|
140 href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-0ED4B1CC-0655-3246-8645-AAC9E0C27298" |
|
141 ><apiname>TAdvancedPointerEvent::Proximity()</apiname></xref> returns |
102 the proximity. </p> </li> |
142 the proximity. </p> </li> |
103 <li id="GUID-16A9A86B-A837-5E43-BB3A-F5A04A7F4552"><p> <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-15DEBFBF-7B7D-3FCF-9929-C973824A5FD3"><apiname>TAdvancedPointerEvent::Pressure()</apiname></xref> returns |
143 <li id="GUID-16A9A86B-A837-5E43-BB3A-F5A04A7F4552"><p> <xref |
|
144 href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-15DEBFBF-7B7D-3FCF-9929-C973824A5FD3" |
|
145 ><apiname>TAdvancedPointerEvent::Pressure()</apiname></xref> returns |
104 the pressure. </p> </li> |
146 the pressure. </p> </li> |
105 <li id="GUID-3E614890-C317-596E-A5B9-FD76426DBD12"><p> <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-114AE77E-D0BD-321E-BFCB-1388B35582EC"><apiname>TAdvancedPointerEvent::ProximityAndPressure()</apiname></xref> returns |
147 <li id="GUID-3E614890-C317-596E-A5B9-FD76426DBD12"><p> <xref |
106 the proximity and pressure combined. </p> </li> |
148 href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-114AE77E-D0BD-321E-BFCB-1388B35582EC" |
107 <li id="GUID-6F62C0D1-FAE4-5F8F-B451-68ABA404A369"><p> <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-E5AA7737-D217-3FDE-9E4D-AAA7F5D2C300"><apiname>TAdvancedPointerEvent:: |
149 ><apiname>TAdvancedPointerEvent::ProximityAndPressure()</apiname></xref |
108 Position3D()</apiname></xref> returns the proximity and the X, Y and Z coordinates. </p> </li> |
150 > returns the proximity and pressure combined. </p> </li> |
109 <li id="GUID-5AD1811D-BCBF-5A44-B6E7-EB71BF254BCA"><p> <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-2F30A8F5-75BA-3FE3-84B7-3C772ED75857"><apiname>TAdvancedPointerEvent::Pressure3D()</apiname></xref> returns |
151 <li id="GUID-6F62C0D1-FAE4-5F8F-B451-68ABA404A369"><p> <xref |
|
152 href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-E5AA7737-D217-3FDE-9E4D-AAA7F5D2C300" |
|
153 ><apiname>TAdvancedPointerEvent:: Position3D()</apiname></xref> returns |
|
154 the proximity and the X, Y and Z coordinates. </p> </li> |
|
155 <li id="GUID-5AD1811D-BCBF-5A44-B6E7-EB71BF254BCA"><p> <xref |
|
156 href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-2F30A8F5-75BA-3FE3-84B7-3C772ED75857" |
|
157 ><apiname>TAdvancedPointerEvent::Pressure3D()</apiname></xref> returns |
110 the pressure and the X and Y coordinates. </p> </li> |
158 the pressure and the X and Y coordinates. </p> </li> |
111 </ul> <p>Proximity is <i>always</i> negative and pressure is <i>always</i> positive. |
159 </ul> <p>Proximity is <i>always</i> negative and pressure is <i>always</i |
112 Internally they are combined together as a Z coordinate. When Z > 0, the proximity |
160 > positive. Internally they are combined together as a Z coordinate. |
113 is 0 and the Z value represents the pressure. When Z < 0, the pressure |
161 When Z > 0, the proximity is 0 and the Z value represents the pressure. |
114 is 0 and the Z value represents the proximity. Some APIs use only a Z coordinate |
162 When Z < 0, the pressure is 0 and the Z value represents the proximity. |
115 (such as the threshold getters and setters and <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-114AE77E-D0BD-321E-BFCB-1388B35582EC"><apiname>TAdvancedPointerEvent::ProximityAndPressure()</apiname></xref>). |
163 Some APIs use only a Z coordinate (such as the threshold getters and |
116 In these, the Z coordinate is interpreted in terms of pressure and proximity. </p> </li> |
164 setters and <xref |
|
165 href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-114AE77E-D0BD-321E-BFCB-1388B35582EC" |
|
166 ><apiname>TAdvancedPointerEvent::ProximityAndPressure()</apiname></xref |
|
167 >). In these, the Z coordinate is interpreted in terms of pressure |
|
168 and proximity. </p> </li> |
117 </ol> <fig id="GUID-7A49B143-5458-5916-B937-55D98B77BB2C"> |
169 </ol> <fig id="GUID-7A49B143-5458-5916-B937-55D98B77BB2C"> |
118 <title> Relationships between the pointer proximity, pressure and Z |
170 <title> Relationships between the pointer proximity, pressure and |
119 coordinate </title> |
171 Z coordinate </title> |
120 <image href="GUID-1A0FB98B-8DB3-5067-9B71-FF838F6AE402_d0e241047_href.png" placement="inline"/> |
172 <image |
121 </fig> </section> |
173 href="GUID-1A0FB98B-8DB3-5067-9B71-FF838F6AE402_d0e241047_href.png" |
122 <section id="GUID-B7057F69-191F-5AA4-8C61-EBECE66D92F6"><title>Pinch zooming</title> <p>This |
174 placement="inline"></image></fig> </section> |
123 example shows an easy way to pinch zoom an image when the screen receives |
175 <section id="GUID-B7057F69-191F-5AA4-8C61-EBECE66D92F6"><title>Pinch |
124 pointer events from two pointers. There are two functions in this code that |
176 zooming</title> <p>This example shows an easy way to pinch zoom an |
125 must be implemented by the programmer: <codeph>BitmapCoordinates()</codeph> and <codeph>MoveBitmap()</codeph>. |
177 image when the screen receives pointer events from two pointers. There |
126 They are not included in the example because they involve complex calculations |
178 are two functions in this code that must be implemented by the programmer: <codeph |
127 that are not related to advanced pointers. </p> <p>The high-level steps to |
179 >BitmapCoordinates()</codeph> and <codeph>MoveBitmap()</codeph>. They |
128 perform pinch zooming are: </p> <ol id="GUID-AEF3917C-AAFE-5C25-9609-396D08478AC0"> |
180 are not included in the example because they involve complex calculations |
|
181 that are not related to advanced pointers. </p> <p>The high-level |
|
182 steps to perform pinch zooming are: </p> <ol |
|
183 id="GUID-AEF3917C-AAFE-5C25-9609-396D08478AC0"> |
129 <li id="GUID-7839E665-C4E1-59C8-BA89-22A62615EFA3"><p>Define the coordinates, |
184 <li id="GUID-7839E665-C4E1-59C8-BA89-22A62615EFA3"><p>Define the coordinates, |
130 equivalent to the given on-screen coordinates. In the code example, this is |
185 equivalent to the given on-screen coordinates. In the code example, |
131 done using the function <codeph>BitmapCoordinates()</codeph>. </p> </li> |
186 this is done using the function <codeph>BitmapCoordinates()</codeph |
132 <li id="GUID-FC4B1BDA-8120-53C9-9C88-BEFEF1AD54B4"><p>Define the ID of the |
187 >. </p> </li> |
133 pointer by using <xref href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-67593D7E-CE40-303F-B847-81D6FC0578B1"><apiname>TAdvancedPointerEvent::PointerNumber()</apiname></xref>. |
188 <li id="GUID-FC4B1BDA-8120-53C9-9C88-BEFEF1AD54B4"><p>Define the ID |
134 If the device can handle two pointers (two fingers) at the same time, their |
189 of the pointer by using <xref |
135 numbers are 0 and 1. The pointer number enables you to distinguish a given |
190 href="GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023.dita#GUID-FADA3278-FF8B-308F-90AD-3DCF8911A023/GUID-67593D7E-CE40-303F-B847-81D6FC0578B1" |
136 pointer from other pointers. </p> </li> |
191 ><apiname>TAdvancedPointerEvent::PointerNumber()</apiname></xref>. |
137 <li id="GUID-1E8F7D23-EEAD-5EA5-8863-276076D6B54E"><p>For each pointer assign |
192 If the device can handle two pointers (two fingers) at the same time, |
138 its coordinates to a local variable. We assume there are only two pointers |
193 their numbers are 0 and 1. The pointer number enables you to distinguish |
139 handled by the system here. </p> </li> |
194 a given pointer from other pointers. </p> </li> |
140 <li id="GUID-E44B3D9B-560A-5959-996D-A63CBD4C3786"><p>Use the <codeph>MoveBitmap()</codeph> function |
195 <li id="GUID-1E8F7D23-EEAD-5EA5-8863-276076D6B54E"><p>For each pointer |
141 to achieve the zoom effect. </p> <codeblock id="GUID-D85CCFDD-8F65-530A-ACD7-93DD1D435FC6" xml:space="preserve"> |
196 assign its coordinates to a local variable. We assume there are only |
|
197 two pointers handled by the system here. </p> </li> |
|
198 <li id="GUID-E44B3D9B-560A-5959-996D-A63CBD4C3786"><p>Use the <codeph |
|
199 >MoveBitmap()</codeph> function to achieve the zoom effect. </p> <codeblock |
|
200 id="GUID-D85CCFDD-8F65-530A-ACD7-93DD1D435FC6" xml:space="preserve" |
|
201 > |
142 /** |
202 /** |
143 Receives pointer events from two pointers to perform Pinch Zoom of the image. |
203 Receives pointer events from two pointers to perform Pinch Zoom of the image. |
144 Function will finish when EButton1Up is received for any of the pointers. |
204 Function will finish when EButton1Up is received for any of the pointers. |
145 @param aPointer1 Coordinates of pointer number 1 when zoom is started |
205 @param aPointer1 Coordinates of pointer number 1 when zoom is started |
146 @param aPointer2 Coordinates of pointer number 2 when zoom is started |
206 @param aPointer2 Coordinates of pointer number 2 when zoom is started |