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

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

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

     2 <!--Arbortext, Inc., 1988-2008, v.4002-->

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

     3 <!DOCTYPE concept PUBLIC "-//OASIS//DTD DITA Concept//EN"

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

     4  "concept.dtd">

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

     5 <concept id="GUID-581A8E4B-12BE-41C0-A20E-3087A80FEECF" xml:lang="en">

     6 <!-- Initial Contributors:

     6 <title>Tactile feedback</title>

     7     Nokia Corporation - initial contribution.

     7 <prolog>

     8 Contributors: 

     8 <metadata><keywords></keywords></metadata>

     9 -->

     9 </prolog>

    10 <!DOCTYPE concept

    10 <conbody>

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

    11 <p>There are two cases where vibration or audio of the device is used

    12 <concept id="GUID-581A8E4B-12BE-41C0-A20E-3087A80FEECF" xml:lang="en"><title>Tactile

    12 as an output method:</p>

    13 feedback</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>There are two cases where vibration or audio of the device is used as an

    15 output method:</p>

    17 <li><p>As a <i>tacticon</i> to inform users through physical feedback, that

    14 <li><p>As a <i>tacticon</i> to inform users through physical feedback,

    18 an important event is occurring in the device. For example, when a new message

    15 that an important event is occurring in the device. For example, when

    19 arrives or a warning note is displayed.</p></li>

    16 a new message arrives or a warning note is displayed.</p></li>

    20 <li><p>As <i>tactile feedback</i> to indicate to the user that an interaction

    17 <li><p>As <i>tactile feedback</i> to indicate to the user that an

    21 event has been made. For example, users receive tactile feedback when they

    18 interaction event has been made. For example, users receive tactile

    22 press a button on the touch screen.</p></li>

    19 feedback when they press a button on the touch screen.</p></li>

    24 <p>As with sounds, tactile feedback must be used carefully so as not to desensitize

    21 <p>As with sounds, tactile feedback must be used carefully so as not

    25 the user to the vibration; the attention grabbing quality remains and functions

    22 to desensitize the user to the vibration; the attention grabbing quality

    26 so long as the feedback is not too frequent.</p>

    23 remains and functions so long as the feedback is not too frequent.</p>

    28 Tactile feedback can be disabled for the common UI components in an application.

    25 Tactile feedback can be disabled for the common UI components in an

    29 However, this is acceptable only if tactile feedback causes interference with

    26 application. However, this is acceptable only if tactile feedback

    30 other device functions.</p>

    27 causes interference with other device functions.</p>

    31 <p>The user can choose the level of tactile feedback and turn tacticons ON

    28 <p>The user can choose the level of tactile feedback and turn tacticons

    32 and OFF.</p>

    29 ON and OFF.</p>

    34 <p><table id="GUID-4969AEA7-3BE4-4644-8232-1FA26D49010B"><title>Tactile feedback

    31 <p><table id="GUID-4969AEA7-3BE4-4644-8232-1FA26D49010B">

    35 effects</title>

    32 <title>Tactile feedback effects</title>

    36 <tgroup cols="2"><colspec colname="col1" colwidth="0.40*"/><colspec colname="col2" colwidth="1.60*"/>

    33 <tgroup cols="2"><colspec colname="col1" colwidth="0.40*"/><colspec

    34 colname="col2" colwidth="1.60*"/>

    46 <entry><p>Provides single pulse effect on repeated key presses with buttons.

    44 <entry><p>Provides single pulse effect on repeated key presses with

    47 It is also possible with other similar components.</p></entry>

    45 buttons. It is also possible with other similar components.</p></entry>

    51 <entry><p>Provides stronger single pulse effect to buttons. It is also possible

    49 <entry><p>Provides stronger single pulse effect to buttons. It is

    52 with other similar components.</p></entry>

    50 also possible with other similar components.</p></entry>

    56 <entry><p>Provides single pulse effect to lists and grids. Effect is used

    54 <entry><p>Provides single pulse effect to lists and grids. Effect

    57 with move (drag and flick) when new item appears on the screen.</p></entry>

    55 is used with move (drag and flick) when new item appears on the screen.</p

    56 ></entry>

    61 <entry><p>Provides stronger single pulse effect to lists and grids. Effect

    60 <entry><p>Provides stronger single pulse effect to lists and grids.

    62 is used with touch down and release when tap makes an action. </p><p>In hierarchical

    61 Effect is used with touch down and release when tap makes an action. </p

    63 list, collapsing/expanding item provides basic list effect with touch down

    62 ><p>In hierarchical list, collapsing/expanding item provides basic

    63 list effect with touch down and release.</p></entry>

    64 </row>

    65 <row>

    66 <entry><p><b>Bounce effect</b></p></entry>

    67 <entry><p>Provides pulse effect when list returns to its normal state

    68 after boundary effect.</p></entry>

    69 </row>

    70 <row>

    71 <entry><p><b>Sensitive slider</b></p></entry>

    72 <entry><p>Provides pulse effect with scrollbar and slider thumbs.

    73 Effect is provided with touch down and release in thumb area.</p></entry>

    74 </row>

    75 <row>

    76 <entry><p><b>Smooth slider</b></p></entry>

    77 <entry><p>Provides continuous smooth feedback when dragging scrollbar

    78 or slider thumb. This can also be increasing or decreasing depending

    79 of the slider type.</p></entry>

    80 </row>

    81 <row>

    82 <entry><p><b>Hold slider</b></p></entry>

    83 <entry><p>Provides sensitive pulse effect when touch down and hold

    84 on the slider or scrollbar area. Slider thumb starts moving step by

    85 step towards the touch point. Every step gives one sensitive pulse.

    86 If slider thumb moves directly to the touch point, then basic slider

    87 effect is provided.</p></entry>

    88 </row>

    89 <row>

    90 <entry><p><b>Pop-up</b></p></entry>

    91 <entry><p>Provides sensitive pulse effect when pop-up is opened or

    92 closed. If the theme animations are ON, then pop-up effect is used

    93 with opening event after increasing long touch effect. In this scenario,

    94 there is no pop-up effect . <note> All pop-ups do not have theme animation.</note

    95 ></p></entry>

    96 </row>

    97 <row>

    98 <entry><p><b>Pop-up close</b></p></entry>

    99 <entry><p>Provides decreasing smooth feedback  a pop-up and when theme

   100 animations are ON.</p></entry>

   101 </row>

   102 <row>

   103 <entry><p><b>Increasing long touch</b></p></entry>

   104 <entry><p>Provides increasing smooth feedback. This can be used with

   105 either long tap animation or pop-up opening theme effects. If the

   106 theme effects are ON and long tap opens a pop-up, then feedback is

   107 provided only with long tap. This is followed by pop-up.</p></entry>

   108 </row>

   109 <row>

   110 <entry><p><b>Basic tab</b></p></entry>

   111 <entry><p>Provides strong pulse effect with touch down event in tab

   112 area.</p></entry>

   113 </row>

   114 <row>

   115 <entry><p><b>Smooth flick</b></p></entry>

   116 <entry><p>Provides smooth feedback with drag when horizontal movement

   117 is possible.</p></entry>

   118 </row>

   119 <row>

   120 <entry><p><b>Sensitive flick</b></p></entry>

   121 <entry><p>Provides sensitive pulse effect with touch release when

   122 horizontal movement is possible.</p></entry>

   123 </row>

   124 <row>

   125 <entry><p><b>Sensitive edit</b></p></entry>

   126 <entry><p>Provides sensitive pulse effect in editors with touch down

   126 <entry><p>Provides pulse effect when painting the text. Effect is provided

   131 <entry><p>Provides pulse effect when painting the text. Effect is

   127 with every character while painting the text.</p></entry>

   132 provided with every character while painting the text.</p></entry>

   131 <entry><p>Provides pulse effect when painting blank character. By default,

   136 <entry><p>Provides pulse effect when painting blank character. By

   132 it is none.</p></entry>

   137 default, it is none.</p></entry>

   139 <entry><p><b>Empty line</b></p></entry>

   144 <entry><p><b>Em<?Pub Caret?>pty line</b></p></entry>

   140 <entry><p>Provides pulse effect when painting an empty line. By default, it

   145 <entry><p>Provides pulse effect when painting an empty line. By default,

   141 is none.</p></entry>

   146 it is none.</p></entry>

   145 <entry><p>Provides pulse effect when marking/unmarking a check box.</p></entry>

   150 <entry><p>Provides pulse effect when marking/unmarking a check box.</p

   146 </row>

   151 ></entry>

   147 <row>

   152 </row>

   148 <entry><p><b>Multi-touch recognition</b></p></entry>

   153 <row>

   149 <entry><p>Provides double pulse (sensitive + sensitive) effect when multi-touch

   154 <entry><p><b>Multiple touch recognition</b></p></entry>

   150 is recognized (generally, when second finger is touched down).</p></entry>

   155 <entry><p>Provides double pulse (sensitive + sensitive) effect when

   156 multiple touch is recognized (generally, when second finger is touched

   157 down).</p></entry>

   154 <entry><p>Provides smooth continuous feedback while moving fingers in multi-touch

   161 <entry><p>Provides smooth continuous feedback while moving fingers

   155 pinch situation.</p></entry>

   162 in multiple touch pinch situation.</p></entry>

   159 <entry><p>Provides smooth continuous feedback  while moving fingers in multi-touch

   166 <entry><p>Provides smooth continuous feedback  while moving fingers

   160 rotate situation.</p></entry>

   167 in multiple touch rotate situation.</p></entry>

   165 <section id="GUID-1EB54408-100B-4E4F-8D56-E13C26CA3B96"><title>Haptics concept</title><p>The different senses associated

   172 <section id="GUID-1EB54408-100B-4E4F-8D56-E13C26CA3B96"><title>Haptics

   166 to the skin are called cutaneous senses. These senses are temperature, pressure

   173 concept</title><p>The different senses associated to the skin are

   167 (touch itself), pain, tickle, itch and vibration senses. We can characterize

   174 called cutaneous senses. These senses are temperature, pressure (touch

   168 touch as passive or active. Passive touch means the sense of touch itself,

   175 itself), pain, tickle, itch and vibration senses. We can characterize

   169 whereas active touch means the touch action.</p><p>To communicate through

   176 touch as passive or active. Passive touch means the sense of touch

   170 the sense of touch, we have to stimulate some of the cutaneous senses or the

   177 itself, whereas active touch means the touch action.</p><p>To communicate

   171 movement sense. The stimulation of the cutaneous senses or one of them by

   178 through the sense of touch, we have to stimulate some of the cutaneous

   172 a product is called tactile stimulation. Respectively, the stimulation of

   179 senses or the movement sense. The stimulation of the cutaneous senses

   173 the movement sense by a product is called haptic stimulation or just haptics.

   180 or one of them by a product is called tactile stimulation. Respectively,

   174 Haptics is also used as general term for all issues related to sense of touch,

   181 the stimulation of the movement sense by a product is called haptic

   175 both human and machine.</p><p>Haptic feedback, often referred to as "Haptics",

   182 stimulation or just haptics. Haptics is also used as general term

   176 is the use of the sense of touch in a user interface design to provide information

   183 for all issues related to sense of touch, both human and machine.</p

   177 to an end user. In mobile phones, this generally means the use of vibrations

   184 ><p>Haptic feedback, often referred to as "Haptics", is the use of

   178 from the device's vibration alarm to denote that a touch screen button has

   185 the sense of touch in a user interface design to provide information

   179 been pressed. In this particular example, the phone would vibrate slightly

   186 to an end user. In mobile phones, this generally means the use of

   180 in response to the user's activation of an on-screen control, making up for

   187 vibrations from the device's vibration alarm to denote that a touch

   181 the lack of a normal tactile response that the user would experience when

   188 screen button has been pressed. In this particular example, the phone

   182 pressing a physical button.</p></section>

   189 would vibrate slightly in response to the user's activation of an

   190 on-screen control, making up for the lack of a normal tactile response

   191 that the user would experience when pressing a physical button.</p

   192 ></section>

   184 of haptics related  APIs</title><p>You can use the following APIs to create

   194 of haptics related  APIs</title><p>You can use the following APIs

   185 haptic effects:</p><ul>

   195 to create haptic effects:</p><ul>

   186 <li><p><xref href="GUID-8661A7E0-F19A-41F8-9062-FBFAE70CF658.dita">Tactile Feedback

   196 <li><p><xref href="GUID-8661A7E0-F19A-41F8-9062-FBFAE70CF658.dita"

   187 Client API</xref></p><ul>

   197 >Tactile Feedback Client API</xref></p><ul>

   189 <li><p>It can be used on all S60 5th Edition or later mobile devices. However,

   199 <li><p>It can be used on all S60 5th Edition or later mobile devices.

   190 the feedback is played only on touch enabled layouts.</p></li>

   200 However, the feedback is played only on touch enabled layouts.</p

   191 <li><p>Provides simple functions for triggering various predefined tactile

   201 ></li>

   192 feedback (vibration or audio) effects.</p></li>

   202 <li><p>Provides simple functions for triggering various predefined

   193 <li><p>Enables a consistent user experience in all applications of the mobile

   203 tactile feedback (vibration or audio) effects.</p></li>

   194 device (an application gives a logical feedback type as an input and the actual

   204 <li><p>Enables a consistent user experience in all applications of

   195 physical effect depends on the mobile device configuration and end user settings).</p></li>

   205 the mobile device (an application gives a logical feedback type as

   196 <li><p>When the area feedback is used, latency is low for the feedback triggering

   206 an input and the actual physical effect depends on the mobile device

   197 (a tactile feedback can already be triggered at the window server level prior

   207 configuration and end user settings).</p></li>

   198 to the corresponding pointer event being delivered to the visible application).</p></li>

   208 <li><p>When the area feedback is used, latency is low for the feedback

   199 <li><p>Direct feedback can be easily integrated into <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita#GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160/GUID-5CF90E7A-4A91-36FF-BB3F-CF7CF687DED2"><apiname>CCoeControl::HandlePointerEventL()</apiname></xref>. </p></li>

   209 triggering (a tactile feedback can already be triggered at the window

   200 <li><p>An application can select the logical tactile feedback from certain

   210 server level prior to the corresponding pointer event being delivered

   201 types. The produced effect may be different on various mobile devices.</p></li>

   211 to the visible application).</p></li>

   212 <li><p>Direct feedback can be easily integrated into <xref

   213 href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita#GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160/GUID-5CF90E7A-4A91-36FF-BB3F-CF7CF687DED2"

   214 ><apiname>CCoeControl::HandlePointerEventL()</apiname></xref>. </p

   215 ></li>

   216 <li><p>An application can select the logical tactile feedback from

   217 certain types. The produced effect may be different on various mobile

   218 devices.</p></li>

   203 <li><p><xref href="jar:GUID-558A5A9B-811E-4A87-B3DD-AE734C9AA966.jar!/public_specs/GuidesA/Haptics_API_Specification/Haptics_API_Specification.html" format="application/java-archive">Haptics

   220 <li><p><xref format="application/java-archive"

   204 API</xref></p><ul>

   221 href="jar:GUID-558A5A9B-811E-4A87-B3DD-AE734C9AA966.jar!/public_specs/GuidesA/Haptics_API_Specification/Haptics_API_Specification.html"

   222 >Haptics API</xref></p><ul>

   207 <li><p>Provides an interface for accessing Haptics player that can control

   225 <li><p>Provides an interface for accessing Haptics player that can

   208 different actuator types.</p></li>

   226 control different actuator types.</p></li>

   210 or machine gun effect in a game, bass boost for a music player, advanced ringing

   228 or machine gun effect in a game, bass boost for a music player, advanced

   211 tone vibration, and so on.</p></li>

   229 ringing tone vibration, and so on.</p></li>

   212 <li><p>Enables simultaneous playing of different kinds of basis effects and

   230 <li><p>Enables simultaneous playing of different kinds of basis effects

   213 modifying them when played. </p></li>

   231 and modifying them when played. </p></li>

   217 (to be set at runtime) to enable the Haptics player functionality.</p></li>

   235 (to be set at runtime) to enable the Haptics player functionality.</p

   236 ></li>

   219 <li><p><xref href="GUID-D53A00E4-CF37-5F11-8D15-C5ECCCE64597.dita">Vibra API</xref></p><ul>

   238 <li><p><xref href="GUID-D53A00E4-CF37-5F11-8D15-C5ECCCE64597.dita"

   239 >Vibra API</xref></p><ul>

   221 <li><p>It can be used for running device vibrator with given intensity for

   241 <li><p>It can be used for running device vibrator with given intensity

   222 a given period of time.</p></li>

   242 for a given period of time.</p></li>

   223 <li><p>It can be used by a privileged client application to play pulse effects,

   243 <li><p>It can be used by a privileged client application to play pulse

   224 which have a very short duration (as the ones used for tactile feedback).</p></li>

   244 effects, which have a very short duration (as the ones used for tactile

   245 feedback).</p></li>

   227 <section id="GUID-428F693C-1CA8-4588-9A7D-C4265D2AED91"><title>When to use

   248 <section id="GUID-428F693C-1CA8-4588-9A7D-C4265D2AED91"><title>When

   228 Tactile Feedback Client API, Haptics API, and Vibra API</title><p><ul>

   249 to use Tactile Feedback Client API, Haptics API, and Vibra API</title

   229 <li><p>Tactile Feedback Client API for providing tactile feedback in custom

   250 ><p><ul>

   230 controls (grids, lists, and so on), which will comply with the style of Core

   251 <li><p>Tactile Feedback Client API for providing tactile feedback

   231 UI components to ensure a uniform user experience among applications.</p></li>

   252 in custom controls (grids, lists, and so on), which will comply with

   232 <li><p>Haptics API on touch and hybrid mobile devices for producing complex

   253 the style of Core UI components to ensure a uniform user experience

   233 vibration feedback, which cannot be achieved with Tactile Framework (games,

   254 among applications.</p></li>

   234 simulations, demos, and so on).</p></li>

   255 <li><p>Haptics API on touch and hybrid mobile devices for producing

   235 <li><p>Vibra API for producing haptic effects such as ringing tone vibration

   256 complex vibration feedback, which cannot be achieved with Tactile

   236 in those mobile devices where Haptics API is not available or functional.</p></li>

   257 Framework (games, simulations, demos, and so on).</p></li>

   258 <li><p>Vibra API for producing haptic effects such as ringing tone

   259 vibration in those mobile devices where Haptics API is not available

   260 or functional.</p></li>

   239 tactile feedback in applications</title><p>The API to use for tactile feedback

   263 tactile feedback in applications</title><p>The API to use for tactile

   240 is the <xref href="GUID-8661A7E0-F19A-41F8-9062-FBFAE70CF658.dita">Tactile feedback

   264 feedback is the <xref

   265 href="GUID-8661A7E0-F19A-41F8-9062-FBFAE70CF658.dita">Tactile feedback

   242 interface to add, modify and remove feedback areas in the registry. There

   267 interface to add, modify and remove feedback areas in the registry.

   243 is also an option to trigger direct feedback and bypass the registry. <xref href="GUID-766333D1-8D66-3B81-9B5D-8C4245F78298.dita#GUID-766333D1-8D66-3B81-9B5D-8C4245F78298/GUID-962B6543-9A59-3E72-893D-F775FEC54ACB"><apiname>MTouchFeedback::Instance()</apiname></xref> is

   268 There is also an option to trigger direct feedback and bypass the

   244 used for acquiring a pointer to a touch feedback instance. When touch feedback

   269 registry. <xref

   245 is activated, the mobile device users get a slight vibration when the control

   270 href="GUID-766333D1-8D66-3B81-9B5D-8C4245F78298.dita#GUID-766333D1-8D66-3B81-9B5D-8C4245F78298/GUID-962B6543-9A59-3E72-893D-F775FEC54ACB"

   246 with the feedback interface is touched. </p><note><p>Tactile feedback can

   271 ><apiname>MTouchFeedback::Instance()</apiname></xref> is used for

   247 be set and disabled in a client application or a mobile device in some scenarios,

   272 acquiring a pointer to a touch feedback instance. When touch feedback

   248 for example, during phone calls.</p></note><p>Client applications cannot determine

   273 is activated, the mobile device users get a slight vibration when

   249 the actual physical feedback that is generated. It depends on device configuration

   274 the control with the feedback interface is touched. </p><note><p>Tactile

   250 and current settings. In current devices, the user changeable settings include

   275 feedback can be set and disabled in a client application or a mobile

   276 device in some scenarios, for example, during phone calls.</p></note

   277 ><p>Client applications cannot determine the actual physical feedback

   278 that is generated. It depends on device configuration and current

   279 settings. In current devices, the user changeable settings include

   252 see <xref href="GUID-21DAC50D-7737-42B6-BBDA-E12E8779741B.dita">Feedback</xref>.</p></section>

   281 see <xref href="GUID-21DAC50D-7737-42B6-BBDA-E12E8779741B.dita">Feedback</xref

   253 </conbody></concept>

   282 >.</p></section>

   283 </conbody>

   284 </concept>

   285 <?Pub *0000013046?>