Line | Source Code | Coverage |
---|
1 | /**************************************************************************** | - |
2 | ** | - |
3 | ** Copyright (C) 2013 Digia Plc and/or its subsidiary(-ies). | - |
4 | ** Contact: http://www.qt-project.org/legal | - |
5 | ** | - |
6 | ** This file is part of the QtCore 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 Digia. For licensing terms and | - |
14 | ** conditions see http://qt.digia.com/licensing. For further information | - |
15 | ** use the contact form at http://qt.digia.com/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 2.1 as published by the Free Software | - |
20 | ** Foundation and appearing in the file LICENSE.LGPL included in the | - |
21 | ** packaging of this file. Please review the following information to | - |
22 | ** ensure the GNU Lesser General Public License version 2.1 requirements | - |
23 | ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. | - |
24 | ** | - |
25 | ** In addition, as a special exception, Digia gives you certain additional | - |
26 | ** rights. These rights are described in the Digia Qt LGPL Exception | - |
27 | ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. | - |
28 | ** | - |
29 | ** GNU General Public License Usage | - |
30 | ** Alternatively, this file may be used under the terms of the GNU | - |
31 | ** General Public License version 3.0 as published by the Free Software | - |
32 | ** Foundation and appearing in the file LICENSE.GPL included in the | - |
33 | ** packaging of this file. Please review the following information to | - |
34 | ** ensure the GNU General Public License version 3.0 requirements will be | - |
35 | ** met: http://www.gnu.org/copyleft/gpl.html. | - |
36 | ** | - |
37 | ** | - |
38 | ** $QT_END_LICENSE$ | - |
39 | ** | - |
40 | ****************************************************************************/ | - |
41 | | - |
42 | #include "qsize.h" | - |
43 | #include "qdatastream.h" | - |
44 | #include "qdebug.h" | - |
45 | | - |
46 | QT_BEGIN_NAMESPACE | - |
47 | | - |
48 | /*! | - |
49 | \class QSize | - |
50 | \inmodule QtCore | - |
51 | \ingroup painting | - |
52 | | - |
53 | \brief The QSize class defines the size of a two-dimensional | - |
54 | object using integer point precision. | - |
55 | | - |
56 | A size is specified by a width() and a height(). It can be set in | - |
57 | the constructor and changed using the setWidth(), setHeight(), or | - |
58 | scale() functions, or using arithmetic operators. A size can also | - |
59 | be manipulated directly by retrieving references to the width and | - |
60 | height using the rwidth() and rheight() functions. Finally, the | - |
61 | width and height can be swapped using the transpose() function. | - |
62 | | - |
63 | The isValid() function determines if a size is valid (a valid size | - |
64 | has both width and height greater than zero). The isEmpty() | - |
65 | function returns true if either of the width and height is less | - |
66 | than, or equal to, zero, while the isNull() function returns true | - |
67 | only if both the width and the height is zero. | - |
68 | | - |
69 | Use the expandedTo() function to retrieve a size which holds the | - |
70 | maximum height and width of \e this size and a given | - |
71 | size. Similarly, the boundedTo() function returns a size which | - |
72 | holds the minimum height and width of \e this size and a given | - |
73 | size. | - |
74 | | - |
75 | QSize objects can be streamed as well as compared. | - |
76 | | - |
77 | \sa QSizeF, QPoint, QRect | - |
78 | */ | - |
79 | | - |
80 | | - |
81 | /***************************************************************************** | - |
82 | QSize member functions | - |
83 | *****************************************************************************/ | - |
84 | | - |
85 | /*! | - |
86 | \fn QSize::QSize() | - |
87 | | - |
88 | Constructs a size with an invalid width and height (i.e., isValid() | - |
89 | returns false). | - |
90 | | - |
91 | \sa isValid() | - |
92 | */ | - |
93 | | - |
94 | /*! | - |
95 | \fn QSize::QSize(int width, int height) | - |
96 | | - |
97 | Constructs a size with the given \a width and \a height. | - |
98 | | - |
99 | \sa setWidth(), setHeight() | - |
100 | */ | - |
101 | | - |
102 | /*! | - |
103 | \fn bool QSize::isNull() const | - |
104 | | - |
105 | Returns true if both the width and height is 0; otherwise returns | - |
106 | false. | - |
107 | | - |
108 | \sa isValid(), isEmpty() | - |
109 | */ | - |
110 | | - |
111 | /*! | - |
112 | \fn bool QSize::isEmpty() const | - |
113 | | - |
114 | Returns true if either of the width and height is less than or | - |
115 | equal to 0; otherwise returns false. | - |
116 | | - |
117 | \sa isNull(), isValid() | - |
118 | */ | - |
119 | | - |
120 | /*! | - |
121 | \fn bool QSize::isValid() const | - |
122 | | - |
123 | Returns true if both the width and height is equal to or greater | - |
124 | than 0; otherwise returns false. | - |
125 | | - |
126 | \sa isNull(), isEmpty() | - |
127 | */ | - |
128 | | - |
129 | /*! | - |
130 | \fn int QSize::width() const | - |
131 | | - |
132 | Returns the width. | - |
133 | | - |
134 | \sa height(), setWidth() | - |
135 | */ | - |
136 | | - |
137 | /*! | - |
138 | \fn int QSize::height() const | - |
139 | | - |
140 | Returns the height. | - |
141 | | - |
142 | \sa width(), setHeight() | - |
143 | */ | - |
144 | | - |
145 | /*! | - |
146 | \fn void QSize::setWidth(int width) | - |
147 | | - |
148 | Sets the width to the given \a width. | - |
149 | | - |
150 | \sa rwidth(), width(), setHeight() | - |
151 | */ | - |
152 | | - |
153 | /*! | - |
154 | \fn void QSize::setHeight(int height) | - |
155 | | - |
156 | Sets the height to the given \a height. | - |
157 | | - |
158 | \sa rheight(), height(), setWidth() | - |
159 | */ | - |
160 | | - |
161 | /*! | - |
162 | Swaps the width and height values. | - |
163 | | - |
164 | \sa setWidth(), setHeight(), transposed() | - |
165 | */ | - |
166 | | - |
167 | void QSize::transpose() | - |
168 | { | - |
169 | int tmp = wd; executed (the execution status of this line is deduced): int tmp = wd; | - |
170 | wd = ht; executed (the execution status of this line is deduced): wd = ht; | - |
171 | ht = tmp; executed (the execution status of this line is deduced): ht = tmp; | - |
172 | } executed: } Execution Count:3 | 3 |
173 | | - |
174 | /*! | - |
175 | \fn QSize QSize::transposed() const | - |
176 | \since 5.0 | - |
177 | | - |
178 | Returns a QSize with width and height swapped. | - |
179 | | - |
180 | \sa transpose() | - |
181 | */ | - |
182 | | - |
183 | /*! | - |
184 | \fn void QSize::scale(int width, int height, Qt::AspectRatioMode mode) | - |
185 | | - |
186 | Scales the size to a rectangle with the given \a width and \a | - |
187 | height, according to the specified \a mode: | - |
188 | | - |
189 | \list | - |
190 | \li If \a mode is Qt::IgnoreAspectRatio, the size is set to (\a width, \a height). | - |
191 | \li If \a mode is Qt::KeepAspectRatio, the current size is scaled to a rectangle | - |
192 | as large as possible inside (\a width, \a height), preserving the aspect ratio. | - |
193 | \li If \a mode is Qt::KeepAspectRatioByExpanding, the current size is scaled to a rectangle | - |
194 | as small as possible outside (\a width, \a height), preserving the aspect ratio. | - |
195 | \endlist | - |
196 | | - |
197 | Example: | - |
198 | \snippet code/src_corelib_tools_qsize.cpp 0 | - |
199 | | - |
200 | \sa setWidth(), setHeight(), scaled() | - |
201 | */ | - |
202 | | - |
203 | /*! | - |
204 | \fn void QSize::scale(const QSize &size, Qt::AspectRatioMode mode) | - |
205 | \overload | - |
206 | | - |
207 | Scales the size to a rectangle with the given \a size, according to | - |
208 | the specified \a mode. | - |
209 | */ | - |
210 | | - |
211 | /*! | - |
212 | \fn QSize QSize::scaled(int width, int height, Qt::AspectRatioMode mode) const | - |
213 | \since 5.0 | - |
214 | | - |
215 | Return a size scaled to a rectangle with the given \a width and \a | - |
216 | height, according to the specified \a mode. | - |
217 | | - |
218 | \sa scale() | - |
219 | */ | - |
220 | | - |
221 | /*! | - |
222 | \overload | - |
223 | \since 5.0 | - |
224 | | - |
225 | Return a size scaled to a rectangle with the given size \a s, | - |
226 | according to the specified \a mode. | - |
227 | */ | - |
228 | QSize QSize::scaled(const QSize &s, Qt::AspectRatioMode mode) const | - |
229 | { | - |
230 | if (mode == Qt::IgnoreAspectRatio || wd == 0 || ht == 0) { evaluated: mode == Qt::IgnoreAspectRatio yes Evaluation Count:412 | yes Evaluation Count:2892 |
evaluated: wd == 0 yes Evaluation Count:2 | yes Evaluation Count:2890 |
partially evaluated: ht == 0 no Evaluation Count:0 | yes Evaluation Count:2890 |
| 0-2892 |
231 | return s; executed: return s; Execution Count:414 | 414 |
232 | } else { | - |
233 | bool useHeight; executed (the execution status of this line is deduced): bool useHeight; | - |
234 | qint64 rw = qint64(s.ht) * qint64(wd) / qint64(ht); executed (the execution status of this line is deduced): qint64 rw = qint64(s.ht) * qint64(wd) / qint64(ht); | - |
235 | | - |
236 | if (mode == Qt::KeepAspectRatio) { evaluated: mode == Qt::KeepAspectRatio yes Evaluation Count:2888 | yes Evaluation Count:2 |
| 2-2888 |
237 | useHeight = (rw <= s.wd); executed (the execution status of this line is deduced): useHeight = (rw <= s.wd); | - |
238 | } else { // mode == Qt::KeepAspectRatioByExpanding executed: } Execution Count:2888 | 2888 |
239 | useHeight = (rw >= s.wd); executed (the execution status of this line is deduced): useHeight = (rw >= s.wd); | - |
240 | } executed: } Execution Count:2 | 2 |
241 | | - |
242 | if (useHeight) { evaluated: useHeight yes Evaluation Count:2852 | yes Evaluation Count:38 |
| 38-2852 |
243 | return QSize(rw, s.ht); executed: return QSize(rw, s.ht); Execution Count:2852 | 2852 |
244 | } else { | - |
245 | return QSize(s.wd, executed: return QSize(s.wd, qint32(qint64(s.wd) * qint64(ht) / qint64(wd))); Execution Count:38 | 38 |
246 | qint32(qint64(s.wd) * qint64(ht) / qint64(wd))); executed: return QSize(s.wd, qint32(qint64(s.wd) * qint64(ht) / qint64(wd))); Execution Count:38 | 38 |
247 | } | - |
248 | } | - |
249 | } | - |
250 | | - |
251 | /*! | - |
252 | \fn int &QSize::rwidth() | - |
253 | | - |
254 | Returns a reference to the width. | - |
255 | | - |
256 | Using a reference makes it possible to manipulate the width | - |
257 | directly. For example: | - |
258 | | - |
259 | \snippet code/src_corelib_tools_qsize.cpp 1 | - |
260 | | - |
261 | \sa rheight(), setWidth() | - |
262 | */ | - |
263 | | - |
264 | /*! | - |
265 | \fn int &QSize::rheight() | - |
266 | | - |
267 | Returns a reference to the height. | - |
268 | | - |
269 | Using a reference makes it possible to manipulate the height | - |
270 | directly. For example: | - |
271 | | - |
272 | \snippet code/src_corelib_tools_qsize.cpp 2 | - |
273 | | - |
274 | \sa rwidth(), setHeight() | - |
275 | */ | - |
276 | | - |
277 | /*! | - |
278 | \fn QSize &QSize::operator+=(const QSize &size) | - |
279 | | - |
280 | Adds the given \a size to \e this size, and returns a reference to | - |
281 | this size. For example: | - |
282 | | - |
283 | \snippet code/src_corelib_tools_qsize.cpp 3 | - |
284 | */ | - |
285 | | - |
286 | /*! | - |
287 | \fn QSize &QSize::operator-=(const QSize &size) | - |
288 | | - |
289 | Subtracts the given \a size from \e this size, and returns a | - |
290 | reference to this size. For example: | - |
291 | | - |
292 | \snippet code/src_corelib_tools_qsize.cpp 4 | - |
293 | */ | - |
294 | | - |
295 | /*! | - |
296 | \fn QSize &QSize::operator*=(qreal factor) | - |
297 | \overload | - |
298 | | - |
299 | Multiplies both the width and height by the given \a factor, and | - |
300 | returns a reference to the size. | - |
301 | | - |
302 | Note that the result is rounded to the nearest integer. | - |
303 | | - |
304 | \sa scale() | - |
305 | */ | - |
306 | | - |
307 | /*! | - |
308 | \fn bool operator==(const QSize &s1, const QSize &s2) | - |
309 | \relates QSize | - |
310 | | - |
311 | Returns true if \a s1 and \a s2 are equal; otherwise returns false. | - |
312 | */ | - |
313 | | - |
314 | /*! | - |
315 | \fn bool operator!=(const QSize &s1, const QSize &s2) | - |
316 | \relates QSize | - |
317 | | - |
318 | Returns true if \a s1 and \a s2 are different; otherwise returns false. | - |
319 | */ | - |
320 | | - |
321 | /*! | - |
322 | \fn const QSize operator+(const QSize &s1, const QSize &s2) | - |
323 | \relates QSize | - |
324 | | - |
325 | Returns the sum of \a s1 and \a s2; each component is added separately. | - |
326 | */ | - |
327 | | - |
328 | /*! | - |
329 | \fn const QSize operator-(const QSize &s1, const QSize &s2) | - |
330 | \relates QSize | - |
331 | | - |
332 | Returns \a s2 subtracted from \a s1; each component is subtracted | - |
333 | separately. | - |
334 | */ | - |
335 | | - |
336 | /*! | - |
337 | \fn const QSize operator*(const QSize &size, qreal factor) | - |
338 | \relates QSize | - |
339 | | - |
340 | Multiplies the given \a size by the given \a factor, and returns | - |
341 | the result rounded to the nearest integer. | - |
342 | | - |
343 | \sa QSize::scale() | - |
344 | */ | - |
345 | | - |
346 | /*! | - |
347 | \fn const QSize operator*(qreal factor, const QSize &size) | - |
348 | \overload | - |
349 | \relates QSize | - |
350 | | - |
351 | Multiplies the given \a size by the given \a factor, and returns | - |
352 | the result rounded to the nearest integer. | - |
353 | */ | - |
354 | | - |
355 | /*! | - |
356 | \fn QSize &QSize::operator/=(qreal divisor) | - |
357 | \overload | - |
358 | | - |
359 | Divides both the width and height by the given \a divisor, and | - |
360 | returns a reference to the size. | - |
361 | | - |
362 | Note that the result is rounded to the nearest integer. | - |
363 | | - |
364 | \sa QSize::scale() | - |
365 | */ | - |
366 | | - |
367 | /*! | - |
368 | \fn const QSize operator/(const QSize &size, qreal divisor) | - |
369 | \relates QSize | - |
370 | \overload | - |
371 | | - |
372 | Divides the given \a size by the given \a divisor, and returns the | - |
373 | result rounded to the nearest integer. | - |
374 | | - |
375 | \sa QSize::scale() | - |
376 | */ | - |
377 | | - |
378 | /*! | - |
379 | \fn QSize QSize::expandedTo(const QSize & otherSize) const | - |
380 | | - |
381 | Returns a size holding the maximum width and height of this size | - |
382 | and the given \a otherSize. | - |
383 | | - |
384 | \sa boundedTo(), scale() | - |
385 | */ | - |
386 | | - |
387 | /*! | - |
388 | \fn QSize QSize::boundedTo(const QSize & otherSize) const | - |
389 | | - |
390 | Returns a size holding the minimum width and height of this size | - |
391 | and the given \a otherSize. | - |
392 | | - |
393 | \sa expandedTo(), scale() | - |
394 | */ | - |
395 | | - |
396 | | - |
397 | | - |
398 | /***************************************************************************** | - |
399 | QSize stream functions | - |
400 | *****************************************************************************/ | - |
401 | #ifndef QT_NO_DATASTREAM | - |
402 | /*! | - |
403 | \fn QDataStream &operator<<(QDataStream &stream, const QSize &size) | - |
404 | \relates QSize | - |
405 | | - |
406 | Writes the given \a size to the given \a stream, and returns a | - |
407 | reference to the stream. | - |
408 | | - |
409 | \sa {Serializing Qt Data Types} | - |
410 | */ | - |
411 | | - |
412 | QDataStream &operator<<(QDataStream &s, const QSize &sz) | - |
413 | { | - |
414 | if (s.version() == 1) partially evaluated: s.version() == 1 no Evaluation Count:0 | yes Evaluation Count:92 |
| 0-92 |
415 | s << (qint16)sz.width() << (qint16)sz.height(); never executed: s << (qint16)sz.width() << (qint16)sz.height(); | 0 |
416 | else | - |
417 | s << (qint32)sz.width() << (qint32)sz.height(); executed: s << (qint32)sz.width() << (qint32)sz.height(); Execution Count:92 | 92 |
418 | return s; executed: return s; Execution Count:92 | 92 |
419 | } | - |
420 | | - |
421 | /*! | - |
422 | \fn QDataStream &operator>>(QDataStream &stream, QSize &size) | - |
423 | \relates QSize | - |
424 | | - |
425 | Reads a size from the given \a stream into the given \a size, and | - |
426 | returns a reference to the stream. | - |
427 | | - |
428 | \sa {Serializing Qt Data Types} | - |
429 | */ | - |
430 | | - |
431 | QDataStream &operator>>(QDataStream &s, QSize &sz) | - |
432 | { | - |
433 | if (s.version() == 1) { partially evaluated: s.version() == 1 no Evaluation Count:0 | yes Evaluation Count:100 |
| 0-100 |
434 | qint16 w, h; never executed (the execution status of this line is deduced): qint16 w, h; | - |
435 | s >> w; sz.rwidth() = w; never executed (the execution status of this line is deduced): s >> w; sz.rwidth() = w; | - |
436 | s >> h; sz.rheight() = h; never executed (the execution status of this line is deduced): s >> h; sz.rheight() = h; | - |
437 | } | 0 |
438 | else { | - |
439 | qint32 w, h; executed (the execution status of this line is deduced): qint32 w, h; | - |
440 | s >> w; sz.rwidth() = w; executed (the execution status of this line is deduced): s >> w; sz.rwidth() = w; | - |
441 | s >> h; sz.rheight() = h; executed (the execution status of this line is deduced): s >> h; sz.rheight() = h; | - |
442 | } executed: } Execution Count:100 | 100 |
443 | return s; executed: return s; Execution Count:100 | 100 |
444 | } | - |
445 | #endif // QT_NO_DATASTREAM | - |
446 | | - |
447 | #ifndef QT_NO_DEBUG_STREAM | - |
448 | QDebug operator<<(QDebug dbg, const QSize &s) { | - |
449 | dbg.nospace() << "QSize(" << s.width() << ", " << s.height() << ')'; executed (the execution status of this line is deduced): dbg.nospace() << "QSize(" << s.width() << ", " << s.height() << ')'; | - |
450 | return dbg.space(); executed: return dbg.space(); Execution Count:4 | 4 |
451 | } | - |
452 | #endif | - |
453 | | - |
454 | | - |
455 | | - |
456 | /*! | - |
457 | \class QSizeF | - |
458 | \inmodule QtCore | - |
459 | \brief The QSizeF class defines the size of a two-dimensional object | - |
460 | using floating point precision. | - |
461 | | - |
462 | \ingroup painting | - |
463 | | - |
464 | A size is specified by a width() and a height(). It can be set in | - |
465 | the constructor and changed using the setWidth(), setHeight(), or | - |
466 | scale() functions, or using arithmetic operators. A size can also | - |
467 | be manipulated directly by retrieving references to the width and | - |
468 | height using the rwidth() and rheight() functions. Finally, the | - |
469 | width and height can be swapped using the transpose() function. | - |
470 | | - |
471 | The isValid() function determines if a size is valid. A valid size | - |
472 | has both width and height greater than or equal to zero. The | - |
473 | isEmpty() function returns true if either of the width and height | - |
474 | is \e less than (or equal to) zero, while the isNull() function | - |
475 | returns true only if both the width and the height is zero. | - |
476 | | - |
477 | Use the expandedTo() function to retrieve a size which holds the | - |
478 | maximum height and width of this size and a given | - |
479 | size. Similarly, the boundedTo() function returns a size which | - |
480 | holds the minimum height and width of this size and a given size. | - |
481 | | - |
482 | The QSizeF class also provides the toSize() function returning a | - |
483 | QSize copy of this size, constructed by rounding the width and | - |
484 | height to the nearest integers. | - |
485 | | - |
486 | QSizeF objects can be streamed as well as compared. | - |
487 | | - |
488 | \sa QSize, QPointF, QRectF | - |
489 | */ | - |
490 | | - |
491 | | - |
492 | /***************************************************************************** | - |
493 | QSizeF member functions | - |
494 | *****************************************************************************/ | - |
495 | | - |
496 | /*! | - |
497 | \fn QSizeF::QSizeF() | - |
498 | | - |
499 | Constructs an invalid size. | - |
500 | | - |
501 | \sa isValid() | - |
502 | */ | - |
503 | | - |
504 | /*! | - |
505 | \fn QSizeF::QSizeF(const QSize &size) | - |
506 | | - |
507 | Constructs a size with floating point accuracy from the given \a | - |
508 | size. | - |
509 | | - |
510 | \sa toSize() | - |
511 | */ | - |
512 | | - |
513 | /*! | - |
514 | \fn QSizeF::QSizeF(qreal width, qreal height) | - |
515 | | - |
516 | Constructs a size with the given \a width and \a height. | - |
517 | */ | - |
518 | | - |
519 | /*! | - |
520 | \fn bool QSizeF::isNull() const | - |
521 | | - |
522 | Returns true if both the width and height are +0.0; otherwise returns | - |
523 | false. | - |
524 | | - |
525 | \note Since this function treats +0.0 and -0.0 differently, sizes with | - |
526 | zero width and height where either or both values have a negative | - |
527 | sign are not defined to be null sizes. | - |
528 | | - |
529 | \sa isValid(), isEmpty() | - |
530 | */ | - |
531 | | - |
532 | /*! | - |
533 | \fn bool QSizeF::isEmpty() const | - |
534 | | - |
535 | Returns true if either of the width and height is less than or | - |
536 | equal to 0; otherwise returns false. | - |
537 | | - |
538 | \sa isNull(), isValid() | - |
539 | */ | - |
540 | | - |
541 | /*! | - |
542 | \fn bool QSizeF::isValid() const | - |
543 | | - |
544 | Returns true if both the width and height is equal to or greater | - |
545 | than 0; otherwise returns false. | - |
546 | | - |
547 | \sa isNull(), isEmpty() | - |
548 | */ | - |
549 | | - |
550 | /*! | - |
551 | \fn int QSizeF::width() const | - |
552 | | - |
553 | Returns the width. | - |
554 | | - |
555 | \sa height(), setWidth() | - |
556 | */ | - |
557 | | - |
558 | /*! | - |
559 | \fn int QSizeF::height() const | - |
560 | | - |
561 | Returns the height. | - |
562 | | - |
563 | \sa width(), setHeight() | - |
564 | */ | - |
565 | | - |
566 | /*! | - |
567 | \fn void QSizeF::setWidth(qreal width) | - |
568 | | - |
569 | Sets the width to the given \a width. | - |
570 | | - |
571 | \sa width(), rwidth(), setHeight() | - |
572 | */ | - |
573 | | - |
574 | /*! | - |
575 | \fn void QSizeF::setHeight(qreal height) | - |
576 | | - |
577 | Sets the height to the given \a height. | - |
578 | | - |
579 | \sa height(), rheight(), setWidth() | - |
580 | */ | - |
581 | | - |
582 | /*! | - |
583 | \fn QSize QSizeF::toSize() const | - |
584 | | - |
585 | Returns an integer based copy of this size. | - |
586 | | - |
587 | Note that the coordinates in the returned size will be rounded to | - |
588 | the nearest integer. | - |
589 | | - |
590 | \sa QSizeF() | - |
591 | */ | - |
592 | | - |
593 | /*! | - |
594 | Swaps the width and height values. | - |
595 | | - |
596 | \sa setWidth(), setHeight(), transposed() | - |
597 | */ | - |
598 | | - |
599 | void QSizeF::transpose() | - |
600 | { | - |
601 | qreal tmp = wd; executed (the execution status of this line is deduced): qreal tmp = wd; | - |
602 | wd = ht; executed (the execution status of this line is deduced): wd = ht; | - |
603 | ht = tmp; executed (the execution status of this line is deduced): ht = tmp; | - |
604 | } executed: } Execution Count:6 | 6 |
605 | | - |
606 | /*! | - |
607 | \fn QSizeF QSizeF::transposed() const | - |
608 | \since 5.0 | - |
609 | | - |
610 | Returns the size with width and height values swapped. | - |
611 | | - |
612 | \sa transpose() | - |
613 | */ | - |
614 | | - |
615 | /*! | - |
616 | \fn void QSizeF::scale(qreal width, qreal height, Qt::AspectRatioMode mode) | - |
617 | | - |
618 | Scales the size to a rectangle with the given \a width and \a | - |
619 | height, according to the specified \a mode. | - |
620 | | - |
621 | \list | - |
622 | \li If \a mode is Qt::IgnoreAspectRatio, the size is set to (\a width, \a height). | - |
623 | \li If \a mode is Qt::KeepAspectRatio, the current size is scaled to a rectangle | - |
624 | as large as possible inside (\a width, \a height), preserving the aspect ratio. | - |
625 | \li If \a mode is Qt::KeepAspectRatioByExpanding, the current size is scaled to a rectangle | - |
626 | as small as possible outside (\a width, \a height), preserving the aspect ratio. | - |
627 | \endlist | - |
628 | | - |
629 | Example: | - |
630 | \snippet code/src_corelib_tools_qsize.cpp 5 | - |
631 | | - |
632 | \sa setWidth(), setHeight(), scaled() | - |
633 | */ | - |
634 | | - |
635 | /*! | - |
636 | \fn void QSizeF::scale(const QSizeF &size, Qt::AspectRatioMode mode) | - |
637 | \overload | - |
638 | | - |
639 | Scales the size to a rectangle with the given \a size, according to | - |
640 | the specified \a mode. | - |
641 | */ | - |
642 | | - |
643 | /*! | - |
644 | \fn QSizeF QSizeF::scaled(qreal width, qreal height, Qt::AspectRatioMode mode) const | - |
645 | \since 5.0 | - |
646 | | - |
647 | Returns a size scaled to a rectangle with the given \a width and | - |
648 | \a height, according to the specified \a mode. | - |
649 | | - |
650 | \sa scale() | - |
651 | */ | - |
652 | | - |
653 | /*! | - |
654 | \overload | - |
655 | \since 5.0 | - |
656 | | - |
657 | Returns a size scaled to a rectangle with the given size \a s, | - |
658 | according to the specified \a mode. | - |
659 | */ | - |
660 | QSizeF QSizeF::scaled(const QSizeF &s, Qt::AspectRatioMode mode) const | - |
661 | { | - |
662 | if (mode == Qt::IgnoreAspectRatio || qIsNull(wd) || qIsNull(ht)) { evaluated: mode == Qt::IgnoreAspectRatio yes Evaluation Count:2 | yes Evaluation Count:6 |
evaluated: qIsNull(wd) yes Evaluation Count:2 | yes Evaluation Count:4 |
partially evaluated: qIsNull(ht) no Evaluation Count:0 | yes Evaluation Count:4 |
| 0-6 |
663 | return s; executed: return s; Execution Count:4 | 4 |
664 | } else { | - |
665 | bool useHeight; executed (the execution status of this line is deduced): bool useHeight; | - |
666 | qreal rw = s.ht * wd / ht; executed (the execution status of this line is deduced): qreal rw = s.ht * wd / ht; | - |
667 | | - |
668 | if (mode == Qt::KeepAspectRatio) { evaluated: mode == Qt::KeepAspectRatio yes Evaluation Count:2 | yes Evaluation Count:2 |
| 2 |
669 | useHeight = (rw <= s.wd); executed (the execution status of this line is deduced): useHeight = (rw <= s.wd); | - |
670 | } else { // mode == Qt::KeepAspectRatioByExpanding executed: } Execution Count:2 | 2 |
671 | useHeight = (rw >= s.wd); executed (the execution status of this line is deduced): useHeight = (rw >= s.wd); | - |
672 | } executed: } Execution Count:2 | 2 |
673 | | - |
674 | if (useHeight) { evaluated: useHeight yes Evaluation Count:2 | yes Evaluation Count:2 |
| 2 |
675 | return QSizeF(rw, s.ht); executed: return QSizeF(rw, s.ht); Execution Count:2 | 2 |
676 | } else { | - |
677 | return QSizeF(s.wd, s.wd * ht / wd); executed: return QSizeF(s.wd, s.wd * ht / wd); Execution Count:2 | 2 |
678 | } | - |
679 | } | - |
680 | } | - |
681 | | - |
682 | /*! | - |
683 | \fn int &QSizeF::rwidth() | - |
684 | | - |
685 | Returns a reference to the width. | - |
686 | | - |
687 | Using a reference makes it possible to manipulate the width | - |
688 | directly. For example: | - |
689 | | - |
690 | \snippet code/src_corelib_tools_qsize.cpp 6 | - |
691 | | - |
692 | \sa rheight(), setWidth() | - |
693 | */ | - |
694 | | - |
695 | /*! | - |
696 | \fn int &QSizeF::rheight() | - |
697 | | - |
698 | Returns a reference to the height. | - |
699 | | - |
700 | Using a reference makes it possible to manipulate the height | - |
701 | directly. For example: | - |
702 | | - |
703 | \snippet code/src_corelib_tools_qsize.cpp 7 | - |
704 | | - |
705 | \sa rwidth(), setHeight() | - |
706 | */ | - |
707 | | - |
708 | /*! | - |
709 | \fn QSizeF &QSizeF::operator+=(const QSizeF &size) | - |
710 | | - |
711 | Adds the given \a size to this size and returns a reference to | - |
712 | this size. For example: | - |
713 | | - |
714 | \snippet code/src_corelib_tools_qsize.cpp 8 | - |
715 | */ | - |
716 | | - |
717 | /*! | - |
718 | \fn QSizeF &QSizeF::operator-=(const QSizeF &size) | - |
719 | | - |
720 | Subtracts the given \a size from this size and returns a reference | - |
721 | to this size. For example: | - |
722 | | - |
723 | \snippet code/src_corelib_tools_qsize.cpp 9 | - |
724 | */ | - |
725 | | - |
726 | /*! | - |
727 | \fn QSizeF &QSizeF::operator*=(qreal factor) | - |
728 | \overload | - |
729 | | - |
730 | Multiplies both the width and height by the given \a factor and | - |
731 | returns a reference to the size. | - |
732 | | - |
733 | \sa scale() | - |
734 | */ | - |
735 | | - |
736 | /*! | - |
737 | \fn bool operator==(const QSizeF &s1, const QSizeF &s2) | - |
738 | \relates QSizeF | - |
739 | | - |
740 | Returns true if \a s1 and \a s2 are equal; otherwise returns | - |
741 | false. | - |
742 | */ | - |
743 | | - |
744 | /*! | - |
745 | \fn bool operator!=(const QSizeF &s1, const QSizeF &s2) | - |
746 | \relates QSizeF | - |
747 | | - |
748 | Returns true if \a s1 and \a s2 are different; otherwise returns false. | - |
749 | */ | - |
750 | | - |
751 | /*! | - |
752 | \fn const QSizeF operator+(const QSizeF &s1, const QSizeF &s2) | - |
753 | \relates QSizeF | - |
754 | | - |
755 | Returns the sum of \a s1 and \a s2; each component is added separately. | - |
756 | */ | - |
757 | | - |
758 | /*! | - |
759 | \fn const QSizeF operator-(const QSizeF &s1, const QSizeF &s2) | - |
760 | \relates QSizeF | - |
761 | | - |
762 | Returns \a s2 subtracted from \a s1; each component is subtracted | - |
763 | separately. | - |
764 | */ | - |
765 | | - |
766 | /*! | - |
767 | \fn const QSizeF operator*(const QSizeF &size, qreal factor) | - |
768 | | - |
769 | \overload | - |
770 | \relates QSizeF | - |
771 | | - |
772 | Multiplies the given \a size by the given \a factor and returns | - |
773 | the result. | - |
774 | | - |
775 | \sa QSizeF::scale() | - |
776 | */ | - |
777 | | - |
778 | /*! | - |
779 | \fn const QSizeF operator*(qreal factor, const QSizeF &size) | - |
780 | | - |
781 | \overload | - |
782 | \relates QSizeF | - |
783 | | - |
784 | Multiplies the given \a size by the given \a factor and returns | - |
785 | the result. | - |
786 | */ | - |
787 | | - |
788 | /*! | - |
789 | \fn QSizeF &QSizeF::operator/=(qreal divisor) | - |
790 | | - |
791 | \overload | - |
792 | | - |
793 | Divides both the width and height by the given \a divisor and | - |
794 | returns a reference to the size. | - |
795 | | - |
796 | \sa scale() | - |
797 | */ | - |
798 | | - |
799 | /*! | - |
800 | \fn const QSizeF operator/(const QSizeF &size, qreal divisor) | - |
801 | | - |
802 | \relates QSizeF | - |
803 | \overload | - |
804 | | - |
805 | Divides the given \a size by the given \a divisor and returns the | - |
806 | result. | - |
807 | | - |
808 | \sa QSizeF::scale() | - |
809 | */ | - |
810 | | - |
811 | /*! | - |
812 | \fn QSizeF QSizeF::expandedTo(const QSizeF & otherSize) const | - |
813 | | - |
814 | Returns a size holding the maximum width and height of this size | - |
815 | and the given \a otherSize. | - |
816 | | - |
817 | \sa boundedTo(), scale() | - |
818 | */ | - |
819 | | - |
820 | /*! | - |
821 | \fn QSizeF QSizeF::boundedTo(const QSizeF & otherSize) const | - |
822 | | - |
823 | Returns a size holding the minimum width and height of this size | - |
824 | and the given \a otherSize. | - |
825 | | - |
826 | \sa expandedTo(), scale() | - |
827 | */ | - |
828 | | - |
829 | | - |
830 | | - |
831 | /***************************************************************************** | - |
832 | QSizeF stream functions | - |
833 | *****************************************************************************/ | - |
834 | #ifndef QT_NO_DATASTREAM | - |
835 | /*! | - |
836 | \fn QDataStream &operator<<(QDataStream &stream, const QSizeF &size) | - |
837 | \relates QSizeF | - |
838 | | - |
839 | Writes the given \a size to the given \a stream and returns a | - |
840 | reference to the stream. | - |
841 | | - |
842 | \sa {Serializing Qt Data Types} | - |
843 | */ | - |
844 | | - |
845 | QDataStream &operator<<(QDataStream &s, const QSizeF &sz) | - |
846 | { | - |
847 | s << double(sz.width()) << double(sz.height()); executed (the execution status of this line is deduced): s << double(sz.width()) << double(sz.height()); | - |
848 | return s; executed: return s; Execution Count:69 | 69 |
849 | } | - |
850 | | - |
851 | /*! | - |
852 | \fn QDataStream &operator>>(QDataStream &stream, QSizeF &size) | - |
853 | \relates QSizeF | - |
854 | | - |
855 | Reads a size from the given \a stream into the given \a size and | - |
856 | returns a reference to the stream. | - |
857 | | - |
858 | \sa {Serializing Qt Data Types} | - |
859 | */ | - |
860 | | - |
861 | QDataStream &operator>>(QDataStream &s, QSizeF &sz) | - |
862 | { | - |
863 | double w, h; executed (the execution status of this line is deduced): double w, h; | - |
864 | s >> w; executed (the execution status of this line is deduced): s >> w; | - |
865 | s >> h; executed (the execution status of this line is deduced): s >> h; | - |
866 | sz.setWidth(qreal(w)); executed (the execution status of this line is deduced): sz.setWidth(qreal(w)); | - |
867 | sz.setHeight(qreal(h)); executed (the execution status of this line is deduced): sz.setHeight(qreal(h)); | - |
868 | return s; executed: return s; Execution Count:73 | 73 |
869 | } | - |
870 | #endif // QT_NO_DATASTREAM | - |
871 | | - |
872 | #ifndef QT_NO_DEBUG_STREAM | - |
873 | QDebug operator<<(QDebug dbg, const QSizeF &s) { | - |
874 | dbg.nospace() << "QSizeF(" << s.width() << ", " << s.height() << ')'; executed (the execution status of this line is deduced): dbg.nospace() << "QSizeF(" << s.width() << ", " << s.height() << ')'; | - |
875 | return dbg.space(); executed: return dbg.space(); Execution Count:1 | 1 |
876 | } | - |
877 | #endif | - |
878 | | - |
879 | QT_END_NAMESPACE | - |
880 | | - |
| | |