1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-930F1E88-2A03-4BD1-AA2A-3A0128A844BD" xml:lang="en"><title>Enabling

    13 Multi-Touch in the Emulator Tutorial</title><shortdesc>This topic describes how to configure the Symbian emulator to enable

    14 a multi-touch environment. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <p><b>Variant</b>: <xref href="GUID-D93978BE-11A3-5CE3-B110-1DEAA5AD566C.dita">ScreenPlay</xref>. <b>Target

    16 audience</b>: Application developers. </p>

    17 <p>This topic builds on <xref href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita">Multi-Touch

    18 Support in the Emulator Overview</xref>.</p>

    19 <section id="GUID-4F4F8E71-517D-4C5D-96A4-BB17CD49FD4C">       <title>Configuring

    20 the emulator</title> <p>Make sure that two or more mice are plugged in and

    21 detected on the Windows PC on which the emulator will run.  The number of

    22 detected mice can be from two up to the maximum number defined in the HAL <codeph>HALData::EPointerMaxPointers</codeph> attribute. </p><ol>

    23 <li id="GUID-63F317A2-E4EA-48BD-8F2B-40B54BF35EC6"><p>Add the following lines

    24 to the <filepath>\epoc32\data\epoc.ini</filepath> file. These lines enable

    25 ScreenPlay and multi-touch.</p><codeblock xml:space="preserve">SYMBIAN_BASE_USE_GCE ON

    26 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

    28 the proximity and pressure steps.</p><codeblock xml:space="preserve">MultiTouchProximityStep 10

    29 MultiTouchPressureStep 200

    30 </codeblock><p>If the above two options are not defined in the <filepath>epoc.ini</filepath> file,

    31 the default proximity and pressure steps are taken from the following HAL

    32 attributes.</p><codeblock xml:space="preserve">HALData::EPointer3DProximityStep

    33 HALData::EPointer3DPressureStep</codeblock></li>

    34 </ol><p><b>Result</b>: Launch the emulator to verify that the mice are detected

    35 and displayed inside the application window area. When you move a mouse or

    36 scroll the mouse wheel, its X, Y and Z values are reflected in the status

    37 bar.</p>     </section>

    38 <section id="GUID-44C3561D-92A1-421E-9AD3-0D8648919C46-GENID-1-10-1-13-1-1-9-1-6-1-6-1-9-1-9-1-8-1-6-1-3-4">       <title>Enabling

    39 and disabling multi-touch</title><p>Multi-touch is only required by UI applications.

    40 Therefore, multi-touch is enabled inside the orange rectangular area shown

    41 on the following diagram. Inside the area two Windows pointers are displayed.

    42 The one numbered zero is the system pointer and the other is used only for

    43 multi-touch purposes. The first mouse to report events to the emulator is

    44 automatically taken as the primary mouse, which owns the Windows system pointer.</p><fig id="GUID-C62E31A2-65F8-4976-A3A9-058BFE3D30D3">

    45 <title>Multi-touch area</title>

    46 <image href="GUID-FD0593E7-A36C-4656-A85A-9D62DFBCC42F_d0e244501_href.png" placement="inline"/>

    47 </fig><p><b>System pointer</b>. Once the system pointer moves outside multi-touch

    48 area, multi-touch is temporarily disabled and standard emulator pointer behavior

    49 is resumed. This means that only one Windows system pointer is displayed and

    50 it is controlled by both mice.</p>     <p><b>Non-system pointer</b>. If the

    51 non-system pointer moves out of the multi-touch area, the pointer just disappears

    52 from the screen. Disabling multi-touch is then not necessary because the system

    53 pointer behaves normally inside the multi-touch area. Moving the non-system

    54 pointer back into the area makes it reappear on the screen.</p>     </section>

    55 </conbody><related-links>

    56 <link href="GUID-9126A296-0301-4077-A183-3D703F77C548.dita"><linktext>Multi-Touch

    57 Support in the Emulator Overview</linktext></link>

    58 </related-links></concept>