QGIS API Documentation 3.30.0-'s-Hertogenbosch (f186b8efe0)
|
Helper functions for various unit types. More...
#include <qgsunittypes.h>
Classes | |
struct | AreaValue |
A combination of area value and unit. More... | |
struct | DistanceValue |
A combination of distance value and unit. More... | |
Public Types | |
typedef QList< Qgis::RenderUnit > | RenderUnitList |
List of render units. More... | |
Static Public Member Functions | |
static Q_INVOKABLE Qgis::DistanceUnit | areaToDistanceUnit (Qgis::AreaUnit areaUnit) |
Converts an area unit to its corresponding distance unit, e.g., square meters to meters. More... | |
static Q_INVOKABLE Qgis::AngleUnit | decodeAngleUnit (const QString &string, bool *ok=nullptr) |
Decodes an angular unit from a string. More... | |
static Q_INVOKABLE Qgis::AreaUnit | decodeAreaUnit (const QString &string, bool *ok=nullptr) |
Decodes an areal unit from a string. More... | |
static Q_INVOKABLE Qgis::DistanceUnit | decodeDistanceUnit (const QString &string, bool *ok=nullptr) |
Decodes a distance unit from a string. More... | |
static Q_INVOKABLE Qgis::LayoutUnit | decodeLayoutUnit (const QString &string, bool *ok=nullptr) |
Decodes a layout unit from a string. More... | |
static Q_INVOKABLE Qgis::RenderUnit | decodeRenderUnit (const QString &string, bool *ok=nullptr) |
Decodes a render unit from a string. More... | |
static Q_INVOKABLE Qgis::TemporalUnit | decodeTemporalUnit (const QString &string, bool *ok=nullptr) |
Decodes a temporal unit from a string. More... | |
static Q_INVOKABLE Qgis::UnitType | decodeUnitType (const QString &string, bool *ok=nullptr) |
Decodes a unit type from a string. More... | |
static Q_INVOKABLE Qgis::VolumeUnit | decodeVolumeUnit (const QString &string, bool *ok=nullptr) |
Decodes a volume unit from a string. More... | |
static Q_INVOKABLE Qgis::AreaUnit | distanceToAreaUnit (Qgis::DistanceUnit distanceUnit) |
Converts a distance unit to its corresponding area unit, e.g., meters to square meters. More... | |
static Q_INVOKABLE Qgis::VolumeUnit | distanceToVolumeUnit (Qgis::DistanceUnit distanceUnit) |
Converts a distance unit to its corresponding volume unit, e.g., meters to cubic meters. More... | |
static QString | encodeUnit (Qgis::AngleUnit unit) |
Encodes an angular unit to a string. More... | |
static QString | encodeUnit (Qgis::AreaUnit unit) |
Encodes an areal unit to a string. More... | |
static Q_INVOKABLE QString | encodeUnit (Qgis::DistanceUnit unit) |
Encodes a distance unit to a string. More... | |
static QString | encodeUnit (Qgis::LayoutUnit unit) |
Encodes a layout unit to a string. More... | |
static QString | encodeUnit (Qgis::RenderUnit unit) |
Encodes a render unit to a string. More... | |
static QString | encodeUnit (Qgis::TemporalUnit unit) |
Encodes a temporal unit to a string. More... | |
static QString | encodeUnit (Qgis::VolumeUnit unit) |
Encodes a volume unit to a string. More... | |
static Q_INVOKABLE QString | encodeUnitType (Qgis::UnitType type) |
Encodes a unit type to a string. More... | |
static Q_INVOKABLE QString | formatAngle (double angle, int decimals, Qgis::AngleUnit unit) |
Returns an angle formatted as a friendly string. More... | |
static Q_INVOKABLE QString | formatArea (double area, int decimals, Qgis::AreaUnit unit, bool keepBaseUnit=false) |
Returns an area formatted as a friendly string. More... | |
static Q_INVOKABLE QString | formatDistance (double distance, int decimals, Qgis::DistanceUnit unit, bool keepBaseUnit=false) |
Returns an distance formatted as a friendly string. More... | |
static double | fromUnitToUnitFactor (Qgis::AngleUnit fromUnit, Qgis::AngleUnit toUnit) |
Returns the conversion factor between the specified angular units. More... | |
static double | fromUnitToUnitFactor (Qgis::AreaUnit fromUnit, Qgis::AreaUnit toUnit) |
Returns the conversion factor between the specified areal units. More... | |
static Q_INVOKABLE double | fromUnitToUnitFactor (Qgis::DistanceUnit fromUnit, Qgis::DistanceUnit toUnit) |
Returns the conversion factor between the specified distance units. More... | |
static double | fromUnitToUnitFactor (Qgis::TemporalUnit fromUnit, Qgis::TemporalUnit toUnit) |
Returns the conversion factor between the specified temporal units. More... | |
static double | fromUnitToUnitFactor (Qgis::VolumeUnit fromUnit, Qgis::VolumeUnit toUnit) |
Returns the conversion factor between the specified volume units. More... | |
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. More... | |
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. More... | |
static Q_INVOKABLE Qgis::AreaUnit | stringToAreaUnit (const QString &string, bool *ok=nullptr) |
Converts a translated string to an areal unit. More... | |
static Q_INVOKABLE Qgis::DistanceUnit | stringToDistanceUnit (const QString &string, bool *ok=nullptr) |
Converts a translated string to a distance unit. More... | |
static Q_INVOKABLE Qgis::TemporalUnit | stringToTemporalUnit (const QString &string, bool *ok=nullptr) |
Converts a translated string to a temporal unit. More... | |
static Q_INVOKABLE Qgis::VolumeUnit | stringToVolumeUnit (const QString &string, bool *ok=nullptr) |
Converts a translated string to a volume unit. More... | |
static QString | toAbbreviatedString (Qgis::AreaUnit unit) |
Returns a translated abbreviation representing an areal unit. More... | |
static Q_INVOKABLE QString | toAbbreviatedString (Qgis::DistanceUnit unit) |
Returns a translated abbreviation representing a distance unit. More... | |
static QString | toAbbreviatedString (Qgis::LayoutUnit unit) |
Returns a translated abbreviation representing a layout unit (e.g. More... | |
static QString | toAbbreviatedString (Qgis::RenderUnit unit) |
Returns a translated abbreviation representing a render unit. More... | |
static QString | toAbbreviatedString (Qgis::TemporalUnit unit) |
Returns a translated abbreviation representing a temporal unit. More... | |
static QString | toAbbreviatedString (Qgis::VolumeUnit unit) |
Returns a translated abbreviation representing a volume unit. More... | |
static QString | toString (Qgis::AngleUnit unit) |
Returns a translated string representing an angular unit. More... | |
static QString | toString (Qgis::AreaUnit unit) |
Returns a translated string representing an areal unit. More... | |
static Q_INVOKABLE QString | toString (Qgis::DistanceUnit unit) |
Returns a translated string representing a distance unit. More... | |
static QString | toString (Qgis::LayoutUnit unit) |
Returns a translated string representing a layout unit. More... | |
static QString | toString (Qgis::RenderUnit unit) |
Returns a translated string representing a render unit. More... | |
static QString | toString (Qgis::TemporalUnit unit) |
Returns a translated string representing a temporal unit. More... | |
static QString | toString (Qgis::VolumeUnit unit) |
Returns a translated string representing a volume unit. More... | |
static Qgis::DistanceUnitType | unitType (Qgis::AreaUnit unit) |
Returns the type for an areal unit. More... | |
static Q_INVOKABLE Qgis::DistanceUnitType | unitType (Qgis::DistanceUnit unit) |
Returns the type for a distance unit. More... | |
static Q_INVOKABLE Qgis::LayoutUnitType | unitType (Qgis::LayoutUnit units) |
Returns the type for a unit of measurement. More... | |
static Qgis::DistanceUnitType | unitType (Qgis::VolumeUnit unit) |
Returns the type for an volume unit. More... | |
static Q_INVOKABLE Qgis::DistanceUnit | volumeToDistanceUnit (Qgis::VolumeUnit volumeUnit) |
Converts a volume unit to its corresponding distance unit, e.g., cubic meters to meters. More... | |
Helper functions for various unit types.
Definition at line 39 of file qgsunittypes.h.
typedef QList<Qgis::RenderUnit> QgsUnitTypes::RenderUnitList |
List of render units.
Definition at line 84 of file qgsunittypes.h.
|
static |
Converts an area unit to its corresponding distance unit, e.g., square meters to meters.
areaUnit | area unit to convert |
Definition at line 1214 of file qgsunittypes.cpp.
|
static |
Decodes an angular unit from a string.
string | string to decode |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 2268 of file qgsunittypes.cpp.
|
static |
Decodes an areal unit from a string.
string | string to decode |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 657 of file qgsunittypes.cpp.
|
static |
Decodes a distance unit from a string.
string | string to decode |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 165 of file qgsunittypes.cpp.
|
static |
Decodes a layout unit from a string.
string | string to decode |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 3043 of file qgsunittypes.cpp.
|
static |
Decodes a render unit from a string.
string | string to decode |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 2948 of file qgsunittypes.cpp.
|
static |
Decodes a temporal unit from a string.
string | string to decode |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 1286 of file qgsunittypes.cpp.
|
static |
Decodes a unit type from a string.
string | string to decode |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 49 of file qgsunittypes.cpp.
|
static |
Decodes a volume unit from a string.
string | string to decode |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 1741 of file qgsunittypes.cpp.
|
static |
Converts a distance unit to its corresponding area unit, e.g., meters to square meters.
distanceUnit | distance unit to convert |
Definition at line 1176 of file qgsunittypes.cpp.
|
static |
Converts a distance unit to its corresponding volume unit, e.g., meters to cubic meters.
distanceUnit | distance unit to convert |
Definition at line 2122 of file qgsunittypes.cpp.
|
static |
Encodes an angular unit to a string.
unit | unit to encode |
Definition at line 2242 of file qgsunittypes.cpp.
|
static |
Encodes an areal unit to a string.
unit | unit to encode |
Definition at line 625 of file qgsunittypes.cpp.
|
static |
Encodes a distance unit to a string.
unit | unit to encode |
Definition at line 122 of file qgsunittypes.cpp.
|
static |
Encodes a layout unit to a string.
unit | unit to encode |
Definition at line 3019 of file qgsunittypes.cpp.
|
static |
Encodes a render unit to a string.
unit | unit to encode |
Definition at line 2924 of file qgsunittypes.cpp.
|
static |
Encodes a temporal unit to a string.
Definition at line 1254 of file qgsunittypes.cpp.
|
static |
Encodes a volume unit to a string.
Definition at line 2212 of file qgsunittypes.cpp.
|
static |
Encodes a unit type to a string.
Definition at line 26 of file qgsunittypes.cpp.
|
static |
Returns an angle formatted as a friendly string.
angle | angle to format |
decimals | number of decimal places to show. A value of -1 indicates that an appropriate number of decimal places should automatically be selected. |
unit | unit of angle |
Definition at line 2538 of file qgsunittypes.cpp.
|
static |
Returns an area formatted as a friendly string.
area | area to format |
decimals | number of decimal places to show |
unit | unit of area |
keepBaseUnit | set to false to allow conversion of large areas to more suitable units, e.g., square meters to square kilometers |
Definition at line 2904 of file qgsunittypes.cpp.
|
static |
Returns an distance formatted as a friendly string.
distance | distance to format |
decimals | number of decimal places to show |
unit | unit of distance |
keepBaseUnit | set to false to allow conversion of large distances to more suitable units, e.g., meters to kilometers |
Definition at line 2884 of file qgsunittypes.cpp.
|
static |
Returns the conversion factor between the specified angular units.
fromUnit | angle unit to convert from |
toUnit | angle unit to convert to |
Definition at line 2325 of file qgsunittypes.cpp.
|
static |
Returns the conversion factor between the specified areal units.
fromUnit | area unit to convert from |
toUnit | area unit to convert to |
Definition at line 796 of file qgsunittypes.cpp.
|
static |
Returns the conversion factor between the specified distance units.
fromUnit | distance unit to convert from |
toUnit | distance unit to convert to |
Definition at line 352 of file qgsunittypes.cpp.
|
static |
Returns the conversion factor between the specified temporal units.
fromUnit | temporal unit to convert from |
toUnit | temporal unit to convert to |
Definition at line 1426 of file qgsunittypes.cpp.
|
static |
Returns the conversion factor between the specified volume units.
fromUnit | volume unit to convert from |
toUnit | volume unit to convert to |
Definition at line 1875 of file qgsunittypes.cpp.
|
static |
Will convert an area with a given unit to an area value which is nice to display.
It will convert between different units (e.g. from square meters to square kilometers) if appropriate, unless forced otherwise with keepBaseUnit. The value will also be rounded to decimals (be prepared that the returned value is still a double so it will require further formatting when converting to a string).
Definition at line 2698 of file qgsunittypes.cpp.
|
static |
Will convert a distance with a given unit to a distance value which is nice to display.
It will convert between different units (e.g. from meters to kilometers or millimeters) if appropriate, unless forced otherwise with keepBaseUnit. The value will also be rounded to decimals (be prepared that the returned value is still a double so it will require further formatting when converting to a string).
Definition at line 2587 of file qgsunittypes.cpp.
|
static |
Converts a translated string to an areal unit.
string | string representing an areal unit |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 759 of file qgsunittypes.cpp.
|
static |
Converts a translated string to a distance unit.
string | string representing a distance unit |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 312 of file qgsunittypes.cpp.
|
static |
Converts a translated string to a temporal unit.
string | string representing a volume unit |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 1388 of file qgsunittypes.cpp.
|
static |
Converts a translated string to a volume unit.
string | string representing a volume unit |
ok | optional boolean, will be set to true if string was converted successfully |
Definition at line 1838 of file qgsunittypes.cpp.
|
static |
Returns a translated abbreviation representing an areal unit.
unit | unit to convert to string |
Definition at line 727 of file qgsunittypes.cpp.
|
static |
Returns a translated abbreviation representing a distance unit.
unit | unit to convert to string |
Definition at line 269 of file qgsunittypes.cpp.
|
static |
Returns a translated abbreviation representing a layout unit (e.g.
"mm").
Definition at line 3094 of file qgsunittypes.cpp.
|
static |
Returns a translated abbreviation representing a render unit.
unit | unit to convert to string |
Definition at line 236 of file qgsunittypes.cpp.
|
static |
Returns a translated abbreviation representing a temporal unit.
Definition at line 1356 of file qgsunittypes.cpp.
|
static |
Returns a translated abbreviation representing a volume unit.
Definition at line 1807 of file qgsunittypes.cpp.
|
static |
Returns a translated string representing an angular unit.
unit | unit to convert to string |
Definition at line 2299 of file qgsunittypes.cpp.
|
static |
Returns a translated string representing an areal unit.
unit | unit to convert to string |
Definition at line 695 of file qgsunittypes.cpp.
|
static |
Returns a translated string representing a distance unit.
unit | unit to convert to string |
Definition at line 199 of file qgsunittypes.cpp.
|
static |
Returns a translated string representing a layout unit.
Definition at line 3118 of file qgsunittypes.cpp.
|
static |
Returns a translated string representing a render unit.
Definition at line 2985 of file qgsunittypes.cpp.
|
static |
Returns a translated string representing a temporal unit.
Definition at line 1324 of file qgsunittypes.cpp.
|
static |
Returns a translated string representing a volume unit.
Definition at line 1777 of file qgsunittypes.cpp.
|
static |
Returns the type for an areal unit.
Definition at line 96 of file qgsunittypes.cpp.
|
static |
Returns the type for a distance unit.
Definition at line 73 of file qgsunittypes.cpp.
|
static |
Returns the type for a unit of measurement.
Definition at line 3074 of file qgsunittypes.cpp.
|
static |
Returns the type for an volume unit.
Definition at line 2190 of file qgsunittypes.cpp.
|
static |
Converts a volume unit to its corresponding distance unit, e.g., cubic meters to meters.
volumeUnit | volume unit to convert |
Definition at line 2160 of file qgsunittypes.cpp.