|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-930F1E88-2A03-4BD1-AA2A-3A0128A844BD" xml:lang="en"><title>Enabling |
|
13 Multi-Touch in the Emulator Tutorial</title><shortdesc>This topic describes how to configure the Symbian emulator to enable |
|
14 a multi-touch environment. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <p><b>Variant</b>: <xref href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">ScreenPlay</xref>. <b>Target |
|
16 audience</b>: Application developers. </p> |
|
17 <p>This topic builds on <xref href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita">Multi-Touch |
|
18 Support in the Emulator Overview</xref>.</p> |
|
19 <section id="GUID-4F4F8E71-517D-4C5D-96A4-BB17CD49FD4C"> <title>Configuring |
|
20 the emulator</title> <p>Make sure that two or more mice are plugged in and |
|
21 detected on the Windows PC on which the emulator will run. The number of |
|
22 detected mice can be from two up to the maximum number defined in the HAL <codeph>HALData::EPointerMaxPointers</codeph> attribute. </p><ol> |
|
23 <li id="GUID-63F317A2-E4EA-48BD-8F2B-40B54BF35EC6"><p>Add the following lines |
|
24 to the <filepath>\epoc32\data\epoc.ini</filepath> file. These lines enable |
|
25 ScreenPlay and multi-touch.</p><codeblock xml:space="preserve">SYMBIAN_BASE_USE_GCE ON |
|
26 EnableMultiTouch ON</codeblock></li> |
|
27 <li id="GUID-CA823DAB-C8C4-4E09-8491-0C0BCD57BAE4"><p>Specify the <codeph>MultiTouchProximityStep</codeph> and <codeph>MultiTouchPressureStep</codeph> values in the <filepath>\epoc32\data\epoc.ini</filepath> file to define |
|
28 the proximity and pressure steps.</p><codeblock xml:space="preserve">MultiTouchProximityStep 10 |
|
29 MultiTouchPressureStep 200 |
|
30 </codeblock><p>If the above two options are not defined in the <filepath>epoc.ini</filepath> file, |
|
31 the default proximity and pressure steps are taken from the following HAL |
|
32 attributes.</p><codeblock xml:space="preserve">HALData::EPointer3DProximityStep |
|
33 HALData::EPointer3DPressureStep</codeblock></li> |
|
34 </ol><p><b>Result</b>: Launch the emulator to verify that the mice are detected |
|
35 and displayed inside the application window area. When you move a mouse or |
|
36 scroll the mouse wheel, its X, Y and Z values are reflected in the status |
|
37 bar.</p> </section> |
|
38 <section id="GUID-44C3561D-92A1-421E-9AD3-0D8648919C46-GENID-1-8-1-12-1-1-7-1-5-1-6-1-8-1-9-1-8-1-6-1-3-4"> <title>Enabling |
|
39 and disabling multi-touch</title><p>Multi-touch is only required by UI applications. |
|
40 Therefore, multi-touch is enabled inside the orange rectangular area shown |
|
41 on the following diagram. Inside the area two Windows pointers are displayed. |
|
42 The one numbered zero is the system pointer and the other is used only for |
|
43 multi-touch purposes. The first mouse to report events to the emulator is |
|
44 automatically taken as the primary mouse, which owns the Windows system pointer.</p><fig id="GUID-C62E31A2-65F8-4976-A3A9-058BFE3D30D3"> |
|
45 <title>Multi-touch area</title> |
|
46 <image href="GUID-FD0593E7-A36C-4656-A85A-9D62DFBCC42F_d0e199268_href.png" placement="inline"/> |
|
47 </fig><p><b>System pointer</b>. Once the system pointer moves outside multi-touch |
|
48 area, multi-touch is temporarily disabled and standard emulator pointer behavior |
|
49 is resumed. This means that only one Windows system pointer is displayed and |
|
50 it is controlled by both mice.</p> <p><b>Non-system pointer</b>. If the |
|
51 non-system pointer moves out of the multi-touch area, the pointer just disappears |
|
52 from the screen. Disabling multi-touch is then not necessary because the system |
|
53 pointer behaves normally inside the multi-touch area. Moving the non-system |
|
54 pointer back into the area makes it reappear on the screen.</p> </section> |
|
55 </conbody><related-links> |
|
56 <link href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita"><linktext>Multi-Touch |
|
57 Support in the Emulator Overview</linktext></link> |
|
58 </related-links></concept> |