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