Qwt User's Guide  6.1-rc3
 All Classes Functions Variables Typedefs Enumerations Enumerator Pages
qwt_interval.h
1 /* -*- mode: C++ ; c-file-style: "stroustrup" -*- *****************************
2  * Qwt Widget Library
3  * Copyright (C) 1997 Josef Wilgen
4  * Copyright (C) 2002 Uwe Rathmann
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the Qwt License, Version 1.0
8  *****************************************************************************/
9 
10 #ifndef QWT_INTERVAL_H
11 #define QWT_INTERVAL_H
12 
13 #include "qwt_global.h"
14 #include <qmetatype.h>
15 
16 #ifndef QT_NO_DEBUG_STREAM
17 #include <qdebug.h>
18 #endif
19 
26 class QWT_EXPORT QwtInterval
27 {
28 public:
34  {
36  IncludeBorders = 0x00,
37 
39  ExcludeMinimum = 0x01,
40 
42  ExcludeMaximum = 0x02,
43 
45  ExcludeBorders = ExcludeMinimum | ExcludeMaximum
46  };
47 
49  typedef QFlags<BorderFlag> BorderFlags;
50 
51  QwtInterval();
52  QwtInterval( double minValue, double maxValue,
53  BorderFlags = IncludeBorders );
54 
55  void setInterval( double minValue, double maxValue,
56  BorderFlags = IncludeBorders );
57 
58  QwtInterval normalized() const;
59  QwtInterval inverted() const;
60  QwtInterval limited( double minValue, double maxValue ) const;
61 
62  bool operator==( const QwtInterval & ) const;
63  bool operator!=( const QwtInterval & ) const;
64 
65  void setBorderFlags( BorderFlags );
66  BorderFlags borderFlags() const;
67 
68  double minValue() const;
69  double maxValue() const;
70 
71  double width() const;
72 
73  void setMinValue( double );
74  void setMaxValue( double );
75 
76  bool contains( double value ) const;
77 
78  bool intersects( const QwtInterval & ) const;
79  QwtInterval intersect( const QwtInterval & ) const;
80  QwtInterval unite( const QwtInterval & ) const;
81 
82  QwtInterval operator|( const QwtInterval & ) const;
83  QwtInterval operator&( const QwtInterval & ) const;
84 
85  QwtInterval &operator|=( const QwtInterval & );
86  QwtInterval &operator&=( const QwtInterval & );
87 
88  QwtInterval extend( double value ) const;
89  QwtInterval operator|( double ) const;
90  QwtInterval &operator|=( double );
91 
92  bool isValid() const;
93  bool isNull() const;
94  void invalidate();
95 
96  QwtInterval symmetrize( double value ) const;
97 
98 private:
99  double d_minValue;
100  double d_maxValue;
101  BorderFlags d_borderFlags;
102 };
103 
104 Q_DECLARE_TYPEINFO(QwtInterval, Q_MOVABLE_TYPE);
105 
113  d_minValue( 0.0 ),
114  d_maxValue( -1.0 ),
115  d_borderFlags( IncludeBorders )
116 {
117 }
118 
129  double minValue, double maxValue, BorderFlags borderFlags ):
130  d_minValue( minValue ),
131  d_maxValue( maxValue ),
132  d_borderFlags( borderFlags )
133 {
134 }
135 
144  double minValue, double maxValue, BorderFlags borderFlags )
145 {
146  d_minValue = minValue;
147  d_maxValue = maxValue;
148  d_borderFlags = borderFlags;
149 }
150 
157 inline void QwtInterval::setBorderFlags( BorderFlags borderFlags )
158 {
159  d_borderFlags = borderFlags;
160 }
161 
167 {
168  return d_borderFlags;
169 }
170 
176 inline void QwtInterval::setMinValue( double minValue )
177 {
178  d_minValue = minValue;
179 }
180 
186 inline void QwtInterval::setMaxValue( double maxValue )
187 {
188  d_maxValue = maxValue;
189 }
190 
192 inline double QwtInterval::minValue() const
193 {
194  return d_minValue;
195 }
196 
198 inline double QwtInterval::maxValue() const
199 {
200  return d_maxValue;
201 }
202 
208 inline bool QwtInterval::isValid() const
209 {
210  if ( ( d_borderFlags & ExcludeBorders ) == 0 )
211  return d_minValue <= d_maxValue;
212  else
213  return d_minValue < d_maxValue;
214 }
215 
223 inline double QwtInterval::width() const
224 {
225  return isValid() ? ( d_maxValue - d_minValue ) : 0.0;
226 }
227 
233  const QwtInterval &interval ) const
234 {
235  return intersect( interval );
236 }
237 
243  const QwtInterval &interval ) const
244 {
245  return unite( interval );
246 }
247 
249 inline bool QwtInterval::operator==( const QwtInterval &other ) const
250 {
251  return ( d_minValue == other.d_minValue ) &&
252  ( d_maxValue == other.d_maxValue ) &&
253  ( d_borderFlags == other.d_borderFlags );
254 }
255 
257 inline bool QwtInterval::operator!=( const QwtInterval &other ) const
258 {
259  return ( !( *this == other ) );
260 }
261 
269 inline QwtInterval QwtInterval::operator|( double value ) const
270 {
271  return extend( value );
272 }
273 
275 inline bool QwtInterval::isNull() const
276 {
277  return isValid() && d_minValue >= d_maxValue;
278 }
279 
287 {
288  d_minValue = 0.0;
289  d_maxValue = -1.0;
290 }
291 
292 Q_DECLARE_OPERATORS_FOR_FLAGS( QwtInterval::BorderFlags )
293 Q_DECLARE_METATYPE( QwtInterval )
294 
295 #ifndef QT_NO_DEBUG_STREAM
296 QWT_EXPORT QDebug operator<<( QDebug, const QwtInterval & );
297 #endif
298 
299 #endif