QgsUnitTypes Class Reference

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
enum	AngleUnit {   AngleDegrees = 0, AngleRadians, AngleGon, AngleMinutesOfArc,   AngleSecondsOfArc, AngleTurn, AngleMilliradiansSI, AngleMilNATO,   AngleUnknownUnit }
	Units of angles. More...
enum	AreaUnit {   AreaSquareMeters = 0, AreaSquareKilometers, AreaSquareFeet, AreaSquareYards,   AreaSquareMiles, AreaHectares, AreaAcres, AreaSquareNauticalMiles,   AreaSquareDegrees, AreaSquareCentimeters, AreaSquareMillimeters, AreaUnknownUnit }
	Units of area. More...
enum	DistanceUnit {   DistanceMeters = 0, DistanceKilometers, DistanceFeet, DistanceNauticalMiles,   DistanceYards, DistanceMiles, DistanceDegrees, DistanceCentimeters,   DistanceMillimeters, DistanceUnknownUnit }
	Units of distance. More...
enum	DistanceUnitType { Standard = 0, Geographic, UnknownType }
	Types of distance units. More...
enum	LayoutUnit {   LayoutMillimeters = 0, LayoutCentimeters, LayoutMeters, LayoutInches,   LayoutFeet, LayoutPoints, LayoutPicas, LayoutPixels }
	Layout measurement units. More...
enum	LayoutUnitType { LayoutPaperUnits = 0, LayoutScreenUnits }
	Types of layout units. More...
enum	RenderUnit {   RenderMillimeters = 0, RenderMapUnits, RenderPixels, RenderPercentage,   RenderPoints, RenderInches, RenderUnknownUnit, RenderMetersInMapUnits }
	Rendering size units. More...
typedef QList< QgsUnitTypes::RenderUnit >	RenderUnitList
	List of render units. More...
enum	SystemOfMeasurement { UnknownSystem = 0, MetricSystem, ImperialSystem, USCSSystem }
	Systems of unit measurement. More...
enum	UnitType { TypeDistance = 0, TypeArea, TypeVolume, TypeUnknown }
	Unit types. More...
enum	VolumeUnit {   VolumeCubicMeters = 0, VolumeCubicFeet, VolumeCubicYards, VolumeBarrel,   VolumeCubicDecimeter, VolumeLiters, VolumeGallonUS, VolumeCubicInch,   VolumeCubicCentimeter, VolumeCubicDegrees, VolumeUnknownUnit }
	Units of volume. More...

Static Public Member Functions
static Q_INVOKABLE QgsUnitTypes::DistanceUnit	areaToDistanceUnit (QgsUnitTypes::AreaUnit areaUnit)
	Converts an area unit to its corresponding distance unit, e.g., square meters to meters. More...
static Q_INVOKABLE QgsUnitTypes::AngleUnit	decodeAngleUnit (const QString &string, bool *ok=nullptr)
	Decodes an angular unit from a string. More...
static Q_INVOKABLE AreaUnit	decodeAreaUnit (const QString &string, bool *ok=nullptr)
	Decodes an areal unit from a string. More...
static Q_INVOKABLE QgsUnitTypes::DistanceUnit	decodeDistanceUnit (const QString &string, bool *ok=nullptr)
	Decodes a distance unit from a string. More...
static Q_INVOKABLE QgsUnitTypes::LayoutUnit	decodeLayoutUnit (const QString &string, bool *ok=nullptr)
	Decodes a layout unit from a string. More...
static Q_INVOKABLE QgsUnitTypes::RenderUnit	decodeRenderUnit (const QString &string, bool *ok=nullptr)
	Decodes a render unit from a string. More...
static Q_INVOKABLE QgsUnitTypes::UnitType	decodeUnitType (const QString &string, bool *ok=nullptr)
	Decodes a unit type from a string. More...
static Q_INVOKABLE VolumeUnit	decodeVolumeUnit (const QString &string, bool *ok=nullptr)
	Decodes a volume unit from a string. More...
static Q_INVOKABLE QgsUnitTypes::AreaUnit	distanceToAreaUnit (QgsUnitTypes::DistanceUnit distanceUnit)
	Converts a distance unit to its corresponding area unit, e.g., meters to square meters. More...
static Q_INVOKABLE QgsUnitTypes::VolumeUnit	distanceToVolumeUnit (QgsUnitTypes::DistanceUnit distanceUnit)
	Converts a distance unit to its corresponding volume unit, e.g., meters to cubic meters. More...
static Q_INVOKABLE QString	encodeUnit (QgsUnitTypes::DistanceUnit unit)
	Encodes a distance unit to a string. More...
static Q_INVOKABLE QString	encodeUnit (QgsUnitTypes::AreaUnit unit)
	Encodes an areal unit to a string. More...
static Q_INVOKABLE QString	encodeUnit (QgsUnitTypes::VolumeUnit unit)
	Encodes a volume unit to a string. More...
static Q_INVOKABLE QString	encodeUnit (QgsUnitTypes::AngleUnit unit)
	Encodes an angular unit to a string. More...
static Q_INVOKABLE QString	encodeUnit (QgsUnitTypes::RenderUnit unit)
	Encodes a render unit to a string. More...
static Q_INVOKABLE QString	encodeUnit (QgsUnitTypes::LayoutUnit unit)
	Encodes a layout unit to a string. More...
static Q_INVOKABLE QString	encodeUnitType (QgsUnitTypes::UnitType type)
	Encodes a unit type to a string. More...
static Q_INVOKABLE QString	formatAngle (double angle, int decimals, QgsUnitTypes::AngleUnit unit)
	Returns an angle formatted as a friendly string. More...
static Q_INVOKABLE QString	formatArea (double area, int decimals, QgsUnitTypes::AreaUnit unit, bool keepBaseUnit=false)
	Returns an area formatted as a friendly string. More...
static Q_INVOKABLE QString	formatDistance (double distance, int decimals, QgsUnitTypes::DistanceUnit unit, bool keepBaseUnit=false)
	Returns an distance formatted as a friendly string. More...
static Q_INVOKABLE double	fromUnitToUnitFactor (QgsUnitTypes::DistanceUnit fromUnit, QgsUnitTypes::DistanceUnit toUnit)
	Returns the conversion factor between the specified distance units. More...
static Q_INVOKABLE double	fromUnitToUnitFactor (QgsUnitTypes::AreaUnit fromUnit, QgsUnitTypes::AreaUnit toUnit)
	Returns the conversion factor between the specified areal units. More...
static Q_INVOKABLE double	fromUnitToUnitFactor (QgsUnitTypes::VolumeUnit fromUnit, QgsUnitTypes::VolumeUnit toUnit)
	Returns the conversion factor between the specified volume units. More...
static Q_INVOKABLE double	fromUnitToUnitFactor (QgsUnitTypes::AngleUnit fromUnit, QgsUnitTypes::AngleUnit toUnit)
	Returns the conversion factor between the specified angular units. More...
static Q_INVOKABLE QgsUnitTypes::AreaValue	scaledArea (double area, QgsUnitTypes::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, QgsUnitTypes::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 AreaUnit	stringToAreaUnit (const QString &string, bool *ok=nullptr)
	Converts a translated string to an areal unit. More...
static Q_INVOKABLE QgsUnitTypes::DistanceUnit	stringToDistanceUnit (const QString &string, bool *ok=nullptr)
	Converts a translated string to a distance unit. More...
static Q_INVOKABLE VolumeUnit	stringToVolumeUnit (const QString &string, bool *ok=nullptr)
	Converts a translatedstring to a volume unit. More...
static Q_INVOKABLE QString	toAbbreviatedString (QgsUnitTypes::DistanceUnit unit)
	Returns a translated abbreviation representing a distance unit. More...
static QString	toAbbreviatedString (QgsUnitTypes::AreaUnit unit)
	Returns a translated abbreviation representing an areal unit. More...
static QString	toAbbreviatedString (QgsUnitTypes::VolumeUnit unit)
	Returns a translated abbreviation representing a volume unit. More...
static Q_INVOKABLE QString	toAbbreviatedString (QgsUnitTypes::RenderUnit unit)
	Returns a translated abbreviation representing a render unit. More...
static QString	toAbbreviatedString (QgsUnitTypes::LayoutUnit unit)
	Returns a translated abbreviation representing a layout unit (e.g. More...
static Q_INVOKABLE QString	toString (QgsUnitTypes::DistanceUnit unit)
	Returns a translated string representing a distance unit. More...
static QString	toString (QgsUnitTypes::AreaUnit unit)
	Returns a translated string representing an areal unit. More...
static QString	toString (QgsUnitTypes::VolumeUnit unit)
	Returns a translated string representing a volume unit. More...
static QString	toString (QgsUnitTypes::AngleUnit unit)
	Returns a translated string representing an angular unit. More...
static QString	toString (QgsUnitTypes::RenderUnit unit)
	Returns a translated string representing a render unit. More...
static QString	toString (QgsUnitTypes::LayoutUnit unit)
	Returns a translated string representing a layout unit. More...
static Q_INVOKABLE DistanceUnitType	unitType (QgsUnitTypes::DistanceUnit unit)
	Returns the type for a distance unit. More...
static Q_INVOKABLE DistanceUnitType	unitType (QgsUnitTypes::AreaUnit unit)
	Returns the type for an areal unit. More...
static Q_INVOKABLE DistanceUnitType	unitType (QgsUnitTypes::VolumeUnit unit)
	Returns the type for an volume unit. More...
static Q_INVOKABLE QgsUnitTypes::LayoutUnitType	unitType (QgsUnitTypes::LayoutUnit units)
	Returns the type for a unit of measurement. More...
static Q_INVOKABLE QgsUnitTypes::DistanceUnit	volumeToDistanceUnit (QgsUnitTypes::VolumeUnit volumeUnit)
	Converts a volume unit to its corresponding distance unit, e.g., cubic meters to meters. More...

Detailed Description

Helper functions for various unit types.

Since

QGIS 2.14

Definition at line 38 of file qgsunittypes.h.

Member Typedef Documentation

RenderUnitList

typedef QList<QgsUnitTypes::RenderUnit> QgsUnitTypes::RenderUnitList

List of render units.

Definition at line 218 of file qgsunittypes.h.

Member Enumeration Documentation

AngleUnit

enum QgsUnitTypes::AngleUnit

Units of angles.

Enumerator
AngleDegrees	Degrees.
AngleRadians	Square kilometers.
AngleGon	Gon/gradian.
AngleMinutesOfArc	Minutes of arc.
AngleSecondsOfArc	Seconds of arc.
AngleTurn	Turn/revolutions.
AngleMilliradiansSI	Angular milliradians (SI definition, 1/1000 of radian)
AngleMilNATO	Angular mil (NATO definition, 6400 mil = 2PI radians)
AngleUnknownUnit	Unknown angle unit.

Definition at line 130 of file qgsunittypes.h.

AreaUnit

enum QgsUnitTypes::AreaUnit

Units of area.

Enumerator
AreaSquareMeters	Square meters.
AreaSquareKilometers	Square kilometers.
AreaSquareFeet	Square feet.
AreaSquareYards	Square yards.
AreaSquareMiles	Square miles.
AreaHectares	Hectares.
AreaAcres	Acres.
AreaSquareNauticalMiles	Square nautical miles.
AreaSquareDegrees	Square degrees, for planar geographic CRS area measurements.
AreaSquareCentimeters	Square centimeters.
AreaSquareMillimeters	Square millimeters.
AreaUnknownUnit	Unknown areal unit.

Definition at line 92 of file qgsunittypes.h.

DistanceUnit

enum QgsUnitTypes::DistanceUnit

Units of distance.

Enumerator
DistanceMeters	Meters.
DistanceKilometers	Kilometers.
DistanceFeet	Imperial feet.
DistanceNauticalMiles	Nautical miles.
DistanceYards	Imperial yards.
DistanceMiles	Terrestrial miles.
DistanceDegrees	Degrees, for planar geographic CRS distance measurements.
DistanceCentimeters	Centimeters.
DistanceMillimeters	Millimeters.
DistanceUnknownUnit	Unknown distance unit.

Definition at line 66 of file qgsunittypes.h.

DistanceUnitType

enum QgsUnitTypes::DistanceUnitType

Types of distance units.

Enumerator
Standard	Unit is a standard measurement unit.
Geographic	Unit is a geographic (e.g., degree based) unit.
UnknownType	Unknown unit type.

Definition at line 84 of file qgsunittypes.h.

LayoutUnit

enum QgsUnitTypes::LayoutUnit

Layout measurement units.

Enumerator
LayoutMillimeters	Millimeters.
LayoutCentimeters	Centimeters.
LayoutMeters	Meters.
LayoutInches	Inches.
LayoutFeet	Feet.
LayoutPoints	Typographic points.
LayoutPicas	Typographic picas.
LayoutPixels	Pixels.

Definition at line 159 of file qgsunittypes.h.

LayoutUnitType

enum QgsUnitTypes::LayoutUnitType

Types of layout units.

Enumerator
LayoutPaperUnits	Unit is a paper based measurement unit.
LayoutScreenUnits	Unit is a screen based measurement unit.

Definition at line 173 of file qgsunittypes.h.

RenderUnit

enum QgsUnitTypes::RenderUnit

Rendering size units.

Enumerator
RenderMillimeters	Millimeters.
RenderMapUnits	Map units.
RenderPixels	Pixels.
RenderPercentage	Percentage of another measurement (e.g., canvas size, feature size)
RenderPoints	Points (e.g., for font sizes)
RenderInches	Inches.
RenderUnknownUnit	Mixed or unknown units.
RenderMetersInMapUnits	Meters value as Map units.

Definition at line 145 of file qgsunittypes.h.

SystemOfMeasurement

enum QgsUnitTypes::SystemOfMeasurement

Systems of unit measurement.

Enumerator
UnknownSystem	Unknown system of measurement.
MetricSystem	International System of Units (SI)
ImperialSystem	British Imperial.
USCSSystem	United States customary system.

Definition at line 44 of file qgsunittypes.h.

UnitType

enum QgsUnitTypes::UnitType

Unit types.

Since

QGIS 3.10

Enumerator
TypeDistance	Distance unit.
TypeArea	Area unit.
TypeVolume	Volume unit.
TypeUnknown	Unknown unit type.

Definition at line 57 of file qgsunittypes.h.

VolumeUnit

enum QgsUnitTypes::VolumeUnit

Units of volume.

Since

QGIS 3.10

Enumerator
VolumeCubicMeters	Cubic meters.
VolumeCubicFeet	Cubic feet.
VolumeCubicYards	Cubic yards.
VolumeBarrel	Barrels.
VolumeCubicDecimeter	Cubic decimeters.
VolumeLiters	Litres.
VolumeGallonUS	US Gallons.
VolumeCubicInch	Cubic inches.
VolumeCubicCentimeter	Cubic Centimeters.
VolumeCubicDegrees	Cubic degrees, for planar geographic CRS volume measurements.
VolumeUnknownUnit	Unknown volume unit.

Definition at line 113 of file qgsunittypes.h.

Member Function Documentation

areaToDistanceUnit()

QgsUnitTypes::DistanceUnit QgsUnitTypes::areaToDistanceUnit ( QgsUnitTypes::AreaUnit  areaUnit )

static

Converts an area unit to its corresponding distance unit, e.g., square meters to meters.

Parameters

areaUnit

area unit to convert

Returns

matching distance unit

Since

QGIS 3.10

Definition at line 1209 of file qgsunittypes.cpp.

decodeAngleUnit()

QgsUnitTypes::AngleUnit QgsUnitTypes::decodeAngleUnit ( const QString &  string, bool *  ok = nullptr  )

static

Decodes an angular unit from a string.

Parameters

string	string to decode
ok	optional boolean, will be set to true if string was converted successfully

Returns

decoded units

See also

encodeUnit()

Definition at line 1776 of file qgsunittypes.cpp.

decodeAreaUnit()

QgsUnitTypes::AreaUnit QgsUnitTypes::decodeAreaUnit ( const QString &  string, bool *  ok = nullptr  )

static

Decodes an areal unit from a string.

Parameters

string	string to decode
ok	optional boolean, will be set to true if string was converted successfully

Returns

decoded units

See also

encodeUnit()

Definition at line 652 of file qgsunittypes.cpp.

decodeDistanceUnit()

QgsUnitTypes::DistanceUnit QgsUnitTypes::decodeDistanceUnit ( const QString &  string, bool *  ok = nullptr  )

static

Decodes a distance unit from a string.

Parameters

string	string to decode
ok	optional boolean, will be set to true if string was converted successfully

Returns

decoded units

See also

encodeUnit()

Definition at line 160 of file qgsunittypes.cpp.

decodeLayoutUnit()

QgsUnitTypes::LayoutUnit QgsUnitTypes::decodeLayoutUnit ( const QString &  string, bool *  ok = nullptr  )

static

Decodes a layout unit from a string.

Parameters

string	string to decode
ok	optional boolean, will be set to true if string was converted successfully

Returns

decoded units

See also

encodeUnit()

Since

QGIS 3.0

Definition at line 2524 of file qgsunittypes.cpp.

decodeRenderUnit()

QgsUnitTypes::RenderUnit QgsUnitTypes::decodeRenderUnit ( const QString &  string, bool *  ok = nullptr  )

static

Decodes a render unit from a string.

Parameters

string	string to decode
ok	optional boolean, will be set to true if string was converted successfully

Returns

decoded units

See also

encodeUnit()

Definition at line 2429 of file qgsunittypes.cpp.

decodeUnitType()

QgsUnitTypes::UnitType QgsUnitTypes::decodeUnitType ( const QString &  string, bool *  ok = nullptr  )

static

Decodes a unit type from a string.

Parameters

string	string to decode
ok	optional boolean, will be set to true if string was converted successfully

Returns

decoded unit type

See also

encodeUnitType()

Since

QGIS 3.10

Definition at line 46 of file qgsunittypes.cpp.

decodeVolumeUnit()

QgsUnitTypes::VolumeUnit QgsUnitTypes::decodeVolumeUnit ( const QString &  string, bool *  ok = nullptr  )

static

Decodes a volume unit from a string.

Parameters

string	string to decode
ok	optional boolean, will be set to true if string was converted successfully

Returns

decoded units

See also

encodeUnit()

Since

QGIS 3.10

Definition at line 1249 of file qgsunittypes.cpp.

distanceToAreaUnit()

QgsUnitTypes::AreaUnit QgsUnitTypes::distanceToAreaUnit ( QgsUnitTypes::DistanceUnit  distanceUnit )

static

Converts a distance unit to its corresponding area unit, e.g., meters to square meters.

Parameters

distanceUnit

distance unit to convert

Returns

matching areal unit

Definition at line 1171 of file qgsunittypes.cpp.

distanceToVolumeUnit()

QgsUnitTypes::VolumeUnit QgsUnitTypes::distanceToVolumeUnit ( QgsUnitTypes::DistanceUnit  distanceUnit )

static

Converts a distance unit to its corresponding volume unit, e.g., meters to cubic meters.

Parameters

distanceUnit

distance unit to convert

Returns

matching volume unit

Since

QGIS 3.10

Definition at line 1630 of file qgsunittypes.cpp.

encodeUnit() [1/6]

QString QgsUnitTypes::encodeUnit ( QgsUnitTypes::DistanceUnit  unit )

static

Encodes a distance unit to a string.

Parameters

unit	unit to encode

Returns

encoded string

See also

decodeDistanceUnit()

Definition at line 117 of file qgsunittypes.cpp.

encodeUnit() [2/6]

QString QgsUnitTypes::encodeUnit ( QgsUnitTypes::AreaUnit  unit )

static

Encodes an areal unit to a string.

Parameters

unit	unit to encode

Returns

encoded string

See also

decodeAreaUnit()

Definition at line 620 of file qgsunittypes.cpp.

encodeUnit() [3/6]

QString QgsUnitTypes::encodeUnit ( QgsUnitTypes::VolumeUnit  unit )

static

Encodes a volume unit to a string.

Returns

encoded string

See also

decodeVolumeUnit()

Since

QGIS 3.10

Definition at line 1720 of file qgsunittypes.cpp.

encodeUnit() [4/6]

QString QgsUnitTypes::encodeUnit ( QgsUnitTypes::AngleUnit  unit )

static

Encodes an angular unit to a string.

Parameters

unit	unit to encode

Returns

encoded string

See also

decodeAngleUnit()

Definition at line 1750 of file qgsunittypes.cpp.

encodeUnit() [5/6]

QString QgsUnitTypes::encodeUnit ( QgsUnitTypes::RenderUnit  unit )

static

Encodes a render unit to a string.

Parameters

unit	unit to encode

Returns

encoded string

See also

decodeRenderUnit()

Definition at line 2405 of file qgsunittypes.cpp.

encodeUnit() [6/6]

QString QgsUnitTypes::encodeUnit ( QgsUnitTypes::LayoutUnit  unit )

static

Encodes a layout unit to a string.

Parameters

unit	unit to encode

Returns

encoded string

See also

decodeLayoutUnit()

Since

QGIS 3.0

Definition at line 2500 of file qgsunittypes.cpp.

encodeUnitType()

QString QgsUnitTypes::encodeUnitType ( QgsUnitTypes::UnitType  type )

static

Encodes a unit type to a string.

Returns

encoded string

See also

decodeUnitType()

Since

QGIS 3.10

Definition at line 26 of file qgsunittypes.cpp.

formatAngle()

QString QgsUnitTypes::formatAngle ( double  angle, int  decimals, QgsUnitTypes::AngleUnit  unit  )

static

Returns an angle formatted as a friendly string.

Parameters

angle	angle to format
decimals	number of decimal places to show
unit	unit of angle

Returns

formatted angle string

Definition at line 2046 of file qgsunittypes.cpp.

formatArea()

QString QgsUnitTypes::formatArea ( double  area, int  decimals, QgsUnitTypes::AreaUnit  unit, bool  keepBaseUnit = false  )

static

Returns an area formatted as a friendly string.

Parameters

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

Returns

formatted area string

See also

formatDistance()

Since

QGIS 3.0

Definition at line 2393 of file qgsunittypes.cpp.

formatDistance()

QString QgsUnitTypes::formatDistance ( double  distance, int  decimals, QgsUnitTypes::DistanceUnit  unit, bool  keepBaseUnit = false  )

static

Returns an distance formatted as a friendly string.

Parameters

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

Returns

formatted distance string

See also

formatArea()

Since

QGIS 3.0

Definition at line 2381 of file qgsunittypes.cpp.

fromUnitToUnitFactor() [1/4]

double QgsUnitTypes::fromUnitToUnitFactor ( QgsUnitTypes::DistanceUnit  fromUnit, QgsUnitTypes::DistanceUnit  toUnit  )

static

Returns the conversion factor between the specified distance units.

Parameters

fromUnit	distance unit to convert from
toUnit	distance unit to convert to

Returns

multiplication factor to convert between units

Definition at line 347 of file qgsunittypes.cpp.

fromUnitToUnitFactor() [2/4]

double QgsUnitTypes::fromUnitToUnitFactor ( QgsUnitTypes::AreaUnit  fromUnit, QgsUnitTypes::AreaUnit  toUnit  )

static

Returns the conversion factor between the specified areal units.

Parameters

fromUnit	area unit to convert from
toUnit	area unit to convert to

Returns

multiplication factor to convert between units

Definition at line 791 of file qgsunittypes.cpp.

fromUnitToUnitFactor() [3/4]

double QgsUnitTypes::fromUnitToUnitFactor ( QgsUnitTypes::VolumeUnit  fromUnit, QgsUnitTypes::VolumeUnit  toUnit  )

static

Returns the conversion factor between the specified volume units.

Parameters

fromUnit	volume unit to convert from
toUnit	volume unit to convert to

Returns

multiplication factor to convert between units

Since

QGIS 3.10

Definition at line 1383 of file qgsunittypes.cpp.

fromUnitToUnitFactor() [4/4]

double QgsUnitTypes::fromUnitToUnitFactor ( QgsUnitTypes::AngleUnit  fromUnit, QgsUnitTypes::AngleUnit  toUnit  )

static

Returns the conversion factor between the specified angular units.

Parameters

fromUnit	angle unit to convert from
toUnit	angle unit to convert to

Returns

multiplication factor to convert between units

Definition at line 1833 of file qgsunittypes.cpp.

scaledArea()

QgsUnitTypes::AreaValue QgsUnitTypes::scaledArea ( double  area, QgsUnitTypes::AreaUnit  unit, int  decimals, bool  keepBaseUnit = false  )

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).

Since

QGIS 3.0

Definition at line 2195 of file qgsunittypes.cpp.

scaledDistance()

QgsUnitTypes::DistanceValue QgsUnitTypes::scaledDistance ( double  distance, QgsUnitTypes::DistanceUnit  unit, int  decimals, bool  keepBaseUnit = false  )

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).

Since

QGIS 3.0

Definition at line 2084 of file qgsunittypes.cpp.

stringToAreaUnit()

QgsUnitTypes::AreaUnit QgsUnitTypes::stringToAreaUnit ( const QString &  string, bool *  ok = nullptr  )

static

Converts a translated string to an areal unit.

Parameters

string	string representing an areal unit
ok	optional boolean, will be set to true if string was converted successfully

Returns

the area unit

See also

toString()

Definition at line 754 of file qgsunittypes.cpp.

stringToDistanceUnit()

QgsUnitTypes::DistanceUnit QgsUnitTypes::stringToDistanceUnit ( const QString &  string, bool *  ok = nullptr  )

static

Converts a translated string to a distance unit.

Parameters

string	string representing a distance unit
ok	optional boolean, will be set to true if string was converted successfully

Returns

the distance unit

See also

toString()

Definition at line 307 of file qgsunittypes.cpp.

stringToVolumeUnit()

QgsUnitTypes::VolumeUnit QgsUnitTypes::stringToVolumeUnit ( const QString &  string, bool *  ok = nullptr  )

static

Converts a translatedstring to a volume unit.

Parameters

string	string representing a volume unit
ok	optional boolean, will be set to true if string was converted successfully

Returns

the volume unit

See also

toString()

Since

QGIS 3.10

Definition at line 1346 of file qgsunittypes.cpp.

toAbbreviatedString() [1/5]

QString QgsUnitTypes::toAbbreviatedString ( QgsUnitTypes::DistanceUnit  unit )

static

Returns a translated abbreviation representing a distance unit.

Parameters

unit	unit to convert to string

See also

stringToDistanceUnit()

Since

QGIS 3.0

Definition at line 264 of file qgsunittypes.cpp.

toAbbreviatedString() [2/5]

QString QgsUnitTypes::toAbbreviatedString ( QgsUnitTypes::AreaUnit  unit )

static

Returns a translated abbreviation representing an areal unit.

Parameters

unit	unit to convert to string

See also

stringToAreaUnit()

Since

QGIS 3.0

Definition at line 722 of file qgsunittypes.cpp.

toAbbreviatedString() [3/5]

QString QgsUnitTypes::toAbbreviatedString ( QgsUnitTypes::VolumeUnit  unit )

static

Returns a translated abbreviation representing a volume unit.

See also

stringToVolumeUnit()

Since

QGIS 3.10

Definition at line 1315 of file qgsunittypes.cpp.

toAbbreviatedString() [4/5]

QString QgsUnitTypes::toAbbreviatedString ( QgsUnitTypes::RenderUnit  unit )

static

Returns a translated abbreviation representing a render unit.

Parameters

unit	unit to convert to string

Since

QGIS 3.8

Definition at line 231 of file qgsunittypes.cpp.

toAbbreviatedString() [5/5]

QString QgsUnitTypes::toAbbreviatedString ( QgsUnitTypes::LayoutUnit  unit )

static

Returns a translated abbreviation representing a layout unit (e.g.

"mm").

Since

QGIS 3.0

Definition at line 2575 of file qgsunittypes.cpp.

toString() [1/6]

QString QgsUnitTypes::toString ( QgsUnitTypes::DistanceUnit  unit )

static

Returns a translated string representing a distance unit.

Parameters

unit	unit to convert to string

See also

stringToDistanceUnit()

Definition at line 194 of file qgsunittypes.cpp.

toString() [2/6]

QString QgsUnitTypes::toString ( QgsUnitTypes::AreaUnit  unit )

static

Returns a translated string representing an areal unit.

Parameters

unit	unit to convert to string

See also

stringToAreaUnit()

Definition at line 690 of file qgsunittypes.cpp.

toString() [3/6]

QString QgsUnitTypes::toString ( QgsUnitTypes::VolumeUnit  unit )

static

Returns a translated string representing a volume unit.

See also

stringToVolumeUnit()

Since

QGIS 3.10

Definition at line 1285 of file qgsunittypes.cpp.

toString() [4/6]

QString QgsUnitTypes::toString ( QgsUnitTypes::AngleUnit  unit )

static

Returns a translated string representing an angular unit.

Parameters

unit	unit to convert to string

Definition at line 1807 of file qgsunittypes.cpp.

toString() [5/6]

QString QgsUnitTypes::toString ( QgsUnitTypes::RenderUnit  unit )

static

Returns a translated string representing a render unit.

Since

QGIS 3.0

Definition at line 2466 of file qgsunittypes.cpp.

toString() [6/6]

QString QgsUnitTypes::toString ( QgsUnitTypes::LayoutUnit  unit )

static

Returns a translated string representing a layout unit.

Since

QGIS 3.0

Definition at line 2599 of file qgsunittypes.cpp.

unitType() [1/4]

QgsUnitTypes::DistanceUnitType QgsUnitTypes::unitType ( QgsUnitTypes::DistanceUnit  unit )

static

Returns the type for a distance unit.

Definition at line 68 of file qgsunittypes.cpp.

unitType() [2/4]

QgsUnitTypes::DistanceUnitType QgsUnitTypes::unitType ( QgsUnitTypes::AreaUnit  unit )

static

Returns the type for an areal unit.

Definition at line 91 of file qgsunittypes.cpp.

unitType() [3/4]

QgsUnitTypes::DistanceUnitType QgsUnitTypes::unitType ( QgsUnitTypes::VolumeUnit  unit )

static

Returns the type for an volume unit.

Since

QGIS 3.10

Definition at line 1698 of file qgsunittypes.cpp.

unitType() [4/4]

QgsUnitTypes::LayoutUnitType QgsUnitTypes::unitType ( QgsUnitTypes::LayoutUnit  units )

static

Returns the type for a unit of measurement.

Since

QGIS 3.0

Definition at line 2555 of file qgsunittypes.cpp.

volumeToDistanceUnit()

QgsUnitTypes::DistanceUnit QgsUnitTypes::volumeToDistanceUnit ( QgsUnitTypes::VolumeUnit  volumeUnit )

static

Converts a volume unit to its corresponding distance unit, e.g., cubic meters to meters.

Parameters

volumeUnit

volume unit to convert

Returns

matching distance unit

Since

QGIS 3.10

Definition at line 1668 of file qgsunittypes.cpp.

---

The documentation for this class was generated from the following files:

• /build/qgis-3.10.0+15buster/src/core/qgsunittypes.h
• /build/qgis-3.10.0+15buster/src/core/qgsunittypes.cpp