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-9126A296-0301-4077-A183-3D703F77C548" xml:lang="en"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
6 |
<title>Support for Multiple Pointers in the Emulator Overview</title> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
7 |
<shortdesc>This topic provides an overview of support for multiple |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
8 |
pointers in the emulator. Two mice are used to provide two independent |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
9 |
pointer positions. The emulator responds to the mice’s individual |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
10 |
button-clicks, moves, and mouse wheel scrolls as if two human fingers |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
11 |
are moving, touching or hovering over the screen.</shortdesc> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
12 |
<prolog> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
13 |
<metadata><keywords></keywords></metadata> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
14 |
</prolog> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
15 |
<conbody> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
16 |
<p>The emulator can be extended to support more than two mice or other |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
17 |
pointer devices.</p> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
18 |
<p><b>Variant</b>: <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
19 |
href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">ScreenPlay</xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
20 |
>. <b>Target audience</b>: Application developers. </p> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
21 |
<p>The following figure shows two Windows pointers on the emulator |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
22 |
screen, each representing a mouse device. The ordinal integer (starting |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
23 |
from 0) beside each pointer is the unique device identifier. The position |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
24 |
of each mouse on the screen is represented by the X and Y coordinates. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
25 |
The pressure (a positive value) and proximity (a negative value) information |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
26 |
captured by the mouse wheel is represented by the Z coordinate. Notice |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
27 |
that the status bar shows the identifier and the dynamic X, Y and |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
28 |
Z values of each pointer.</p> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
29 |
<fig id="GUID-03428614-06B1-4821-A284-C3B6DB8E053C"> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
30 |
<title>Two pointers are displayed in the emulator</title> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
31 |
<image |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
32 |
href="GUID-3E80A006-F8D8-45C5-9773-7CC239AE86D9_d0e194049_href.png" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
33 |
placement="inline"></image></fig> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
34 |
<p>The delivery of pointer events from the emulator driver to the |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
35 |
Window Server is the same when there are multiple pointers as in the |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
36 |
single pointer environment. This means the raw events for a mouse |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
37 |
move, button click and mouse wheel movement are delivered to the Window |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
38 |
Server as usual. Each mouse has a unique device identifier, which |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
39 |
makes it possible to ascertain which mouse the events relate to. The |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
40 |
raw events for each individual mouse include the following: </p> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
41 |
<ul> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
42 |
<li><p><codeph>TRawEvent::EPointerMove</codeph> indicates a mouse |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
43 |
move or a mouse wheel movement event.</p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
44 |
<li><p><codeph>TRawEvent::EButton1Down</codeph> indicates that the |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
45 |
left mouse button is pressed down.</p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
46 |
<li><p><codeph>TRawEvent::EButton1Up</codeph> indicates that the left |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
47 |
mouse button is released.</p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
48 |
<li><p><codeph>TRawEvent::EPointerOutOfRange</codeph> indicates that |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
49 |
the proximity of a mouse is out of range. This means that the Z coordinate |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
50 |
value of the mouse has reached <codeph>HALData::EPointer3DMaxProximity</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
51 |
>.</p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
52 |
</ul> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
53 |
<section |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
54 |
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-5-1-3-7" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
55 |
> <title>Pressure and proximity emulation</title><p>The Z coordinate |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
56 |
value is used to represent the pressure and proximity to the screen. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
57 |
In the emulator, the Z value is captured and tuned by the mouse wheel |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
58 |
movement.</p><ul> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
59 |
<li><p>Z < 0 indicates the proximity of the device from the screen.</p |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
60 |
></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
61 |
<li><p>Z > 0 indicates pressure.</p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
62 |
</ul><p>See <xref href="GUID-9C269F45-F160-5A4B-ABF8-896D2A538E3B.dita" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
63 |
>Advanced Pointer Overview</xref> for more information about pressure |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
64 |
and proximity.</p><p>The mouse wheel combines the features of a wheel |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
65 |
and a mouse button. The wheel has discrete, evenly spaced notches. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
66 |
Rotating the wheel backwards or forwards has the effect of changing |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
67 |
the pressure or proximity.</p><ul> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
68 |
<li><p>When the mouse wheel is rotated, a device-specific message |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
69 |
is sent to the emulator window that has focus as each notch is encountered.</p |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
70 |
></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
71 |
<li><p>The Z coordinate is initiated as 0. Then when the wheel is |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
72 |
moved forward, the Z value enters the pressure range and increases |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
73 |
by one pressure step. When the wheel is moved backward, the Z value |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
74 |
enters the proximity range and decreases by one proximity step.</p |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
75 |
><p>The pressure or proximity step can be customized in the <filepath |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
76 |
>epoc.ini</filepath> file. See <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
77 |
href="GUID-930F1E88-2A03-4BD1-AA2A-3A0128A844BD.dita">Enabling Multiple |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
78 |
Pointers in the Emulator Tutorial</xref> for more information.</p |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
79 |
></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
80 |
<li><p>When the Z value is in the pressure range (Z > 0), moving the |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
81 |
wheel forward by one notch increases Z by one pressure step. Moving |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
82 |
the wheel backward by one notch decreases Z by one pressure step, |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
83 |
until Z returns to 0.</p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
84 |
<li><p>When the Z value is in the proximity range (Z < 0), moving |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
85 |
the wheel backward by one notch decreases Z by one proximity step. |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
86 |
Moving the wheel forward by one notch increases Z by one proximity |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
87 |
step, until Z returns to 0. </p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
88 |
<li><p>There are limits to the values of the Z coordinate. This means |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
89 |
that the Symbian emulator does not allow Z to exceed the upper boundary <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
90 |
href="GUID-8BE90160-2C60-3582-82C8-4A108C7C0317.dita#GUID-8BE90160-2C60-3582-82C8-4A108C7C0317/GUID-BF464EF0-D685-3B12-9E13-65A86BAED610" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
91 |
><apiname>HALData::EPointer3DMaxPressure</apiname></xref> (a positive |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
92 |
value) and lower boundary <xref |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
93 |
href="GUID-8BE90160-2C60-3582-82C8-4A108C7C0317.dita#GUID-8BE90160-2C60-3582-82C8-4A108C7C0317/GUID-7FCDA198-1E26-3BC9-A5A1-C4AF67016615" |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
94 |
><apiname>HALData::EPointer3DMaxProximity</apiname></xref> (a negative |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
95 |
value). If Z is at the lower boundary, when the mouse wheel is moved |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
96 |
backward next time, Z does not change. A new <codeph>Out of Range</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
97 |
> pointer event is generated and sent to the Window Server. Similarly |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
98 |
when Z is at the upper boundary, Z does not change when the mouse |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
99 |
wheel is moved forward.</p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
100 |
<li><p>When the mouse button down or up event (<codeph>TRawEvent::EButton1Down</codeph |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
101 |
> or <codeph>TRawEvent::EButton1Up</codeph>) is generated, Z is reset |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
102 |
to 0.</p></li> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
103 |
</ul> </section> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
104 |
</conbody> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
105 |
<related-links> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
106 |
<link href="GUID-A12A66ED-2C8F-5CE6-8F3E-332B045A35B4.dita"><linktext |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
107 |
>Advanced Pointers</linktext></link> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
108 |
<link href="GUID-930F1E88-2A03-4BD1-AA2A-3A0128A844BD.dita"><linktext |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
109 |
>Enabling Multiple Pointers <?Pub Caret?>in the Emulator Tutorial</linktext> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
110 |
</link> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
111 |
</related-links> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
112 |
</concept> |
5072524fcc79
Fixing terminology
Dominic Pinkman <dominic.pinkman@nokia.com>
parents:
8
diff
changeset
|
113 |
<?Pub *0000006176?> |