QGIS API Documentation  3.0.2-Girona (307d082)
qgis.cpp
Go to the documentation of this file.
1 /***************************************************************************
2  qgis.cpp
3 
4  -------------------
5  begin : 2007
6  copyright : (C) 2007 by Gary E. Sherman
7  email : sherman@mrcc.com
8 ***************************************************************************/
9 
10 /***************************************************************************
11  * *
12  * This program is free software; you can redistribute it and/or modify *
13  * it under the terms of the GNU General Public License as published by *
14  * the Free Software Foundation; either version 2 of the License, or *
15  * (at your option) any later version. *
16  * *
17  ***************************************************************************/
18 #include "qgis.h"
19 #ifndef QGSVERSION
20 #include "qgsversion.h"
21 #endif
22 #include <QCoreApplication>
23 #include <QColor>
24 #include <QDate>
25 #include <QTime>
26 #include <QLocale>
27 #include <QDateTime>
28 #include "qgsconfig.h"
29 #include "qgslogger.h"
30 #include "qgswkbtypes.h"
31 
32 #include <ogr_api.h>
33 
34 // Version constants
35 //
36 
37 // Version string
38 const QString Qgis::QGIS_VERSION( QStringLiteral( VERSION ) );
39 
40 // development version
41 const char *Qgis::QGIS_DEV_VERSION = QGSVERSION;
42 
43 // Version number used for comparing versions using the
44 // "Check QGIS Version" function
45 const int Qgis::QGIS_VERSION_INT = VERSION_INT;
46 
47 // Release name
48 const QString Qgis::QGIS_RELEASE_NAME( QStringLiteral( RELEASE_NAME ) );
49 
50 const QString GEOPROJ4 = QStringLiteral( "+proj=longlat +datum=WGS84 +no_defs" );
51 
52 const QString GEOWKT =
53  "GEOGCS[\"WGS 84\", "
54  " DATUM[\"WGS_1984\", "
55  " SPHEROID[\"WGS 84\",6378137,298.257223563, "
56  " AUTHORITY[\"EPSG\",7030]], "
57  " TOWGS84[0,0,0,0,0,0,0], "
58  " AUTHORITY[\"EPSG\",6326]], "
59  " PRIMEM[\"Greenwich\",0,AUTHORITY[\"EPSG\",8901]], "
60  " UNIT[\"DMSH\",0.0174532925199433,AUTHORITY[\"EPSG\",9108]], "
61  " AXIS[\"Lat\",NORTH], "
62  " AXIS[\"Long\",EAST], "
63  " AUTHORITY[\"EPSG\",4326]]";
64 
65 const QString PROJECT_SCALES =
66  "1:1000000,1:500000,1:250000,1:100000,1:50000,1:25000,"
67  "1:10000,1:5000,1:2500,1:1000,1:500";
68 
69 const QString GEO_EPSG_CRS_AUTHID = QStringLiteral( "EPSG:4326" );
70 
71 const QString GEO_NONE = QStringLiteral( "NONE" );
72 
73 const double Qgis::DEFAULT_SEARCH_RADIUS_MM = 2.;
74 
75 const float Qgis::DEFAULT_MAPTOPIXEL_THRESHOLD = 1.0f;
76 
77 const QColor Qgis::DEFAULT_HIGHLIGHT_COLOR = QColor( 255, 0, 0, 128 );
78 
79 const double Qgis::DEFAULT_HIGHLIGHT_BUFFER_MM = 0.5;
80 
81 const double Qgis::DEFAULT_HIGHLIGHT_MIN_WIDTH_MM = 1.0;
82 
83 const double Qgis::SCALE_PRECISION = 0.9999999999;
84 
85 const double Qgis::DEFAULT_Z_COORDINATE = 0.0;
86 
87 const double Qgis::DEFAULT_SNAP_TOLERANCE = 12.0;
88 
90 
91 #ifdef Q_OS_WIN
92 const double Qgis::UI_SCALE_FACTOR = 1.5;
93 #else
94 const double Qgis::UI_SCALE_FACTOR = 1;
95 #endif
96 
97 double qgsPermissiveToDouble( QString string, bool &ok )
98 {
99  //remove any thousands separators
100  string.remove( QLocale::system().groupSeparator() );
101  return QLocale::system().toDouble( string, &ok );
102 }
103 
104 int qgsPermissiveToInt( QString string, bool &ok )
105 {
106  //remove any thousands separators
107  string.remove( QLocale::system().groupSeparator() );
108  return QLocale::system().toInt( string, &ok );
109 }
110 
111 void *qgsMalloc( size_t size )
112 {
113  if ( size == 0 || long( size ) < 0 )
114  {
115  QgsDebugMsg( QString( "Negative or zero size %1." ).arg( size ) );
116  return nullptr;
117  }
118  void *p = malloc( size );
119  if ( !p )
120  {
121  QgsDebugMsg( QString( "Allocation of %1 bytes failed." ).arg( size ) );
122  }
123  return p;
124 }
125 
126 void *qgsCalloc( size_t nmemb, size_t size )
127 {
128  if ( nmemb == 0 || long( nmemb ) < 0 || size == 0 || long( size ) < 0 )
129  {
130  QgsDebugMsg( QString( "Negative or zero nmemb %1 or size %2." ).arg( nmemb ).arg( size ) );
131  return nullptr;
132  }
133  void *p = qgsMalloc( nmemb * size );
134  if ( p )
135  {
136  memset( p, 0, nmemb * size );
137  }
138  return p;
139 }
140 
141 void qgsFree( void *ptr )
142 {
143  free( ptr );
144 }
145 
146 bool qgsVariantLessThan( const QVariant &lhs, const QVariant &rhs )
147 {
148  // invalid < NULL < any value
149  if ( !lhs.isValid() )
150  return rhs.isValid();
151  else if ( lhs.isNull() )
152  return rhs.isValid() && !rhs.isNull();
153  else if ( !rhs.isValid() || rhs.isNull() )
154  return false;
155 
156  switch ( lhs.type() )
157  {
158  case QVariant::Int:
159  return lhs.toInt() < rhs.toInt();
160  case QVariant::UInt:
161  return lhs.toUInt() < rhs.toUInt();
162  case QVariant::LongLong:
163  return lhs.toLongLong() < rhs.toLongLong();
164  case QVariant::ULongLong:
165  return lhs.toULongLong() < rhs.toULongLong();
166  case QVariant::Double:
167  return lhs.toDouble() < rhs.toDouble();
168  case QVariant::Char:
169  return lhs.toChar() < rhs.toChar();
170  case QVariant::Date:
171  return lhs.toDate() < rhs.toDate();
172  case QVariant::Time:
173  return lhs.toTime() < rhs.toTime();
174  case QVariant::DateTime:
175  return lhs.toDateTime() < rhs.toDateTime();
176  case QVariant::Bool:
177  return lhs.toBool() < rhs.toBool();
178 
179  case QVariant::List:
180  {
181  const QList<QVariant> &lhsl = lhs.toList();
182  const QList<QVariant> &rhsl = rhs.toList();
183 
184  int i, n = std::min( lhsl.size(), rhsl.size() );
185  for ( i = 0; i < n && lhsl[i].type() == rhsl[i].type() && lhsl[i].isNull() == rhsl[i].isNull() && lhsl[i] == rhsl[i]; i++ )
186  ;
187 
188  if ( i == n )
189  return lhsl.size() < rhsl.size();
190  else
191  return qgsVariantLessThan( lhsl[i], rhsl[i] );
192  }
193 
194  case QVariant::StringList:
195  {
196  const QStringList &lhsl = lhs.toStringList();
197  const QStringList &rhsl = rhs.toStringList();
198 
199  int i, n = std::min( lhsl.size(), rhsl.size() );
200  for ( i = 0; i < n && lhsl[i] == rhsl[i]; i++ )
201  ;
202 
203  if ( i == n )
204  return lhsl.size() < rhsl.size();
205  else
206  return lhsl[i] < rhsl[i];
207  }
208 
209  default:
210  return QString::localeAwareCompare( lhs.toString(), rhs.toString() ) < 0;
211  }
212 }
213 
214 bool qgsVariantGreaterThan( const QVariant &lhs, const QVariant &rhs )
215 {
216  return ! qgsVariantLessThan( lhs, rhs );
217 }
218 
219 QString qgsVsiPrefix( const QString &path )
220 {
221  if ( path.startsWith( QLatin1String( "/vsizip/" ), Qt::CaseInsensitive ) ||
222  path.endsWith( QLatin1String( ".zip" ), Qt::CaseInsensitive ) )
223  return QStringLiteral( "/vsizip/" );
224  else if ( path.startsWith( QLatin1String( "/vsitar/" ), Qt::CaseInsensitive ) ||
225  path.endsWith( QLatin1String( ".tar" ), Qt::CaseInsensitive ) ||
226  path.endsWith( QLatin1String( ".tar.gz" ), Qt::CaseInsensitive ) ||
227  path.endsWith( QLatin1String( ".tgz" ), Qt::CaseInsensitive ) )
228  return QStringLiteral( "/vsitar/" );
229  else if ( path.startsWith( QLatin1String( "/vsigzip/" ), Qt::CaseInsensitive ) ||
230  path.endsWith( QLatin1String( ".gz" ), Qt::CaseInsensitive ) )
231  return QStringLiteral( "/vsigzip/" );
232  else
233  return QLatin1String( "" );
234 }
235 
236 uint qHash( const QVariant &variant )
237 {
238  if ( !variant.isValid() || variant.isNull() )
239  return std::numeric_limits<uint>::max();
240 
241  switch ( variant.type() )
242  {
243  case QVariant::Int:
244  return qHash( variant.toInt() );
245  case QVariant::UInt:
246  return qHash( variant.toUInt() );
247  case QVariant::Bool:
248  return qHash( variant.toBool() );
249  case QVariant::Double:
250  return qHash( variant.toDouble() );
251  case QVariant::LongLong:
252  return qHash( variant.toLongLong() );
253  case QVariant::ULongLong:
254  return qHash( variant.toULongLong() );
255  case QVariant::String:
256  return qHash( variant.toString() );
257  case QVariant::Char:
258  return qHash( variant.toChar() );
259  case QVariant::List:
260 
261 #if QT_VERSION >= 0x050600
262  return qHash( variant.toList() );
263 #else
264  {
265  QVariantList list = variant.toList();
266  if ( list.isEmpty() )
267  return -1;
268  else
269  return qHash( list.at( 0 ) );
270  }
271 #endif
272  case QVariant::StringList:
273 #if QT_VERSION >= 0x050600
274  return qHash( variant.toStringList() );
275 #else
276  {
277  QStringList list = variant.toStringList();
278  if ( list.isEmpty() )
279  return -1;
280  else
281  return qHash( list.at( 0 ) );
282  }
283 #endif
284  case QVariant::ByteArray:
285  return qHash( variant.toByteArray() );
286  case QVariant::Date:
287  return qHash( variant.toDate() );
288  case QVariant::Time:
289  return qHash( variant.toTime() );
290  case QVariant::DateTime:
291  return qHash( variant.toDateTime() );
292  case QVariant::Url:
293  case QVariant::Locale:
294  case QVariant::RegExp:
295  return qHash( variant.toString() );
296  default:
297  break;
298  }
299 
300  return std::numeric_limits<uint>::max();
301 }
static const QString QGIS_VERSION
Version string.
Definition: qgis.h:63
static const char * QGIS_DEV_VERSION
The development version.
Definition: qgis.h:69
void * qgsMalloc(size_t size)
Allocates size bytes and returns a pointer to the allocated memory.
Definition: qgis.cpp:111
static const double UI_SCALE_FACTOR
UI scaling factor.
Definition: qgis.h:151
#define QgsDebugMsg(str)
Definition: qgslogger.h:38
double qgsPermissiveToDouble(QString string, bool &ok)
Converts a string to a double in a permissive way, e.g., allowing for incorrect numbers of digits bet...
Definition: qgis.cpp:97
void * qgsCalloc(size_t nmemb, size_t size)
Allocates memory for an array of nmemb elements of size bytes each and returns a pointer to the alloc...
Definition: qgis.cpp:126
UnitType
Type of unit of tolerance value from settings.
Definition: qgstolerance.h:40
static const QColor DEFAULT_HIGHLIGHT_COLOR
Default highlight color.
Definition: qgis.h:121
bool qgsVariantGreaterThan(const QVariant &lhs, const QVariant &rhs)
Compares two QVariant values and returns whether the first is greater than the second.
Definition: qgis.cpp:214
static const int QGIS_VERSION_INT
Version number used for comparing versions using the "Check QGIS Version" function.
Definition: qgis.h:65
int qgsPermissiveToInt(QString string, bool &ok)
Converts a string to an integer in a permissive way, e.g., allowing for incorrect numbers of digits b...
Definition: qgis.cpp:104
bool qgsVariantLessThan(const QVariant &lhs, const QVariant &rhs)
Compares two QVariant values and returns whether the first is less than the second.
Definition: qgis.cpp:146
const QString GEO_NONE
Constant that holds the string representation for "No ellips/No CRS".
Definition: qgis.cpp:71
static const double DEFAULT_Z_COORDINATE
Default Z coordinate value for 2.5d geometry This value have to be assigned to the Z coordinate for t...
Definition: qgis.h:144
static const double DEFAULT_SNAP_TOLERANCE
Default snapping distance tolerance.
Definition: qgis.h:157
Pixels unit of tolerance.
Definition: qgstolerance.h:45
const QString GEOPROJ4
PROJ4 string that represents a geographic coord sys.
Definition: qgis.cpp:50
static const double DEFAULT_SEARCH_RADIUS_MM
Identify search radius in mm.
Definition: qgis.h:112
const QString GEO_EPSG_CRS_AUTHID
Geographic coord sys from EPSG authority.
Definition: qgis.cpp:69
static const QgsTolerance::UnitType DEFAULT_SNAP_UNITS
Default snapping distance units.
Definition: qgis.h:163
const QString GEOWKT
Wkt string that represents a geographic coord sys.
Definition: qgis.cpp:52
uint qHash(const QVariant &variant)
Hash for QVariant.
Definition: qgis.cpp:236
static const float DEFAULT_MAPTOPIXEL_THRESHOLD
Default threshold between map coordinates and device coordinates for map2pixel simplification.
Definition: qgis.h:115
static const QString QGIS_RELEASE_NAME
Release name.
Definition: qgis.h:67
const QString PROJECT_SCALES
Definition: qgis.cpp:65
QString qgsVsiPrefix(const QString &path)
Definition: qgis.cpp:219
static const double DEFAULT_HIGHLIGHT_MIN_WIDTH_MM
Default highlight line/stroke minimum width in mm.
Definition: qgis.h:131
static const double DEFAULT_HIGHLIGHT_BUFFER_MM
Default highlight buffer in mm.
Definition: qgis.h:126
void qgsFree(void *ptr)
Frees the memory space pointed to by ptr.
Definition: qgis.cpp:141
static const double SCALE_PRECISION
Fudge factor used to compare two scales.
Definition: qgis.h:138