author | Dominic Pinkman <dominic.pinkman@nokia.com> |
Fri, 02 Jul 2010 12:51:36 +0100 | |
changeset 11 | 5072524fcc79 |
parent 8 | ae94777fff8f |
child 13 | 48780e181b38 |
permissions | -rw-r--r-- |
11
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
1 |
<?xml version="1.0" encoding="UTF-8"?> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
2 |
<!--Arbortext, Inc., 1988-2008, v.4002--> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
3 |
<!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
4 |
"concept.dtd"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
5 |
<concept id="GUID-930F1E88-2A03-4BD1-AA2A-3A0128A844BD" xml:lang="en"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
6 |
<title>Enabling Multiple Pointers in the Emulator Tutorial</title> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
7 |
<shortdesc>This topic describes how to configure the Symbian emulator |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
8 |
to enable a multiple pointer environment. </shortdesc> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
9 |
<prolog> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
10 |
<metadata><keywords></keywords></metadata> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
11 |
</prolog> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
12 |
<conbody> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
13 |
<p><b>Variant</b>: <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
14 |
href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">ScreenPlay</xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
15 |
>. <b>Target audience</b>: Application developers. </p> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
16 |
<p>This topic builds on <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
17 |
href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita">Support for |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
18 |
Multiple Pointers in the Emulator Overview</xref>.</p> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
19 |
<section id="GUID-4F4F8E71-517D-4C5D-96A4-BB17CD49FD4C"> <title |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
20 |
>Configuring the emulator</title> <p>Make sure that two or more mice |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
21 |
are plugged in and detected on the Windows PC on which the emulator |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
22 |
will run. The number of detected mice can be from two up to the maximum |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
23 |
number defined in the HAL <codeph>HALData::EPointerMaxPointers</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
24 |
> attribute. </p><ol> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
25 |
<li id="GUID-63F317A2-E4EA-48BD-8F2B-40B54BF35EC6"><p>Add the following |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
26 |
lines to the <filepath>\epoc32\data\epoc.ini</filepath> file. These |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
27 |
lines enable ScreenPlay and multiple pointers.</p><codeblock |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
28 |
xml:space="preserve">SYMBIAN_BASE_USE_GCE ON |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
29 |
EnableMultiTouch ON</codeblock></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
30 |
<li id="GUID-CA823DAB-C8C4-4E09-8491-0C0BCD57BAE4"><p>Specify the <codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
31 |
>MultiTouchProximityStep</codeph> and <codeph>MultiTouchPressureStep</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
32 |
> values in the <filepath>\epoc32\data\epoc.ini</filepath> file to |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
33 |
define the proximity and pressure steps.</p><codeblock |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
34 |
xml:space="preserve">MultiTouchProximityStep 10 |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
35 |
MultiTouchPressureStep 200 |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
36 |
</codeblock><p>If the above two options are not defined in the <filepath |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
37 |
>epoc.ini</filepath> file, the default proximity and pressure steps |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
38 |
are taken from the following HAL attributes.</p><codeblock |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
39 |
xml:space="preserve">HALData::EPointer3DProximityStep |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
40 |
HALData::EPointer3DPressureStep</codeblock></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
41 |
</ol><p><b>Result</b>: Launch the emulator to verify that the mice |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
42 |
are detected and displayed inside the application window area. When |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
43 |
you move a mouse or scroll the mouse wheel, its X, Y and Z values |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
44 |
are reflected in the status bar.</p> </section> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
45 |
<section |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
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" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
47 |
> <title>Enabling and disabling multiple pointers</title><p |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
48 |
>Multiple pointers are only required by UI applications. Therefore, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
49 |
multiple pointers are enabled inside the orange rectangular area shown |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
50 |
on the following diagram. Inside the area two Windows pointers are |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
51 |
displayed. The one numbered zero is the system pointer and the other |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
52 |
is used only for emulating touch with two fingers. The first mouse |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
53 |
to report events to the emulator is automatically taken as the primary |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
54 |
mouse, which owns the Windows system pointer.</p><fig |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
55 |
id="GUID-C62E31A2-65F8-4976-A3A9-058BFE3D30D3"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
56 |
<title>Multiple pointer area</title> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
57 |
<image |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
58 |
href="GUID-FD0593E7-A36C-4656-A85A-9D62DFBCC42F_d0e194260_href.png" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
59 |
placement="inline"></image></fig><p><b>System pointer</b>. Once the |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
60 |
system pointer moves outside the multiple pointer area, multiple pointers |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
61 |
are temporarily disabled and standard emulator pointer behavior is |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
62 |
resumed. This means that only one Windows system pointer is displayed |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
63 |
and it is controlled by both mice.</p> <p><b>Non-system pointer</b |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
64 |
>. If the non-system pointer moves out of the multiple pointer area, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
65 |
the pointer just disappears from the screen. Disabling multiple pointers |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
66 |
is then not necessary because the system pointer behaves normally |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
67 |
inside the multiple pointer area. Moving the non-system pointer back |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
68 |
into the area makes it reappear on the screen.</p> </section> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
69 |
</conbody> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
70 |
<related-links> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
71 |
<link href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita"><linktext |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
72 |
>Suppo<?Pub Caret?>rt for Multiple Pointers in the Emulator Overview</linktext> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
73 |
</link> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
74 |
</related-links> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
75 |
</concept> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
76 |
<?Pub *0000004080?> |