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