QgsCoordinateReferenceSystemRegistry Class Reference

A registry for known coordinate reference system (CRS) definitions, including any user-defined CRSes. More...

#include <qgscoordinatereferencesystemregistry.h>

Inheritance diagram for QgsCoordinateReferenceSystemRegistry:

Classes
class	UserCrsDetails
	Contains details of a custom (user defined) CRS. More...

Signals
void	crsDefinitionsChanged ()
	Emitted whenever an operation has caused any of the known CRS definitions (including user-defined CRS) to change. More...
void	userCrsAdded (const QString &id)
	Emitted whenever a new user CRS definition is added. More...
void	userCrsChanged (const QString &id)
	Emitted whenever an existing user CRS definition is changed. More...
void	userCrsRemoved (long id)
	Emitted when the user CRS with matching id is removed from the database. More...

Public Member Functions
	QgsCoordinateReferenceSystemRegistry (QObject *parent=nullptr)
	Constructor for QgsCoordinateReferenceSystemRegistry, with the specified parent object. More...
long	addUserCrs (const QgsCoordinateReferenceSystem &crs, const QString &name, QgsCoordinateReferenceSystem::Format nativeFormat=QgsCoordinateReferenceSystem::FormatWkt)
	Adds a new crs definition as a custom ("USER") CRS. More...
bool	removeUserCrs (long id)
	Removes the existing user CRS with matching id. More...
bool	updateUserCrs (long id, const QgsCoordinateReferenceSystem &crs, const QString &name, QgsCoordinateReferenceSystem::Format nativeFormat=QgsCoordinateReferenceSystem::FormatWkt)
	Updates the definition of the existing user CRS with matching id. More...
QList< QgsCoordinateReferenceSystemRegistry::UserCrsDetails >	userCrsList () const
	Returns a list containing the details of all registered custom (user-defined) CRSes. More...

Detailed Description

A registry for known coordinate reference system (CRS) definitions, including any user-defined CRSes.

QgsCoordinateReferenceSystemRegistry is not usually directly created, but rather accessed through QgsApplication::coordinateReferenceSystemRegistry().

Since

QGIS 3.18

Definition at line 35 of file qgscoordinatereferencesystemregistry.h.

Constructor & Destructor Documentation

QgsCoordinateReferenceSystemRegistry()

QgsCoordinateReferenceSystemRegistry::QgsCoordinateReferenceSystemRegistry ( QObject *  parent = nullptr )

explicit

Constructor for QgsCoordinateReferenceSystemRegistry, with the specified parent object.

Definition at line 28 of file qgscoordinatereferencesystemregistry.cpp.

Member Function Documentation

addUserCrs()

long QgsCoordinateReferenceSystemRegistry::addUserCrs	(	const QgsCoordinateReferenceSystem &	crs,
		const QString &	name,
		QgsCoordinateReferenceSystem::Format	nativeFormat = QgsCoordinateReferenceSystem::FormatWkt
	)

Adds a new crs definition as a custom ("USER") CRS.

Returns the new CRS srsid(), or -1 if the CRS could not be saved.

The nativeFormat argument specifies the format to use when saving the CRS definition. FormatWkt is recommended as it is a lossless format.

Warning

Not all CRS definitions can be represented as a Proj string, so take care when using the FormatProj option.

See also

updateUserCrs()

userCrsAdded()

Definition at line 73 of file qgscoordinatereferencesystemregistry.cpp.

crsDefinitionsChanged

void QgsCoordinateReferenceSystemRegistry::crsDefinitionsChanged ( )

signal

Emitted whenever an operation has caused any of the known CRS definitions (including user-defined CRS) to change.

removeUserCrs()

bool QgsCoordinateReferenceSystemRegistry::removeUserCrs

(

long

id

)

Removes the existing user CRS with matching id.

Returns false if the CRS could not be removed.

See also

userCrsRemoved()

Definition at line 235 of file qgscoordinatereferencesystemregistry.cpp.

updateUserCrs()

bool QgsCoordinateReferenceSystemRegistry::updateUserCrs	(	long	id,
		const QgsCoordinateReferenceSystem &	crs,
		const QString &	name,
		QgsCoordinateReferenceSystem::Format	nativeFormat = QgsCoordinateReferenceSystem::FormatWkt
	)

Updates the definition of the existing user CRS with matching id.

The crs argument specifies a CRS with the desired new definition.

Returns false if the new CRS definition could not be saved.

The nativeFormat argument specifies the format to use when saving the CRS definition. FormatWkt is recommended as it is a lossless format.

Warning

Not all CRS definitions can be represented as a Proj string, so take care when using the FormatProj option.

See also

addUserCrs()

userCrsChanged()

Definition at line 165 of file qgscoordinatereferencesystemregistry.cpp.

userCrsAdded

void QgsCoordinateReferenceSystemRegistry::userCrsAdded ( const QString &  id )

signal

Emitted whenever a new user CRS definition is added.

The id argument specifies the ID of the user CRS which has been changed.

See also

userCrsChanged()

crsDefinitionsChanged()

userCrsChanged

void QgsCoordinateReferenceSystemRegistry::userCrsChanged ( const QString &  id )

signal

Emitted whenever an existing user CRS definition is changed.

The id argument specifies the ID of the user CRS which has been changed.

Objects which store QgsCoordinateReferenceSystem members should connect to this signal and update any stored CRS definitions to ensure that they always use the current definition of any user defined CRSes.

See also

crsDefinitionsChanged()

userCrsAdded()

userCrsList()

QList< QgsCoordinateReferenceSystemRegistry::UserCrsDetails > QgsCoordinateReferenceSystemRegistry::userCrsList

(

)

const

Returns a list containing the details of all registered custom (user-defined) CRSes.

Definition at line 34 of file qgscoordinatereferencesystemregistry.cpp.

userCrsRemoved

void QgsCoordinateReferenceSystemRegistry::userCrsRemoved ( long  id )

signal

Emitted when the user CRS with matching id is removed from the database.

See also

removeUserCrs()

---

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

• /build/qgis-3.18.1+99unstable/src/core/qgscoordinatereferencesystemregistry.h
• /build/qgis-3.18.1+99unstable/src/core/qgscoordinatereferencesystemregistry.cpp