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-930F1E88-2A03-4BD1-AA2A-3A0128A844BD" xml:lang="en"> |
6 <!-- Initial Contributors: |
6 <title>Enabling Multi<?Pub Caret?>ple Pointers in the Emulator Tutorial</title> |
7 Nokia Corporation - initial contribution. |
7 <shortdesc>This topic describes how to configure the Symbian emulator |
8 Contributors: |
8 to enable a multiple pointer environment. </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-930F1E88-2A03-4BD1-AA2A-3A0128A844BD" xml:lang="en"><title>Enabling |
12 <conbody> |
13 Multi-Touch in the Emulator Tutorial</title><shortdesc>This topic describes how to configure the Symbian emulator to enable |
13 <p><b>Variant</b>: <xref |
14 a multi-touch environment. </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 <p>This topic builds on <xref |
17 <p>This topic builds on <xref href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita">Multi-Touch |
17 href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita">Support for |
18 Support in the Emulator Overview</xref>.</p> |
18 Multiple Pointers in the Emulator Overview</xref>.</p> |
19 <section id="GUID-4F4F8E71-517D-4C5D-96A4-BB17CD49FD4C"> <title>Configuring |
19 <section id="GUID-4F4F8E71-517D-4C5D-96A4-BB17CD49FD4C"> <title |
20 the emulator</title> <p>Make sure that two or more mice are plugged in and |
20 >Configuring the emulator</title> <p>Make sure that two or more mice |
21 detected on the Windows PC on which the emulator will run. The number of |
21 are plugged in and detected on the Windows PC on which the emulator |
22 detected mice can be from two up to the maximum number defined in the HAL <codeph>HALData::EPointerMaxPointers</codeph> attribute. </p><ol> |
22 will run. The number of detected mice can be from two up to the maximum |
23 <li id="GUID-63F317A2-E4EA-48BD-8F2B-40B54BF35EC6"><p>Add the following lines |
23 number defined in the HAL <codeph>HALData::EPointerMaxPointers</codeph |
24 to the <filepath>\epoc32\data\epoc.ini</filepath> file. These lines enable |
24 > attribute. </p><ol> |
25 ScreenPlay and multi-touch.</p><codeblock xml:space="preserve">SYMBIAN_BASE_USE_GCE ON |
25 <li id="GUID-63F317A2-E4EA-48BD-8F2B-40B54BF35EC6"><p>Add the following |
|
26 lines to the <filepath>\epoc32\data\epoc.ini</filepath> file. These |
|
27 lines enable ScreenPlay and multiple pointers.</p><codeblock |
|
28 xml:space="preserve">SYMBIAN_BASE_USE_GCE ON |
26 EnableMultiTouch ON</codeblock></li> |
29 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 |
30 <li id="GUID-CA823DAB-C8C4-4E09-8491-0C0BCD57BAE4"><p>Specify the <codeph |
28 the proximity and pressure steps.</p><codeblock xml:space="preserve">MultiTouchProximityStep 10 |
31 >MultiTouchProximityStep</codeph> and <codeph>MultiTouchPressureStep</codeph |
|
32 > values in the <filepath>\epoc32\data\epoc.ini</filepath> file to |
|
33 define the proximity and pressure steps.</p><codeblock |
|
34 xml:space="preserve">MultiTouchProximityStep 10 |
29 MultiTouchPressureStep 200 |
35 MultiTouchPressureStep 200 |
30 </codeblock><p>If the above two options are not defined in the <filepath>epoc.ini</filepath> file, |
36 </codeblock><p>If the above two options are not defined in the <filepath |
31 the default proximity and pressure steps are taken from the following HAL |
37 >epoc.ini</filepath> file, the default proximity and pressure steps |
32 attributes.</p><codeblock xml:space="preserve">HALData::EPointer3DProximityStep |
38 are taken from the following HAL attributes.</p><codeblock |
|
39 xml:space="preserve">HALData::EPointer3DProximityStep |
33 HALData::EPointer3DPressureStep</codeblock></li> |
40 HALData::EPointer3DPressureStep</codeblock></li> |
34 </ol><p><b>Result</b>: Launch the emulator to verify that the mice are detected |
41 </ol><p><b>Result</b>: Launch the emulator to verify that the mice |
35 and displayed inside the application window area. When you move a mouse or |
42 are detected and displayed inside the application window area. When |
36 scroll the mouse wheel, its X, Y and Z values are reflected in the status |
43 you move a mouse or scroll the mouse wheel, its X, Y and Z values |
37 bar.</p> </section> |
44 are reflected in the status bar.</p> </section> |
38 <section id="GUID-44C3561D-92A1-421E-9AD3-0D8648919C46-GENID-1-12-1-14-1-1-9-1-6-1-6-1-9-1-9-1-8-1-6-1-3-4"> <title>Enabling |
45 <section |
39 and disabling multi-touch</title><p>Multi-touch is only required by UI applications. |
46 id="GUID-44C3561D-92A1-421E-9AD3-0D8648919C46-GENID-1-12-1-14-1-1-9-1-6-1-6-1-9-1-9-1-8-1-6-1-3-4" |
40 Therefore, multi-touch is enabled inside the orange rectangular area shown |
47 > <title>Enabling and disabling multiple pointers</title><p |
41 on the following diagram. Inside the area two Windows pointers are displayed. |
48 >Multiple pointers are only required by UI applications. Therefore, |
42 The one numbered zero is the system pointer and the other is used only for |
49 they are enabled inside the orange rectangular area shown on the following |
43 multi-touch purposes. The first mouse to report events to the emulator is |
50 diagram. Inside the area two Windows pointers are displayed. The one |
44 automatically taken as the primary mouse, which owns the Windows system pointer.</p><fig id="GUID-C62E31A2-65F8-4976-A3A9-058BFE3D30D3"> |
51 numbered zero is the system pointer and the other is used only for |
45 <title>Multi-touch area</title> |
52 emulating touch with two fingers. The first mouse to report events |
46 <image href="GUID-FD0593E7-A36C-4656-A85A-9D62DFBCC42F_d0e241381_href.png" placement="inline"/> |
53 to the emulator is automatically taken as the primary mouse, which |
47 </fig><p><b>System pointer</b>. Once the system pointer moves outside multi-touch |
54 owns the Windows system pointer.</p><fig |
48 area, multi-touch is temporarily disabled and standard emulator pointer behavior |
55 id="GUID-C62E31A2-65F8-4976-A3A9-058BFE3D30D3"> |
49 is resumed. This means that only one Windows system pointer is displayed and |
56 <title>Multiple pointer area</title> |
50 it is controlled by both mice.</p> <p><b>Non-system pointer</b>. If the |
57 <image |
51 non-system pointer moves out of the multi-touch area, the pointer just disappears |
58 href="GUID-FD0593E7-A36C-4656-A85A-9D62DFBCC42F_d0e241381_href.png" |
52 from the screen. Disabling multi-touch is then not necessary because the system |
59 placement="inline"></image></fig><p><b>System pointer</b>. Once the |
53 pointer behaves normally inside the multi-touch area. Moving the non-system |
60 system pointer moves outside the multiple pointer area, multiple pointers |
54 pointer back into the area makes it reappear on the screen.</p> </section> |
61 are temporarily disabled and standard emulator pointer behavior is |
55 </conbody><related-links> |
62 resumed. This means that only one Windows system pointer is displayed |
56 <link href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita"><linktext>Multi-Touch |
63 and it is controlled by both mice.</p> <p><b>Non-system pointer</b |
57 Support in the Emulator Overview</linktext></link> |
64 >. If the non-system pointer moves out of the multiple pointer area, |
58 </related-links></concept> |
65 the pointer just disappears from the screen. Disabling multiple pointers |
|
66 is then not necessary because the system pointer behaves normally |
|
67 inside the multiple pointer area. Moving the non-system pointer back |
|
68 into the area makes it reappear on the screen.</p> </section> |
|
69 </conbody> |
|
70 <related-links> |
|
71 <link href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita"><linktext |
|
72 >Support for Multiple Pointers in the Emulator Overview</linktext> |
|
73 </link> |
|
74 </related-links> |
|
75 </concept> |
|
76 <?Pub *0000004067?> |