QGIS API Documentation 3.99.0-Master (d270888f95f)
Loading...
Searching...
No Matches
qgsunittypes.cpp
Go to the documentation of this file.
1/***************************************************************************
2 qgsunittypes.cpp
3 --------------
4 begin : February 2016
5 copyright : (C) 2016 by Nyall Dawson
6 email : nyall dot dawson at gmail dot com
7 ***************************************************************************/
8/***************************************************************************
9 * *
10 * This program is free software; you can redistribute it and/or modify *
11 * it under the terms of the GNU General Public License as published by *
12 * the Free Software Foundation; either version 2 of the License, or *
13 * (at your option) any later version. *
14 * *
15 ***************************************************************************/
16
17#include "qgsunittypes.h"
18
19#include "qgis.h"
20
21#include <QString>
22
23#include "moc_qgsunittypes.cpp"
24
25using namespace Qt::StringLiterals;
26
27/***************************************************************************
28 * This class is considered CRITICAL and any change MUST be accompanied with
29 * full unit tests in test_qgsunittypes.py.
30 * See details in QEP #17
31 ****************************************************************************/
32
33QString QgsUnitTypes::encodeUnitType( Qgis::UnitType type )
34{
35 switch ( type )
36 {
37 case Qgis::UnitType::Distance:
38 return u"distance"_s;
39
40 case Qgis::UnitType::Area:
41 return u"area"_s;
42
43 case Qgis::UnitType::Volume:
44 return u"volume"_s;
45
46 case Qgis::UnitType::Temporal:
47 return u"temporal"_s;
48
49 case Qgis::UnitType::Unknown:
50 return u"<unknown>"_s;
51
52 }
53 return QString();
54}
55
56Qgis::UnitType QgsUnitTypes::decodeUnitType( const QString &string, bool *ok )
57{
58 const QString normalized = string.trimmed().toLower();
59
60 if ( ok )
61 *ok = true;
62
63 if ( normalized == encodeUnitType( Qgis::UnitType::Distance ) )
64 return Qgis::UnitType::Distance;
65 if ( normalized == encodeUnitType( Qgis::UnitType::Area ) )
66 return Qgis::UnitType::Area;
67 if ( normalized == encodeUnitType( Qgis::UnitType::Volume ) )
68 return Qgis::UnitType::Volume;
69 if ( normalized == encodeUnitType( Qgis::UnitType::Temporal ) )
70 return Qgis::UnitType::Temporal;
71 if ( normalized == encodeUnitType( Qgis::UnitType::Unknown ) )
72 return Qgis::UnitType::Unknown;
73
74 if ( ok )
75 *ok = false;
76
77 return Qgis::UnitType::Unknown;
78}
79
80Qgis::DistanceUnitType QgsUnitTypes::unitType( Qgis::DistanceUnit unit )
81{
82 switch ( unit )
83 {
84 case Qgis::DistanceUnit::Meters:
85 case Qgis::DistanceUnit::Feet:
86 case Qgis::DistanceUnit::NauticalMiles:
87 case Qgis::DistanceUnit::Yards:
88 case Qgis::DistanceUnit::Miles:
89 case Qgis::DistanceUnit::Kilometers:
90 case Qgis::DistanceUnit::Centimeters:
91 case Qgis::DistanceUnit::Millimeters:
92 case Qgis::DistanceUnit::Inches:
93 case Qgis::DistanceUnit::ChainsInternational:
94 case Qgis::DistanceUnit::ChainsBritishBenoit1895A:
95 case Qgis::DistanceUnit::ChainsBritishBenoit1895B:
96 case Qgis::DistanceUnit::ChainsBritishSears1922Truncated:
97 case Qgis::DistanceUnit::ChainsBritishSears1922:
98 case Qgis::DistanceUnit::ChainsClarkes:
99 case Qgis::DistanceUnit::ChainsUSSurvey:
100 case Qgis::DistanceUnit::FeetBritish1865:
101 case Qgis::DistanceUnit::FeetBritish1936:
102 case Qgis::DistanceUnit::FeetBritishBenoit1895A:
103 case Qgis::DistanceUnit::FeetBritishBenoit1895B:
104 case Qgis::DistanceUnit::FeetBritishSears1922Truncated:
105 case Qgis::DistanceUnit::FeetBritishSears1922:
106 case Qgis::DistanceUnit::FeetClarkes:
107 case Qgis::DistanceUnit::FeetGoldCoast:
108 case Qgis::DistanceUnit::FeetIndian:
109 case Qgis::DistanceUnit::FeetIndian1937:
110 case Qgis::DistanceUnit::FeetIndian1962:
111 case Qgis::DistanceUnit::FeetIndian1975:
112 case Qgis::DistanceUnit::FeetUSSurvey:
113 case Qgis::DistanceUnit::LinksInternational:
114 case Qgis::DistanceUnit::LinksBritishBenoit1895A:
115 case Qgis::DistanceUnit::LinksBritishBenoit1895B:
116 case Qgis::DistanceUnit::LinksBritishSears1922Truncated:
117 case Qgis::DistanceUnit::LinksBritishSears1922:
118 case Qgis::DistanceUnit::LinksClarkes:
119 case Qgis::DistanceUnit::LinksUSSurvey:
120 case Qgis::DistanceUnit::YardsBritishBenoit1895A:
121 case Qgis::DistanceUnit::YardsBritishBenoit1895B:
122 case Qgis::DistanceUnit::YardsBritishSears1922Truncated:
123 case Qgis::DistanceUnit::YardsBritishSears1922:
124 case Qgis::DistanceUnit::YardsClarkes:
125 case Qgis::DistanceUnit::YardsIndian:
126 case Qgis::DistanceUnit::YardsIndian1937:
127 case Qgis::DistanceUnit::YardsIndian1962:
128 case Qgis::DistanceUnit::YardsIndian1975:
129 case Qgis::DistanceUnit::MilesUSSurvey:
130 case Qgis::DistanceUnit::Fathoms:
131 case Qgis::DistanceUnit::MetersGermanLegal:
132 return Qgis::DistanceUnitType::Standard;
133
134 case Qgis::DistanceUnit::Degrees:
135 return Qgis::DistanceUnitType::Geographic;
136
137 case Qgis::DistanceUnit::Unknown:
138 return Qgis::DistanceUnitType::Unknown;
139 }
140 return Qgis::DistanceUnitType::Unknown;
141}
142
169
170QString QgsUnitTypes::encodeUnit( Qgis::DistanceUnit unit )
171{
172 switch ( unit )
173 {
174 case Qgis::DistanceUnit::Meters:
175 return u"meters"_s;
176
177 case Qgis::DistanceUnit::Kilometers:
178 return u"km"_s;
179
180 case Qgis::DistanceUnit::Feet:
181 return u"feet"_s;
182
183 case Qgis::DistanceUnit::Yards:
184 return u"yd"_s;
185
186 case Qgis::DistanceUnit::Miles:
187 return u"mi"_s;
188
189 case Qgis::DistanceUnit::Degrees:
190 return u"degrees"_s;
191
192 case Qgis::DistanceUnit::Unknown:
193 return u"<unknown>"_s;
194
195 case Qgis::DistanceUnit::NauticalMiles:
196 return u"nautical miles"_s;
197
198 case Qgis::DistanceUnit::Centimeters:
199 return u"cm"_s;
200
201 case Qgis::DistanceUnit::Millimeters:
202 return u"mm"_s;
203
204 case Qgis::DistanceUnit::Inches:
205 return u"in"_s;
206
207 case Qgis::DistanceUnit::ChainsInternational:
208 return u"chain"_s;
209
210 case Qgis::DistanceUnit::ChainsBritishBenoit1895A:
211 return u"chain british benoit b1895a"_s;
212
213 case Qgis::DistanceUnit::ChainsBritishBenoit1895B:
214 return u"chain british benoit b1895b"_s;
215
216 case Qgis::DistanceUnit::ChainsBritishSears1922Truncated:
217 return u"chain british sears 1922 truncated"_s;
218
219 case Qgis::DistanceUnit::ChainsBritishSears1922:
220 return u"chain british sears 1922"_s;
221
222 case Qgis::DistanceUnit::ChainsClarkes:
223 return u"chain clarkes"_s;
224
225 case Qgis::DistanceUnit::ChainsUSSurvey:
226 return u"chain us survey"_s;
227
228 case Qgis::DistanceUnit::FeetBritish1865:
229 return u"feet british 1865"_s;
230
231 case Qgis::DistanceUnit::FeetBritish1936:
232 return u"feet british 1936"_s;
233
234 case Qgis::DistanceUnit::FeetBritishBenoit1895A:
235 return u"feet british benoit 1895a"_s;
236
237 case Qgis::DistanceUnit::FeetBritishBenoit1895B:
238 return u"feet british benoit 1895b"_s;
239
240 case Qgis::DistanceUnit::FeetBritishSears1922Truncated:
241 return u"feet british sears 1922 truncated"_s;
242
243 case Qgis::DistanceUnit::FeetBritishSears1922:
244 return u"feet british sears 1922"_s;
245
246 case Qgis::DistanceUnit::FeetClarkes:
247 return u"feet clarkes"_s;
248
249 case Qgis::DistanceUnit::FeetGoldCoast:
250 return u"feet gold coast"_s;
251
252 case Qgis::DistanceUnit::FeetIndian:
253 return u"feet indian"_s;
254 case Qgis::DistanceUnit::FeetIndian1937:
255 return u"feet indian 1937"_s;
256
257 case Qgis::DistanceUnit::FeetIndian1962:
258 return u"feet indian 1962"_s;
259
260 case Qgis::DistanceUnit::FeetIndian1975:
261 return u"feet indian 1975"_s;
262
263 case Qgis::DistanceUnit::FeetUSSurvey:
264 return u"feet us survey"_s;
265
266 case Qgis::DistanceUnit::LinksInternational:
267 return u"links"_s;
268
269 case Qgis::DistanceUnit::LinksBritishBenoit1895A:
270 return u"links british benoit 1895a"_s;
271
272 case Qgis::DistanceUnit::LinksBritishBenoit1895B:
273 return u"links british benoit 1895b"_s;
274
275 case Qgis::DistanceUnit::LinksBritishSears1922Truncated:
276 return u"links british sears 1922 truncated"_s;
277
278 case Qgis::DistanceUnit::LinksBritishSears1922:
279 return u"links british sears 1922"_s;
280
281 case Qgis::DistanceUnit::LinksClarkes:
282 return u"links clarkes"_s;
283
284 case Qgis::DistanceUnit::LinksUSSurvey:
285 return u"links us survey"_s;
286
287 case Qgis::DistanceUnit::YardsBritishBenoit1895A:
288 return u"yards british benoit 1895a"_s;
289
290 case Qgis::DistanceUnit::YardsBritishBenoit1895B:
291 return u"yards british benoit 1895b"_s;
292
293 case Qgis::DistanceUnit::YardsBritishSears1922Truncated:
294 return u"yards british sears 1922 truncated"_s;
295
296 case Qgis::DistanceUnit::YardsBritishSears1922:
297 return u"yards british sears 1922"_s;
298
299 case Qgis::DistanceUnit::YardsClarkes:
300 return u"yards clarkes"_s;
301
302 case Qgis::DistanceUnit::YardsIndian:
303 return u"yards indian"_s;
304
305 case Qgis::DistanceUnit::YardsIndian1937:
306 return u"yards indian 1937"_s;
307
308 case Qgis::DistanceUnit::YardsIndian1962:
309 return u"yards indian 1962"_s;
310
311 case Qgis::DistanceUnit::YardsIndian1975:
312 return u"yards indian 1975"_s;
313
314 case Qgis::DistanceUnit::MilesUSSurvey:
315 return u"miles us survey"_s;
316
317 case Qgis::DistanceUnit::Fathoms:
318 return u"yards fathom"_s;
319
320 case Qgis::DistanceUnit::MetersGermanLegal:
321 return u"german legal meters"_s;
322 }
323 return QString();
324}
325
326/***************************************************************************
327 * This class is considered CRITICAL and any change MUST be accompanied with
328 * full unit tests in test_qgsunittypes.py.
329 * See details in QEP #17
330 ****************************************************************************/
331
332Qgis::DistanceUnit QgsUnitTypes::decodeDistanceUnit( const QString &string, bool *ok )
333{
334 const QString normalized = string.trimmed().toLower();
335
336 if ( ok )
337 *ok = true;
338
339 for ( const Qgis::DistanceUnit unit :
340 {
341 Qgis::DistanceUnit::Meters,
342 Qgis::DistanceUnit::Feet,
343 Qgis::DistanceUnit::Degrees,
344 Qgis::DistanceUnit::NauticalMiles,
345 Qgis::DistanceUnit::Kilometers,
346 Qgis::DistanceUnit::Yards,
347 Qgis::DistanceUnit::Miles,
348 Qgis::DistanceUnit::Centimeters,
349 Qgis::DistanceUnit::Millimeters,
350 Qgis::DistanceUnit::Inches,
351 Qgis::DistanceUnit::Unknown,
352
353 Qgis::DistanceUnit::ChainsInternational,
354 Qgis::DistanceUnit::ChainsBritishBenoit1895A,
355 Qgis::DistanceUnit::ChainsBritishBenoit1895B,
356 Qgis::DistanceUnit::ChainsBritishSears1922Truncated,
357 Qgis::DistanceUnit::ChainsBritishSears1922,
358 Qgis::DistanceUnit::ChainsClarkes,
359 Qgis::DistanceUnit::ChainsUSSurvey,
360 Qgis::DistanceUnit::FeetBritish1865,
361 Qgis::DistanceUnit::FeetBritish1936,
362 Qgis::DistanceUnit::FeetBritishBenoit1895A,
363 Qgis::DistanceUnit::FeetBritishBenoit1895B,
364 Qgis::DistanceUnit::FeetBritishSears1922Truncated,
365 Qgis::DistanceUnit::FeetBritishSears1922,
366 Qgis::DistanceUnit::FeetClarkes,
367 Qgis::DistanceUnit::FeetGoldCoast,
368 Qgis::DistanceUnit::FeetIndian,
369 Qgis::DistanceUnit::FeetIndian1937,
370 Qgis::DistanceUnit::FeetIndian1962,
371 Qgis::DistanceUnit::FeetIndian1975,
372 Qgis::DistanceUnit::FeetUSSurvey,
373 Qgis::DistanceUnit::LinksInternational,
374 Qgis::DistanceUnit::LinksBritishBenoit1895A,
375 Qgis::DistanceUnit::LinksBritishBenoit1895B,
376 Qgis::DistanceUnit::LinksBritishSears1922Truncated,
377 Qgis::DistanceUnit::LinksBritishSears1922,
378 Qgis::DistanceUnit::LinksClarkes,
379 Qgis::DistanceUnit::LinksUSSurvey,
380 Qgis::DistanceUnit::YardsBritishBenoit1895A,
381 Qgis::DistanceUnit::YardsBritishBenoit1895B,
382 Qgis::DistanceUnit::YardsBritishSears1922Truncated,
383 Qgis::DistanceUnit::YardsBritishSears1922,
384 Qgis::DistanceUnit::YardsClarkes,
385 Qgis::DistanceUnit::YardsIndian,
386 Qgis::DistanceUnit::YardsIndian1937,
387 Qgis::DistanceUnit::YardsIndian1962,
388 Qgis::DistanceUnit::YardsIndian1975,
389 Qgis::DistanceUnit::MilesUSSurvey,
390 Qgis::DistanceUnit::Fathoms,
391 Qgis::DistanceUnit::MetersGermanLegal,
392 } )
393 {
394 if ( normalized == encodeUnit( unit ) )
395 return unit;
396 }
397 if ( ok )
398 *ok = false;
399
400 return Qgis::DistanceUnit::Unknown;
401}
402
403QString QgsUnitTypes::toString( Qgis::DistanceUnit unit )
404{
405 switch ( unit )
406 {
407 case Qgis::DistanceUnit::Meters:
408 return QObject::tr( "meters", "distance" );
409
410 case Qgis::DistanceUnit::Kilometers:
411 return QObject::tr( "kilometers", "distance" );
412
413 case Qgis::DistanceUnit::Feet:
414 return QObject::tr( "feet", "distance" );
415
416 case Qgis::DistanceUnit::Yards:
417 return QObject::tr( "yards", "distance" );
418
419 case Qgis::DistanceUnit::Miles:
420 return QObject::tr( "miles", "distance" );
421
422 case Qgis::DistanceUnit::Degrees:
423 return QObject::tr( "degrees", "distance" );
424
425 case Qgis::DistanceUnit::Centimeters:
426 return QObject::tr( "centimeters", "distance" );
427
428 case Qgis::DistanceUnit::Millimeters:
429 return QObject::tr( "millimeters", "distance" );
430
431 case Qgis::DistanceUnit::Inches:
432 return QObject::tr( "inches", "distance" );
433
434 case Qgis::DistanceUnit::Unknown:
435 return QObject::tr( "<unknown>", "distance" );
436
437 case Qgis::DistanceUnit::NauticalMiles:
438 return QObject::tr( "nautical miles", "distance" );
439
440 case Qgis::DistanceUnit::ChainsInternational:
441 return QObject::tr( "chains (international)", "distance" );
442
443 case Qgis::DistanceUnit::ChainsBritishBenoit1895A:
444 return QObject::tr( "chains (British, Benoit 1895 A)", "distance" );
445
446 case Qgis::DistanceUnit::ChainsBritishBenoit1895B:
447 return QObject::tr( "chains (British, Benoit 1895 B)", "distance" );
448
449 case Qgis::DistanceUnit::ChainsBritishSears1922Truncated:
450 return QObject::tr( "chains (British, Sears 1922 truncated)", "distance" );
451
452 case Qgis::DistanceUnit::ChainsBritishSears1922:
453 return QObject::tr( "chains (British, Sears 1922)", "distance" );
454
455 case Qgis::DistanceUnit::ChainsClarkes:
456 return QObject::tr( "chains (Clarke's)", "distance" );
457
458 case Qgis::DistanceUnit::ChainsUSSurvey:
459 return QObject::tr( "chains (US survey)", "distance" );
460
461 case Qgis::DistanceUnit::FeetBritish1865:
462 return QObject::tr( "feet (British, 1865)", "distance" );
463
464 case Qgis::DistanceUnit::FeetBritish1936:
465 return QObject::tr( "feet (British, 1936)", "distance" );
466
467 case Qgis::DistanceUnit::FeetBritishBenoit1895A:
468 return QObject::tr( "feet (British, Benoit 1895 A)", "distance" );
469
470 case Qgis::DistanceUnit::FeetBritishBenoit1895B:
471 return QObject::tr( "feet (British, Benoit 1895 B)", "distance" );
472
473 case Qgis::DistanceUnit::FeetBritishSears1922Truncated:
474 return QObject::tr( "feet (British, Sears 1922 truncated)", "distance" );
475
476 case Qgis::DistanceUnit::FeetBritishSears1922:
477 return QObject::tr( "feet (British, Sears 1922)", "distance" );
478
479 case Qgis::DistanceUnit::FeetClarkes:
480 return QObject::tr( "feet (Clarke's)", "distance" );
481
482 case Qgis::DistanceUnit::FeetGoldCoast:
483 return QObject::tr( "feet (Gold Coast)", "distance" );
484
485 case Qgis::DistanceUnit::FeetIndian:
486 return QObject::tr( "feet (Indian)", "distance" );
487
488 case Qgis::DistanceUnit::FeetIndian1937:
489 return QObject::tr( "feet (Indian 1937)", "distance" );
490
491 case Qgis::DistanceUnit::FeetIndian1962:
492 return QObject::tr( "feet (Indian 1962)", "distance" );
493
494 case Qgis::DistanceUnit::FeetIndian1975:
495 return QObject::tr( "feet (Indian 1975)", "distance" );
496
497 case Qgis::DistanceUnit::FeetUSSurvey:
498 return QObject::tr( "feet (US survey)", "distance" );
499
500 case Qgis::DistanceUnit::LinksInternational:
501 return QObject::tr( "links", "distance" );
502
503 case Qgis::DistanceUnit::LinksBritishBenoit1895A:
504 return QObject::tr( "links (British, Benoit 1895 A)", "distance" );
505
506 case Qgis::DistanceUnit::LinksBritishBenoit1895B:
507 return QObject::tr( "links (British, Benoit 1895 B)", "distance" );
508
509 case Qgis::DistanceUnit::LinksBritishSears1922Truncated:
510 return QObject::tr( "links (British, Sears 1922 truncated)", "distance" );
511
512 case Qgis::DistanceUnit::LinksBritishSears1922:
513 return QObject::tr( "links (British, Sears 1922)", "distance" );
514
515 case Qgis::DistanceUnit::LinksClarkes:
516 return QObject::tr( "links (Clarke's)", "distance" );
517
518 case Qgis::DistanceUnit::LinksUSSurvey:
519 return QObject::tr( "links (US survey)", "distance" );
520
521 case Qgis::DistanceUnit::YardsBritishBenoit1895A:
522 return QObject::tr( "yards (British, Benoit 1895 A)", "distance" );
523
524 case Qgis::DistanceUnit::YardsBritishBenoit1895B:
525 return QObject::tr( "yards (British, Benoit 1895 B)", "distance" );
526
527 case Qgis::DistanceUnit::YardsBritishSears1922Truncated:
528 return QObject::tr( "yards (British, Sears 1922 truncated)", "distance" );
529
530 case Qgis::DistanceUnit::YardsBritishSears1922:
531 return QObject::tr( "yards (British, Sears 1922)", "distance" );
532
533 case Qgis::DistanceUnit::YardsClarkes:
534 return QObject::tr( "yards (Clarke's)", "distance" );
535
536 case Qgis::DistanceUnit::YardsIndian:
537 return QObject::tr( "yards (Indian)", "distance" );
538
539 case Qgis::DistanceUnit::YardsIndian1937:
540 return QObject::tr( "yards (Indian 1937)", "distance" );
541
542 case Qgis::DistanceUnit::YardsIndian1962:
543 return QObject::tr( "yards (Indian 1962)", "distance" );
544
545 case Qgis::DistanceUnit::YardsIndian1975:
546 return QObject::tr( "yards (Indian 1975)", "distance" );
547
548 case Qgis::DistanceUnit::MilesUSSurvey:
549 return QObject::tr( "miles (US survey)", "distance" );
550
551 case Qgis::DistanceUnit::Fathoms:
552 return QObject::tr( "fathoms", "distance" );
553
554 case Qgis::DistanceUnit::MetersGermanLegal:
555 return QObject::tr( "meters (German legal)", "distance" );
556 }
557 return QString();
558}
559
560QString QgsUnitTypes::toAbbreviatedString( Qgis::RenderUnit unit )
561{
562 switch ( unit )
563 {
564 case Qgis::RenderUnit::Millimeters:
565 return QObject::tr( "mm", "render" );
566
567 case Qgis::RenderUnit::MapUnits:
568 return QObject::tr( "map units", "render" );
569
570 case Qgis::RenderUnit::Pixels:
571 return QObject::tr( "px", "render" );
572
573 case Qgis::RenderUnit::Percentage:
574 return QObject::tr( "%", "render" );
575
576 case Qgis::RenderUnit::Points:
577 return QObject::tr( "pt", "render" );
578
579 case Qgis::RenderUnit::Inches:
580 return QObject::tr( "in", "render" );
581
582 case Qgis::RenderUnit::Unknown:
583 return QObject::tr( "unknown", "render" );
584
585 case Qgis::RenderUnit::MetersInMapUnits:
586 return QObject::tr( "m", "render" );
587
588 }
589
590 return QString();
591}
592
593QString QgsUnitTypes::toAbbreviatedString( Qgis::DistanceUnit unit )
594{
595 switch ( unit )
596 {
597 case Qgis::DistanceUnit::Meters:
598 return QObject::tr( "m", "distance" );
599
600 case Qgis::DistanceUnit::Kilometers:
601 return QObject::tr( "km", "distance" );
602
603 case Qgis::DistanceUnit::Feet:
604 case Qgis::DistanceUnit::FeetBritish1865:
605 case Qgis::DistanceUnit::FeetBritish1936:
606 case Qgis::DistanceUnit::FeetBritishBenoit1895A:
607 case Qgis::DistanceUnit::FeetBritishBenoit1895B:
608 case Qgis::DistanceUnit::FeetBritishSears1922Truncated:
609 case Qgis::DistanceUnit::FeetBritishSears1922:
610 case Qgis::DistanceUnit::FeetClarkes:
611 case Qgis::DistanceUnit::FeetGoldCoast:
612 case Qgis::DistanceUnit::FeetIndian:
613 case Qgis::DistanceUnit::FeetIndian1937:
614 case Qgis::DistanceUnit::FeetIndian1962:
615 case Qgis::DistanceUnit::FeetIndian1975:
616 case Qgis::DistanceUnit::FeetUSSurvey:
617 return QObject::tr( "ft", "distance" );
618
619 case Qgis::DistanceUnit::Yards:
620 case Qgis::DistanceUnit::YardsBritishBenoit1895A:
621 case Qgis::DistanceUnit::YardsBritishBenoit1895B:
622 case Qgis::DistanceUnit::YardsBritishSears1922Truncated:
623 case Qgis::DistanceUnit::YardsBritishSears1922:
624 case Qgis::DistanceUnit::YardsClarkes:
625 case Qgis::DistanceUnit::YardsIndian:
626 case Qgis::DistanceUnit::YardsIndian1937:
627 case Qgis::DistanceUnit::YardsIndian1962:
628 case Qgis::DistanceUnit::YardsIndian1975:
629 return QObject::tr( "yd", "distance" );
630
631 case Qgis::DistanceUnit::Miles:
632 case Qgis::DistanceUnit::MilesUSSurvey:
633 return QObject::tr( "mi", "distance" );
634
635 case Qgis::DistanceUnit::Degrees:
636 return QObject::tr( "deg", "distance" );
637
638 case Qgis::DistanceUnit::Centimeters:
639 return QObject::tr( "cm", "distance" );
640
641 case Qgis::DistanceUnit::Millimeters:
642 return QObject::tr( "mm", "distance" );
643
644 case Qgis::DistanceUnit::Inches:
645 return QObject::tr( "in", "distance" );
646
647 case Qgis::DistanceUnit::Unknown:
648 return QString();
649
650 case Qgis::DistanceUnit::NauticalMiles:
651 return QObject::tr( "NM", "distance" );
652
653 case Qgis::DistanceUnit::ChainsInternational:
654 case Qgis::DistanceUnit::ChainsBritishBenoit1895A:
655 case Qgis::DistanceUnit::ChainsBritishBenoit1895B:
656 case Qgis::DistanceUnit::ChainsBritishSears1922Truncated:
657 case Qgis::DistanceUnit::ChainsBritishSears1922:
658 case Qgis::DistanceUnit::ChainsClarkes:
659 case Qgis::DistanceUnit::ChainsUSSurvey:
660 return QObject::tr( "ch", "distance" );
661
662 case Qgis::DistanceUnit::LinksInternational:
663 case Qgis::DistanceUnit::LinksBritishBenoit1895A:
664 case Qgis::DistanceUnit::LinksBritishBenoit1895B:
665 case Qgis::DistanceUnit::LinksBritishSears1922Truncated:
666 case Qgis::DistanceUnit::LinksBritishSears1922:
667 case Qgis::DistanceUnit::LinksClarkes:
668 case Qgis::DistanceUnit::LinksUSSurvey:
669 return QObject::tr( "lk", "distance" );
670
671 case Qgis::DistanceUnit::Fathoms:
672 return QObject::tr( "f", "distance" );
673
674 case Qgis::DistanceUnit::MetersGermanLegal:
675 return QObject::tr( "glm", "distance" );
676
677 }
678 return QString();
679}
680
681/***************************************************************************
682 * This class is considered CRITICAL and any change MUST be accompanied with
683 * full unit tests in test_qgsunittypes.py.
684 * See details in QEP #17
685 ****************************************************************************/
686
687Qgis::DistanceUnit QgsUnitTypes::stringToDistanceUnit( const QString &string, bool *ok )
688{
689 const QString normalized = string.trimmed().toLower();
690
691 if ( ok )
692 *ok = true;
693
694 for ( const Qgis::DistanceUnit unit :
695 {
696 Qgis::DistanceUnit::Meters,
697 Qgis::DistanceUnit::Feet,
698 Qgis::DistanceUnit::Degrees,
699 Qgis::DistanceUnit::NauticalMiles,
700 Qgis::DistanceUnit::Kilometers,
701 Qgis::DistanceUnit::Yards,
702 Qgis::DistanceUnit::Miles,
703 Qgis::DistanceUnit::Centimeters,
704 Qgis::DistanceUnit::Millimeters,
705 Qgis::DistanceUnit::Inches,
706 Qgis::DistanceUnit::Unknown,
707 Qgis::DistanceUnit::ChainsInternational,
708 Qgis::DistanceUnit::ChainsBritishBenoit1895A,
709 Qgis::DistanceUnit::ChainsBritishBenoit1895B,
710 Qgis::DistanceUnit::ChainsBritishSears1922Truncated,
711 Qgis::DistanceUnit::ChainsBritishSears1922,
712 Qgis::DistanceUnit::ChainsClarkes,
713 Qgis::DistanceUnit::ChainsUSSurvey,
714 Qgis::DistanceUnit::FeetBritish1865,
715 Qgis::DistanceUnit::FeetBritish1936,
716 Qgis::DistanceUnit::FeetBritishBenoit1895A,
717 Qgis::DistanceUnit::FeetBritishBenoit1895B,
718 Qgis::DistanceUnit::FeetBritishSears1922Truncated,
719 Qgis::DistanceUnit::FeetBritishSears1922,
720 Qgis::DistanceUnit::FeetClarkes,
721 Qgis::DistanceUnit::FeetGoldCoast,
722 Qgis::DistanceUnit::FeetIndian,
723 Qgis::DistanceUnit::FeetIndian1937,
724 Qgis::DistanceUnit::FeetIndian1962,
725 Qgis::DistanceUnit::FeetIndian1975,
726 Qgis::DistanceUnit::FeetUSSurvey,
727 Qgis::DistanceUnit::LinksInternational,
728 Qgis::DistanceUnit::LinksBritishBenoit1895A,
729 Qgis::DistanceUnit::LinksBritishBenoit1895B,
730 Qgis::DistanceUnit::LinksBritishSears1922Truncated,
731 Qgis::DistanceUnit::LinksBritishSears1922,
732 Qgis::DistanceUnit::LinksClarkes,
733 Qgis::DistanceUnit::LinksUSSurvey,
734 Qgis::DistanceUnit::YardsBritishBenoit1895A,
735 Qgis::DistanceUnit::YardsBritishBenoit1895B,
736 Qgis::DistanceUnit::YardsBritishSears1922Truncated,
737 Qgis::DistanceUnit::YardsBritishSears1922,
738 Qgis::DistanceUnit::YardsClarkes,
739 Qgis::DistanceUnit::YardsIndian,
740 Qgis::DistanceUnit::YardsIndian1937,
741 Qgis::DistanceUnit::YardsIndian1962,
742 Qgis::DistanceUnit::YardsIndian1975,
743 Qgis::DistanceUnit::MilesUSSurvey,
744 Qgis::DistanceUnit::Fathoms,
745 Qgis::DistanceUnit::MetersGermanLegal,
746 } )
747 {
748 if ( normalized.compare( toString( unit ), Qt::CaseInsensitive ) == 0 )
749 return unit;
750 }
751
752 if ( ok )
753 *ok = false;
754
755 return Qgis::DistanceUnit::Unknown;
756}
757
758/***************************************************************************
759 * This class is considered CRITICAL and any change MUST be accompanied with
760 * full unit tests in test_qgsunittypes.py.
761 * See details in QEP #17
762 ****************************************************************************/
763
764constexpr double distanceUnitToMeter( Qgis::DistanceUnit unit )
765{
766 // values are from the EPSG units database:
767 switch ( unit )
768 {
769 case Qgis::DistanceUnit::Meters:
770 return 1.0;
771 case Qgis::DistanceUnit::Kilometers:
772 return 1000.0;
773 case Qgis::DistanceUnit::Feet:
774 return 0.3048;
775 case Qgis::DistanceUnit::NauticalMiles:
776 return 1852.0;
777 case Qgis::DistanceUnit::Yards:
778 return 0.9144;
779 case Qgis::DistanceUnit::Miles:
780 return 1609.344;
781 case Qgis::DistanceUnit::Degrees:
782 return 111319.49079327358;
783 case Qgis::DistanceUnit::Centimeters:
784 return 0.01;
785 case Qgis::DistanceUnit::Millimeters:
786 return 0.001;
787 case Qgis::DistanceUnit::Inches:
788 return 0.0254;
789 case Qgis::DistanceUnit::ChainsInternational:
790 return 20.1168;
791 case Qgis::DistanceUnit::ChainsBritishBenoit1895A:
792 return 20.1167824;
793 case Qgis::DistanceUnit::ChainsBritishBenoit1895B:
794 return 20.116782494376;
795 case Qgis::DistanceUnit::ChainsBritishSears1922Truncated:
796 return 20.116756;
797 case Qgis::DistanceUnit::ChainsBritishSears1922:
798 return 20.116765121553;
799 case Qgis::DistanceUnit::ChainsClarkes:
800 return 20.1166195164;
801 case Qgis::DistanceUnit::ChainsUSSurvey:
802 return 20.11684023368;
803 case Qgis::DistanceUnit::FeetBritish1865:
804 return 0.30480083333333;
805 case Qgis::DistanceUnit::FeetBritish1936:
806 return 0.3048007491;
807 case Qgis::DistanceUnit::FeetBritishBenoit1895A:
808 return 0.30479973333333;
809 case Qgis::DistanceUnit::FeetBritishBenoit1895B:
810 return 0.30479973476327;
811 case Qgis::DistanceUnit::FeetBritishSears1922Truncated:
812 return 0.30479933333333;
813 case Qgis::DistanceUnit::FeetBritishSears1922:
814 return 0.30479947153868;
815 case Qgis::DistanceUnit::FeetClarkes:
816 return 0.3047972654;
817 case Qgis::DistanceUnit::FeetGoldCoast:
818 return 0.30479971018151;
819 case Qgis::DistanceUnit::FeetIndian:
820 return 0.30479951024815;
821 case Qgis::DistanceUnit::FeetIndian1937:
822 return 0.30479841;
823 case Qgis::DistanceUnit::FeetIndian1962:
824 return 0.3047996;
825 case Qgis::DistanceUnit::FeetIndian1975:
826 return 0.3047995;
827 case Qgis::DistanceUnit::FeetUSSurvey:
828 return 0.30480060960122;
829 case Qgis::DistanceUnit::LinksInternational:
830 return 0.201168;
831 case Qgis::DistanceUnit::LinksBritishBenoit1895A:
832 return 0.201167824;
833 case Qgis::DistanceUnit::LinksBritishBenoit1895B:
834 return 0.20116782494376;
835 case Qgis::DistanceUnit::LinksBritishSears1922Truncated:
836 return 0.20116756;
837 case Qgis::DistanceUnit::LinksBritishSears1922:
838 return 0.20116765121553;
839 case Qgis::DistanceUnit::LinksClarkes:
840 return 0.201166195164;
841 case Qgis::DistanceUnit::LinksUSSurvey:
842 return 0.2011684023368;
843 case Qgis::DistanceUnit::YardsBritishBenoit1895A:
844 return 0.9143992;
845 case Qgis::DistanceUnit::YardsBritishBenoit1895B:
846 return 0.91439920428981;
847 case Qgis::DistanceUnit::YardsBritishSears1922Truncated:
848 return 0.914398;
849 case Qgis::DistanceUnit::YardsBritishSears1922:
850 return 0.91439841461603;
851 case Qgis::DistanceUnit::YardsClarkes:
852 return 0.9143917962;
853 case Qgis::DistanceUnit::YardsIndian:
854 return 0.91439853074444;
855 case Qgis::DistanceUnit::YardsIndian1937:
856 return 0.91439523;
857 case Qgis::DistanceUnit::YardsIndian1962:
858 return 0.9143988;
859 case Qgis::DistanceUnit::YardsIndian1975:
860 return 0.9143985;
861 case Qgis::DistanceUnit::MilesUSSurvey:
862 return 1609.3472186944;
863 case Qgis::DistanceUnit::Fathoms:
864 return 1.8288;
865 case Qgis::DistanceUnit::Unknown:
866 return 1;
867 case Qgis::DistanceUnit::MetersGermanLegal:
868 return 1.0000135965;
869 }
870 return 1;
871}
872
873double QgsUnitTypes::fromUnitToUnitFactor( Qgis::DistanceUnit fromUnit, Qgis::DistanceUnit toUnit )
874{
875 if ( fromUnit == toUnit || fromUnit == Qgis::DistanceUnit::Unknown || toUnit == Qgis::DistanceUnit::Unknown )
876 return 1.0;
877
878 constexpr double FEET_TO_INCHES = 12;
879 constexpr double YARDS_TO_FEET = 3.0;
880
881 // Calculate the conversion factor between the specified units
882
883 // special cases, where we don't go through meters as an intermediate unit:
884 switch ( fromUnit )
885 {
886 case Qgis::DistanceUnit::Feet:
887 {
888 switch ( toUnit )
889 {
890 case Qgis::DistanceUnit::Inches:
891 return FEET_TO_INCHES;
892 case Qgis::DistanceUnit::Yards:
893 return 1.0 / YARDS_TO_FEET;
894 default:
895 break;
896 }
897
898 break;
899 }
900 case Qgis::DistanceUnit::Yards:
901 {
902 switch ( toUnit )
903 {
904 case Qgis::DistanceUnit::Feet:
905 return YARDS_TO_FEET;
906 case Qgis::DistanceUnit::Inches:
907 return YARDS_TO_FEET * FEET_TO_INCHES;
908 default:
909 break;
910 }
911
912 break;
913 }
914
915 case Qgis::DistanceUnit::Inches:
916 {
917 switch ( toUnit )
918 {
919 case Qgis::DistanceUnit::Feet:
920 return 1.0 / FEET_TO_INCHES;
921 case Qgis::DistanceUnit::Yards:
922 return 1.0 / ( YARDS_TO_FEET * FEET_TO_INCHES );
923 default:
924 break;
925 }
926
927 break;
928 }
929
930 default:
931 break;
932 }
933
934 return distanceUnitToMeter( fromUnit ) / distanceUnitToMeter( toUnit );
935}
936
937QString QgsUnitTypes::encodeUnit( Qgis::AreaUnit unit )
938{
939 switch ( unit )
940 {
941 case Qgis::AreaUnit::SquareMeters:
942 return u"m2"_s;
943 case Qgis::AreaUnit::SquareKilometers:
944 return u"km2"_s;
945 case Qgis::AreaUnit::SquareFeet:
946 return u"ft2"_s;
947 case Qgis::AreaUnit::SquareYards:
948 return u"y2"_s;
949 case Qgis::AreaUnit::SquareMiles:
950 return u"mi2"_s;
951 case Qgis::AreaUnit::Hectares:
952 return u"ha"_s;
953 case Qgis::AreaUnit::Acres:
954 return u"ac"_s;
955 case Qgis::AreaUnit::SquareNauticalMiles:
956 return u"nm2"_s;
957 case Qgis::AreaUnit::SquareDegrees:
958 return u"deg2"_s;
959 case Qgis::AreaUnit::SquareCentimeters:
960 return u"cm2"_s;
961 case Qgis::AreaUnit::SquareMillimeters:
962 return u"mm2"_s;
963 case Qgis::AreaUnit::SquareInches:
964 return u"in2"_s;
965 case Qgis::AreaUnit::Unknown:
966 return u"<unknown>"_s;
967 }
968 return QString();
969}
970
971Qgis::AreaUnit QgsUnitTypes::decodeAreaUnit( const QString &string, bool *ok )
972{
973 const QString normalized = string.trimmed().toLower();
974
975 if ( ok )
976 *ok = true;
977
978 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareMeters ) )
979 return Qgis::AreaUnit::SquareMeters;
980 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareKilometers ) )
981 return Qgis::AreaUnit::SquareKilometers;
982 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareFeet ) )
983 return Qgis::AreaUnit::SquareFeet;
984 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareYards ) )
985 return Qgis::AreaUnit::SquareYards;
986 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareMiles ) )
987 return Qgis::AreaUnit::SquareMiles;
988 if ( normalized == encodeUnit( Qgis::AreaUnit::Hectares ) )
989 return Qgis::AreaUnit::Hectares;
990 if ( normalized == encodeUnit( Qgis::AreaUnit::Acres ) )
991 return Qgis::AreaUnit::Acres;
992 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareNauticalMiles ) )
993 return Qgis::AreaUnit::SquareNauticalMiles;
994 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareDegrees ) )
995 return Qgis::AreaUnit::SquareDegrees;
996 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareCentimeters ) )
997 return Qgis::AreaUnit::SquareCentimeters;
998 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareMillimeters ) )
999 return Qgis::AreaUnit::SquareMillimeters;
1000 if ( normalized == encodeUnit( Qgis::AreaUnit::SquareInches ) )
1001 return Qgis::AreaUnit::SquareInches;
1002 if ( normalized == encodeUnit( Qgis::AreaUnit::Unknown ) )
1003 return Qgis::AreaUnit::Unknown;
1004
1005 if ( ok )
1006 *ok = false;
1007
1008 return Qgis::AreaUnit::Unknown;
1009}
1010
1011QString QgsUnitTypes::toString( Qgis::AreaUnit unit )
1012{
1013 switch ( unit )
1014 {
1015 case Qgis::AreaUnit::SquareMeters:
1016 return QObject::tr( "square meters", "area" );
1017 case Qgis::AreaUnit::SquareKilometers:
1018 return QObject::tr( "square kilometers", "area" );
1019 case Qgis::AreaUnit::SquareFeet:
1020 return QObject::tr( "square feet", "area" );
1021 case Qgis::AreaUnit::SquareYards:
1022 return QObject::tr( "square yards", "area" );
1023 case Qgis::AreaUnit::SquareMiles:
1024 return QObject::tr( "square miles", "area" );
1025 case Qgis::AreaUnit::Hectares:
1026 return QObject::tr( "hectares", "area" );
1027 case Qgis::AreaUnit::Acres:
1028 return QObject::tr( "acres", "area" );
1029 case Qgis::AreaUnit::SquareNauticalMiles:
1030 return QObject::tr( "square nautical miles", "area" );
1031 case Qgis::AreaUnit::SquareDegrees:
1032 return QObject::tr( "square degrees", "area" );
1033 case Qgis::AreaUnit::SquareMillimeters:
1034 return QObject::tr( "square millimeters", "area" );
1035 case Qgis::AreaUnit::SquareCentimeters:
1036 return QObject::tr( "square centimeters", "area" );
1037 case Qgis::AreaUnit::SquareInches:
1038 return QObject::tr( "square inches", "area" );
1039 case Qgis::AreaUnit::Unknown:
1040 return QObject::tr( "<unknown>", "area" );
1041 }
1042 return QString();
1043}
1044
1045QString QgsUnitTypes::toAbbreviatedString( Qgis::AreaUnit unit )
1046{
1047 switch ( unit )
1048 {
1049 case Qgis::AreaUnit::SquareMeters:
1050 return QObject::tr( "m²", "area" );
1051 case Qgis::AreaUnit::SquareKilometers:
1052 return QObject::tr( "km²", "area" );
1053 case Qgis::AreaUnit::SquareFeet:
1054 return QObject::tr( "ft²", "area" );
1055 case Qgis::AreaUnit::SquareYards:
1056 return QObject::tr( "yd²", "area" );
1057 case Qgis::AreaUnit::SquareMiles:
1058 return QObject::tr( "mi²", "area" );
1059 case Qgis::AreaUnit::Hectares:
1060 return QObject::tr( "ha", "area" );
1061 case Qgis::AreaUnit::Acres:
1062 return QObject::tr( "ac", "area" );
1063 case Qgis::AreaUnit::SquareNauticalMiles:
1064 return QObject::tr( "NM²", "area" );
1065 case Qgis::AreaUnit::SquareDegrees:
1066 return QObject::tr( "deg²", "area" );
1067 case Qgis::AreaUnit::SquareCentimeters:
1068 return QObject::tr( "cm²", "area" );
1069 case Qgis::AreaUnit::SquareMillimeters:
1070 return QObject::tr( "mm²", "area" );
1071 case Qgis::AreaUnit::SquareInches:
1072 return QObject::tr( "in²", "area" );
1073 case Qgis::AreaUnit::Unknown:
1074 return QString();
1075 }
1076 return QString();
1077}
1078
1079Qgis::AreaUnit QgsUnitTypes::stringToAreaUnit( const QString &string, bool *ok )
1080{
1081 const QString normalized = string.trimmed().toLower();
1082
1083 if ( ok )
1084 *ok = true;
1085
1086 if ( normalized == toString( Qgis::AreaUnit::SquareMeters ) )
1087 return Qgis::AreaUnit::SquareMeters;
1088 if ( normalized == toString( Qgis::AreaUnit::SquareKilometers ) )
1089 return Qgis::AreaUnit::SquareKilometers;
1090 if ( normalized == toString( Qgis::AreaUnit::SquareFeet ) )
1091 return Qgis::AreaUnit::SquareFeet;
1092 if ( normalized == toString( Qgis::AreaUnit::SquareYards ) )
1093 return Qgis::AreaUnit::SquareYards;
1094 if ( normalized == toString( Qgis::AreaUnit::SquareMiles ) )
1095 return Qgis::AreaUnit::SquareMiles;
1096 if ( normalized == toString( Qgis::AreaUnit::Hectares ) )
1097 return Qgis::AreaUnit::Hectares;
1098 if ( normalized == toString( Qgis::AreaUnit::Acres ) )
1099 return Qgis::AreaUnit::Acres;
1100 if ( normalized == toString( Qgis::AreaUnit::SquareNauticalMiles ) )
1101 return Qgis::AreaUnit::SquareNauticalMiles;
1102 if ( normalized == toString( Qgis::AreaUnit::SquareDegrees ) )
1103 return Qgis::AreaUnit::SquareDegrees;
1104 if ( normalized == toString( Qgis::AreaUnit::SquareMillimeters ) )
1105 return Qgis::AreaUnit::SquareMillimeters;
1106 if ( normalized == toString( Qgis::AreaUnit::SquareCentimeters ) )
1107 return Qgis::AreaUnit::SquareCentimeters;
1108 if ( normalized == toString( Qgis::AreaUnit::SquareInches ) )
1109 return Qgis::AreaUnit::SquareInches;
1110 if ( normalized == toString( Qgis::AreaUnit::Unknown ) )
1111 return Qgis::AreaUnit::Unknown;
1112 if ( ok )
1113 *ok = false;
1114
1115 return Qgis::AreaUnit::Unknown;
1116}
1117
1118double QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit fromUnit, Qgis::AreaUnit toUnit )
1119{
1120#define KM2_TO_M2 1000000.0
1121#define CM2_TO_M2 0.0001
1122#define MM2_TO_M2 0.000001
1123#define FT2_TO_M2 0.09290304
1124#define IN2_TO_M2 0.00064516
1125#define YD2_TO_M2 0.83612736
1126#define MI2_TO_M2 2589988.110336
1127#define HA_TO_M2 10000.0
1128#define AC_TO_FT2 43560.0
1129#define DEG2_TO_M2 12392029030.5
1130#define NM2_TO_M2 3429904.0
1131
1132 // Calculate the conversion factor between the specified units
1133 switch ( fromUnit )
1134 {
1135 case Qgis::AreaUnit::SquareMeters:
1136 {
1137 switch ( toUnit )
1138 {
1139 case Qgis::AreaUnit::SquareMeters:
1140 return 1.0;
1141 case Qgis::AreaUnit::SquareKilometers:
1142 return 1.0 / KM2_TO_M2;
1143 case Qgis::AreaUnit::SquareFeet:
1144 return 1.0 / FT2_TO_M2;
1145 case Qgis::AreaUnit::SquareYards:
1146 return 1.0 / YD2_TO_M2;
1147 case Qgis::AreaUnit::SquareMiles:
1148 return 1.0 / MI2_TO_M2;
1149 case Qgis::AreaUnit::Hectares:
1150 return 1.0 / HA_TO_M2;
1151 case Qgis::AreaUnit::Acres:
1152 return 1.0 / AC_TO_FT2 / FT2_TO_M2;
1153 case Qgis::AreaUnit::SquareNauticalMiles:
1154 return 1.0 / NM2_TO_M2;
1155 case Qgis::AreaUnit::SquareDegrees:
1156 return 1.0 / DEG2_TO_M2;
1157 case Qgis::AreaUnit::SquareCentimeters:
1158 return 1.0 / CM2_TO_M2;
1159 case Qgis::AreaUnit::SquareMillimeters:
1160 return 1.0 / MM2_TO_M2;
1161 case Qgis::AreaUnit::SquareInches:
1162 return 1.0 / IN2_TO_M2;
1163 case Qgis::AreaUnit::Unknown:
1164 break;
1165 }
1166
1167 break;
1168 }
1169 case Qgis::AreaUnit::SquareKilometers:
1170 {
1171 switch ( toUnit )
1172 {
1173 case Qgis::AreaUnit::SquareMeters:
1174 return KM2_TO_M2;
1175 case Qgis::AreaUnit::SquareKilometers:
1176 return 1.0;
1177 case Qgis::AreaUnit::SquareFeet:
1178 return KM2_TO_M2 / FT2_TO_M2;
1179 case Qgis::AreaUnit::SquareYards:
1180 return KM2_TO_M2 / YD2_TO_M2;
1181 case Qgis::AreaUnit::SquareMiles:
1182 return KM2_TO_M2 / MI2_TO_M2;
1183 case Qgis::AreaUnit::Hectares:
1184 return KM2_TO_M2 / HA_TO_M2;
1185 case Qgis::AreaUnit::Acres:
1186 return KM2_TO_M2 / AC_TO_FT2 / FT2_TO_M2;
1187 case Qgis::AreaUnit::SquareNauticalMiles:
1188 return KM2_TO_M2 / NM2_TO_M2;
1189 case Qgis::AreaUnit::SquareDegrees:
1190 return KM2_TO_M2 / DEG2_TO_M2;
1191 case Qgis::AreaUnit::SquareCentimeters:
1192 return KM2_TO_M2 / CM2_TO_M2;
1193 case Qgis::AreaUnit::SquareMillimeters:
1194 return KM2_TO_M2 / MM2_TO_M2;
1195 case Qgis::AreaUnit::SquareInches:
1196 return KM2_TO_M2 / IN2_TO_M2;
1197 case Qgis::AreaUnit::Unknown:
1198 break;
1199 }
1200
1201 break;
1202 }
1203 case Qgis::AreaUnit::SquareFeet:
1204 {
1205 switch ( toUnit )
1206 {
1207 case Qgis::AreaUnit::SquareMeters:
1208 return FT2_TO_M2;
1209 case Qgis::AreaUnit::SquareKilometers:
1210 return FT2_TO_M2 / KM2_TO_M2;
1211 case Qgis::AreaUnit::SquareFeet:
1212 return 1.0;
1213 case Qgis::AreaUnit::SquareYards:
1214 return FT2_TO_M2 / YD2_TO_M2;
1215 case Qgis::AreaUnit::SquareMiles:
1216 return FT2_TO_M2 / MI2_TO_M2;
1217 case Qgis::AreaUnit::Hectares:
1218 return FT2_TO_M2 / HA_TO_M2;
1219 case Qgis::AreaUnit::Acres:
1220 return 1.0 / AC_TO_FT2;
1221 case Qgis::AreaUnit::SquareNauticalMiles:
1222 return FT2_TO_M2 / NM2_TO_M2;
1223 case Qgis::AreaUnit::SquareDegrees:
1224 return FT2_TO_M2 / DEG2_TO_M2;
1225 case Qgis::AreaUnit::SquareCentimeters:
1226 return FT2_TO_M2 / CM2_TO_M2;
1227 case Qgis::AreaUnit::SquareMillimeters:
1228 return FT2_TO_M2 / MM2_TO_M2;
1229 case Qgis::AreaUnit::SquareInches:
1230 return FT2_TO_M2 / IN2_TO_M2;
1231 case Qgis::AreaUnit::Unknown:
1232 break;
1233 }
1234
1235 break;
1236 }
1237
1238 case Qgis::AreaUnit::SquareYards:
1239 {
1240 switch ( toUnit )
1241 {
1242 case Qgis::AreaUnit::SquareMeters:
1243 return YD2_TO_M2;
1244 case Qgis::AreaUnit::SquareKilometers:
1245 return YD2_TO_M2 / KM2_TO_M2;
1246 case Qgis::AreaUnit::SquareFeet:
1247 return YD2_TO_M2 / FT2_TO_M2;
1248 case Qgis::AreaUnit::SquareYards:
1249 return 1.0;
1250 case Qgis::AreaUnit::SquareMiles:
1251 return YD2_TO_M2 / MI2_TO_M2;
1252 case Qgis::AreaUnit::Hectares:
1253 return YD2_TO_M2 / HA_TO_M2;
1254 case Qgis::AreaUnit::Acres:
1255 return YD2_TO_M2 / FT2_TO_M2 / AC_TO_FT2;
1256 case Qgis::AreaUnit::SquareNauticalMiles:
1257 return YD2_TO_M2 / NM2_TO_M2;
1258 case Qgis::AreaUnit::SquareDegrees:
1259 return YD2_TO_M2 / DEG2_TO_M2;
1260 case Qgis::AreaUnit::SquareCentimeters:
1261 return YD2_TO_M2 / CM2_TO_M2;
1262 case Qgis::AreaUnit::SquareMillimeters:
1263 return YD2_TO_M2 / MM2_TO_M2;
1264 case Qgis::AreaUnit::SquareInches:
1265 return YD2_TO_M2 / IN2_TO_M2;
1266 case Qgis::AreaUnit::Unknown:
1267 break;
1268 }
1269 break;
1270 }
1271
1272 case Qgis::AreaUnit::SquareMiles:
1273 {
1274 switch ( toUnit )
1275 {
1276 case Qgis::AreaUnit::SquareMeters:
1277 return MI2_TO_M2;
1278 case Qgis::AreaUnit::SquareKilometers:
1279 return MI2_TO_M2 / KM2_TO_M2;
1280 case Qgis::AreaUnit::SquareFeet:
1281 return MI2_TO_M2 / FT2_TO_M2;
1282 case Qgis::AreaUnit::SquareYards:
1283 return MI2_TO_M2 / YD2_TO_M2;
1284 case Qgis::AreaUnit::SquareMiles:
1285 return 1.0;
1286 case Qgis::AreaUnit::Hectares:
1287 return MI2_TO_M2 / HA_TO_M2;
1288 case Qgis::AreaUnit::Acres:
1289 return MI2_TO_M2 / FT2_TO_M2 / AC_TO_FT2;
1290 case Qgis::AreaUnit::SquareNauticalMiles:
1291 return MI2_TO_M2 / NM2_TO_M2;
1292 case Qgis::AreaUnit::SquareDegrees:
1293 return MI2_TO_M2 / DEG2_TO_M2;
1294 case Qgis::AreaUnit::SquareCentimeters:
1295 return MI2_TO_M2 / CM2_TO_M2;
1296 case Qgis::AreaUnit::SquareMillimeters:
1297 return MI2_TO_M2 / MM2_TO_M2;
1298 case Qgis::AreaUnit::SquareInches:
1299 return MI2_TO_M2 / IN2_TO_M2;
1300 case Qgis::AreaUnit::Unknown:
1301 break;
1302 }
1303
1304 break;
1305 }
1306
1307 case Qgis::AreaUnit::Hectares:
1308 {
1309 switch ( toUnit )
1310 {
1311 case Qgis::AreaUnit::SquareMeters:
1312 return HA_TO_M2;
1313 case Qgis::AreaUnit::SquareKilometers:
1314 return HA_TO_M2 / KM2_TO_M2;
1315 case Qgis::AreaUnit::SquareFeet:
1316 return HA_TO_M2 / FT2_TO_M2;
1317 case Qgis::AreaUnit::SquareYards:
1318 return HA_TO_M2 / YD2_TO_M2;
1319 case Qgis::AreaUnit::SquareMiles:
1320 return HA_TO_M2 / MI2_TO_M2;
1321 case Qgis::AreaUnit::Hectares:
1322 return 1.0;
1323 case Qgis::AreaUnit::Acres:
1324 return HA_TO_M2 / FT2_TO_M2 / AC_TO_FT2;
1325 case Qgis::AreaUnit::SquareNauticalMiles:
1326 return HA_TO_M2 / NM2_TO_M2;
1327 case Qgis::AreaUnit::SquareDegrees:
1328 return HA_TO_M2 / DEG2_TO_M2;
1329 case Qgis::AreaUnit::SquareCentimeters:
1330 return HA_TO_M2 / CM2_TO_M2;
1331 case Qgis::AreaUnit::SquareMillimeters:
1332 return HA_TO_M2 / MM2_TO_M2;
1333 case Qgis::AreaUnit::SquareInches:
1334 return HA_TO_M2 / IN2_TO_M2;
1335 case Qgis::AreaUnit::Unknown:
1336 break;
1337 }
1338
1339 break;
1340 }
1341
1342 case Qgis::AreaUnit::Acres:
1343 {
1344 switch ( toUnit )
1345 {
1346 case Qgis::AreaUnit::SquareMeters:
1347 return AC_TO_FT2 * FT2_TO_M2;
1348 case Qgis::AreaUnit::SquareKilometers:
1349 return AC_TO_FT2 * FT2_TO_M2 / KM2_TO_M2;
1350 case Qgis::AreaUnit::SquareFeet:
1351 return AC_TO_FT2;
1352 case Qgis::AreaUnit::SquareYards:
1353 return AC_TO_FT2 * FT2_TO_M2 / YD2_TO_M2;
1354 case Qgis::AreaUnit::SquareMiles:
1355 return AC_TO_FT2 * FT2_TO_M2 / MI2_TO_M2;
1356 case Qgis::AreaUnit::Hectares:
1357 return AC_TO_FT2 * FT2_TO_M2 / HA_TO_M2;
1358 case Qgis::AreaUnit::Acres:
1359 return 1.0;
1360 case Qgis::AreaUnit::SquareNauticalMiles:
1361 return AC_TO_FT2 * FT2_TO_M2 / NM2_TO_M2;
1362 case Qgis::AreaUnit::SquareDegrees:
1363 return AC_TO_FT2 * FT2_TO_M2 / DEG2_TO_M2;
1364 case Qgis::AreaUnit::SquareCentimeters:
1365 return AC_TO_FT2 * FT2_TO_M2 / CM2_TO_M2;
1366 case Qgis::AreaUnit::SquareMillimeters:
1367 return AC_TO_FT2 * FT2_TO_M2 / MM2_TO_M2;
1368 case Qgis::AreaUnit::SquareInches:
1369 return AC_TO_FT2 * FT2_TO_M2 / IN2_TO_M2;
1370 case Qgis::AreaUnit::Unknown:
1371 break;
1372 }
1373
1374 break;
1375 }
1376
1377 case Qgis::AreaUnit::SquareNauticalMiles:
1378 {
1379 switch ( toUnit )
1380 {
1381 case Qgis::AreaUnit::SquareMeters:
1382 return NM2_TO_M2;
1383 case Qgis::AreaUnit::SquareKilometers:
1384 return NM2_TO_M2 / KM2_TO_M2;
1385 case Qgis::AreaUnit::SquareFeet:
1386 return NM2_TO_M2 / FT2_TO_M2;
1387 case Qgis::AreaUnit::SquareYards:
1388 return NM2_TO_M2 / YD2_TO_M2;
1389 case Qgis::AreaUnit::SquareMiles:
1390 return NM2_TO_M2 / MI2_TO_M2;
1391 case Qgis::AreaUnit::Hectares:
1392 return NM2_TO_M2 / HA_TO_M2;
1393 case Qgis::AreaUnit::Acres:
1394 return NM2_TO_M2 / FT2_TO_M2 / AC_TO_FT2;
1395 case Qgis::AreaUnit::SquareNauticalMiles:
1396 return 1.0;
1397 case Qgis::AreaUnit::SquareDegrees:
1398 return NM2_TO_M2 / DEG2_TO_M2;
1399 case Qgis::AreaUnit::SquareCentimeters:
1400 return NM2_TO_M2 / CM2_TO_M2;
1401 case Qgis::AreaUnit::SquareMillimeters:
1402 return NM2_TO_M2 / MM2_TO_M2;
1403 case Qgis::AreaUnit::SquareInches:
1404 return NM2_TO_M2 / IN2_TO_M2;
1405 case Qgis::AreaUnit::Unknown:
1406 break;
1407 }
1408
1409 break;
1410 }
1411
1412 case Qgis::AreaUnit::SquareDegrees:
1413 {
1414 switch ( toUnit )
1415 {
1416 case Qgis::AreaUnit::SquareMeters:
1417 return DEG2_TO_M2;
1418 case Qgis::AreaUnit::SquareKilometers:
1419 return DEG2_TO_M2 / KM2_TO_M2;
1420 case Qgis::AreaUnit::SquareFeet:
1421 return DEG2_TO_M2 / FT2_TO_M2;
1422 case Qgis::AreaUnit::SquareYards:
1423 return DEG2_TO_M2 / YD2_TO_M2;
1424 case Qgis::AreaUnit::SquareMiles:
1425 return DEG2_TO_M2 / MI2_TO_M2;
1426 case Qgis::AreaUnit::Hectares:
1427 return DEG2_TO_M2 / HA_TO_M2;
1428 case Qgis::AreaUnit::Acres:
1429 return DEG2_TO_M2 / FT2_TO_M2 / AC_TO_FT2;
1430 case Qgis::AreaUnit::SquareNauticalMiles:
1431 return DEG2_TO_M2 / NM2_TO_M2;
1432 case Qgis::AreaUnit::SquareDegrees:
1433 return 1.0;
1434 case Qgis::AreaUnit::SquareCentimeters:
1435 return DEG2_TO_M2 / CM2_TO_M2;
1436 case Qgis::AreaUnit::SquareMillimeters:
1437 return DEG2_TO_M2 / MM2_TO_M2;
1438 case Qgis::AreaUnit::SquareInches:
1439 return DEG2_TO_M2 / IN2_TO_M2;
1440 case Qgis::AreaUnit::Unknown:
1441 break;
1442 }
1443
1444 break;
1445 }
1446
1447 case Qgis::AreaUnit::SquareMillimeters:
1448 {
1449 switch ( toUnit )
1450 {
1451 case Qgis::AreaUnit::SquareMeters:
1452 return MM2_TO_M2;
1453 case Qgis::AreaUnit::SquareKilometers:
1454 return MM2_TO_M2 / KM2_TO_M2;
1455 case Qgis::AreaUnit::SquareFeet:
1456 return MM2_TO_M2 / FT2_TO_M2;
1457 case Qgis::AreaUnit::SquareYards:
1458 return MM2_TO_M2 / YD2_TO_M2;
1459 case Qgis::AreaUnit::SquareMiles:
1460 return MM2_TO_M2 / MI2_TO_M2;
1461 case Qgis::AreaUnit::Hectares:
1462 return MM2_TO_M2 / HA_TO_M2;
1463 case Qgis::AreaUnit::Acres:
1464 return MM2_TO_M2 / AC_TO_FT2 / FT2_TO_M2;
1465 case Qgis::AreaUnit::SquareNauticalMiles:
1466 return MM2_TO_M2 / NM2_TO_M2;
1467 case Qgis::AreaUnit::SquareDegrees:
1468 return MM2_TO_M2 / DEG2_TO_M2;
1469 case Qgis::AreaUnit::SquareCentimeters:
1470 return MM2_TO_M2 / CM2_TO_M2;
1471 case Qgis::AreaUnit::SquareMillimeters:
1472 return 1.0;
1473 case Qgis::AreaUnit::SquareInches:
1474 return MM2_TO_M2 / IN2_TO_M2;
1475 case Qgis::AreaUnit::Unknown:
1476 break;
1477 }
1478
1479 break;
1480 }
1481 case Qgis::AreaUnit::SquareCentimeters:
1482 {
1483 switch ( toUnit )
1484 {
1485 case Qgis::AreaUnit::SquareMeters:
1486 return CM2_TO_M2;
1487 case Qgis::AreaUnit::SquareKilometers:
1488 return CM2_TO_M2 / KM2_TO_M2;
1489 case Qgis::AreaUnit::SquareFeet:
1490 return CM2_TO_M2 / FT2_TO_M2;
1491 case Qgis::AreaUnit::SquareYards:
1492 return CM2_TO_M2 / YD2_TO_M2;
1493 case Qgis::AreaUnit::SquareMiles:
1494 return CM2_TO_M2 / MI2_TO_M2;
1495 case Qgis::AreaUnit::Hectares:
1496 return CM2_TO_M2 / HA_TO_M2;
1497 case Qgis::AreaUnit::Acres:
1498 return CM2_TO_M2 / AC_TO_FT2 / FT2_TO_M2;
1499 case Qgis::AreaUnit::SquareNauticalMiles:
1500 return CM2_TO_M2 / NM2_TO_M2;
1501 case Qgis::AreaUnit::SquareDegrees:
1502 return CM2_TO_M2 / DEG2_TO_M2;
1503 case Qgis::AreaUnit::SquareCentimeters:
1504 return 1.0;
1505 case Qgis::AreaUnit::SquareMillimeters:
1506 return CM2_TO_M2 / MM2_TO_M2;
1507 case Qgis::AreaUnit::SquareInches:
1508 return CM2_TO_M2 / IN2_TO_M2;
1509 case Qgis::AreaUnit::Unknown:
1510 break;
1511 }
1512
1513 break;
1514 }
1515 case Qgis::AreaUnit::SquareInches:
1516 {
1517 switch ( toUnit )
1518 {
1519 case Qgis::AreaUnit::SquareMeters:
1520 return IN2_TO_M2;
1521 case Qgis::AreaUnit::SquareKilometers:
1522 return IN2_TO_M2 / KM2_TO_M2;
1523 case Qgis::AreaUnit::SquareFeet:
1524 return IN2_TO_M2 / FT2_TO_M2;
1525 case Qgis::AreaUnit::SquareYards:
1526 return IN2_TO_M2 / YD2_TO_M2;
1527 case Qgis::AreaUnit::SquareMiles:
1528 return IN2_TO_M2 / MI2_TO_M2;
1529 case Qgis::AreaUnit::Hectares:
1530 return IN2_TO_M2 / HA_TO_M2;
1531 case Qgis::AreaUnit::Acres:
1532 return IN2_TO_M2 / AC_TO_FT2 / FT2_TO_M2;
1533 case Qgis::AreaUnit::SquareNauticalMiles:
1534 return IN2_TO_M2 / NM2_TO_M2;
1535 case Qgis::AreaUnit::SquareDegrees:
1536 return IN2_TO_M2 / DEG2_TO_M2;
1537 case Qgis::AreaUnit::SquareCentimeters:
1538 return IN2_TO_M2 / CM2_TO_M2;
1539 case Qgis::AreaUnit::SquareMillimeters:
1540 return IN2_TO_M2 / MM2_TO_M2;
1541 case Qgis::AreaUnit::SquareInches:
1542 return 1;
1543 case Qgis::AreaUnit::Unknown:
1544 break;
1545 }
1546
1547 break;
1548 }
1549 case Qgis::AreaUnit::Unknown:
1550 break;
1551 }
1552 return 1.0;
1553}
1554
1555Qgis::AreaUnit QgsUnitTypes::distanceToAreaUnit( Qgis::DistanceUnit distanceUnit )
1556{
1557 switch ( distanceUnit )
1558 {
1559 case Qgis::DistanceUnit::Meters:
1560 case Qgis::DistanceUnit::MetersGermanLegal:
1561 return Qgis::AreaUnit::SquareMeters;
1562
1563 case Qgis::DistanceUnit::Kilometers:
1564 return Qgis::AreaUnit::SquareKilometers;
1565
1566 case Qgis::DistanceUnit::Centimeters:
1567 return Qgis::AreaUnit::SquareCentimeters;
1568
1569 case Qgis::DistanceUnit::Millimeters:
1570 return Qgis::AreaUnit::SquareMillimeters;
1571
1572 case Qgis::DistanceUnit::Feet:
1573 case Qgis::DistanceUnit::ChainsInternational:
1574 case Qgis::DistanceUnit::ChainsBritishBenoit1895A:
1575 case Qgis::DistanceUnit::ChainsBritishBenoit1895B:
1576 case Qgis::DistanceUnit::ChainsBritishSears1922Truncated:
1577 case Qgis::DistanceUnit::ChainsBritishSears1922:
1578 case Qgis::DistanceUnit::ChainsClarkes:
1579 case Qgis::DistanceUnit::ChainsUSSurvey:
1580 case Qgis::DistanceUnit::FeetBritish1865:
1581 case Qgis::DistanceUnit::FeetBritish1936:
1582 case Qgis::DistanceUnit::FeetBritishBenoit1895A:
1583 case Qgis::DistanceUnit::FeetBritishBenoit1895B:
1584 case Qgis::DistanceUnit::FeetBritishSears1922Truncated:
1585 case Qgis::DistanceUnit::FeetBritishSears1922:
1586 case Qgis::DistanceUnit::FeetClarkes:
1587 case Qgis::DistanceUnit::FeetGoldCoast:
1588 case Qgis::DistanceUnit::FeetIndian:
1589 case Qgis::DistanceUnit::FeetIndian1937:
1590 case Qgis::DistanceUnit::FeetIndian1962:
1591 case Qgis::DistanceUnit::FeetIndian1975:
1592 case Qgis::DistanceUnit::FeetUSSurvey:
1593 case Qgis::DistanceUnit::LinksInternational:
1594 case Qgis::DistanceUnit::LinksBritishBenoit1895A:
1595 case Qgis::DistanceUnit::LinksBritishBenoit1895B:
1596 case Qgis::DistanceUnit::LinksBritishSears1922Truncated:
1597 case Qgis::DistanceUnit::LinksBritishSears1922:
1598 case Qgis::DistanceUnit::LinksClarkes:
1599 case Qgis::DistanceUnit::LinksUSSurvey:
1600 case Qgis::DistanceUnit::YardsBritishBenoit1895A:
1601 case Qgis::DistanceUnit::YardsBritishBenoit1895B:
1602 case Qgis::DistanceUnit::YardsBritishSears1922Truncated:
1603 case Qgis::DistanceUnit::YardsBritishSears1922:
1604 case Qgis::DistanceUnit::YardsClarkes:
1605 case Qgis::DistanceUnit::YardsIndian:
1606 case Qgis::DistanceUnit::YardsIndian1937:
1607 case Qgis::DistanceUnit::YardsIndian1962:
1608 case Qgis::DistanceUnit::YardsIndian1975:
1609 case Qgis::DistanceUnit::Fathoms:
1610 return Qgis::AreaUnit::SquareFeet;
1611
1612 case Qgis::DistanceUnit::Yards:
1613 return Qgis::AreaUnit::SquareYards;
1614
1615 case Qgis::DistanceUnit::Miles:
1616 case Qgis::DistanceUnit::MilesUSSurvey:
1617 return Qgis::AreaUnit::SquareMiles;
1618
1619 case Qgis::DistanceUnit::Degrees:
1620 return Qgis::AreaUnit::SquareDegrees;
1621
1622 case Qgis::DistanceUnit::Unknown:
1623 return Qgis::AreaUnit::Unknown;
1624
1625 case Qgis::DistanceUnit::NauticalMiles:
1626 return Qgis::AreaUnit::SquareNauticalMiles;
1627
1628 case Qgis::DistanceUnit::Inches:
1629 return Qgis::AreaUnit::SquareInches;
1630 }
1631
1632 return Qgis::AreaUnit::Unknown;
1633}
1634
1677
1678QString QgsUnitTypes::encodeUnit( Qgis::TemporalUnit unit )
1679{
1680 switch ( unit )
1681 {
1682 case Qgis::TemporalUnit::Seconds:
1683 return u"s"_s;
1684 case Qgis::TemporalUnit::Milliseconds:
1685 return u"ms"_s;
1686 case Qgis::TemporalUnit::Minutes:
1687 return u"min"_s;
1688 case Qgis::TemporalUnit::Hours:
1689 return u"h"_s;
1690 case Qgis::TemporalUnit::Days:
1691 return u"d"_s;
1692 case Qgis::TemporalUnit::Weeks:
1693 return u"wk"_s;
1694 case Qgis::TemporalUnit::Months:
1695 return u"mon"_s;
1696 case Qgis::TemporalUnit::Years:
1697 return u"y"_s;
1698 case Qgis::TemporalUnit::Decades:
1699 return u"dec"_s;
1700 case Qgis::TemporalUnit::Centuries:
1701 return u"c"_s;
1702 case Qgis::TemporalUnit::IrregularStep:
1703 return u"xxx"_s;
1704 case Qgis::TemporalUnit::Unknown:
1705 return u"<unknown>"_s;
1706 }
1707 return QString();
1708}
1709
1710Qgis::TemporalUnit QgsUnitTypes::decodeTemporalUnit( const QString &string, bool *ok )
1711{
1712 const QString normalized = string.trimmed().toLower();
1713
1714 if ( ok )
1715 *ok = true;
1716
1717 if ( normalized == encodeUnit( Qgis::TemporalUnit::Seconds ) )
1718 return Qgis::TemporalUnit::Seconds;
1719 if ( normalized == encodeUnit( Qgis::TemporalUnit::Milliseconds ) )
1720 return Qgis::TemporalUnit::Milliseconds;
1721 if ( normalized == encodeUnit( Qgis::TemporalUnit::Minutes ) )
1722 return Qgis::TemporalUnit::Minutes;
1723 if ( normalized == encodeUnit( Qgis::TemporalUnit::Hours ) )
1724 return Qgis::TemporalUnit::Hours;
1725 if ( normalized == encodeUnit( Qgis::TemporalUnit::Days ) )
1726 return Qgis::TemporalUnit::Days;
1727 if ( normalized == encodeUnit( Qgis::TemporalUnit::Weeks ) )
1728 return Qgis::TemporalUnit::Weeks;
1729 if ( normalized == encodeUnit( Qgis::TemporalUnit::Months ) )
1730 return Qgis::TemporalUnit::Months;
1731 if ( normalized == encodeUnit( Qgis::TemporalUnit::Years ) )
1732 return Qgis::TemporalUnit::Years;
1733 if ( normalized == encodeUnit( Qgis::TemporalUnit::Decades ) )
1734 return Qgis::TemporalUnit::Decades;
1735 if ( normalized == encodeUnit( Qgis::TemporalUnit::Centuries ) )
1736 return Qgis::TemporalUnit::Centuries;
1737 if ( normalized == encodeUnit( Qgis::TemporalUnit::IrregularStep ) )
1738 return Qgis::TemporalUnit::IrregularStep;
1739 if ( normalized == encodeUnit( Qgis::TemporalUnit::Unknown ) )
1740 return Qgis::TemporalUnit::Unknown;
1741
1742 if ( ok )
1743 *ok = false;
1744
1745 return Qgis::TemporalUnit::Unknown;
1746}
1747
1748QString QgsUnitTypes::toString( Qgis::TemporalUnit unit )
1749{
1750 switch ( unit )
1751 {
1752 case Qgis::TemporalUnit::Seconds:
1753 return QObject::tr( "seconds", "temporal" );
1754 case Qgis::TemporalUnit::Milliseconds:
1755 return QObject::tr( "milliseconds", "temporal" );
1756 case Qgis::TemporalUnit::Minutes:
1757 return QObject::tr( "minutes", "temporal" );
1758 case Qgis::TemporalUnit::Hours:
1759 return QObject::tr( "hours", "temporal" );
1760 case Qgis::TemporalUnit::Days:
1761 return QObject::tr( "days", "temporal" );
1762 case Qgis::TemporalUnit::Weeks:
1763 return QObject::tr( "weeks", "temporal" );
1764 case Qgis::TemporalUnit::Months:
1765 return QObject::tr( "months", "temporal" );
1766 case Qgis::TemporalUnit::Years:
1767 return QObject::tr( "years", "temporal" );
1768 case Qgis::TemporalUnit::Decades:
1769 return QObject::tr( "decades", "temporal" );
1770 case Qgis::TemporalUnit::Centuries:
1771 return QObject::tr( "centuries", "temporal" );
1772 case Qgis::TemporalUnit::IrregularStep:
1773 return QObject::tr( "steps", "temporal" );
1774 case Qgis::TemporalUnit::Unknown:
1775 return QObject::tr( "<unknown>", "temporal" );
1776 }
1777 return QString();
1778}
1779
1780QString QgsUnitTypes::toAbbreviatedString( Qgis::TemporalUnit unit )
1781{
1782 switch ( unit )
1783 {
1784 case Qgis::TemporalUnit::Seconds:
1785 return QObject::tr( "s", "temporal" );
1786 case Qgis::TemporalUnit::Milliseconds:
1787 return QObject::tr( "ms", "temporal" );
1788 case Qgis::TemporalUnit::Minutes:
1789 return QObject::tr( "min", "temporal" );
1790 case Qgis::TemporalUnit::Hours:
1791 return QObject::tr( "h", "temporal" );
1792 case Qgis::TemporalUnit::Days:
1793 return QObject::tr( "d", "temporal" );
1794 case Qgis::TemporalUnit::Weeks:
1795 return QObject::tr( "wk", "temporal" );
1796 case Qgis::TemporalUnit::Months:
1797 return QObject::tr( "mon", "temporal" );
1798 case Qgis::TemporalUnit::Years:
1799 return QObject::tr( "y", "temporal" );
1800 case Qgis::TemporalUnit::Decades:
1801 return QObject::tr( "dec", "temporal" );
1802 case Qgis::TemporalUnit::Centuries:
1803 return QObject::tr( "cen", "temporal" );
1804 case Qgis::TemporalUnit::IrregularStep:
1805 return QObject::tr( "steps", "temporal" );
1806 case Qgis::TemporalUnit::Unknown:
1807 return QObject::tr( "<unknown>", "temporal" );
1808 }
1809 return QString();
1810}
1811
1812Qgis::TemporalUnit QgsUnitTypes::stringToTemporalUnit( const QString &string, bool *ok )
1813{
1814 const QString normalized = string.trimmed().toLower();
1815
1816 if ( ok )
1817 *ok = true;
1818
1819 if ( normalized == toString( Qgis::TemporalUnit::Seconds ) )
1820 return Qgis::TemporalUnit::Seconds;
1821 if ( normalized == toString( Qgis::TemporalUnit::Milliseconds ) )
1822 return Qgis::TemporalUnit::Milliseconds;
1823 if ( normalized == toString( Qgis::TemporalUnit::Minutes ) )
1824 return Qgis::TemporalUnit::Minutes;
1825 if ( normalized == toString( Qgis::TemporalUnit::Hours ) )
1826 return Qgis::TemporalUnit::Hours;
1827 if ( normalized == toString( Qgis::TemporalUnit::Days ) )
1828 return Qgis::TemporalUnit::Days;
1829 if ( normalized == toString( Qgis::TemporalUnit::Weeks ) )
1830 return Qgis::TemporalUnit::Weeks;
1831 if ( normalized == toString( Qgis::TemporalUnit::Months ) )
1832 return Qgis::TemporalUnit::Months;
1833 if ( normalized == toString( Qgis::TemporalUnit::Years ) )
1834 return Qgis::TemporalUnit::Years;
1835 if ( normalized == toString( Qgis::TemporalUnit::Decades ) )
1836 return Qgis::TemporalUnit::Decades;
1837 if ( normalized == toString( Qgis::TemporalUnit::Centuries ) )
1838 return Qgis::TemporalUnit::Centuries;
1839 if ( normalized == toString( Qgis::TemporalUnit::IrregularStep ) )
1840 return Qgis::TemporalUnit::IrregularStep;
1841 if ( normalized == toString( Qgis::TemporalUnit::Unknown ) )
1842 return Qgis::TemporalUnit::Unknown;
1843
1844 if ( ok )
1845 *ok = false;
1846
1847 return Qgis::TemporalUnit::Unknown;
1848}
1849
1850double QgsUnitTypes::fromUnitToUnitFactor( Qgis::TemporalUnit fromUnit, Qgis::TemporalUnit toUnit )
1851{
1852 switch ( fromUnit )
1853 {
1854 case Qgis::TemporalUnit::Seconds:
1855 {
1856 switch ( toUnit )
1857 {
1858 case Qgis::TemporalUnit::Seconds:
1859 return 1.0;
1860 case Qgis::TemporalUnit::Milliseconds:
1861 return 1000.0;
1862 case Qgis::TemporalUnit::Minutes:
1863 return 1 / 60.0;
1864 case Qgis::TemporalUnit::Hours:
1865 return 1 / 3600.0;
1866 case Qgis::TemporalUnit::Days:
1867 return 1 / 86400.0;
1868 case Qgis::TemporalUnit::Weeks:
1869 return 1 / 604800.0;
1870 case Qgis::TemporalUnit::Months:
1871 return 1 / 2592000.0;
1872 case Qgis::TemporalUnit::Years:
1873 return 1 / 31557600.0;
1874 case Qgis::TemporalUnit::Decades:
1875 return 1 / 315576000.0;
1876 case Qgis::TemporalUnit::Centuries:
1877 return 1 / 3155760000.0;
1878 case Qgis::TemporalUnit::Unknown:
1879 case Qgis::TemporalUnit::IrregularStep:
1880 return 1.0;
1881 }
1882 break;
1883 }
1884 case Qgis::TemporalUnit::Milliseconds:
1885 {
1886 switch ( toUnit )
1887 {
1888 case Qgis::TemporalUnit::Seconds:
1889 return 1 / 1000.0;
1890 case Qgis::TemporalUnit::Milliseconds:
1891 return 1.0;
1892 case Qgis::TemporalUnit::Minutes:
1893 return 1 / 60000.0;
1894 case Qgis::TemporalUnit::Hours:
1895 return 1 / 3600000.0;
1896 case Qgis::TemporalUnit::Days:
1897 return 1 / 86400000.0;
1898 case Qgis::TemporalUnit::Weeks:
1899 return 1 / 604800000.0;
1900 case Qgis::TemporalUnit::Months:
1901 return 1 / 2592000000.0;
1902 case Qgis::TemporalUnit::Years:
1903 return 1 / 31557600000.0;
1904 case Qgis::TemporalUnit::Decades:
1905 return 1 / 315576000000.0;
1906 case Qgis::TemporalUnit::Centuries:
1907 return 1 / 3155760000000.0;
1908 case Qgis::TemporalUnit::Unknown:
1909 case Qgis::TemporalUnit::IrregularStep:
1910 return 1.0;
1911 }
1912 break;
1913 }
1914 case Qgis::TemporalUnit::Minutes:
1915 {
1916 switch ( toUnit )
1917 {
1918 case Qgis::TemporalUnit::Seconds:
1919 return 60.0;
1920 case Qgis::TemporalUnit::Milliseconds:
1921 return 60000.0;
1922 case Qgis::TemporalUnit::Minutes:
1923 return 1;
1924 case Qgis::TemporalUnit::Hours:
1925 return 1 / 60.0;
1926 case Qgis::TemporalUnit::Days:
1927 return 1 / 1440.0;
1928 case Qgis::TemporalUnit::Weeks:
1929 return 1 / 10080.0;
1930 case Qgis::TemporalUnit::Months:
1931 return 1 / 43200.0;
1932 case Qgis::TemporalUnit::Years:
1933 return 1 / 525960.0;
1934 case Qgis::TemporalUnit::Decades:
1935 return 1 / 5259600.0;
1936 case Qgis::TemporalUnit::Centuries:
1937 return 1 / 52596000.0;
1938 case Qgis::TemporalUnit::Unknown:
1939 case Qgis::TemporalUnit::IrregularStep:
1940 return 1.0;
1941 }
1942 break;
1943 }
1944 case Qgis::TemporalUnit::Hours:
1945 {
1946 switch ( toUnit )
1947 {
1948 case Qgis::TemporalUnit::Seconds:
1949 return 3600.0;
1950 case Qgis::TemporalUnit::Milliseconds:
1951 return 3600000.0;
1952 case Qgis::TemporalUnit::Minutes:
1953 return 60;
1954 case Qgis::TemporalUnit::Hours:
1955 return 1;
1956 case Qgis::TemporalUnit::Days:
1957 return 1 / 24.0;
1958 case Qgis::TemporalUnit::Weeks:
1959 return 1 / 168.0;
1960 case Qgis::TemporalUnit::Months:
1961 return 1 / 720.0;
1962 case Qgis::TemporalUnit::Years:
1963 return 1 / 8766.0;
1964 case Qgis::TemporalUnit::Decades:
1965 return 1 / 87660.0;
1966 case Qgis::TemporalUnit::Centuries:
1967 return 1 / 876600.0;
1968 case Qgis::TemporalUnit::Unknown:
1969 case Qgis::TemporalUnit::IrregularStep:
1970 return 1.0;
1971 }
1972 break;
1973 }
1974 case Qgis::TemporalUnit::Days:
1975 {
1976 switch ( toUnit )
1977 {
1978 case Qgis::TemporalUnit::Seconds:
1979 return 86400.0;
1980 case Qgis::TemporalUnit::Milliseconds:
1981 return 86400000.0;
1982 case Qgis::TemporalUnit::Minutes:
1983 return 1440;
1984 case Qgis::TemporalUnit::Hours:
1985 return 24;
1986 case Qgis::TemporalUnit::Days:
1987 return 1;
1988 case Qgis::TemporalUnit::Weeks:
1989 return 1 / 7.0;
1990 case Qgis::TemporalUnit::Months:
1991 return 1 / 30.0;
1992 case Qgis::TemporalUnit::Years:
1993 return 1 / 365.25;
1994 case Qgis::TemporalUnit::Decades:
1995 return 1 / 3652.5;
1996 case Qgis::TemporalUnit::Centuries:
1997 return 1 / 36525.0;
1998 case Qgis::TemporalUnit::Unknown:
1999 case Qgis::TemporalUnit::IrregularStep:
2000 return 1.0;
2001 }
2002 break;
2003 }
2004 case Qgis::TemporalUnit::Weeks:
2005 {
2006 switch ( toUnit )
2007 {
2008 case Qgis::TemporalUnit::Seconds:
2009 return 604800.0;
2010 case Qgis::TemporalUnit::Milliseconds:
2011 return 604800000.0;
2012 case Qgis::TemporalUnit::Minutes:
2013 return 10080;
2014 case Qgis::TemporalUnit::Hours:
2015 return 168;
2016 case Qgis::TemporalUnit::Days:
2017 return 7;
2018 case Qgis::TemporalUnit::Weeks:
2019 return 1;
2020 case Qgis::TemporalUnit::Months:
2021 return 7 / 30.0;
2022 case Qgis::TemporalUnit::Years:
2023 return 7 / 365.25;
2024 case Qgis::TemporalUnit::Decades:
2025 return 7 / 3652.5;
2026 case Qgis::TemporalUnit::Centuries:
2027 return 7 / 36525.0;
2028 case Qgis::TemporalUnit::Unknown:
2029 case Qgis::TemporalUnit::IrregularStep:
2030 return 1.0;
2031 }
2032 break;
2033 }
2034 case Qgis::TemporalUnit::Months:
2035 {
2036 switch ( toUnit )
2037 {
2038 case Qgis::TemporalUnit::Seconds:
2039 return 2592000.0;
2040 case Qgis::TemporalUnit::Milliseconds:
2041 return 2592000000.0;
2042 case Qgis::TemporalUnit::Minutes:
2043 return 43200;
2044 case Qgis::TemporalUnit::Hours:
2045 return 720;
2046 case Qgis::TemporalUnit::Days:
2047 return 30;
2048 case Qgis::TemporalUnit::Weeks:
2049 return 30 / 7.0;
2050 case Qgis::TemporalUnit::Months:
2051 return 1;
2052 case Qgis::TemporalUnit::Years:
2053 return 30 / 365.25;
2054 case Qgis::TemporalUnit::Decades:
2055 return 30 / 3652.5;
2056 case Qgis::TemporalUnit::Centuries:
2057 return 30 / 36525.0;
2058 case Qgis::TemporalUnit::Unknown:
2059 case Qgis::TemporalUnit::IrregularStep:
2060 return 1.0;
2061 }
2062 break;
2063 }
2064 case Qgis::TemporalUnit::Years:
2065 {
2066 switch ( toUnit )
2067 {
2068 case Qgis::TemporalUnit::Seconds:
2069 return 31557600.0;
2070 case Qgis::TemporalUnit::Milliseconds:
2071 return 31557600000.0;
2072 case Qgis::TemporalUnit::Minutes:
2073 return 525960.0;
2074 case Qgis::TemporalUnit::Hours:
2075 return 8766.0;
2076 case Qgis::TemporalUnit::Days:
2077 return 365.25;
2078 case Qgis::TemporalUnit::Weeks:
2079 return 365.25 / 7.0;
2080 case Qgis::TemporalUnit::Months:
2081 return 365.25 / 30.0;
2082 case Qgis::TemporalUnit::Years:
2083 return 1;
2084 case Qgis::TemporalUnit::Decades:
2085 return 0.1;
2086 case Qgis::TemporalUnit::Centuries:
2087 return 0.01;
2088 case Qgis::TemporalUnit::Unknown:
2089 case Qgis::TemporalUnit::IrregularStep:
2090 return 1.0;
2091 }
2092 break;
2093 }
2094 case Qgis::TemporalUnit::Decades:
2095 {
2096 switch ( toUnit )
2097 {
2098 case Qgis::TemporalUnit::Seconds:
2099 return 315576000.0;
2100 case Qgis::TemporalUnit::Milliseconds:
2101 return 315576000000.0;
2102 case Qgis::TemporalUnit::Minutes:
2103 return 5259600.0;
2104 case Qgis::TemporalUnit::Hours:
2105 return 87660.0;
2106 case Qgis::TemporalUnit::Days:
2107 return 3652.5;
2108 case Qgis::TemporalUnit::Weeks:
2109 return 3652.5 / 7.0;
2110 case Qgis::TemporalUnit::Months:
2111 return 3652.5 / 30.0;
2112 case Qgis::TemporalUnit::Years:
2113 return 10;
2114 case Qgis::TemporalUnit::Decades:
2115 return 1;
2116 case Qgis::TemporalUnit::Centuries:
2117 return 0.1;
2118 case Qgis::TemporalUnit::Unknown:
2119 case Qgis::TemporalUnit::IrregularStep:
2120 return 1.0;
2121 }
2122 break;
2123 }
2124
2125 case Qgis::TemporalUnit::Centuries:
2126 {
2127 switch ( toUnit )
2128 {
2129 case Qgis::TemporalUnit::Seconds:
2130 return 3155760000.0;
2131 case Qgis::TemporalUnit::Milliseconds:
2132 return 3155760000000.0;
2133 case Qgis::TemporalUnit::Minutes:
2134 return 52596000.0;
2135 case Qgis::TemporalUnit::Hours:
2136 return 876600.0;
2137 case Qgis::TemporalUnit::Days:
2138 return 36525;
2139 case Qgis::TemporalUnit::Weeks:
2140 return 36525 / 7.0;
2141 case Qgis::TemporalUnit::Months:
2142 return 36525 / 30.0;
2143 case Qgis::TemporalUnit::Years:
2144 return 100;
2145 case Qgis::TemporalUnit::Decades:
2146 return 10;
2147 case Qgis::TemporalUnit::Centuries:
2148 return 1;
2149 case Qgis::TemporalUnit::Unknown:
2150 case Qgis::TemporalUnit::IrregularStep:
2151 return 1.0;
2152 }
2153 break;
2154 }
2155
2156 case Qgis::TemporalUnit::Unknown:
2157 case Qgis::TemporalUnit::IrregularStep:
2158 {
2159 return 1.0;
2160 }
2161 }
2162 return 1.0;
2163}
2164
2165Qgis::VolumeUnit QgsUnitTypes::decodeVolumeUnit( const QString &string, bool *ok )
2166{
2167 const QString normalized = string.trimmed().toLower();
2168
2169 if ( ok )
2170 *ok = true;
2171
2172 if ( normalized == encodeUnit( Qgis::VolumeUnit::CubicMeters ) )
2173 return Qgis::VolumeUnit::CubicMeters;
2174 if ( normalized == encodeUnit( Qgis::VolumeUnit::CubicFeet ) )
2175 return Qgis::VolumeUnit::CubicFeet;
2176 if ( normalized == encodeUnit( Qgis::VolumeUnit::CubicYards ) )
2177 return Qgis::VolumeUnit::CubicYards;
2178 if ( normalized == encodeUnit( Qgis::VolumeUnit::Barrel ) )
2179 return Qgis::VolumeUnit::Barrel;
2180 if ( normalized == encodeUnit( Qgis::VolumeUnit::CubicDecimeter ) )
2181 return Qgis::VolumeUnit::CubicDecimeter;
2182 if ( normalized == encodeUnit( Qgis::VolumeUnit::Liters ) )
2183 return Qgis::VolumeUnit::Liters;
2184 if ( normalized == encodeUnit( Qgis::VolumeUnit::GallonUS ) )
2185 return Qgis::VolumeUnit::GallonUS;
2186 if ( normalized == encodeUnit( Qgis::VolumeUnit::CubicInch ) )
2187 return Qgis::VolumeUnit::CubicInch;
2188 if ( normalized == encodeUnit( Qgis::VolumeUnit::CubicCentimeter ) )
2189 return Qgis::VolumeUnit::CubicCentimeter;
2190 if ( normalized == encodeUnit( Qgis::VolumeUnit::CubicDegrees ) )
2191 return Qgis::VolumeUnit::CubicDegrees;
2192 if ( normalized == encodeUnit( Qgis::VolumeUnit::Unknown ) )
2193 return Qgis::VolumeUnit::Unknown;
2194
2195 if ( ok )
2196 *ok = false;
2197
2198 return Qgis::VolumeUnit::Unknown;
2199}
2200
2201QString QgsUnitTypes::toString( Qgis::VolumeUnit unit )
2202{
2203 switch ( unit )
2204 {
2205 case Qgis::VolumeUnit::CubicMeters:
2206 return QObject::tr( "cubic meters", "volume" );
2207 case Qgis::VolumeUnit::CubicFeet:
2208 return QObject::tr( "cubic feet", "volume" );
2209 case Qgis::VolumeUnit::CubicYards:
2210 return QObject::tr( "cubic yards", "volume" );
2211 case Qgis::VolumeUnit::Barrel:
2212 return QObject::tr( "barrels", "volume" );
2213 case Qgis::VolumeUnit::CubicDecimeter:
2214 return QObject::tr( "cubic decimeters", "volume" );
2215 case Qgis::VolumeUnit::Liters:
2216 return QObject::tr( "liters", "volume" );
2217 case Qgis::VolumeUnit::GallonUS:
2218 return QObject::tr( "gallons", "volume" );
2219 case Qgis::VolumeUnit::CubicInch:
2220 return QObject::tr( "cubic inches", "volume" );
2221 case Qgis::VolumeUnit::CubicCentimeter:
2222 return QObject::tr( "cubic centimeters", "volume" );
2223 case Qgis::VolumeUnit::CubicDegrees:
2224 return QObject::tr( "cubic degrees", "volume" );
2225 case Qgis::VolumeUnit::Unknown:
2226 return QObject::tr( "<unknown>", "volume" );
2227 }
2228 return QString();
2229}
2230
2231QString QgsUnitTypes::toAbbreviatedString( Qgis::VolumeUnit unit )
2232{
2233 switch ( unit )
2234 {
2235 case Qgis::VolumeUnit::CubicMeters:
2236 return QObject::tr( "m³", "volume" );
2237 case Qgis::VolumeUnit::CubicFeet:
2238 return QObject::tr( "ft³", "volume" );
2239 case Qgis::VolumeUnit::CubicYards:
2240 return QObject::tr( "yds³", "volume" );
2241 case Qgis::VolumeUnit::Barrel:
2242 return QObject::tr( "bbl", "volume" );
2243 case Qgis::VolumeUnit::CubicDecimeter:
2244 return QObject::tr( "dm³", "volume" );
2245 case Qgis::VolumeUnit::Liters:
2246 return QObject::tr( "l", "volume" );
2247 case Qgis::VolumeUnit::GallonUS:
2248 return QObject::tr( "gal", "volume" );
2249 case Qgis::VolumeUnit::CubicInch:
2250 return QObject::tr( "in³", "volume" );
2251 case Qgis::VolumeUnit::CubicCentimeter:
2252 return QObject::tr( "cm³", "volume" );
2253 case Qgis::VolumeUnit::CubicDegrees:
2254 return QObject::tr( "deg³", "volume" );
2255 case Qgis::VolumeUnit::Unknown:
2256 return QObject::tr( "<unknown>", "volume" );
2257 }
2258 return QString();
2259
2260}
2261
2262Qgis::VolumeUnit QgsUnitTypes::stringToVolumeUnit( const QString &string, bool *ok )
2263{
2264 const QString normalized = string.trimmed().toLower();
2265
2266 if ( ok )
2267 *ok = true;
2268
2269 if ( normalized == toString( Qgis::VolumeUnit::CubicMeters ) )
2270 return Qgis::VolumeUnit::CubicMeters;
2271 if ( normalized == toString( Qgis::VolumeUnit::CubicFeet ) )
2272 return Qgis::VolumeUnit::CubicFeet;
2273 if ( normalized == toString( Qgis::VolumeUnit::CubicYards ) )
2274 return Qgis::VolumeUnit::CubicYards;
2275 if ( normalized == toString( Qgis::VolumeUnit::Barrel ) )
2276 return Qgis::VolumeUnit::Barrel;
2277 if ( normalized == toString( Qgis::VolumeUnit::CubicDecimeter ) )
2278 return Qgis::VolumeUnit::CubicDecimeter;
2279 if ( normalized == toString( Qgis::VolumeUnit::Liters ) )
2280 return Qgis::VolumeUnit::Liters;
2281 if ( normalized == toString( Qgis::VolumeUnit::GallonUS ) )
2282 return Qgis::VolumeUnit::GallonUS;
2283 if ( normalized == toString( Qgis::VolumeUnit::CubicInch ) )
2284 return Qgis::VolumeUnit::CubicInch;
2285 if ( normalized == toString( Qgis::VolumeUnit::CubicCentimeter ) )
2286 return Qgis::VolumeUnit::CubicCentimeter;
2287 if ( normalized == toString( Qgis::VolumeUnit::CubicDegrees ) )
2288 return Qgis::VolumeUnit::CubicDegrees;
2289 if ( normalized == toString( Qgis::VolumeUnit::Unknown ) )
2290 return Qgis::VolumeUnit::Unknown;
2291
2292 if ( ok )
2293 *ok = false;
2294
2295 return Qgis::VolumeUnit::Unknown;
2296}
2297
2298#define DEG2_TO_M3 1379474361572186.2
2299double QgsUnitTypes::fromUnitToUnitFactor( Qgis::VolumeUnit fromUnit, Qgis::VolumeUnit toUnit )
2300{
2301 // cloned branches are intentional here for improved readability
2302 // NOLINTBEGIN(bugprone-branch-clone)
2303 switch ( fromUnit )
2304 {
2305 case Qgis::VolumeUnit::CubicMeters:
2306 {
2307 switch ( toUnit )
2308 {
2309 case Qgis::VolumeUnit::CubicMeters:
2310 return 1.0;
2311 case Qgis::VolumeUnit::CubicFeet:
2312 return 35.314666572222;
2313 case Qgis::VolumeUnit::CubicYards:
2314 return 1.307950613786;
2315 case Qgis::VolumeUnit::Barrel:
2316 return 6.2898107438466;
2317 case Qgis::VolumeUnit::CubicDecimeter:
2318 return 1000;
2319 case Qgis::VolumeUnit::Liters:
2320 return 1000;
2321 case Qgis::VolumeUnit::GallonUS:
2322 return 264.17205124156;
2323 case Qgis::VolumeUnit::CubicInch:
2324 return 61023.7438368;
2325 case Qgis::VolumeUnit::CubicCentimeter:
2326 return 1000000;
2327 case Qgis::VolumeUnit::CubicDegrees:
2328 return 1 / DEG2_TO_M3; // basically meaningless!
2329 case Qgis::VolumeUnit::Unknown:
2330 return 1.0;
2331 }
2332 break;
2333 }
2334 case Qgis::VolumeUnit::CubicFeet:
2335 {
2336 switch ( toUnit )
2337 {
2338 case Qgis::VolumeUnit::CubicMeters:
2339 return 0.028316846592;
2340 case Qgis::VolumeUnit::CubicFeet:
2341 return 1.0;
2342 case Qgis::VolumeUnit::CubicYards:
2343 return 0.037037037;
2344 case Qgis::VolumeUnit::Barrel:
2345 return 0.178107622;
2346 case Qgis::VolumeUnit::CubicDecimeter:
2347 return 28.31685;
2348 case Qgis::VolumeUnit::Liters:
2349 return 28.31685;
2350 case Qgis::VolumeUnit::GallonUS:
2351 return 7.480519954;
2352 case Qgis::VolumeUnit::CubicInch:
2353 return 1728.000629765;
2354 case Qgis::VolumeUnit::CubicCentimeter:
2355 return 28316.85;
2356 case Qgis::VolumeUnit::CubicDegrees:
2357 return 0.028316846592 / DEG2_TO_M3; // basically meaningless!
2358 case Qgis::VolumeUnit::Unknown:
2359 return 1.0;
2360 }
2361 break;
2362 }
2363 case Qgis::VolumeUnit::CubicYards:
2364 {
2365 switch ( toUnit )
2366 {
2367 case Qgis::VolumeUnit::CubicMeters:
2368 return 0.764554900;
2369 case Qgis::VolumeUnit::CubicFeet:
2370 return 26.999998234;
2371 case Qgis::VolumeUnit::CubicYards:
2372 return 1.0;
2373 case Qgis::VolumeUnit::Barrel:
2374 return 4.808905491;
2375 case Qgis::VolumeUnit::CubicDecimeter:
2376 return 764.5549;
2377 case Qgis::VolumeUnit::Liters:
2378 return 764.5549;
2379 case Qgis::VolumeUnit::GallonUS:
2380 return 201.974025549;
2381 case Qgis::VolumeUnit::CubicInch:
2382 return 46656.013952472;
2383 case Qgis::VolumeUnit::CubicCentimeter:
2384 return 764554.9;
2385 case Qgis::VolumeUnit::CubicDegrees:
2386 return 0.764554900 / DEG2_TO_M3; // basically meaningless!
2387 case Qgis::VolumeUnit::Unknown:
2388 return 1.0;
2389 }
2390 break;
2391 }
2392 case Qgis::VolumeUnit::Barrel:
2393 {
2394 switch ( toUnit )
2395 {
2396 case Qgis::VolumeUnit::CubicMeters:
2397 return 0.158987300;
2398 case Qgis::VolumeUnit::CubicFeet:
2399 return 5.614582837;
2400 case Qgis::VolumeUnit::CubicYards:
2401 return 0.207947526;
2402 case Qgis::VolumeUnit::Barrel:
2403 return 1.0;
2404 case Qgis::VolumeUnit::CubicDecimeter:
2405 return 158.9873;
2406 case Qgis::VolumeUnit::Liters:
2407 return 158.9873;
2408 case Qgis::VolumeUnit::GallonUS:
2409 return 41.999998943;
2410 case Qgis::VolumeUnit::CubicInch:
2411 return 9702.002677722;
2412 case Qgis::VolumeUnit::CubicCentimeter:
2413 return 158987.3;
2414 case Qgis::VolumeUnit::CubicDegrees:
2415 return 0.158987300 / DEG2_TO_M3; // basically meaningless!
2416 case Qgis::VolumeUnit::Unknown:
2417 return 1.0;
2418 }
2419 break;
2420 }
2421 case Qgis::VolumeUnit::CubicDecimeter:
2422 case Qgis::VolumeUnit::Liters:
2423 {
2424 switch ( toUnit )
2425 {
2426 case Qgis::VolumeUnit::CubicMeters:
2427 return 0.001;
2428 case Qgis::VolumeUnit::CubicFeet:
2429 return 0.035314662;
2430 case Qgis::VolumeUnit::CubicYards:
2431 return 0.001307951;
2432 case Qgis::VolumeUnit::Barrel:
2433 return 0.006289811;
2434 case Qgis::VolumeUnit::CubicDecimeter:
2435 case Qgis::VolumeUnit::Liters:
2436 return 1.0;
2437 case Qgis::VolumeUnit::GallonUS:
2438 return 0.264172037;
2439 case Qgis::VolumeUnit::CubicInch:
2440 return 61.023758990;
2441 case Qgis::VolumeUnit::CubicCentimeter:
2442 return 1000;
2443 case Qgis::VolumeUnit::CubicDegrees:
2444 return 0.001 / DEG2_TO_M3; // basically meaningless!
2445 case Qgis::VolumeUnit::Unknown:
2446 return 1.0;
2447 }
2448 break;
2449 }
2450 case Qgis::VolumeUnit::GallonUS:
2451 {
2452 switch ( toUnit )
2453 {
2454 case Qgis::VolumeUnit::CubicMeters:
2455 return 0.003785412;
2456 case Qgis::VolumeUnit::CubicFeet:
2457 return 0.133680547;
2458 case Qgis::VolumeUnit::CubicYards:
2459 return 0.004951132;
2460 case Qgis::VolumeUnit::Barrel:
2461 return 0.023809524;
2462 case Qgis::VolumeUnit::CubicDecimeter:
2463 case Qgis::VolumeUnit::Liters:
2464 return 3.785412000;
2465 case Qgis::VolumeUnit::GallonUS:
2466 return 1.0;
2467 case Qgis::VolumeUnit::CubicInch:
2468 return 231.000069567;
2469 case Qgis::VolumeUnit::CubicCentimeter:
2470 return 3785.412;
2471 case Qgis::VolumeUnit::CubicDegrees:
2472 return 0.003785412 / DEG2_TO_M3; // basically meaningless!
2473 case Qgis::VolumeUnit::Unknown:
2474 return 1.0;
2475 }
2476 break;
2477 }
2478 case Qgis::VolumeUnit::CubicInch:
2479 {
2480 switch ( toUnit )
2481 {
2482 case Qgis::VolumeUnit::CubicMeters:
2483 return 0.000016387;
2484 case Qgis::VolumeUnit::CubicFeet:
2485 return 0.000578703;
2486 case Qgis::VolumeUnit::CubicYards:
2487 return 0.000021433;
2488 case Qgis::VolumeUnit::Barrel:
2489 return 0.000103072;
2490 case Qgis::VolumeUnit::CubicDecimeter:
2491 case Qgis::VolumeUnit::Liters:
2492 return 0.016387060;
2493 case Qgis::VolumeUnit::GallonUS:
2494 return 0.004329003;
2495 case Qgis::VolumeUnit::CubicInch:
2496 return 1.0;
2497 case Qgis::VolumeUnit::CubicCentimeter:
2498 return 16.387060000;
2499 case Qgis::VolumeUnit::CubicDegrees:
2500 return 0.000016387 / DEG2_TO_M3; // basically meaningless!
2501 case Qgis::VolumeUnit::Unknown:
2502 return 1.0;
2503 }
2504 break;
2505 }
2506 case Qgis::VolumeUnit::CubicCentimeter:
2507 {
2508 switch ( toUnit )
2509 {
2510 case Qgis::VolumeUnit::CubicMeters:
2511 return 0.000001;
2512 case Qgis::VolumeUnit::CubicFeet:
2513 return 0.000035315;
2514 case Qgis::VolumeUnit::CubicYards:
2515 return 0.000001308;
2516 case Qgis::VolumeUnit::Barrel:
2517 return 0.000006290;
2518 case Qgis::VolumeUnit::CubicDecimeter:
2519 case Qgis::VolumeUnit::Liters:
2520 return 0.001;
2521 case Qgis::VolumeUnit::GallonUS:
2522 return 0.000264172 ;
2523 case Qgis::VolumeUnit::CubicInch:
2524 return 0.061023759;
2525 case Qgis::VolumeUnit::CubicCentimeter:
2526 return 1.0;
2527 case Qgis::VolumeUnit::CubicDegrees:
2528 return 0.000001 / DEG2_TO_M3; // basically meaningless!
2529 case Qgis::VolumeUnit::Unknown:
2530 return 1.0;
2531 }
2532 break;
2533 }
2534 case Qgis::VolumeUnit::CubicDegrees:
2535 if ( toUnit == Qgis::VolumeUnit::Unknown || toUnit == Qgis::VolumeUnit::CubicDegrees )
2536 return 1.0;
2537 else
2538 return fromUnitToUnitFactor( toUnit, Qgis::VolumeUnit::CubicMeters ) * DEG2_TO_M3;
2539
2540 case Qgis::VolumeUnit::Unknown:
2541 {
2542 return 1.0;
2543 }
2544 }
2545 // NOLINTEND(bugprone-branch-clone)
2546 return 1.0;
2547}
2548
2549Qgis::VolumeUnit QgsUnitTypes::distanceToVolumeUnit( Qgis::DistanceUnit distanceUnit )
2550{
2551 // cloned branches are intentional here for improved readability
2552 // NOLINTBEGIN(bugprone-branch-clone)
2553 switch ( distanceUnit )
2554 {
2555 case Qgis::DistanceUnit::Meters:
2556 case Qgis::DistanceUnit::MetersGermanLegal:
2557 return Qgis::VolumeUnit::CubicMeters;
2558
2559 case Qgis::DistanceUnit::Kilometers:
2560 return Qgis::VolumeUnit::CubicMeters;
2561
2562 case Qgis::DistanceUnit::Centimeters:
2563 return Qgis::VolumeUnit::CubicCentimeter;
2564
2565 case Qgis::DistanceUnit::Millimeters:
2566 return Qgis::VolumeUnit::CubicCentimeter;
2567
2568 case Qgis::DistanceUnit::Feet:
2569 case Qgis::DistanceUnit::FeetBritish1865:
2570 case Qgis::DistanceUnit::FeetBritish1936:
2571 case Qgis::DistanceUnit::FeetBritishBenoit1895A:
2572 case Qgis::DistanceUnit::FeetBritishBenoit1895B:
2573 case Qgis::DistanceUnit::FeetBritishSears1922Truncated:
2574 case Qgis::DistanceUnit::FeetBritishSears1922:
2575 case Qgis::DistanceUnit::FeetClarkes:
2576 case Qgis::DistanceUnit::FeetGoldCoast:
2577 case Qgis::DistanceUnit::FeetIndian:
2578 case Qgis::DistanceUnit::FeetIndian1937:
2579 case Qgis::DistanceUnit::FeetIndian1962:
2580 case Qgis::DistanceUnit::FeetIndian1975:
2581 case Qgis::DistanceUnit::FeetUSSurvey:
2582 return Qgis::VolumeUnit::CubicFeet;
2583
2584 case Qgis::DistanceUnit::Yards:
2585 case Qgis::DistanceUnit::YardsBritishBenoit1895A:
2586 case Qgis::DistanceUnit::YardsBritishBenoit1895B:
2587 case Qgis::DistanceUnit::YardsBritishSears1922Truncated:
2588 case Qgis::DistanceUnit::YardsBritishSears1922:
2589 case Qgis::DistanceUnit::YardsClarkes:
2590 case Qgis::DistanceUnit::YardsIndian:
2591 case Qgis::DistanceUnit::YardsIndian1937:
2592 case Qgis::DistanceUnit::YardsIndian1962:
2593 case Qgis::DistanceUnit::YardsIndian1975:
2594 return Qgis::VolumeUnit::CubicYards;
2595
2596 case Qgis::DistanceUnit::Miles:
2597 case Qgis::DistanceUnit::MilesUSSurvey:
2598 case Qgis::DistanceUnit::ChainsInternational:
2599 case Qgis::DistanceUnit::ChainsBritishBenoit1895A:
2600 case Qgis::DistanceUnit::ChainsBritishBenoit1895B:
2601 case Qgis::DistanceUnit::ChainsBritishSears1922Truncated:
2602 case Qgis::DistanceUnit::ChainsBritishSears1922:
2603 case Qgis::DistanceUnit::ChainsClarkes:
2604 case Qgis::DistanceUnit::ChainsUSSurvey:
2605 case Qgis::DistanceUnit::LinksInternational:
2606 case Qgis::DistanceUnit::LinksBritishBenoit1895A:
2607 case Qgis::DistanceUnit::LinksBritishBenoit1895B:
2608 case Qgis::DistanceUnit::LinksBritishSears1922Truncated:
2609 case Qgis::DistanceUnit::LinksBritishSears1922:
2610 case Qgis::DistanceUnit::LinksClarkes:
2611 case Qgis::DistanceUnit::LinksUSSurvey:
2612 case Qgis::DistanceUnit::Fathoms:
2613 return Qgis::VolumeUnit::CubicFeet;
2614
2615 case Qgis::DistanceUnit::Degrees:
2616 return Qgis::VolumeUnit::CubicDegrees;
2617
2618 case Qgis::DistanceUnit::Unknown:
2619 return Qgis::VolumeUnit::Unknown;
2620
2621 case Qgis::DistanceUnit::NauticalMiles:
2622 return Qgis::VolumeUnit::CubicFeet;
2623
2624 case Qgis::DistanceUnit::Inches:
2625 return Qgis::VolumeUnit::CubicInch;
2626 }
2627 // NOLINTEND(bugprone-branch-clone)
2628
2629 return Qgis::VolumeUnit::Unknown;
2630}
2631
2661
2683
2684QString QgsUnitTypes::encodeUnit( Qgis::VolumeUnit unit )
2685{
2686 switch ( unit )
2687 {
2688 case Qgis::VolumeUnit::CubicMeters:
2689 return u"m3"_s;
2690 case Qgis::VolumeUnit::CubicFeet:
2691 return u"ft3"_s;
2692 case Qgis::VolumeUnit::CubicYards:
2693 return u"yd3"_s;
2694 case Qgis::VolumeUnit::Barrel:
2695 return u"bbl"_s;
2696 case Qgis::VolumeUnit::CubicDecimeter:
2697 return u"dm3"_s;
2698 case Qgis::VolumeUnit::Liters:
2699 return u"l"_s;
2700 case Qgis::VolumeUnit::GallonUS:
2701 return u"gal"_s;
2702 case Qgis::VolumeUnit::CubicInch:
2703 return u"in3"_s;
2704 case Qgis::VolumeUnit::CubicCentimeter:
2705 return u"cm3"_s;
2706 case Qgis::VolumeUnit::CubicDegrees:
2707 return u"deg3"_s;
2708 case Qgis::VolumeUnit::Unknown:
2709 return u"<unknown>"_s;
2710 }
2711 return QString();
2712}
2713
2714QString QgsUnitTypes::encodeUnit( Qgis::AngleUnit unit )
2715{
2716 switch ( unit )
2717 {
2718 case Qgis::AngleUnit::Degrees:
2719 return u"degrees"_s;
2720 case Qgis::AngleUnit::Radians:
2721 return u"radians"_s;
2722 case Qgis::AngleUnit::Gon:
2723 return u"gon"_s;
2724 case Qgis::AngleUnit::MinutesOfArc:
2725 return u"moa"_s;
2726 case Qgis::AngleUnit::SecondsOfArc:
2727 return u"soa"_s;
2728 case Qgis::AngleUnit::Turn:
2729 return u"tr"_s;
2730 case Qgis::AngleUnit::MilliradiansSI:
2731 return u"milliradians"_s;
2732 case Qgis::AngleUnit::MilNATO:
2733 return u"mil"_s;
2734 case Qgis::AngleUnit::Unknown:
2735 return u"<unknown>"_s;
2736 }
2737 return QString();
2738}
2739
2740Qgis::AngleUnit QgsUnitTypes::decodeAngleUnit( const QString &string, bool *ok )
2741{
2742 const QString normalized = string.trimmed().toLower();
2743
2744 if ( ok )
2745 *ok = true;
2746
2747 if ( normalized == encodeUnit( Qgis::AngleUnit::Degrees ) )
2748 return Qgis::AngleUnit::Degrees;
2749 if ( normalized == encodeUnit( Qgis::AngleUnit::Radians ) )
2750 return Qgis::AngleUnit::Radians;
2751 if ( normalized == encodeUnit( Qgis::AngleUnit::Gon ) )
2752 return Qgis::AngleUnit::Gon;
2753 if ( normalized == encodeUnit( Qgis::AngleUnit::MinutesOfArc ) )
2754 return Qgis::AngleUnit::MinutesOfArc;
2755 if ( normalized == encodeUnit( Qgis::AngleUnit::SecondsOfArc ) )
2756 return Qgis::AngleUnit::SecondsOfArc;
2757 if ( normalized == encodeUnit( Qgis::AngleUnit::Turn ) )
2758 return Qgis::AngleUnit::Turn;
2759 if ( normalized == encodeUnit( Qgis::AngleUnit::MilliradiansSI ) )
2760 return Qgis::AngleUnit::MilliradiansSI;
2761 if ( normalized == encodeUnit( Qgis::AngleUnit::MilNATO ) )
2762 return Qgis::AngleUnit::MilNATO;
2763 if ( normalized == encodeUnit( Qgis::AngleUnit::Unknown ) )
2764 return Qgis::AngleUnit::Unknown;
2765 if ( ok )
2766 *ok = false;
2767
2768 return Qgis::AngleUnit::Unknown;
2769}
2770
2771QString QgsUnitTypes::toString( Qgis::AngleUnit unit )
2772{
2773 switch ( unit )
2774 {
2775 case Qgis::AngleUnit::Degrees:
2776 return QObject::tr( "degrees", "angle" );
2777 case Qgis::AngleUnit::Radians:
2778 return QObject::tr( "radians", "angle" );
2779 case Qgis::AngleUnit::Gon:
2780 return QObject::tr( "gon", "angle" );
2781 case Qgis::AngleUnit::MinutesOfArc:
2782 return QObject::tr( "minutes of arc", "angle" );
2783 case Qgis::AngleUnit::SecondsOfArc:
2784 return QObject::tr( "seconds of arc", "angle" );
2785 case Qgis::AngleUnit::Turn:
2786 return QObject::tr( "turns", "angle" );
2787 case Qgis::AngleUnit::MilliradiansSI:
2788 return QObject::tr( "milliradians", "angle" );
2789 case Qgis::AngleUnit::MilNATO:
2790 return QObject::tr( "mil", "angle" );
2791 case Qgis::AngleUnit::Unknown:
2792 return QObject::tr( "<unknown>", "angle" );
2793 }
2794 return QString();
2795}
2796
2797double QgsUnitTypes::fromUnitToUnitFactor( Qgis::AngleUnit fromUnit, Qgis::AngleUnit toUnit )
2798{
2799 // Calculate the conversion factor between the specified units
2800 switch ( fromUnit )
2801 {
2802 case Qgis::AngleUnit::Degrees:
2803 {
2804 switch ( toUnit )
2805 {
2806 case Qgis::AngleUnit::Degrees:
2807 return 1.0;
2808 case Qgis::AngleUnit::Radians:
2809 return M_PI / 180.0;
2810 case Qgis::AngleUnit::Gon:
2811 return 400.0 / 360.0;
2812 case Qgis::AngleUnit::MinutesOfArc:
2813 return 60;
2814 case Qgis::AngleUnit::SecondsOfArc:
2815 return 3600;
2816 case Qgis::AngleUnit::Turn:
2817 return 1.0 / 360.0;
2818 case Qgis::AngleUnit::MilliradiansSI:
2819 return M_PI / 180.0 * 1000;
2820 case Qgis::AngleUnit::MilNATO:
2821 return 3200.0 / 180;
2822 case Qgis::AngleUnit::Unknown:
2823 break;
2824 }
2825 break;
2826 }
2827 case Qgis::AngleUnit::Radians:
2828 {
2829 switch ( toUnit )
2830 {
2831 case Qgis::AngleUnit::Degrees:
2832 return 180.0 / M_PI;
2833 case Qgis::AngleUnit::Radians:
2834 return 1.0;
2835 case Qgis::AngleUnit::Gon:
2836 return 200.0 / M_PI;
2837 case Qgis::AngleUnit::MinutesOfArc:
2838 return 60 * 180.0 / M_PI;
2839 case Qgis::AngleUnit::SecondsOfArc:
2840 return 3600 * 180.0 / M_PI;
2841 case Qgis::AngleUnit::Turn:
2842 return 0.5 / M_PI;
2843 case Qgis::AngleUnit::MilliradiansSI:
2844 return 1000;
2845 case Qgis::AngleUnit::MilNATO:
2846 return 3200.0 / M_PI;
2847 case Qgis::AngleUnit::Unknown:
2848 break;
2849 }
2850 break;
2851 }
2852 case Qgis::AngleUnit::Gon:
2853 {
2854 switch ( toUnit )
2855 {
2856 case Qgis::AngleUnit::Degrees:
2857 return 360.0 / 400.0;
2858 case Qgis::AngleUnit::Radians:
2859 return M_PI / 200.0;
2860 case Qgis::AngleUnit::Gon:
2861 return 1.0;
2862 case Qgis::AngleUnit::MinutesOfArc:
2863 return 60 * 360.0 / 400.0;
2864 case Qgis::AngleUnit::SecondsOfArc:
2865 return 3600 * 360.0 / 400.0;
2866 case Qgis::AngleUnit::Turn:
2867 return 1.0 / 400.0;
2868 case Qgis::AngleUnit::MilliradiansSI:
2869 return M_PI / 200.0 * 1000;
2870 case Qgis::AngleUnit::MilNATO:
2871 return 3200.0 / 200.0;
2872 case Qgis::AngleUnit::Unknown:
2873 break;
2874 }
2875 break;
2876 }
2877 case Qgis::AngleUnit::MinutesOfArc:
2878 {
2879 switch ( toUnit )
2880 {
2881 case Qgis::AngleUnit::Degrees:
2882 return 1 / 60.0;
2883 case Qgis::AngleUnit::Radians:
2884 return M_PI / 180.0 / 60.0;
2885 case Qgis::AngleUnit::Gon:
2886 return 400.0 / 360.0 / 60.0;
2887 case Qgis::AngleUnit::MinutesOfArc:
2888 return 1.0;
2889 case Qgis::AngleUnit::SecondsOfArc:
2890 return 60.0;
2891 case Qgis::AngleUnit::Turn:
2892 return 1.0 / 360.0 / 60.0;
2893 case Qgis::AngleUnit::MilliradiansSI:
2894 return M_PI / 180.0 / 60.0 * 1000;
2895 case Qgis::AngleUnit::MilNATO:
2896 return 3200.0 / 180.0 / 60.0;
2897 case Qgis::AngleUnit::Unknown:
2898 break;
2899 }
2900 break;
2901 }
2902 case Qgis::AngleUnit::SecondsOfArc:
2903 {
2904 switch ( toUnit )
2905 {
2906 case Qgis::AngleUnit::Degrees:
2907 return 1 / 3600.0;
2908 case Qgis::AngleUnit::Radians:
2909 return M_PI / 180.0 / 3600.0;
2910 case Qgis::AngleUnit::Gon:
2911 return 400.0 / 360.0 / 3600.0;
2912 case Qgis::AngleUnit::MinutesOfArc:
2913 return 1.0 / 60.0;
2914 case Qgis::AngleUnit::SecondsOfArc:
2915 return 1.0;
2916 case Qgis::AngleUnit::Turn:
2917 return 1.0 / 360.0 / 3600.0;
2918 case Qgis::AngleUnit::MilliradiansSI:
2919 return M_PI / 180.0 / 3600.0 * 1000;
2920 case Qgis::AngleUnit::MilNATO:
2921 return 3200.0 / 180.0 / 3600.0;
2922 case Qgis::AngleUnit::Unknown:
2923 break;
2924 }
2925 break;
2926 }
2927 case Qgis::AngleUnit::Turn:
2928 {
2929 switch ( toUnit )
2930 {
2931 case Qgis::AngleUnit::Degrees:
2932 return 360.0;
2933 case Qgis::AngleUnit::Radians:
2934 return 2 * M_PI;
2935 case Qgis::AngleUnit::Gon:
2936 return 400.0;
2937 case Qgis::AngleUnit::MinutesOfArc:
2938 return 360.0 * 60.0;
2939 case Qgis::AngleUnit::SecondsOfArc:
2940 return 360.0 * 3600.0;
2941 case Qgis::AngleUnit::Turn:
2942 return 1.0;
2943 case Qgis::AngleUnit::MilliradiansSI:
2944 return 2 * M_PI * 1000;
2945 case Qgis::AngleUnit::MilNATO:
2946 return 2 * 3200;
2947 case Qgis::AngleUnit::Unknown:
2948 break;
2949 }
2950 break;
2951 }
2952 case Qgis::AngleUnit::MilliradiansSI:
2953 {
2954 switch ( toUnit )
2955 {
2956 case Qgis::AngleUnit::Degrees:
2957 return 180.0 / M_PI / 1000;
2958 case Qgis::AngleUnit::Radians:
2959 return 0.001;
2960 case Qgis::AngleUnit::Gon:
2961 return 200.0 / M_PI / 1000;
2962 case Qgis::AngleUnit::MinutesOfArc:
2963 return 180.0 * 60.0 / M_PI / 1000;
2964 case Qgis::AngleUnit::SecondsOfArc:
2965 return 180.0 * 3600.0 / M_PI / 1000;
2966 case Qgis::AngleUnit::Turn:
2967 return M_PI / 2 / 1000;
2968 case Qgis::AngleUnit::MilliradiansSI:
2969 return 1.0;
2970 case Qgis::AngleUnit::MilNATO:
2971 return 3200.0 / 1000.0 / M_PI;
2972 case Qgis::AngleUnit::Unknown:
2973 break;
2974 }
2975 break;
2976 }
2977
2978 case Qgis::AngleUnit::MilNATO:
2979 {
2980 switch ( toUnit )
2981 {
2982 case Qgis::AngleUnit::Degrees:
2983 return 180.0 / 3200;
2984 case Qgis::AngleUnit::Radians:
2985 return M_PI / 3200;
2986 case Qgis::AngleUnit::Gon:
2987 return 200.0 / 3200;
2988 case Qgis::AngleUnit::MinutesOfArc:
2989 return 60 * 180.0 / 3200;
2990 case Qgis::AngleUnit::SecondsOfArc:
2991 return 3600.0 * 180 / 3200;
2992 case Qgis::AngleUnit::Turn:
2993 return 1.0 / ( 2 * 32000 );
2994 case Qgis::AngleUnit::MilliradiansSI:
2995 return 1000.0 * M_PI / 3200.0;
2996 case Qgis::AngleUnit::MilNATO:
2997 return 1.0;
2998 case Qgis::AngleUnit::Unknown:
2999 break;
3000 }
3001 break;
3002 }
3003
3004 case Qgis::AngleUnit::Unknown:
3005 break;
3006 }
3007 return 1.0;
3008}
3009
3010QString QgsUnitTypes::formatAngle( double angle, int decimals, Qgis::AngleUnit unit )
3011{
3012 QString unitLabel;
3013 int decimalPlaces = 2;
3014
3015 switch ( unit )
3016 {
3017 case Qgis::AngleUnit::Degrees:
3018 unitLabel = QObject::tr( "°", "angle" );
3019 decimalPlaces = 0;
3020 break;
3021 case Qgis::AngleUnit::Radians:
3022 unitLabel = QObject::tr( " rad", "angle" );
3023 decimalPlaces = 2;
3024 break;
3025 case Qgis::AngleUnit::Gon:
3026 unitLabel = QObject::tr( " gon", "angle" );
3027 decimalPlaces = 0;
3028 break;
3029 case Qgis::AngleUnit::MinutesOfArc:
3030 unitLabel = QObject::tr( "′", "angle minutes" );
3031 decimalPlaces = 0;
3032 break;
3033 case Qgis::AngleUnit::SecondsOfArc:
3034 unitLabel = QObject::tr( "″", "angle seconds" );
3035 decimalPlaces = 0;
3036 break;
3037 case Qgis::AngleUnit::Turn:
3038 unitLabel = QObject::tr( " tr", "angle turn" );
3039 decimalPlaces = 3;
3040 break;
3041 case Qgis::AngleUnit::MilliradiansSI:
3042 unitLabel = QObject::tr( " millirad", "angular mil SI" );
3043 decimalPlaces = 0;
3044 break;
3045 case Qgis::AngleUnit::MilNATO:
3046 unitLabel = QObject::tr( " mil", "angular mil NATO" );
3047 decimalPlaces = 0;
3048 break;
3049 case Qgis::AngleUnit::Unknown:
3050 break;
3051 }
3052
3053 if ( decimals >= 0 )
3054 decimalPlaces = decimals;
3055
3056 return u"%L1%2"_s.arg( angle, 0, 'f', decimalPlaces ).arg( unitLabel );
3057}
3058
3059QgsUnitTypes::DistanceValue QgsUnitTypes::scaledDistance( double distance, Qgis::DistanceUnit unit, int decimals, bool keepBaseUnit )
3060{
3061 DistanceValue result;
3062
3063 // cloned branches are intentional here for improved readability
3064 // NOLINTBEGIN(bugprone-branch-clone)
3065 switch ( unit )
3066 {
3067 case Qgis::DistanceUnit::Meters:
3068 if ( keepBaseUnit )
3069 {
3070 result.value = qgsRound( distance, decimals );
3071 result.unit = Qgis::DistanceUnit::Meters;
3072 }
3073 else if ( std::fabs( distance ) > 1000.0 )
3074 {
3075 result.value = qgsRound( distance / 1000, decimals );
3076 result.unit = Qgis::DistanceUnit::Kilometers;
3077 }
3078 else if ( std::fabs( distance ) < 0.01 )
3079 {
3080 result.value = qgsRound( distance * 1000, decimals );
3081 result.unit = Qgis::DistanceUnit::Millimeters;
3082 }
3083 else if ( std::fabs( distance ) < 0.1 )
3084 {
3085
3086 result.value = qgsRound( distance * 100, decimals );
3087 result.unit = Qgis::DistanceUnit::Centimeters;
3088 }
3089 else
3090 {
3091 result.value = qgsRound( distance, decimals );
3092 result.unit = Qgis::DistanceUnit::Meters;
3093 }
3094 break;
3095
3096 case Qgis::DistanceUnit::Kilometers:
3097 if ( keepBaseUnit || std::fabs( distance ) >= 1.0 )
3098 {
3099 result.value = qgsRound( distance, decimals );
3100 result.unit = Qgis::DistanceUnit::Kilometers;
3101 }
3102 else
3103 {
3104 result.value = qgsRound( distance * 1000, decimals );
3105 result.unit = Qgis::DistanceUnit::Meters;
3106 }
3107 break;
3108
3109 case Qgis::DistanceUnit::Feet:
3110 if ( std::fabs( distance ) <= 5280.0 || keepBaseUnit )
3111 {
3112 result.value = qgsRound( distance, decimals );
3113 result.unit = Qgis::DistanceUnit::Feet;
3114 }
3115 else
3116 {
3117 result.value = qgsRound( distance / 5280.0, decimals );
3118 result.unit = Qgis::DistanceUnit::Miles;
3119 }
3120 break;
3121
3122 case Qgis::DistanceUnit::Yards:
3123 if ( std::fabs( distance ) <= 1760.0 || keepBaseUnit )
3124 {
3125 result.value = qgsRound( distance, decimals );
3126 result.unit = Qgis::DistanceUnit::Yards;
3127 }
3128 else
3129 {
3130 result.value = qgsRound( distance / 1760.0, decimals );
3131 result.unit = Qgis::DistanceUnit::Miles;
3132 }
3133 break;
3134
3135 case Qgis::DistanceUnit::Miles:
3136 if ( std::fabs( distance ) >= 1.0 || keepBaseUnit )
3137 {
3138 result.value = qgsRound( distance, decimals );
3139 result.unit = Qgis::DistanceUnit::Miles;
3140 }
3141 else
3142 {
3143 result.value = qgsRound( distance * 5280.0, decimals );
3144 result.unit = Qgis::DistanceUnit::Feet;
3145 }
3146 break;
3147
3148 case Qgis::DistanceUnit::NauticalMiles:
3149 result.value = qgsRound( distance, decimals );
3150 result.unit = Qgis::DistanceUnit::NauticalMiles;
3151 break;
3152
3153 case Qgis::DistanceUnit::Degrees:
3154 result.value = qgsRound( distance, decimals );
3155 result.unit = Qgis::DistanceUnit::Degrees;
3156 break;
3157
3158 case Qgis::DistanceUnit::Unknown:
3159 result.value = qgsRound( distance, decimals );
3160 result.unit = Qgis::DistanceUnit::Unknown;
3161 break;
3162
3163 default:
3164 result.value = qgsRound( distance, decimals );
3165 result.unit = unit;
3166 break;
3167 }
3168 // NOLINTEND(bugprone-branch-clone)
3169
3170 return result;
3171}
3172
3173QgsUnitTypes::AreaValue QgsUnitTypes::scaledArea( double area, Qgis::AreaUnit unit, int decimals, bool keepBaseUnit )
3174{
3175 QgsUnitTypes::AreaValue result;
3176 result.value = -1.0;
3177 result.unit = Qgis::AreaUnit::Unknown;
3178
3179 // If we are not forced to keep the base units, switch to meter calculation
3180 if ( unit == Qgis::AreaUnit::SquareMillimeters )
3181 {
3182 if ( keepBaseUnit )
3183 {
3184 result.value = qgsRound( area, decimals );
3185 result.unit = Qgis::AreaUnit::SquareMillimeters;
3186 }
3187 else
3188 {
3189 area /= 1000000.0;
3190 unit = Qgis::AreaUnit::SquareMeters;
3191 }
3192 }
3193 else if ( unit == Qgis::AreaUnit::SquareCentimeters )
3194 {
3195 if ( keepBaseUnit )
3196 {
3197 result.value = qgsRound( area, decimals );
3198 result.unit = Qgis::AreaUnit::SquareCentimeters;
3199 }
3200 else
3201 {
3202 area /= 10000.0;
3203 unit = Qgis::AreaUnit::SquareMeters;
3204 }
3205 }
3206
3207 // cloned branches are intentional here for improved readability
3208 // NOLINTBEGIN(bugprone-branch-clone)
3209 switch ( unit )
3210 {
3211 case Qgis::AreaUnit::SquareCentimeters:
3212 // handled in the if above
3213 break;
3214 case Qgis::AreaUnit::SquareMillimeters:
3215 // handled in the if above
3216 break;
3217 case Qgis::AreaUnit::SquareMeters:
3218 {
3219 if ( keepBaseUnit )
3220 {
3221 result.value = qgsRound( area, decimals );
3222 result.unit = Qgis::AreaUnit::SquareMeters;
3223 }
3224 else if ( std::fabs( area ) > QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareKilometers, Qgis::AreaUnit::SquareMeters ) )
3225 {
3226 result.value = qgsRound( area * QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareMeters, Qgis::AreaUnit::SquareKilometers ), decimals );
3227 result.unit = Qgis::AreaUnit::SquareKilometers;
3228 }
3229 else if ( std::fabs( area ) > QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::Hectares, Qgis::AreaUnit::SquareMeters ) )
3230 {
3231 result.value = qgsRound( area * QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareMeters, Qgis::AreaUnit::Hectares ), decimals );
3232 result.unit = Qgis::AreaUnit::Hectares;
3233 }
3234 else
3235 {
3236 result.value = qgsRound( area, decimals );
3237 result.unit = Qgis::AreaUnit::SquareMeters;
3238 }
3239 break;
3240 }
3241
3242 case Qgis::AreaUnit::SquareKilometers:
3243 {
3244 result.value = qgsRound( area, decimals );
3245 result.unit = Qgis::AreaUnit::SquareKilometers;
3246 break;
3247 }
3248
3249 case Qgis::AreaUnit::SquareInches:
3250 {
3251 result.value = qgsRound( area, decimals );
3252 result.unit = Qgis::AreaUnit::SquareInches;
3253 break;
3254 }
3255
3256 case Qgis::AreaUnit::SquareFeet:
3257 {
3258 if ( keepBaseUnit )
3259 {
3260 result.value = qgsRound( area, decimals );
3261 result.unit = Qgis::AreaUnit::SquareFeet;
3262 }
3263 else if ( std::fabs( area ) > QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareMiles, Qgis::AreaUnit::SquareFeet ) )
3264 {
3265 result.value = qgsRound( area * QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareFeet, Qgis::AreaUnit::SquareMiles ), decimals );
3266 result.unit = Qgis::AreaUnit::SquareMiles;
3267 }
3268 else
3269 {
3270 result.value = qgsRound( area, decimals );
3271 result.unit = Qgis::AreaUnit::SquareFeet;
3272 }
3273 break;
3274 }
3275
3276 case Qgis::AreaUnit::SquareYards:
3277 {
3278 if ( keepBaseUnit )
3279 {
3280 result.value = qgsRound( area, decimals );
3281 result.unit = Qgis::AreaUnit::SquareYards;
3282 }
3283 else if ( std::fabs( area ) > QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareMiles, Qgis::AreaUnit::SquareYards ) )
3284 {
3285 result.value = qgsRound( area * QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareYards, Qgis::AreaUnit::SquareMiles ), decimals );
3286 result.unit = Qgis::AreaUnit::SquareMiles;
3287 }
3288 else
3289 {
3290 result.value = qgsRound( area, decimals );
3291 result.unit = Qgis::AreaUnit::SquareYards;
3292 }
3293 break;
3294 }
3295
3296 case Qgis::AreaUnit::SquareMiles:
3297 {
3298 result.value = qgsRound( area, decimals );
3299 result.unit = Qgis::AreaUnit::SquareMiles;
3300 break;
3301 }
3302
3303 case Qgis::AreaUnit::Hectares:
3304 {
3305 if ( keepBaseUnit )
3306 {
3307 result.value = qgsRound( area, decimals );
3308 result.unit = Qgis::AreaUnit::Hectares;
3309 }
3310 else if ( std::fabs( area ) > QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareKilometers, Qgis::AreaUnit::Hectares ) )
3311 {
3312 result.value = qgsRound( area * QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::Hectares, Qgis::AreaUnit::SquareKilometers ), decimals );
3313 result.unit = Qgis::AreaUnit::SquareKilometers;
3314 }
3315 else
3316 {
3317 result.value = qgsRound( area, decimals );
3318 result.unit = Qgis::AreaUnit::Hectares;
3319 }
3320 break;
3321 }
3322
3323 case Qgis::AreaUnit::Acres:
3324 {
3325 if ( keepBaseUnit )
3326 {
3327 result.value = qgsRound( area, decimals );
3328 result.unit = Qgis::AreaUnit::Acres;
3329 }
3330 else if ( std::fabs( area ) > QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::SquareMiles, Qgis::AreaUnit::Acres ) )
3331 {
3332 result.value = qgsRound( area * QgsUnitTypes::fromUnitToUnitFactor( Qgis::AreaUnit::Acres, Qgis::AreaUnit::SquareMiles ), decimals );
3333 result.unit = Qgis::AreaUnit::SquareMiles;
3334 }
3335 else
3336 {
3337 result.value = qgsRound( area, decimals );
3338 result.unit = Qgis::AreaUnit::Acres;
3339 }
3340 break;
3341 }
3342
3343 case Qgis::AreaUnit::SquareNauticalMiles:
3344 {
3345 result.value = qgsRound( area, decimals );
3346 result.unit = Qgis::AreaUnit::SquareNauticalMiles;
3347 break;
3348 }
3349
3350 case Qgis::AreaUnit::SquareDegrees:
3351 {
3352 result.value = qgsRound( area, decimals );
3353 result.unit = Qgis::AreaUnit::SquareDegrees;
3354 break;
3355 }
3356
3357 case Qgis::AreaUnit::Unknown:
3358 {
3359 result.value = qgsRound( area, decimals );
3360 result.unit = Qgis::AreaUnit::Unknown;
3361 break;
3362 }
3363 }
3364 // NOLINTEND(bugprone-branch-clone)
3365 return result;
3366}
3367
3368
3369QString QgsUnitTypes::formatDistance( double distance, int decimals, Qgis::DistanceUnit unit, bool keepBaseUnit )
3370{
3371 const DistanceValue dist = scaledDistance( distance, unit, decimals, keepBaseUnit );
3372
3373 QString unitText;
3374
3375 if ( dist.unit != Qgis::DistanceUnit::Unknown )
3376 unitText = QChar( ' ' ) + QgsUnitTypes::toAbbreviatedString( dist.unit );
3377
3378 if ( qgsDoubleNear( dist.value, 0 ) )
3379 {
3380 unitText = QChar( ' ' ) + QgsUnitTypes::toAbbreviatedString( unit );
3381 return u"%L1%2"_s.arg( distance, 0, 'e', decimals ).arg( unitText );
3382 }
3383 else
3384 {
3385 return u"%L1%2"_s.arg( dist.value, 0, 'f', decimals ).arg( unitText );
3386 }
3387}
3388
3389QString QgsUnitTypes::formatArea( double area, int decimals, Qgis::AreaUnit unit, bool keepBaseUnit )
3390{
3391 const QgsUnitTypes::AreaValue areaValue = scaledArea( area, unit, decimals, keepBaseUnit );
3392
3393 QString unitText;
3394
3395 if ( areaValue.unit != Qgis::AreaUnit::Unknown )
3396 unitText = QChar( ' ' ) + QgsUnitTypes::toAbbreviatedString( areaValue.unit );
3397
3398 if ( qgsDoubleNear( areaValue.value, 0 ) )
3399 {
3400 unitText = QChar( ' ' ) + QgsUnitTypes::toAbbreviatedString( unit );
3401 return u"%L1%2"_s.arg( area, 0, 'e', decimals ).arg( unitText );
3402 }
3403 else
3404 {
3405 return u"%L1%2"_s.arg( areaValue.value, 0, 'f', decimals ).arg( unitText );
3406 }
3407}
3408
3409QString QgsUnitTypes::encodeUnit( Qgis::RenderUnit unit )
3410{
3411 switch ( unit )
3412 {
3413 case Qgis::RenderUnit::Millimeters:
3414 return u"MM"_s;
3415 case Qgis::RenderUnit::MetersInMapUnits:
3416 return u"RenderMetersInMapUnits"_s;
3417 case Qgis::RenderUnit::MapUnits:
3418 return u"MapUnit"_s;
3419 case Qgis::RenderUnit::Pixels:
3420 return u"Pixel"_s;
3421 case Qgis::RenderUnit::Percentage:
3422 return u"Percentage"_s;
3423 case Qgis::RenderUnit::Points:
3424 return u"Point"_s;
3425 case Qgis::RenderUnit::Inches:
3426 return u"Inch"_s;
3427 case Qgis::RenderUnit::Unknown:
3428 return QString();
3429 }
3430 return QString();
3431}
3432
3433Qgis::RenderUnit QgsUnitTypes::decodeRenderUnit( const QString &string, bool *ok )
3434{
3435 const QString normalized = string.trimmed().toLower();
3436
3437 if ( ok )
3438 *ok = true;
3439
3440 if ( normalized == encodeUnit( Qgis::RenderUnit::Millimeters ).toLower() )
3441 return Qgis::RenderUnit::Millimeters;
3442 if ( normalized == encodeUnit( Qgis::RenderUnit::MetersInMapUnits ).toLower() )
3443 return Qgis::RenderUnit::MetersInMapUnits;
3444 if ( normalized == "meters"_L1 )
3445 return Qgis::RenderUnit::MetersInMapUnits;
3446 if ( normalized == encodeUnit( Qgis::RenderUnit::MapUnits ).toLower() )
3447 return Qgis::RenderUnit::MapUnits;
3448 if ( normalized == "mapunits"_L1 )
3449 return Qgis::RenderUnit::MapUnits;
3450 if ( normalized == encodeUnit( Qgis::RenderUnit::Pixels ).toLower() )
3451 return Qgis::RenderUnit::Pixels;
3452 if ( normalized == encodeUnit( Qgis::RenderUnit::Percentage ).toLower() )
3453 return Qgis::RenderUnit::Percentage;
3454 if ( normalized == "percent"_L1 )
3455 return Qgis::RenderUnit::Percentage;
3456 if ( normalized == encodeUnit( Qgis::RenderUnit::Points ).toLower() )
3457 return Qgis::RenderUnit::Points;
3458 if ( normalized == "points"_L1 )
3459 return Qgis::RenderUnit::Points;
3460 if ( normalized == encodeUnit( Qgis::RenderUnit::Inches ).toLower() )
3461 return Qgis::RenderUnit::Inches;
3462
3463 if ( ok )
3464 *ok = false;
3465
3466 // millimeters are default
3467 return Qgis::RenderUnit::Millimeters;
3468}
3469
3470QString QgsUnitTypes::toString( Qgis::RenderUnit unit )
3471{
3472 switch ( unit )
3473 {
3474 case Qgis::RenderUnit::Millimeters:
3475 return QObject::tr( "millimeters", "render" );
3476
3477 case Qgis::RenderUnit::MetersInMapUnits:
3478 return QObject::tr( "meters at scale", "render" );
3479
3480 case Qgis::RenderUnit::MapUnits:
3481 return QObject::tr( "map units", "render" );
3482
3483 case Qgis::RenderUnit::Pixels:
3484 return QObject::tr( "pixels", "render" );
3485
3486 case Qgis::RenderUnit::Percentage:
3487 return QObject::tr( "percent", "render" );
3488
3489 case Qgis::RenderUnit::Points:
3490 return QObject::tr( "points", "render" );
3491
3492 case Qgis::RenderUnit::Inches:
3493 return QObject::tr( "inches", "render" );
3494
3495 case Qgis::RenderUnit::Unknown:
3496 return QObject::tr( "<unknown>", "render" );
3497
3498 }
3499 return QString();
3500}
3501
3502
3503
3504QString QgsUnitTypes::encodeUnit( Qgis::LayoutUnit unit )
3505{
3506 switch ( unit )
3507 {
3508 case Qgis::LayoutUnit::Centimeters:
3509 return u"cm"_s;
3510 case Qgis::LayoutUnit::Meters:
3511 return u"m"_s;
3512 case Qgis::LayoutUnit::Inches:
3513 return u"in"_s;
3514 case Qgis::LayoutUnit::Feet:
3515 return u"ft"_s;
3516 case Qgis::LayoutUnit::Points:
3517 return u"pt"_s;
3518 case Qgis::LayoutUnit::Picas:
3519 return u"pi"_s;
3520 case Qgis::LayoutUnit::Pixels:
3521 return u"px"_s;
3522 case Qgis::LayoutUnit::Millimeters:
3523 return u"mm"_s;
3524 }
3525 return QString();
3526}
3527
3528Qgis::LayoutUnit QgsUnitTypes::decodeLayoutUnit( const QString &string, bool *ok )
3529{
3530 const QString normalized = string.trimmed().toLower();
3531
3532 if ( ok )
3533 *ok = true;
3534
3535 if ( normalized == encodeUnit( Qgis::LayoutUnit::Millimeters ).toLower() )
3536 return Qgis::LayoutUnit::Millimeters;
3537 if ( normalized == encodeUnit( Qgis::LayoutUnit::Centimeters ).toLower() )
3538 return Qgis::LayoutUnit::Centimeters;
3539 if ( normalized == encodeUnit( Qgis::LayoutUnit::Meters ).toLower() )
3540 return Qgis::LayoutUnit::Meters;
3541 if ( normalized == encodeUnit( Qgis::LayoutUnit::Inches ).toLower() )
3542 return Qgis::LayoutUnit::Inches;
3543 if ( normalized == encodeUnit( Qgis::LayoutUnit::Feet ).toLower() )
3544 return Qgis::LayoutUnit::Feet;
3545 if ( normalized == encodeUnit( Qgis::LayoutUnit::Points ).toLower() )
3546 return Qgis::LayoutUnit::Points;
3547 if ( normalized == encodeUnit( Qgis::LayoutUnit::Picas ).toLower() )
3548 return Qgis::LayoutUnit::Picas;
3549 if ( normalized == encodeUnit( Qgis::LayoutUnit::Pixels ).toLower() )
3550 return Qgis::LayoutUnit::Pixels;
3551
3552 if ( ok )
3553 *ok = false;
3554
3555 // millimeters are default
3556 return Qgis::LayoutUnit::Millimeters;
3557}
3558
3578
3579QString QgsUnitTypes::toAbbreviatedString( Qgis::LayoutUnit unit )
3580{
3581 switch ( unit )
3582 {
3583 case Qgis::LayoutUnit::Pixels:
3584 return QObject::tr( "px" );
3585 case Qgis::LayoutUnit::Millimeters:
3586 return QObject::tr( "mm" );
3587 case Qgis::LayoutUnit::Centimeters:
3588 return QObject::tr( "cm" );
3589 case Qgis::LayoutUnit::Meters:
3590 return QObject::tr( "m" );
3591 case Qgis::LayoutUnit::Inches:
3592 return QObject::tr( "in", "unit inch" );
3593 case Qgis::LayoutUnit::Feet:
3594 return QObject::tr( "ft" );
3595 case Qgis::LayoutUnit::Points:
3596 return QObject::tr( "pt" );
3597 case Qgis::LayoutUnit::Picas:
3598 return QObject::tr( "pica" );
3599 }
3600 return QString(); // no warnings
3601}
3602
3603QString QgsUnitTypes::toString( Qgis::LayoutUnit unit )
3604{
3605 switch ( unit )
3606 {
3607 case Qgis::LayoutUnit::Pixels:
3608 return QObject::tr( "pixels" );
3609 case Qgis::LayoutUnit::Millimeters:
3610 return QObject::tr( "millimeters" );
3611 case Qgis::LayoutUnit::Centimeters:
3612 return QObject::tr( "centimeters" );
3613 case Qgis::LayoutUnit::Meters:
3614 return QObject::tr( "meters" );
3615 case Qgis::LayoutUnit::Inches:
3616 return QObject::tr( "inches" );
3617 case Qgis::LayoutUnit::Feet:
3618 return QObject::tr( "feet" );
3619 case Qgis::LayoutUnit::Points:
3620 return QObject::tr( "points" );
3621 case Qgis::LayoutUnit::Picas:
3622 return QObject::tr( "picas" );
3623 }
3624 return QString(); // no warnings
3625}
Qgis::DistanceUnitType
DistanceUnitType
Types of distance units.
Definition qgis.h:5147
Qgis::DistanceUnitType::Geographic
@ Geographic
Unit is a geographic (e.g., degree based) unit.
Definition qgis.h:5149
Qgis::DistanceUnitType::Unknown
@ Unknown
Unknown unit type.
Definition qgis.h:5150
Qgis::DistanceUnitType::Standard
@ Standard
Unit is a standard measurement unit.
Definition qgis.h:5148
Qgis::UnitType
UnitType
Unit types.
Definition qgis.h:5068
Qgis::UnitType::Distance
@ Distance
Distance unit.
Definition qgis.h:5069
Qgis::UnitType::Temporal
@ Temporal
Temporal unit.
Definition qgis.h:5073
Qgis::UnitType::Unknown
@ Unknown
Unknown unit type.
Definition qgis.h:5072
Qgis::UnitType::Volume
@ Volume
Volume unit.
Definition qgis.h:5071
Qgis::UnitType::Area
@ Area
Area unit.
Definition qgis.h:5070
Qgis::LayoutUnit
LayoutUnit
Layout measurement units.
Definition qgis.h:5275
Qgis::LayoutUnit::Feet
@ Feet
Feet.
Definition qgis.h:5280
Qgis::LayoutUnit::Centimeters
@ Centimeters
Centimeters.
Definition qgis.h:5277
Qgis::LayoutUnit::Millimeters
@ Millimeters
Millimeters.
Definition qgis.h:5276
Qgis::LayoutUnit::Points
@ Points
Typographic points.
Definition qgis.h:5281
Qgis::LayoutUnit::Meters
@ Meters
Meters.
Definition qgis.h:5278
Qgis::LayoutUnit::Picas
@ Picas
Typographic picas.
Definition qgis.h:5282
Qgis::LayoutUnit::Pixels
@ Pixels
Pixels.
Definition qgis.h:5283
Qgis::LayoutUnit::Inches
@ Inches
Inches.
Definition qgis.h:5279
Qgis::AngleUnit
AngleUnit
Units of angles.
Definition qgis.h:5210
Qgis::AngleUnit::SecondsOfArc
@ SecondsOfArc
Seconds of arc.
Definition qgis.h:5215
Qgis::AngleUnit::Radians
@ Radians
Square kilometers.
Definition qgis.h:5212
Qgis::AngleUnit::Turn
@ Turn
Turn/revolutions.
Definition qgis.h:5216
Qgis::AngleUnit::MinutesOfArc
@ MinutesOfArc
Minutes of arc.
Definition qgis.h:5214
Qgis::AngleUnit::Unknown
@ Unknown
Unknown angle unit.
Definition qgis.h:5219
Qgis::AngleUnit::MilliradiansSI
@ MilliradiansSI
Angular milliradians (SI definition, 1/1000 of radian).
Definition qgis.h:5217
Qgis::AngleUnit::Degrees
@ Degrees
Degrees.
Definition qgis.h:5211
Qgis::AngleUnit::Gon
@ Gon
Gon/gradian.
Definition qgis.h:5213
Qgis::AngleUnit::MilNATO
@ MilNATO
Angular mil (NATO definition, 6400 mil = 2PI radians).
Definition qgis.h:5218
Qgis::DistanceUnit
DistanceUnit
Units of distance.
Definition qgis.h:5085
Qgis::DistanceUnit::YardsBritishSears1922Truncated
@ YardsBritishSears1922Truncated
British yards (Sears 1922 truncated).
Definition qgis.h:5125
Qgis::DistanceUnit::Feet
@ Feet
Imperial feet.
Definition qgis.h:5088
Qgis::DistanceUnit::MilesUSSurvey
@ MilesUSSurvey
US Survey miles.
Definition qgis.h:5132
Qgis::DistanceUnit::LinksBritishSears1922
@ LinksBritishSears1922
British links (Sears 1922).
Definition qgis.h:5120
Qgis::DistanceUnit::YardsBritishBenoit1895A
@ YardsBritishBenoit1895A
British yards (Benoit 1895 A).
Definition qgis.h:5123
Qgis::DistanceUnit::LinksBritishBenoit1895A
@ LinksBritishBenoit1895A
British links (Benoit 1895 A).
Definition qgis.h:5117
Qgis::DistanceUnit::Centimeters
@ Centimeters
Centimeters.
Definition qgis.h:5093
Qgis::DistanceUnit::YardsIndian1975
@ YardsIndian1975
Indian yards (1975).
Definition qgis.h:5131
Qgis::DistanceUnit::FeetUSSurvey
@ FeetUSSurvey
US Survey feet.
Definition qgis.h:5115
Qgis::DistanceUnit::Millimeters
@ Millimeters
Millimeters.
Definition qgis.h:5094
Qgis::DistanceUnit::FeetBritishSears1922
@ FeetBritishSears1922
British feet (Sears 1922).
Definition qgis.h:5108
Qgis::DistanceUnit::YardsClarkes
@ YardsClarkes
Clarke's yards.
Definition qgis.h:5127
Qgis::DistanceUnit::YardsIndian
@ YardsIndian
Indian yards.
Definition qgis.h:5128
Qgis::DistanceUnit::FeetBritishBenoit1895B
@ FeetBritishBenoit1895B
British feet (Benoit 1895 B).
Definition qgis.h:5106
Qgis::DistanceUnit::Miles
@ Miles
Terrestrial miles.
Definition qgis.h:5091
Qgis::DistanceUnit::LinksUSSurvey
@ LinksUSSurvey
US Survey links.
Definition qgis.h:5122
Qgis::DistanceUnit::Meters
@ Meters
Meters.
Definition qgis.h:5086
Qgis::DistanceUnit::ChainsUSSurvey
@ ChainsUSSurvey
US Survey chains.
Definition qgis.h:5102
Qgis::DistanceUnit::FeetClarkes
@ FeetClarkes
Clarke's feet.
Definition qgis.h:5109
Qgis::DistanceUnit::Unknown
@ Unknown
Unknown distance unit.
Definition qgis.h:5135
Qgis::DistanceUnit::Yards
@ Yards
Imperial yards.
Definition qgis.h:5090
Qgis::DistanceUnit::FeetBritish1936
@ FeetBritish1936
British feet (1936).
Definition qgis.h:5104
Qgis::DistanceUnit::FeetIndian1962
@ FeetIndian1962
Indian feet (1962).
Definition qgis.h:5113
Qgis::DistanceUnit::YardsBritishSears1922
@ YardsBritishSears1922
British yards (Sears 1922).
Definition qgis.h:5126
Qgis::DistanceUnit::FeetIndian1937
@ FeetIndian1937
Indian feet (1937).
Definition qgis.h:5112
Qgis::DistanceUnit::YardsIndian1937
@ YardsIndian1937
Indian yards (1937).
Definition qgis.h:5129
Qgis::DistanceUnit::Degrees
@ Degrees
Degrees, for planar geographic CRS distance measurements.
Definition qgis.h:5092
Qgis::DistanceUnit::ChainsBritishBenoit1895B
@ ChainsBritishBenoit1895B
British chains (Benoit 1895 B).
Definition qgis.h:5098
Qgis::DistanceUnit::LinksBritishSears1922Truncated
@ LinksBritishSears1922Truncated
British links (Sears 1922 truncated).
Definition qgis.h:5119
Qgis::DistanceUnit::ChainsBritishBenoit1895A
@ ChainsBritishBenoit1895A
British chains (Benoit 1895 A).
Definition qgis.h:5097
Qgis::DistanceUnit::YardsBritishBenoit1895B
@ YardsBritishBenoit1895B
British yards (Benoit 1895 B).
Definition qgis.h:5124
Qgis::DistanceUnit::FeetBritish1865
@ FeetBritish1865
British feet (1865).
Definition qgis.h:5103
Qgis::DistanceUnit::YardsIndian1962
@ YardsIndian1962
Indian yards (1962).
Definition qgis.h:5130
Qgis::DistanceUnit::FeetBritishSears1922Truncated
@ FeetBritishSears1922Truncated
British feet (Sears 1922 truncated).
Definition qgis.h:5107
Qgis::DistanceUnit::MetersGermanLegal
@ MetersGermanLegal
German legal meter.
Definition qgis.h:5134
Qgis::DistanceUnit::LinksBritishBenoit1895B
@ LinksBritishBenoit1895B
British links (Benoit 1895 B).
Definition qgis.h:5118
Qgis::DistanceUnit::ChainsInternational
@ ChainsInternational
International chains.
Definition qgis.h:5096
Qgis::DistanceUnit::Inches
@ Inches
Inches.
Definition qgis.h:5095
Qgis::DistanceUnit::Fathoms
@ Fathoms
Fathoms.
Definition qgis.h:5133
Qgis::DistanceUnit::LinksInternational
@ LinksInternational
International links.
Definition qgis.h:5116
Qgis::DistanceUnit::ChainsBritishSears1922Truncated
@ ChainsBritishSears1922Truncated
British chains (Sears 1922 truncated).
Definition qgis.h:5099
Qgis::DistanceUnit::FeetIndian
@ FeetIndian
Indian (geodetic) feet.
Definition qgis.h:5111
Qgis::DistanceUnit::NauticalMiles
@ NauticalMiles
Nautical miles.
Definition qgis.h:5089
Qgis::DistanceUnit::ChainsClarkes
@ ChainsClarkes
Clarke's chains.
Definition qgis.h:5101
Qgis::DistanceUnit::LinksClarkes
@ LinksClarkes
Clarke's links.
Definition qgis.h:5121
Qgis::DistanceUnit::ChainsBritishSears1922
@ ChainsBritishSears1922
British chains (Sears 1922).
Definition qgis.h:5100
Qgis::DistanceUnit::Kilometers
@ Kilometers
Kilometers.
Definition qgis.h:5087
Qgis::DistanceUnit::FeetIndian1975
@ FeetIndian1975
Indian feet (1975).
Definition qgis.h:5114
Qgis::DistanceUnit::FeetGoldCoast
@ FeetGoldCoast
Gold Coast feet.
Definition qgis.h:5110
Qgis::DistanceUnit::FeetBritishBenoit1895A
@ FeetBritishBenoit1895A
British feet (Benoit 1895 A).
Definition qgis.h:5105
Qgis::AreaUnit
AreaUnit
Units of area.
Definition qgis.h:5162
Qgis::AreaUnit::Acres
@ Acres
Acres.
Definition qgis.h:5169
Qgis::AreaUnit::SquareFeet
@ SquareFeet
Square feet.
Definition qgis.h:5165
Qgis::AreaUnit::SquareCentimeters
@ SquareCentimeters
Square centimeters.
Definition qgis.h:5172
Qgis::AreaUnit::SquareInches
@ SquareInches
Square inches.
Definition qgis.h:5174
Qgis::AreaUnit::SquareNauticalMiles
@ SquareNauticalMiles
Square nautical miles.
Definition qgis.h:5170
Qgis::AreaUnit::SquareMillimeters
@ SquareMillimeters
Square millimeters.
Definition qgis.h:5173
Qgis::AreaUnit::SquareYards
@ SquareYards
Square yards.
Definition qgis.h:5166
Qgis::AreaUnit::Hectares
@ Hectares
Hectares.
Definition qgis.h:5168
Qgis::AreaUnit::SquareKilometers
@ SquareKilometers
Square kilometers.
Definition qgis.h:5164
Qgis::AreaUnit::SquareMeters
@ SquareMeters
Square meters.
Definition qgis.h:5163
Qgis::AreaUnit::Unknown
@ Unknown
Unknown areal unit.
Definition qgis.h:5175
Qgis::AreaUnit::SquareDegrees
@ SquareDegrees
Square degrees, for planar geographic CRS area measurements.
Definition qgis.h:5171
Qgis::AreaUnit::SquareMiles
@ SquareMiles
Square miles.
Definition qgis.h:5167
Qgis::TemporalUnit
TemporalUnit
Temporal units.
Definition qgis.h:5231
Qgis::TemporalUnit::IrregularStep
@ IrregularStep
Special 'irregular step' time unit, used for temporal data which uses irregular, non-real-world unit ...
Definition qgis.h:5242
Qgis::TemporalUnit::Milliseconds
@ Milliseconds
Milliseconds.
Definition qgis.h:5232
Qgis::TemporalUnit::Hours
@ Hours
Hours.
Definition qgis.h:5235
Qgis::TemporalUnit::Unknown
@ Unknown
Unknown time unit.
Definition qgis.h:5243
Qgis::TemporalUnit::Centuries
@ Centuries
Centuries.
Definition qgis.h:5241
Qgis::TemporalUnit::Seconds
@ Seconds
Seconds.
Definition qgis.h:5233
Qgis::TemporalUnit::Weeks
@ Weeks
Weeks.
Definition qgis.h:5237
Qgis::TemporalUnit::Years
@ Years
Years.
Definition qgis.h:5239
Qgis::TemporalUnit::Decades
@ Decades
Decades.
Definition qgis.h:5240
Qgis::TemporalUnit::Months
@ Months
Months.
Definition qgis.h:5238
Qgis::TemporalUnit::Minutes
@ Minutes
Minutes.
Definition qgis.h:5234
Qgis::RenderUnit
RenderUnit
Rendering size units.
Definition qgis.h:5255
Qgis::RenderUnit::Percentage
@ Percentage
Percentage of another measurement (e.g., canvas size, feature size).
Definition qgis.h:5259
Qgis::RenderUnit::Millimeters
@ Millimeters
Millimeters.
Definition qgis.h:5256
Qgis::RenderUnit::Points
@ Points
Points (e.g., for font sizes).
Definition qgis.h:5260
Qgis::RenderUnit::Unknown
@ Unknown
Mixed or unknown units.
Definition qgis.h:5262
Qgis::RenderUnit::MapUnits
@ MapUnits
Map units.
Definition qgis.h:5257
Qgis::RenderUnit::Pixels
@ Pixels
Pixels.
Definition qgis.h:5258
Qgis::RenderUnit::Inches
@ Inches
Inches.
Definition qgis.h:5261
Qgis::RenderUnit::MetersInMapUnits
@ MetersInMapUnits
Meters value as Map units.
Definition qgis.h:5263
Qgis::LayoutUnitType
LayoutUnitType
Types of layout units.
Definition qgis.h:5295
Qgis::LayoutUnitType::PaperUnits
@ PaperUnits
Unit is a paper based measurement unit.
Definition qgis.h:5296
Qgis::LayoutUnitType::ScreenUnits
@ ScreenUnits
Unit is a screen based measurement unit.
Definition qgis.h:5297
Qgis::VolumeUnit
VolumeUnit
Units of volume.
Definition qgis.h:5187
Qgis::VolumeUnit::CubicMeters
@ CubicMeters
Cubic meters.
Definition qgis.h:5188
Qgis::VolumeUnit::Barrel
@ Barrel
Barrels.
Definition qgis.h:5191
Qgis::VolumeUnit::CubicYards
@ CubicYards
Cubic yards.
Definition qgis.h:5190
Qgis::VolumeUnit::CubicFeet
@ CubicFeet
Cubic feet.
Definition qgis.h:5189
Qgis::VolumeUnit::CubicDegrees
@ CubicDegrees
Cubic degrees, for planar geographic CRS volume measurements.
Definition qgis.h:5197
Qgis::VolumeUnit::CubicDecimeter
@ CubicDecimeter
Cubic decimeters.
Definition qgis.h:5192
Qgis::VolumeUnit::Unknown
@ Unknown
Unknown volume unit.
Definition qgis.h:5198
Qgis::VolumeUnit::CubicInch
@ CubicInch
Cubic inches.
Definition qgis.h:5195
Qgis::VolumeUnit::GallonUS
@ GallonUS
US Gallons.
Definition qgis.h:5194
Qgis::VolumeUnit::Liters
@ Liters
Litres.
Definition qgis.h:5193
Qgis::VolumeUnit::CubicCentimeter
@ CubicCentimeter
Cubic Centimeters.
Definition qgis.h:5196
QgsUnitTypes::decodeVolumeUnit
static Q_INVOKABLE Qgis::VolumeUnit decodeVolumeUnit(const QString &string, bool *ok=nullptr)
Decodes a volume unit from a string.
Definition qgsunittypes.cpp:2165
QgsUnitTypes::stringToDistanceUnit
static Q_INVOKABLE Qgis::DistanceUnit stringToDistanceUnit(const QString &string, bool *ok=nullptr)
Converts a translated string to a distance unit.
Definition qgsunittypes.cpp:687
QgsUnitTypes::scaledArea
static Q_INVOKABLE QgsUnitTypes::AreaValue scaledArea(double area, Qgis::AreaUnit unit, int decimals, bool keepBaseUnit=false)
Will convert an area with a given unit to an area value which is nice to display.
Definition qgsunittypes.cpp:3173
QgsUnitTypes::scaledDistance
static Q_INVOKABLE QgsUnitTypes::DistanceValue scaledDistance(double distance, Qgis::DistanceUnit unit, int decimals, bool keepBaseUnit=false)
Will convert a distance with a given unit to a distance value which is nice to display.
Definition qgsunittypes.cpp:3059
QgsUnitTypes::toString
static Q_INVOKABLE QString toString(Qgis::DistanceUnit unit)
Returns a translated string representing a distance unit.
Definition qgsunittypes.cpp:403
QgsUnitTypes::formatArea
static Q_INVOKABLE QString formatArea(double area, int decimals, Qgis::AreaUnit unit, bool keepBaseUnit=false)
Returns an area formatted as a friendly string.
Definition qgsunittypes.cpp:3389
QgsUnitTypes::fromUnitToUnitFactor
static Q_INVOKABLE double fromUnitToUnitFactor(Qgis::DistanceUnit fromUnit, Qgis::DistanceUnit toUnit)
Returns the conversion factor between the specified distance units.
Definition qgsunittypes.cpp:873
QgsUnitTypes::stringToVolumeUnit
static Q_INVOKABLE Qgis::VolumeUnit stringToVolumeUnit(const QString &string, bool *ok=nullptr)
Converts a translated string to a volume unit.
Definition qgsunittypes.cpp:2262
QgsUnitTypes::formatDistance
static Q_INVOKABLE QString formatDistance(double distance, int decimals, Qgis::DistanceUnit unit, bool keepBaseUnit=false)
Returns an distance formatted as a friendly string.
Definition qgsunittypes.cpp:3369
QgsUnitTypes::toAbbreviatedString
static Q_INVOKABLE QString toAbbreviatedString(Qgis::DistanceUnit unit)
Returns a translated abbreviation representing a distance unit.
Definition qgsunittypes.cpp:593
QgsUnitTypes::unitType
static Q_INVOKABLE Qgis::DistanceUnitType unitType(Qgis::DistanceUnit unit)
Returns the type for a distance unit.
Definition qgsunittypes.cpp:80
QgsUnitTypes::decodeUnitType
static Q_INVOKABLE Qgis::UnitType decodeUnitType(const QString &string, bool *ok=nullptr)
Decodes a unit type from a string.
Definition qgsunittypes.cpp:56
QgsUnitTypes::decodeAreaUnit
static Q_INVOKABLE Qgis::AreaUnit decodeAreaUnit(const QString &string, bool *ok=nullptr)
Decodes an areal unit from a string.
Definition qgsunittypes.cpp:971
QgsUnitTypes::decodeRenderUnit
static Q_INVOKABLE Qgis::RenderUnit decodeRenderUnit(const QString &string, bool *ok=nullptr)
Decodes a render unit from a string.
Definition qgsunittypes.cpp:3433
QgsUnitTypes::stringToTemporalUnit
static Q_INVOKABLE Qgis::TemporalUnit stringToTemporalUnit(const QString &string, bool *ok=nullptr)
Converts a translated string to a temporal unit.
Definition qgsunittypes.cpp:1812
QgsUnitTypes::decodeLayoutUnit
static Q_INVOKABLE Qgis::LayoutUnit decodeLayoutUnit(const QString &string, bool *ok=nullptr)
Decodes a layout unit from a string.
Definition qgsunittypes.cpp:3528
QgsUnitTypes::stringToAreaUnit
static Q_INVOKABLE Qgis::AreaUnit stringToAreaUnit(const QString &string, bool *ok=nullptr)
Converts a translated string to an areal unit.
Definition qgsunittypes.cpp:1079
QgsUnitTypes::distanceToAreaUnit
static Q_INVOKABLE Qgis::AreaUnit distanceToAreaUnit(Qgis::DistanceUnit distanceUnit)
Converts a distance unit to its corresponding area unit, e.g., meters to square meters.
Definition qgsunittypes.cpp:1555
QgsUnitTypes::decodeTemporalUnit
static Q_INVOKABLE Qgis::TemporalUnit decodeTemporalUnit(const QString &string, bool *ok=nullptr)
Decodes a temporal unit from a string.
Definition qgsunittypes.cpp:1710
QgsUnitTypes::decodeAngleUnit
static Q_INVOKABLE Qgis::AngleUnit decodeAngleUnit(const QString &string, bool *ok=nullptr)
Decodes an angular unit from a string.
Definition qgsunittypes.cpp:2740
QgsUnitTypes::areaToDistanceUnit
static Q_INVOKABLE Qgis::DistanceUnit areaToDistanceUnit(Qgis::AreaUnit areaUnit)
Converts an area unit to its corresponding distance unit, e.g., square meters to meters.
Definition qgsunittypes.cpp:1635
QgsUnitTypes::volumeToDistanceUnit
static Q_INVOKABLE Qgis::DistanceUnit volumeToDistanceUnit(Qgis::VolumeUnit volumeUnit)
Converts a volume unit to its corresponding distance unit, e.g., cubic meters to meters.
Definition qgsunittypes.cpp:2632
QgsUnitTypes::encodeUnit
static Q_INVOKABLE QString encodeUnit(Qgis::DistanceUnit unit)
Encodes a distance unit to a string.
Definition qgsunittypes.cpp:170
QgsUnitTypes::encodeUnitType
static Q_INVOKABLE QString encodeUnitType(Qgis::UnitType type)
Encodes a unit type to a string.
Definition qgsunittypes.cpp:33
QgsUnitTypes::formatAngle
static Q_INVOKABLE QString formatAngle(double angle, int decimals, Qgis::AngleUnit unit)
Returns an angle formatted as a friendly string.
Definition qgsunittypes.cpp:3010
QgsUnitTypes::distanceToVolumeUnit
static Q_INVOKABLE Qgis::VolumeUnit distanceToVolumeUnit(Qgis::DistanceUnit distanceUnit)
Converts a distance unit to its corresponding volume unit, e.g., meters to cubic meters.
Definition qgsunittypes.cpp:2549
QgsUnitTypes::decodeDistanceUnit
static Q_INVOKABLE Qgis::DistanceUnit decodeDistanceUnit(const QString &string, bool *ok=nullptr)
Decodes a distance unit from a string.
Definition qgsunittypes.cpp:332
qgsRound
double qgsRound(double number, int places)
Returns a double number, rounded (as close as possible) to the specified number of places.
Definition qgis.h:6941
qgsDoubleNear
bool qgsDoubleNear(double a, double b, double epsilon=4 *std::numeric_limits< double >::epsilon())
Compare two doubles (but allow some difference).
Definition qgis.h:6900
KM2_TO_M2
#define KM2_TO_M2
DEG2_TO_M3
#define DEG2_TO_M3
Definition qgsunittypes.cpp:2298
MI2_TO_M2
#define MI2_TO_M2
AC_TO_FT2
#define AC_TO_FT2
YD2_TO_M2
#define YD2_TO_M2
NM2_TO_M2
#define NM2_TO_M2
IN2_TO_M2
#define IN2_TO_M2
MM2_TO_M2
#define MM2_TO_M2
DEG2_TO_M2
#define DEG2_TO_M2
CM2_TO_M2
#define CM2_TO_M2
FT2_TO_M2
#define FT2_TO_M2
distanceUnitToMeter
constexpr double distanceUnitToMeter(Qgis::DistanceUnit unit)
Definition qgsunittypes.cpp:764
HA_TO_M2
#define HA_TO_M2
QgsUnitTypes::AreaValue
A combination of area value and unit.
Definition qgsunittypes.h:68
QgsUnitTypes::AreaValue::value
double value
The value part of the distance.
Definition qgsunittypes.h:73
QgsUnitTypes::AreaValue::unit
Qgis::AreaUnit unit
The value part of the distance.
Definition qgsunittypes.h:78
QgsUnitTypes::DistanceValue
A combination of distance value and unit.
Definition qgsunittypes.h:50
QgsUnitTypes::DistanceValue::value
double value
The value part of the distance.
Definition qgsunittypes.h:55
QgsUnitTypes::DistanceValue::unit
Qgis::DistanceUnit unit
The value part of the distance.
Definition qgsunittypes.h:60
Generated on for QGIS API Documentation by doxygen 1.15.0