Absolute File Name: | /home/qt/qt5_coco/qt5/qtbase/src/widgets/graphicsview/qgraphicsitemanimation.cpp |
Source code | Switch to Preprocessed file |
Line | Source | Count | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | /**************************************************************************** | - | ||||||||||||
2 | ** | - | ||||||||||||
3 | ** Copyright (C) 2016 The Qt Company Ltd. | - | ||||||||||||
4 | ** Contact: https://www.qt.io/licensing/ | - | ||||||||||||
5 | ** | - | ||||||||||||
6 | ** This file is part of the QtWidgets module of the Qt Toolkit. | - | ||||||||||||
7 | ** | - | ||||||||||||
8 | ** $QT_BEGIN_LICENSE:LGPL$ | - | ||||||||||||
9 | ** Commercial License Usage | - | ||||||||||||
10 | ** Licensees holding valid commercial Qt licenses may use this file in | - | ||||||||||||
11 | ** accordance with the commercial license agreement provided with the | - | ||||||||||||
12 | ** Software or, alternatively, in accordance with the terms contained in | - | ||||||||||||
13 | ** a written agreement between you and The Qt Company. For licensing terms | - | ||||||||||||
14 | ** and conditions see https://www.qt.io/terms-conditions. For further | - | ||||||||||||
15 | ** information use the contact form at https://www.qt.io/contact-us. | - | ||||||||||||
16 | ** | - | ||||||||||||
17 | ** GNU Lesser General Public License Usage | - | ||||||||||||
18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - | ||||||||||||
19 | ** General Public License version 3 as published by the Free Software | - | ||||||||||||
20 | ** Foundation and appearing in the file LICENSE.LGPL3 included in the | - | ||||||||||||
21 | ** packaging of this file. Please review the following information to | - | ||||||||||||
22 | ** ensure the GNU Lesser General Public License version 3 requirements | - | ||||||||||||
23 | ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. | - | ||||||||||||
24 | ** | - | ||||||||||||
25 | ** GNU General Public License Usage | - | ||||||||||||
26 | ** Alternatively, this file may be used under the terms of the GNU | - | ||||||||||||
27 | ** General Public License version 2.0 or (at your option) the GNU General | - | ||||||||||||
28 | ** Public license version 3 or any later version approved by the KDE Free | - | ||||||||||||
29 | ** Qt Foundation. The licenses are as published by the Free Software | - | ||||||||||||
30 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 | - | ||||||||||||
31 | ** included in the packaging of this file. Please review the following | - | ||||||||||||
32 | ** information to ensure the GNU General Public License requirements will | - | ||||||||||||
33 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and | - | ||||||||||||
34 | ** https://www.gnu.org/licenses/gpl-3.0.html. | - | ||||||||||||
35 | ** | - | ||||||||||||
36 | ** $QT_END_LICENSE$ | - | ||||||||||||
37 | ** | - | ||||||||||||
38 | ****************************************************************************/ | - | ||||||||||||
39 | - | |||||||||||||
40 | /*! | - | ||||||||||||
41 | \class QGraphicsItemAnimation | - | ||||||||||||
42 | \brief The QGraphicsItemAnimation class provides simple animation | - | ||||||||||||
43 | support for QGraphicsItem. | - | ||||||||||||
44 | \since 4.2 | - | ||||||||||||
45 | \ingroup graphicsview-api | - | ||||||||||||
46 | \inmodule QtWidgets | - | ||||||||||||
47 | \deprecated | - | ||||||||||||
48 | - | |||||||||||||
49 | The QGraphicsItemAnimation class animates a QGraphicsItem. You can | - | ||||||||||||
50 | schedule changes to the item's transformation matrix at | - | ||||||||||||
51 | specified steps. The QGraphicsItemAnimation class has a | - | ||||||||||||
52 | current step value. When this value changes the transformations | - | ||||||||||||
53 | scheduled at that step are performed. The current step of the | - | ||||||||||||
54 | animation is set with the \c setStep() function. | - | ||||||||||||
55 | - | |||||||||||||
56 | QGraphicsItemAnimation will do a simple linear interpolation | - | ||||||||||||
57 | between the nearest adjacent scheduled changes to calculate the | - | ||||||||||||
58 | matrix. For instance, if you set the position of an item at values | - | ||||||||||||
59 | 0.0 and 1.0, the animation will show the item moving in a straight | - | ||||||||||||
60 | line between these positions. The same is true for scaling and | - | ||||||||||||
61 | rotation. | - | ||||||||||||
62 | - | |||||||||||||
63 | It is usual to use the class with a QTimeLine. The timeline's | - | ||||||||||||
64 | \l{QTimeLine::}{valueChanged()} signal is then connected to the | - | ||||||||||||
65 | \c setStep() slot. For example, you can set up an item for rotation | - | ||||||||||||
66 | by calling \c setRotationAt() for different step values. | - | ||||||||||||
67 | The animations timeline is set with the setTimeLine() function. | - | ||||||||||||
68 | - | |||||||||||||
69 | An example animation with a timeline follows: | - | ||||||||||||
70 | - | |||||||||||||
71 | \snippet timeline/main.cpp 0 | - | ||||||||||||
72 | - | |||||||||||||
73 | Note that steps lie between 0.0 and 1.0. It may be necessary to use | - | ||||||||||||
74 | \l{QTimeLine::}{setUpdateInterval()}. The default update interval | - | ||||||||||||
75 | is 40 ms. A scheduled transformation cannot be removed when set, | - | ||||||||||||
76 | so scheduling several transformations of the same kind (e.g., | - | ||||||||||||
77 | rotations) at the same step is not recommended. | - | ||||||||||||
78 | - | |||||||||||||
79 | \sa QTimeLine, {Graphics View Framework} | - | ||||||||||||
80 | */ | - | ||||||||||||
81 | - | |||||||||||||
82 | #include "qgraphicsitemanimation.h" | - | ||||||||||||
83 | - | |||||||||||||
84 | #ifndef QT_NO_GRAPHICSVIEW | - | ||||||||||||
85 | - | |||||||||||||
86 | #include "qgraphicsitem.h" | - | ||||||||||||
87 | - | |||||||||||||
88 | #include <QtCore/qtimeline.h> | - | ||||||||||||
89 | #include <QtCore/qpoint.h> | - | ||||||||||||
90 | #include <QtCore/qpointer.h> | - | ||||||||||||
91 | #include <QtCore/qpair.h> | - | ||||||||||||
92 | #include <QtGui/qmatrix.h> | - | ||||||||||||
93 | - | |||||||||||||
94 | #include <algorithm> | - | ||||||||||||
95 | - | |||||||||||||
96 | QT_BEGIN_NAMESPACE | - | ||||||||||||
97 | - | |||||||||||||
98 | static inline bool check_step_valid(qreal step, const char *method) | - | ||||||||||||
99 | { | - | ||||||||||||
100 | if (!(step >= 0 && step <= 1)) {
| 0 | ||||||||||||
101 | qWarning("QGraphicsItemAnimation::%s: invalid step = %f", method, step); | - | ||||||||||||
102 | return false; never executed: return false; | 0 | ||||||||||||
103 | } | - | ||||||||||||
104 | return true; never executed: return true; | 0 | ||||||||||||
105 | } | - | ||||||||||||
106 | - | |||||||||||||
107 | class QGraphicsItemAnimationPrivate | - | ||||||||||||
108 | { | - | ||||||||||||
109 | public: | - | ||||||||||||
110 | inline QGraphicsItemAnimationPrivate() | - | ||||||||||||
111 | : q(0), timeLine(0), item(0), step(0) | - | ||||||||||||
112 | { } never executed: end of block | 0 | ||||||||||||
113 | - | |||||||||||||
114 | QGraphicsItemAnimation *q; | - | ||||||||||||
115 | - | |||||||||||||
116 | QPointer<QTimeLine> timeLine; | - | ||||||||||||
117 | QGraphicsItem *item; | - | ||||||||||||
118 | - | |||||||||||||
119 | QPointF startPos; | - | ||||||||||||
120 | QMatrix startMatrix; | - | ||||||||||||
121 | - | |||||||||||||
122 | qreal step; | - | ||||||||||||
123 | - | |||||||||||||
124 | struct Pair { | - | ||||||||||||
125 | bool operator <(const Pair &other) const | - | ||||||||||||
126 | { return step < other.step; } never executed: return step < other.step; | 0 | ||||||||||||
127 | bool operator==(const Pair &other) const | - | ||||||||||||
128 | { return step == other.step; } never executed: return step == other.step; | 0 | ||||||||||||
129 | qreal step; | - | ||||||||||||
130 | qreal value; | - | ||||||||||||
131 | }; | - | ||||||||||||
132 | QVector<Pair> xPosition; | - | ||||||||||||
133 | QVector<Pair> yPosition; | - | ||||||||||||
134 | QVector<Pair> rotation; | - | ||||||||||||
135 | QVector<Pair> verticalScale; | - | ||||||||||||
136 | QVector<Pair> horizontalScale; | - | ||||||||||||
137 | QVector<Pair> verticalShear; | - | ||||||||||||
138 | QVector<Pair> horizontalShear; | - | ||||||||||||
139 | QVector<Pair> xTranslation; | - | ||||||||||||
140 | QVector<Pair> yTranslation; | - | ||||||||||||
141 | - | |||||||||||||
142 | qreal linearValueForStep(qreal step, const QVector<Pair> &source, qreal defaultValue = 0); | - | ||||||||||||
143 | void insertUniquePair(qreal step, qreal value, QVector<Pair> *binList, const char* method); | - | ||||||||||||
144 | }; | - | ||||||||||||
145 | Q_DECLARE_TYPEINFO(QGraphicsItemAnimationPrivate::Pair, Q_PRIMITIVE_TYPE); | - | ||||||||||||
146 | - | |||||||||||||
147 | qreal QGraphicsItemAnimationPrivate::linearValueForStep(qreal step, const QVector<Pair> &source, qreal defaultValue) | - | ||||||||||||
148 | { | - | ||||||||||||
149 | if (source.isEmpty())
| 0 | ||||||||||||
150 | return defaultValue; never executed: return defaultValue; | 0 | ||||||||||||
151 | step = qMin<qreal>(qMax<qreal>(step, 0), 1); | - | ||||||||||||
152 | - | |||||||||||||
153 | if (step == 1)
| 0 | ||||||||||||
154 | return source.back().value; never executed: return source.back().value; | 0 | ||||||||||||
155 | - | |||||||||||||
156 | qreal stepBefore = 0; | - | ||||||||||||
157 | qreal stepAfter = 1; | - | ||||||||||||
158 | qreal valueBefore = source.front().step == 0 ? source.front().value : defaultValue;
| 0 | ||||||||||||
159 | qreal valueAfter = source.back().value; | - | ||||||||||||
160 | - | |||||||||||||
161 | // Find the closest step and value before the given step. | - | ||||||||||||
162 | for (int i = 0; i < source.size() && step >= source[i].step; ++i) {
| 0 | ||||||||||||
163 | stepBefore = source[i].step; | - | ||||||||||||
164 | valueBefore = source[i].value; | - | ||||||||||||
165 | } never executed: end of block | 0 | ||||||||||||
166 | - | |||||||||||||
167 | // Find the closest step and value after the given step. | - | ||||||||||||
168 | for (int i = source.size() - 1; i >= 0 && step < source[i].step; --i) {
| 0 | ||||||||||||
169 | stepAfter = source[i].step; | - | ||||||||||||
170 | valueAfter = source[i].value; | - | ||||||||||||
171 | } never executed: end of block | 0 | ||||||||||||
172 | - | |||||||||||||
173 | // Do a simple linear interpolation. | - | ||||||||||||
174 | return valueBefore + (valueAfter - valueBefore) * ((step - stepBefore) / (stepAfter - stepBefore)); never executed: return valueBefore + (valueAfter - valueBefore) * ((step - stepBefore) / (stepAfter - stepBefore)); | 0 | ||||||||||||
175 | } | - | ||||||||||||
176 | - | |||||||||||||
177 | void QGraphicsItemAnimationPrivate::insertUniquePair(qreal step, qreal value, QVector<Pair> *binList, const char* method) | - | ||||||||||||
178 | { | - | ||||||||||||
179 | if (!check_step_valid(step, method))
| 0 | ||||||||||||
180 | return; never executed: return; | 0 | ||||||||||||
181 | - | |||||||||||||
182 | const Pair pair = { step, value }; | - | ||||||||||||
183 | - | |||||||||||||
184 | const QVector<Pair>::iterator result = std::lower_bound(binList->begin(), binList->end(), pair); | - | ||||||||||||
185 | if (result == binList->end() || pair < *result)
| 0 | ||||||||||||
186 | binList->insert(result, pair); never executed: binList->insert(result, pair); | 0 | ||||||||||||
187 | else | - | ||||||||||||
188 | result->value = value; never executed: result->value = value; | 0 | ||||||||||||
189 | } | - | ||||||||||||
190 | - | |||||||||||||
191 | /*! | - | ||||||||||||
192 | Constructs an animation object with the given \a parent. | - | ||||||||||||
193 | */ | - | ||||||||||||
194 | QGraphicsItemAnimation::QGraphicsItemAnimation(QObject *parent) | - | ||||||||||||
195 | : QObject(parent), d(new QGraphicsItemAnimationPrivate) | - | ||||||||||||
196 | { | - | ||||||||||||
197 | d->q = this; | - | ||||||||||||
198 | } never executed: end of block | 0 | ||||||||||||
199 | - | |||||||||||||
200 | /*! | - | ||||||||||||
201 | Destroys the animation object. | - | ||||||||||||
202 | */ | - | ||||||||||||
203 | QGraphicsItemAnimation::~QGraphicsItemAnimation() | - | ||||||||||||
204 | { | - | ||||||||||||
205 | delete d; | - | ||||||||||||
206 | } never executed: end of block | 0 | ||||||||||||
207 | - | |||||||||||||
208 | /*! | - | ||||||||||||
209 | Returns the item on which the animation object operates. | - | ||||||||||||
210 | - | |||||||||||||
211 | \sa setItem() | - | ||||||||||||
212 | */ | - | ||||||||||||
213 | QGraphicsItem *QGraphicsItemAnimation::item() const | - | ||||||||||||
214 | { | - | ||||||||||||
215 | return d->item; never executed: return d->item; | 0 | ||||||||||||
216 | } | - | ||||||||||||
217 | - | |||||||||||||
218 | /*! | - | ||||||||||||
219 | Sets the specified \a item to be used in the animation. | - | ||||||||||||
220 | - | |||||||||||||
221 | \sa item() | - | ||||||||||||
222 | */ | - | ||||||||||||
223 | void QGraphicsItemAnimation::setItem(QGraphicsItem *item) | - | ||||||||||||
224 | { | - | ||||||||||||
225 | d->item = item; | - | ||||||||||||
226 | d->startPos = d->item->pos(); | - | ||||||||||||
227 | } never executed: end of block | 0 | ||||||||||||
228 | - | |||||||||||||
229 | /*! | - | ||||||||||||
230 | Returns the timeline object used to control the rate at which the animation | - | ||||||||||||
231 | occurs. | - | ||||||||||||
232 | - | |||||||||||||
233 | \sa setTimeLine() | - | ||||||||||||
234 | */ | - | ||||||||||||
235 | QTimeLine *QGraphicsItemAnimation::timeLine() const | - | ||||||||||||
236 | { | - | ||||||||||||
237 | return d->timeLine; never executed: return d->timeLine; | 0 | ||||||||||||
238 | } | - | ||||||||||||
239 | - | |||||||||||||
240 | /*! | - | ||||||||||||
241 | Sets the timeline object used to control the rate of animation to the \a timeLine | - | ||||||||||||
242 | specified. | - | ||||||||||||
243 | - | |||||||||||||
244 | \sa timeLine() | - | ||||||||||||
245 | */ | - | ||||||||||||
246 | void QGraphicsItemAnimation::setTimeLine(QTimeLine *timeLine) | - | ||||||||||||
247 | { | - | ||||||||||||
248 | if (d->timeLine == timeLine)
| 0 | ||||||||||||
249 | return; never executed: return; | 0 | ||||||||||||
250 | if (d->timeLine)
| 0 | ||||||||||||
251 | delete d->timeLine; never executed: delete d->timeLine; | 0 | ||||||||||||
252 | if (!timeLine)
| 0 | ||||||||||||
253 | return; never executed: return; | 0 | ||||||||||||
254 | d->timeLine = timeLine; | - | ||||||||||||
255 | connect(timeLine, SIGNAL(valueChanged(qreal)), this, SLOT(setStep(qreal))); | - | ||||||||||||
256 | } never executed: end of block | 0 | ||||||||||||
257 | - | |||||||||||||
258 | /*! | - | ||||||||||||
259 | Returns the position of the item at the given \a step value. | - | ||||||||||||
260 | - | |||||||||||||
261 | \sa setPosAt() | - | ||||||||||||
262 | */ | - | ||||||||||||
263 | QPointF QGraphicsItemAnimation::posAt(qreal step) const | - | ||||||||||||
264 | { | - | ||||||||||||
265 | check_step_valid(step, "posAt"); | - | ||||||||||||
266 | return QPointF(d->linearValueForStep(step, d->xPosition, d->startPos.x()), never executed: return QPointF(d->linearValueForStep(step, d->xPosition, d->startPos.x()), d->linearValueForStep(step, d->yPosition, d->startPos.y())); | 0 | ||||||||||||
267 | d->linearValueForStep(step, d->yPosition, d->startPos.y())); never executed: return QPointF(d->linearValueForStep(step, d->xPosition, d->startPos.x()), d->linearValueForStep(step, d->yPosition, d->startPos.y())); | 0 | ||||||||||||
268 | } | - | ||||||||||||
269 | - | |||||||||||||
270 | /*! | - | ||||||||||||
271 | \fn void QGraphicsItemAnimation::setPosAt(qreal step, const QPointF &point) | - | ||||||||||||
272 | - | |||||||||||||
273 | Sets the position of the item at the given \a step value to the \a point specified. | - | ||||||||||||
274 | - | |||||||||||||
275 | \sa posAt() | - | ||||||||||||
276 | */ | - | ||||||||||||
277 | void QGraphicsItemAnimation::setPosAt(qreal step, const QPointF &pos) | - | ||||||||||||
278 | { | - | ||||||||||||
279 | d->insertUniquePair(step, pos.x(), &d->xPosition, "setPosAt"); | - | ||||||||||||
280 | d->insertUniquePair(step, pos.y(), &d->yPosition, "setPosAt"); | - | ||||||||||||
281 | } never executed: end of block | 0 | ||||||||||||
282 | - | |||||||||||||
283 | /*! | - | ||||||||||||
284 | Returns all explicitly inserted positions. | - | ||||||||||||
285 | - | |||||||||||||
286 | \sa posAt(), setPosAt() | - | ||||||||||||
287 | */ | - | ||||||||||||
288 | QList<QPair<qreal, QPointF> > QGraphicsItemAnimation::posList() const | - | ||||||||||||
289 | { | - | ||||||||||||
290 | QList<QPair<qreal, QPointF> > list; | - | ||||||||||||
291 | const int xPosCount = d->xPosition.size(); | - | ||||||||||||
292 | list.reserve(xPosCount); | - | ||||||||||||
293 | for (int i = 0; i < xPosCount; ++i)
| 0 | ||||||||||||
294 | list << QPair<qreal, QPointF>(d->xPosition.at(i).step, QPointF(d->xPosition.at(i).value, d->yPosition.at(i).value)); never executed: list << QPair<qreal, QPointF>(d->xPosition.at(i).step, QPointF(d->xPosition.at(i).value, d->yPosition.at(i).value)); | 0 | ||||||||||||
295 | - | |||||||||||||
296 | return list; never executed: return list; | 0 | ||||||||||||
297 | } | - | ||||||||||||
298 | - | |||||||||||||
299 | /*! | - | ||||||||||||
300 | Returns the matrix used to transform the item at the specified \a step value. | - | ||||||||||||
301 | */ | - | ||||||||||||
302 | QMatrix QGraphicsItemAnimation::matrixAt(qreal step) const | - | ||||||||||||
303 | { | - | ||||||||||||
304 | check_step_valid(step, "matrixAt"); | - | ||||||||||||
305 | - | |||||||||||||
306 | QMatrix matrix; | - | ||||||||||||
307 | if (!d->rotation.isEmpty())
| 0 | ||||||||||||
308 | matrix.rotate(rotationAt(step)); never executed: matrix.rotate(rotationAt(step)); | 0 | ||||||||||||
309 | if (!d->verticalScale.isEmpty())
| 0 | ||||||||||||
310 | matrix.scale(horizontalScaleAt(step), verticalScaleAt(step)); never executed: matrix.scale(horizontalScaleAt(step), verticalScaleAt(step)); | 0 | ||||||||||||
311 | if (!d->verticalShear.isEmpty())
| 0 | ||||||||||||
312 | matrix.shear(horizontalShearAt(step), verticalShearAt(step)); never executed: matrix.shear(horizontalShearAt(step), verticalShearAt(step)); | 0 | ||||||||||||
313 | if (!d->xTranslation.isEmpty())
| 0 | ||||||||||||
314 | matrix.translate(xTranslationAt(step), yTranslationAt(step)); never executed: matrix.translate(xTranslationAt(step), yTranslationAt(step)); | 0 | ||||||||||||
315 | return matrix; never executed: return matrix; | 0 | ||||||||||||
316 | } | - | ||||||||||||
317 | - | |||||||||||||
318 | /*! | - | ||||||||||||
319 | Returns the angle at which the item is rotated at the specified \a step value. | - | ||||||||||||
320 | - | |||||||||||||
321 | \sa setRotationAt() | - | ||||||||||||
322 | */ | - | ||||||||||||
323 | qreal QGraphicsItemAnimation::rotationAt(qreal step) const | - | ||||||||||||
324 | { | - | ||||||||||||
325 | check_step_valid(step, "rotationAt"); | - | ||||||||||||
326 | return d->linearValueForStep(step, d->rotation); never executed: return d->linearValueForStep(step, d->rotation); | 0 | ||||||||||||
327 | } | - | ||||||||||||
328 | - | |||||||||||||
329 | /*! | - | ||||||||||||
330 | Sets the rotation of the item at the given \a step value to the \a angle specified. | - | ||||||||||||
331 | - | |||||||||||||
332 | \sa rotationAt() | - | ||||||||||||
333 | */ | - | ||||||||||||
334 | void QGraphicsItemAnimation::setRotationAt(qreal step, qreal angle) | - | ||||||||||||
335 | { | - | ||||||||||||
336 | d->insertUniquePair(step, angle, &d->rotation, "setRotationAt"); | - | ||||||||||||
337 | } never executed: end of block | 0 | ||||||||||||
338 | - | |||||||||||||
339 | /*! | - | ||||||||||||
340 | Returns all explicitly inserted rotations. | - | ||||||||||||
341 | - | |||||||||||||
342 | \sa rotationAt(), setRotationAt() | - | ||||||||||||
343 | */ | - | ||||||||||||
344 | QList<QPair<qreal, qreal> > QGraphicsItemAnimation::rotationList() const | - | ||||||||||||
345 | { | - | ||||||||||||
346 | QList<QPair<qreal, qreal> > list; | - | ||||||||||||
347 | const int numRotations = d->rotation.size(); | - | ||||||||||||
348 | list.reserve(numRotations); | - | ||||||||||||
349 | for (int i = 0; i < numRotations; ++i)
| 0 | ||||||||||||
350 | list << QPair<qreal, qreal>(d->rotation.at(i).step, d->rotation.at(i).value); never executed: list << QPair<qreal, qreal>(d->rotation.at(i).step, d->rotation.at(i).value); | 0 | ||||||||||||
351 | - | |||||||||||||
352 | return list; never executed: return list; | 0 | ||||||||||||
353 | } | - | ||||||||||||
354 | - | |||||||||||||
355 | /*! | - | ||||||||||||
356 | Returns the horizontal translation of the item at the specified \a step value. | - | ||||||||||||
357 | - | |||||||||||||
358 | \sa setTranslationAt() | - | ||||||||||||
359 | */ | - | ||||||||||||
360 | qreal QGraphicsItemAnimation::xTranslationAt(qreal step) const | - | ||||||||||||
361 | { | - | ||||||||||||
362 | check_step_valid(step, "xTranslationAt"); | - | ||||||||||||
363 | return d->linearValueForStep(step, d->xTranslation); never executed: return d->linearValueForStep(step, d->xTranslation); | 0 | ||||||||||||
364 | } | - | ||||||||||||
365 | - | |||||||||||||
366 | /*! | - | ||||||||||||
367 | Returns the vertical translation of the item at the specified \a step value. | - | ||||||||||||
368 | - | |||||||||||||
369 | \sa setTranslationAt() | - | ||||||||||||
370 | */ | - | ||||||||||||
371 | qreal QGraphicsItemAnimation::yTranslationAt(qreal step) const | - | ||||||||||||
372 | { | - | ||||||||||||
373 | check_step_valid(step, "yTranslationAt"); | - | ||||||||||||
374 | return d->linearValueForStep(step, d->yTranslation); never executed: return d->linearValueForStep(step, d->yTranslation); | 0 | ||||||||||||
375 | } | - | ||||||||||||
376 | - | |||||||||||||
377 | /*! | - | ||||||||||||
378 | Sets the translation of the item at the given \a step value using the horizontal | - | ||||||||||||
379 | and vertical coordinates specified by \a dx and \a dy. | - | ||||||||||||
380 | - | |||||||||||||
381 | \sa xTranslationAt(), yTranslationAt() | - | ||||||||||||
382 | */ | - | ||||||||||||
383 | void QGraphicsItemAnimation::setTranslationAt(qreal step, qreal dx, qreal dy) | - | ||||||||||||
384 | { | - | ||||||||||||
385 | d->insertUniquePair(step, dx, &d->xTranslation, "setTranslationAt"); | - | ||||||||||||
386 | d->insertUniquePair(step, dy, &d->yTranslation, "setTranslationAt"); | - | ||||||||||||
387 | } never executed: end of block | 0 | ||||||||||||
388 | - | |||||||||||||
389 | /*! | - | ||||||||||||
390 | Returns all explicitly inserted translations. | - | ||||||||||||
391 | - | |||||||||||||
392 | \sa xTranslationAt(), yTranslationAt(), setTranslationAt() | - | ||||||||||||
393 | */ | - | ||||||||||||
394 | QList<QPair<qreal, QPointF> > QGraphicsItemAnimation::translationList() const | - | ||||||||||||
395 | { | - | ||||||||||||
396 | QList<QPair<qreal, QPointF> > list; | - | ||||||||||||
397 | const int numTranslations = d->xTranslation.size(); | - | ||||||||||||
398 | list.reserve(numTranslations); | - | ||||||||||||
399 | for (int i = 0; i < numTranslations; ++i)
| 0 | ||||||||||||
400 | list << QPair<qreal, QPointF>(d->xTranslation.at(i).step, QPointF(d->xTranslation.at(i).value, d->yTranslation.at(i).value)); never executed: list << QPair<qreal, QPointF>(d->xTranslation.at(i).step, QPointF(d->xTranslation.at(i).value, d->yTranslation.at(i).value)); | 0 | ||||||||||||
401 | - | |||||||||||||
402 | return list; never executed: return list; | 0 | ||||||||||||
403 | } | - | ||||||||||||
404 | - | |||||||||||||
405 | /*! | - | ||||||||||||
406 | Returns the vertical scale for the item at the specified \a step value. | - | ||||||||||||
407 | - | |||||||||||||
408 | \sa setScaleAt() | - | ||||||||||||
409 | */ | - | ||||||||||||
410 | qreal QGraphicsItemAnimation::verticalScaleAt(qreal step) const | - | ||||||||||||
411 | { | - | ||||||||||||
412 | check_step_valid(step, "verticalScaleAt"); | - | ||||||||||||
413 | - | |||||||||||||
414 | return d->linearValueForStep(step, d->verticalScale, 1); never executed: return d->linearValueForStep(step, d->verticalScale, 1); | 0 | ||||||||||||
415 | } | - | ||||||||||||
416 | - | |||||||||||||
417 | /*! | - | ||||||||||||
418 | Returns the horizontal scale for the item at the specified \a step value. | - | ||||||||||||
419 | - | |||||||||||||
420 | \sa setScaleAt() | - | ||||||||||||
421 | */ | - | ||||||||||||
422 | qreal QGraphicsItemAnimation::horizontalScaleAt(qreal step) const | - | ||||||||||||
423 | { | - | ||||||||||||
424 | check_step_valid(step, "horizontalScaleAt"); | - | ||||||||||||
425 | return d->linearValueForStep(step, d->horizontalScale, 1); never executed: return d->linearValueForStep(step, d->horizontalScale, 1); | 0 | ||||||||||||
426 | } | - | ||||||||||||
427 | - | |||||||||||||
428 | /*! | - | ||||||||||||
429 | Sets the scale of the item at the given \a step value using the horizontal and | - | ||||||||||||
430 | vertical scale factors specified by \a sx and \a sy. | - | ||||||||||||
431 | - | |||||||||||||
432 | \sa verticalScaleAt(), horizontalScaleAt() | - | ||||||||||||
433 | */ | - | ||||||||||||
434 | void QGraphicsItemAnimation::setScaleAt(qreal step, qreal sx, qreal sy) | - | ||||||||||||
435 | { | - | ||||||||||||
436 | d->insertUniquePair(step, sx, &d->horizontalScale, "setScaleAt"); | - | ||||||||||||
437 | d->insertUniquePair(step, sy, &d->verticalScale, "setScaleAt"); | - | ||||||||||||
438 | } never executed: end of block | 0 | ||||||||||||
439 | - | |||||||||||||
440 | /*! | - | ||||||||||||
441 | Returns all explicitly inserted scales. | - | ||||||||||||
442 | - | |||||||||||||
443 | \sa verticalScaleAt(), horizontalScaleAt(), setScaleAt() | - | ||||||||||||
444 | */ | - | ||||||||||||
445 | QList<QPair<qreal, QPointF> > QGraphicsItemAnimation::scaleList() const | - | ||||||||||||
446 | { | - | ||||||||||||
447 | QList<QPair<qreal, QPointF> > list; | - | ||||||||||||
448 | const int numScales = d->horizontalScale.size(); | - | ||||||||||||
449 | list.reserve(numScales); | - | ||||||||||||
450 | for (int i = 0; i < numScales; ++i)
| 0 | ||||||||||||
451 | list << QPair<qreal, QPointF>(d->horizontalScale.at(i).step, QPointF(d->horizontalScale.at(i).value, d->verticalScale.at(i).value)); never executed: list << QPair<qreal, QPointF>(d->horizontalScale.at(i).step, QPointF(d->horizontalScale.at(i).value, d->verticalScale.at(i).value)); | 0 | ||||||||||||
452 | - | |||||||||||||
453 | return list; never executed: return list; | 0 | ||||||||||||
454 | } | - | ||||||||||||
455 | - | |||||||||||||
456 | /*! | - | ||||||||||||
457 | Returns the vertical shear for the item at the specified \a step value. | - | ||||||||||||
458 | - | |||||||||||||
459 | \sa setShearAt() | - | ||||||||||||
460 | */ | - | ||||||||||||
461 | qreal QGraphicsItemAnimation::verticalShearAt(qreal step) const | - | ||||||||||||
462 | { | - | ||||||||||||
463 | check_step_valid(step, "verticalShearAt"); | - | ||||||||||||
464 | return d->linearValueForStep(step, d->verticalShear, 0); never executed: return d->linearValueForStep(step, d->verticalShear, 0); | 0 | ||||||||||||
465 | } | - | ||||||||||||
466 | - | |||||||||||||
467 | /*! | - | ||||||||||||
468 | Returns the horizontal shear for the item at the specified \a step value. | - | ||||||||||||
469 | - | |||||||||||||
470 | \sa setShearAt() | - | ||||||||||||
471 | */ | - | ||||||||||||
472 | qreal QGraphicsItemAnimation::horizontalShearAt(qreal step) const | - | ||||||||||||
473 | { | - | ||||||||||||
474 | check_step_valid(step, "horizontalShearAt"); | - | ||||||||||||
475 | return d->linearValueForStep(step, d->horizontalShear, 0); never executed: return d->linearValueForStep(step, d->horizontalShear, 0); | 0 | ||||||||||||
476 | } | - | ||||||||||||
477 | - | |||||||||||||
478 | /*! | - | ||||||||||||
479 | Sets the shear of the item at the given \a step value using the horizontal and | - | ||||||||||||
480 | vertical shear factors specified by \a sh and \a sv. | - | ||||||||||||
481 | - | |||||||||||||
482 | \sa verticalShearAt(), horizontalShearAt() | - | ||||||||||||
483 | */ | - | ||||||||||||
484 | void QGraphicsItemAnimation::setShearAt(qreal step, qreal sh, qreal sv) | - | ||||||||||||
485 | { | - | ||||||||||||
486 | d->insertUniquePair(step, sh, &d->horizontalShear, "setShearAt"); | - | ||||||||||||
487 | d->insertUniquePair(step, sv, &d->verticalShear, "setShearAt"); | - | ||||||||||||
488 | } never executed: end of block | 0 | ||||||||||||
489 | - | |||||||||||||
490 | /*! | - | ||||||||||||
491 | Returns all explicitly inserted shears. | - | ||||||||||||
492 | - | |||||||||||||
493 | \sa verticalShearAt(), horizontalShearAt(), setShearAt() | - | ||||||||||||
494 | */ | - | ||||||||||||
495 | QList<QPair<qreal, QPointF> > QGraphicsItemAnimation::shearList() const | - | ||||||||||||
496 | { | - | ||||||||||||
497 | QList<QPair<qreal, QPointF> > list; | - | ||||||||||||
498 | const int numShears = d->horizontalShear.size(); | - | ||||||||||||
499 | list.reserve(numShears); | - | ||||||||||||
500 | for (int i = 0; i < numShears; ++i)
| 0 | ||||||||||||
501 | list << QPair<qreal, QPointF>(d->horizontalShear.at(i).step, QPointF(d->horizontalShear.at(i).value, d->verticalShear.at(i).value)); never executed: list << QPair<qreal, QPointF>(d->horizontalShear.at(i).step, QPointF(d->horizontalShear.at(i).value, d->verticalShear.at(i).value)); | 0 | ||||||||||||
502 | - | |||||||||||||
503 | return list; never executed: return list; | 0 | ||||||||||||
504 | } | - | ||||||||||||
505 | - | |||||||||||||
506 | /*! | - | ||||||||||||
507 | Clears the scheduled transformations used for the animation, but | - | ||||||||||||
508 | retains the item and timeline. | - | ||||||||||||
509 | */ | - | ||||||||||||
510 | void QGraphicsItemAnimation::clear() | - | ||||||||||||
511 | { | - | ||||||||||||
512 | d->xPosition.clear(); | - | ||||||||||||
513 | d->yPosition.clear(); | - | ||||||||||||
514 | d->rotation.clear(); | - | ||||||||||||
515 | d->verticalScale.clear(); | - | ||||||||||||
516 | d->horizontalScale.clear(); | - | ||||||||||||
517 | d->verticalShear.clear(); | - | ||||||||||||
518 | d->horizontalShear.clear(); | - | ||||||||||||
519 | d->xTranslation.clear(); | - | ||||||||||||
520 | d->yTranslation.clear(); | - | ||||||||||||
521 | } never executed: end of block | 0 | ||||||||||||
522 | - | |||||||||||||
523 | /*! | - | ||||||||||||
524 | \fn void QGraphicsItemAnimation::setStep(qreal step) | - | ||||||||||||
525 | - | |||||||||||||
526 | Sets the current \a step value for the animation, causing the | - | ||||||||||||
527 | transformations scheduled at this step to be performed. | - | ||||||||||||
528 | */ | - | ||||||||||||
529 | void QGraphicsItemAnimation::setStep(qreal step) | - | ||||||||||||
530 | { | - | ||||||||||||
531 | if (!check_step_valid(step, "setStep"))
| 0 | ||||||||||||
532 | return; never executed: return; | 0 | ||||||||||||
533 | - | |||||||||||||
534 | beforeAnimationStep(step); | - | ||||||||||||
535 | - | |||||||||||||
536 | d->step = step; | - | ||||||||||||
537 | if (d->item) {
| 0 | ||||||||||||
538 | if (!d->xPosition.isEmpty() || !d->yPosition.isEmpty())
| 0 | ||||||||||||
539 | d->item->setPos(posAt(step)); never executed: d->item->setPos(posAt(step)); | 0 | ||||||||||||
540 | if (!d->rotation.isEmpty()
| 0 | ||||||||||||
541 | || !d->verticalScale.isEmpty()
| 0 | ||||||||||||
542 | || !d->horizontalScale.isEmpty()
| 0 | ||||||||||||
543 | || !d->verticalShear.isEmpty()
| 0 | ||||||||||||
544 | || !d->horizontalShear.isEmpty()
| 0 | ||||||||||||
545 | || !d->xTranslation.isEmpty()
| 0 | ||||||||||||
546 | || !d->yTranslation.isEmpty()) {
| 0 | ||||||||||||
547 | d->item->setMatrix(d->startMatrix * matrixAt(step)); | - | ||||||||||||
548 | } never executed: end of block | 0 | ||||||||||||
549 | } never executed: end of block | 0 | ||||||||||||
550 | - | |||||||||||||
551 | afterAnimationStep(step); | - | ||||||||||||
552 | } never executed: end of block | 0 | ||||||||||||
553 | - | |||||||||||||
554 | /*! | - | ||||||||||||
555 | Resets the item to its starting position and transformation. | - | ||||||||||||
556 | - | |||||||||||||
557 | \obsolete | - | ||||||||||||
558 | - | |||||||||||||
559 | You can call setStep(0) instead. | - | ||||||||||||
560 | */ | - | ||||||||||||
561 | void QGraphicsItemAnimation::reset() | - | ||||||||||||
562 | { | - | ||||||||||||
563 | if (!d->item)
| 0 | ||||||||||||
564 | return; never executed: return; | 0 | ||||||||||||
565 | d->startPos = d->item->pos(); | - | ||||||||||||
566 | d->startMatrix = d->item->matrix(); | - | ||||||||||||
567 | } never executed: end of block | 0 | ||||||||||||
568 | - | |||||||||||||
569 | /*! | - | ||||||||||||
570 | \fn void QGraphicsItemAnimation::beforeAnimationStep(qreal step) | - | ||||||||||||
571 | - | |||||||||||||
572 | This method is meant to be overridden by subclassed that needs to | - | ||||||||||||
573 | execute additional code before a new step takes place. The | - | ||||||||||||
574 | animation \a step is provided for use in cases where the action | - | ||||||||||||
575 | depends on its value. | - | ||||||||||||
576 | */ | - | ||||||||||||
577 | void QGraphicsItemAnimation::beforeAnimationStep(qreal step) | - | ||||||||||||
578 | { | - | ||||||||||||
579 | Q_UNUSED(step); | - | ||||||||||||
580 | } never executed: end of block | 0 | ||||||||||||
581 | - | |||||||||||||
582 | /*! | - | ||||||||||||
583 | \fn void QGraphicsItemAnimation::afterAnimationStep(qreal step) | - | ||||||||||||
584 | - | |||||||||||||
585 | This method is meant to be overridden in subclasses that need to | - | ||||||||||||
586 | execute additional code after a new step has taken place. The | - | ||||||||||||
587 | animation \a step is provided for use in cases where the action | - | ||||||||||||
588 | depends on its value. | - | ||||||||||||
589 | */ | - | ||||||||||||
590 | void QGraphicsItemAnimation::afterAnimationStep(qreal step) | - | ||||||||||||
591 | { | - | ||||||||||||
592 | Q_UNUSED(step); | - | ||||||||||||
593 | } never executed: end of block | 0 | ||||||||||||
594 | - | |||||||||||||
595 | QT_END_NAMESPACE | - | ||||||||||||
596 | - | |||||||||||||
597 | #include "moc_qgraphicsitemanimation.cpp" | - | ||||||||||||
598 | - | |||||||||||||
599 | #endif // QT_NO_GRAPHICSVIEW | - | ||||||||||||
Source code | Switch to Preprocessed file |