This file is indexed.

/usr/share/qt5/doc/qtfeedback/qfeedbackhapticseffect.html is in qtfeedback5-doc-html 5.0~git20130529-0ubuntu13.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qfeedbackeffect.cpp -->
  <title>QFeedbackHapticsEffect Class | Qt 5.0 </title>
  <link rel="stylesheet" type="text/css" href="style/style.css" />
</head>
<body>
<body>
<div class="header" id="qtdocheader">
    <div class="main">
    <div class="main-rounded">
        <div class="navigationbar">
        <ul>
<li>Qt 5.0</li>
<li>QFeedbackHapticsEffect</li>
<li id="buildversion">Qt 5.0.0 Reference Documentation</li>
    </ul>
    </div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#reimplemented-public-functions">Reimplemented Public Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">QFeedbackHapticsEffect Class</h1>
<!-- $$$QFeedbackHapticsEffect-brief -->
<p>The <a href="qfeedbackhapticseffect.html">QFeedbackHapticsEffect</a> class allows you to play a haptics effect. <a href="#details">More...</a></p>
<!-- @@@QFeedbackHapticsEffect -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> <span class="preprocessor">#include &lt;QFeedbackHapticsEffect&gt;</span>
</td></tr><tr><td class="memItemLeft rightAlign topAlign"> Inherits:</td><td class="memItemRight bottomAlign"> <a href="qfeedbackeffect.html">QFeedbackEffect</a></td></tr></table></div><ul>
<li><a href="qfeedbackhapticseffect-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2 id="properties">Properties</h2>
<div class="table"><table class="propsummary">
<tr><td class="topAlign"><ul>
<li class="fn"><b><a href="qfeedbackhapticseffect.html#actuator-prop">actuator</a></b> : QFeedbackActuator *</li>
<li class="fn"><b><a href="qfeedbackhapticseffect.html#attackIntensity-prop">attackIntensity</a></b> : qreal</li>
<li class="fn"><b><a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a></b> : int</li>
<li class="fn"><b><a href="qfeedbackhapticseffect.html#duration-prop">duration</a></b> : int</li>
</ul></td><td class="topAlign"><ul>
<li class="fn"><b><a href="qfeedbackhapticseffect.html#fadeIntensity-prop">fadeIntensity</a></b> : qreal</li>
<li class="fn"><b><a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a></b> : int</li>
<li class="fn"><b><a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a></b> : qreal</li>
<li class="fn"><b><a href="qfeedbackhapticseffect.html#period-prop">period</a></b> : int</li>
</ul>
</td></tr>
</table></div>
<ul>
<li class="fn">2 properties inherited from <a href="qfeedbackeffect.html#properties">QFeedbackEffect</a></li>
</ul>
<a name="public-functions"></a>
<h2 id="public-functions">Public Functions</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#QFeedbackHapticsEffect">QFeedbackHapticsEffect</a></b>(QObject *<i> parent</i> = 0)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#dtor.QFeedbackHapticsEffect">~QFeedbackHapticsEffect</a></b>()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QFeedbackActuator * </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#actuator-prop">actuator</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#attackIntensity-prop">attackIntensity</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#fadeIntensity-prop">fadeIntensity</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qreal </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> int </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#period-prop">period</a></b>() const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#actuator-prop">setActuator</a></b>(QFeedbackActuator *<i> actuator</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#attackIntensity-prop">setAttackIntensity</a></b>(qreal<i> intensity</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#attackTime-prop">setAttackTime</a></b>(int<i> msecs</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#duration-prop">setDuration</a></b>(int<i> msecs</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#fadeIntensity-prop">setFadeIntensity</a></b>(qreal<i> intensity</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#fadeTime-prop">setFadeTime</a></b>(int<i> msecs</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#intensity-prop">setIntensity</a></b>(qreal<i> intensity</i>)</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#period-prop">setPeriod</a></b>(int<i> msecs</i>)</td></tr>
</table></div>
<a name="reimplemented-public-functions"></a>
<h2 id="reimplemented-public-functions">Reimplemented Public Functions</h2>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual int </td><td class="memItemRight bottomAlign"><b><a href="qfeedbackhapticseffect.html#duration-prop">duration</a></b>() const</td></tr>
</table></div>
<ul>
<li class="fn">2 public functions inherited from <a href="qfeedbackeffect.html#public-functions">QFeedbackEffect</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">3 public slots inherited from <a href="qfeedbackeffect.html#public-slots">QFeedbackEffect</a></li>
<li class="fn">2 signals inherited from <a href="qfeedbackeffect.html#signals">QFeedbackEffect</a></li>
<li class="fn">2 static public members inherited from <a href="qfeedbackeffect.html#static-public-members">QFeedbackEffect</a></li>
<li class="fn">1 protected function inherited from <a href="qfeedbackeffect.html#protected-functions">QFeedbackEffect</a></li>
</ul>
<a name="details"></a>
<!-- $$$QFeedbackHapticsEffect-description -->
<div class="descr">
<h2 id="details">Detailed Description</h2>
<p>The <a href="qfeedbackhapticseffect.html">QFeedbackHapticsEffect</a> class allows you to play a haptics effect.</p>
<p>A haptics effect is an effect that takes advantage of the sense of touch. Most mobile devices today supports one such effect, vibration, which will then be the default when you create a <a href="qfeedbackhapticseffect.html">QFeedbackHapticsEffect</a>.</p>
<p>A haptics effect has a few parameters that must be set up before it can be played:</p>
<ul>
<li><a href="qfeedbackhapticseffect.html#duration-prop">duration</a>(): The total duration of the effect in milliseconds.</li>
<li><a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>(): The intensity, e.g&#x2e;, how hard the device will vibrate.</li>
</ul>
<p>An effect can, for example, be set up as follows:</p>
<pre class="cpp"><span class="type"><a href="qfeedbackhapticseffect.html#QFeedbackHapticsEffect">QFeedbackHapticsEffect</a></span> rumble;
rumble<span class="operator">.</span><a href="qfeedbackhapticseffect.html#intensity-prop">setIntensity</a>(<span class="number">1.0</span>);
rumble<span class="operator">.</span><a href="qfeedbackhapticseffect.html#duration-prop">setDuration</a>(<span class="number">100</span>);</pre>
<p>You can now <a href="qfeedbackeffect.html#start">start</a>() the effect.</p>
<pre class="cpp">rumble<span class="operator">.</span><a href="qfeedbackeffect.html#start">start</a>();</pre>
<p>At any given time, the effect is in one of four states: <a href="qfeedbackeffect.html#State-enum">Stopped</a>, <a href="qfeedbackeffect.html#State-enum">Paused</a>, <a href="qfeedbackeffect.html#State-enum">Running</a>, or <a href="qfeedbackeffect.html#State-enum">Loading</a>. You can request a state change by calling <a href="qfeedbackeffect.html#start">start</a>(), <a href="qfeedbackeffect.html#pause">pause</a>(), or <a href="qfeedbackeffect.html#stop">stop</a>(). The state is queried with <a href="qfeedbackeffect.html#state-prop">state</a>().</p>
<p>The haptics effect also supports a fade-in of the effect. For vibration, this means that the vibration will grow (or sink) in intensity from when the effect starts until <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>() is reached. You can set that up as follows:</p>
<pre class="cpp">rumble<span class="operator">.</span><a href="qfeedbackhapticseffect.html#attackIntensity-prop">setAttackIntensity</a>(<span class="number">0.0</span>);
rumble<span class="operator">.</span><a href="qfeedbackhapticseffect.html#attackTime-prop">setAttackTime</a>(<span class="number">250</span>);</pre>
<p>Attack intensity is the start intensity and attack time is the duration of the fade-in. We have a similar fade-out:</p>
<pre class="cpp">rumble<span class="operator">.</span><a href="qfeedbackhapticseffect.html#fadeTime-prop">setFadeTime</a>(<span class="number">250</span>);
rumble<span class="operator">.</span><a href="qfeedbackhapticseffect.html#fadeIntensity-prop">setFadeIntensity</a>(<span class="number">0.0</span>);</pre>
<p>When using fade-in and fade-out the total duration of the haptics effect will be: <a href="qfeedbackhapticseffect.html#duration-prop">duration</a>(); the main <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>() will be played for (<a href="qfeedbackhapticseffect.html#duration-prop">duration</a>() - (<a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>() + <a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>())) milliseconds.</p>
<p>A <a href="qfeedbackhapticseffect.html">QFeedbackHapticsEffect</a> is played on an <a href="qfeedbackhapticseffect.html#actuator-prop">actuator()</a>, which is the physical component that performs the effect. You can query if other actuators are available - see the <a href="qfeedbackactuator.html#actuators">QFeedbackActuator::actuators</a>() function documentation for details.</p>
<p>Errors occurring during playback are notified through the <a href="qfeedbackeffect.html#error">error</a>() signal.</p>
</div>
<p><b>See also </b><a href="qfeedbackactuator.html">QFeedbackActuator</a>.</p>
<!-- @@@QFeedbackHapticsEffect -->
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$actuator-prop$$$actuator$$$setActuatorQFeedbackActuator* -->
<h3 class="fn" id="actuator-prop"><a name="actuator-prop"></a><span class="name">actuator</span> : <span class="type"><a href="qfeedbackactuator.html">QFeedbackActuator</a></span> *</h3>
<p>This property holds the actuator on which the effect operates.</p>
<p>This property defines the actuator on which the effect operates. You can only change the actuator used when the effect is stopped. Setting a null actuator resets the effect to use the default actuator.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QFeedbackActuator * </td><td class="memItemRight bottomAlign"><span class="name"><b>actuator</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setActuator</b></span>(QFeedbackActuator *<i> actuator</i>)</td></tr>
</table></div>
<!-- @@@actuator -->
<!-- $$$attackIntensity-prop$$$attackIntensity$$$setAttackIntensityqreal -->
<h3 class="fn" id="attackIntensity-prop"><a name="attackIntensity-prop"></a><span class="name">attackIntensity</span> : <span class="type">qreal</span></h3>
<p>This property holds the initial intensity of the effect.</p>
<p>This property defines the initial intensity of the effect, before it fades in. It is usually lower than <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>. The effect will ramp up (or down) from attackIntensity() to <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>() in <a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>() milliseconds.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> qreal </td><td class="memItemRight bottomAlign"><span class="name"><b>attackIntensity</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setAttackIntensity</b></span>(qreal<i> intensity</i>)</td></tr>
</table></div>
<!-- @@@attackIntensity -->
<!-- $$$attackTime-prop$$$attackTime$$$setAttackTimeint -->
<h3 class="fn" id="attackTime-prop"><a name="attackTime-prop"></a><span class="name">attackTime</span> : <span class="type">int</span></h3>
<p>This property holds the duration of the fade-in effect.</p>
<p>This property defines the duration of the fade-in effect in milliseconds. The effect will ramp up (or down) from <a href="qfeedbackhapticseffect.html#attackIntensity-prop">attackIntensity</a>() to <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>() in attackTime() milliseconds.</p>
<p>If the attack time is set to a value such that attackTime() + <a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>() is greater than <a href="qfeedbackhapticseffect.html#duration-prop">duration</a>() for non-periodic effects, or greater than <a href="qfeedbackhapticseffect.html#period-prop">period</a>() for periodic effects, the waveform which will result is backend-specific.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>attackTime</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setAttackTime</b></span>(int<i> msecs</i>)</td></tr>
</table></div>
<p><b>See also </b><a href="qfeedbackhapticseffect.html#duration-prop">duration</a>() and <a href="qfeedbackhapticseffect.html#period-prop">period</a>().</p>
<!-- @@@attackTime -->
<!-- $$$duration-prop$$$duration$$$setDurationint -->
<h3 class="fn" id="duration-prop"><a name="duration-prop"></a><span class="name">duration</span> : <span class="type">int</span></h3>
<p>This property holds the expected duration of the effect.</p>
<p>This property defines the total duration of the feedback effect, in milliseconds. It includes the duration of any fade-in or fade-out parts, if any, in non-periodic effects, and includes all repetitions of the period in periodic-effects, if any.</p>
<p>If the duration is set to a value less than <a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>() + <a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>(), or less than the <a href="qfeedbackhapticseffect.html#period-prop">period</a>() of the effect, the waveform which will result is backend-specific.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> virtual int </td><td class="memItemRight bottomAlign"><span class="name"><b>duration</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setDuration</b></span>(int<i> msecs</i>)</td></tr>
</table></div>
<p><b>See also </b><a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>(), <a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>(), and <a href="qfeedbackhapticseffect.html#period-prop">period</a>().</p>
<!-- @@@duration -->
<!-- $$$fadeIntensity-prop$$$fadeIntensity$$$setFadeIntensityqreal -->
<h3 class="fn" id="fadeIntensity-prop"><a name="fadeIntensity-prop"></a><span class="name">fadeIntensity</span> : <span class="type">qreal</span></h3>
<p>This property holds the final intensity of the effect.</p>
<p>This property defines the final intensity of the effect, after it fades out. It is usually lower than <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>. The effect will ramp down (or up) from <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>() to fadeIntensity() in <a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>() milliseconds.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> qreal </td><td class="memItemRight bottomAlign"><span class="name"><b>fadeIntensity</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setFadeIntensity</b></span>(qreal<i> intensity</i>)</td></tr>
</table></div>
<!-- @@@fadeIntensity -->
<!-- $$$fadeTime-prop$$$fadeTime$$$setFadeTimeint -->
<h3 class="fn" id="fadeTime-prop"><a name="fadeTime-prop"></a><span class="name">fadeTime</span> : <span class="type">int</span></h3>
<p>This property holds the duration of the fade-out effect.</p>
<p>This property defines the duration of the fade-out effect in milliseconds. The effect will ramp down (or up) from <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>() to <a href="qfeedbackhapticseffect.html#fadeIntensity-prop">fadeIntensity</a>() in fadeTime() milliseconds.</p>
<p>If the fade time is set to a value such that <a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>() + fadeTime() is greater than <a href="qfeedbackhapticseffect.html#duration-prop">duration</a>() for non-periodic effects, or greater than <a href="qfeedbackhapticseffect.html#period-prop">period</a>() for periodic effects, the waveform which will result is backend-specific.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>fadeTime</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setFadeTime</b></span>(int<i> msecs</i>)</td></tr>
</table></div>
<p><b>See also </b><a href="qfeedbackhapticseffect.html#duration-prop">duration</a>() and <a href="qfeedbackhapticseffect.html#period-prop">period</a>().</p>
<!-- @@@fadeTime -->
<!-- $$$intensity-prop$$$intensity$$$setIntensityqreal -->
<h3 class="fn" id="intensity-prop"><a name="intensity-prop"></a><span class="name">intensity</span> : <span class="type">qreal</span></h3>
<p>This property holds the intensity of the effect.</p>
<p>This property defines the intensity of the feedback effect. The value can be between 0 and 1.</p>
<p>For non-periodic effects, the effect will be at this intensity for (<a href="qfeedbackhapticseffect.html#duration-prop">duration</a>() - (<a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>() + <a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>())) milliseconds. For periodic effects, the effect will be at this intensity once per period for (<a href="qfeedbackhapticseffect.html#period-prop">period</a>() - (<a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>() + <a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>())) milliseconds.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> qreal </td><td class="memItemRight bottomAlign"><span class="name"><b>intensity</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setIntensity</b></span>(qreal<i> intensity</i>)</td></tr>
</table></div>
<!-- @@@intensity -->
<!-- $$$period-prop$$$period$$$setPeriodint -->
<h3 class="fn" id="period-prop"><a name="period-prop"></a><span class="name">period</span> : <span class="type">int</span></h3>
<p>This property holds set the period for the effect.</p>
<p>It has a default value of -1, which means that it is not a periodic effect. You can only change the period when the effect is stopped. The duration of the effect should be set to a value larger than the period of the effect if you wish the periodicity to be discernable.</p>
<p><b>Note: </b>Not all actuators support periodic effects</p><p>The period defines the total length of the periodic envelope, which will be repeated up until <a href="qfeedbackhapticseffect.html#duration-prop">duration</a>() milliseconds has elapsed. For a periodic effect, the intensity will start at <a href="qfeedbackhapticseffect.html#attackIntensity-prop">attackIntensity</a>(), ramp to <a href="qfeedbackhapticseffect.html#intensity-prop">intensity</a>() (where it stays for (period() - (<a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>() + <a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>())) milliseconds), then ramp to <a href="qfeedbackhapticseffect.html#fadeIntensity-prop">fadeIntensity</a>(). This waveform will be repeated as many times as required until the <a href="qfeedbackhapticseffect.html#duration-prop">duration</a>() has elapsed.</p>
<p>If the period is set to a value which is less than <a href="qfeedbackhapticseffect.html#attackTime-prop">attackTime</a>() + <a href="qfeedbackhapticseffect.html#fadeTime-prop">fadeTime</a>(), the waveform which will result is backend-specific.</p>
<p><b>Access functions:</b></p>
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> int </td><td class="memItemRight bottomAlign"><span class="name"><b>period</b></span>() const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setPeriod</b></span>(int<i> msecs</i>)</td></tr>
</table></div>
<!-- @@@period -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QFeedbackHapticsEffect[overload1]$$$QFeedbackHapticsEffectQObject* -->
<h3 class="fn" id="QFeedbackHapticsEffect"><a name="QFeedbackHapticsEffect"></a>QFeedbackHapticsEffect::<span class="name">QFeedbackHapticsEffect</span>(<span class="type">QObject</span> *<i> parent</i> = 0)</h3>
<p>Constructs the <a href="qfeedbackhapticseffect.html">QFeedbackHapticsEffect</a> class, and passes <i>parent</i> to QObject's constructor. The default <a href="qfeedbackactuator.html">QFeedbackActuator</a> will be used.</p>
<p><b>See also </b><a href="qfeedbackactuator.html#actuators">QFeedbackActuator::actuators</a>().</p>
<!-- @@@QFeedbackHapticsEffect -->
<!-- $$$~QFeedbackHapticsEffect[overload1]$$$~QFeedbackHapticsEffect -->
<h3 class="fn" id="dtor.QFeedbackHapticsEffect"><a name="dtor.QFeedbackHapticsEffect"></a>QFeedbackHapticsEffect::<span class="name">~QFeedbackHapticsEffect</span>()</h3>
<p>Destroys this effect and stops the feedback if it is running.</p>
<!-- @@@~QFeedbackHapticsEffect -->
</div>
<div class="footer">Copyright (c) 2011 Nokia Corporation and/or its subsidiaries. All rights reserved.</div>
</body>
</html>