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