Cartographic (PROJ4) projection class. More...

#include <Inventor/projection/SbProj4Projection.h>

Inheritance diagram for SbProj4Projection:

Public Types
enum	CoordinateSystem { GEOCENTRIC = 0 , GEODETIC , NUM_COORDINATE_SYSTEMS }
	Available coordinate systems. More...

enum	PredefinedEllipsoid { SPHERE = 0 , AIRY , AIRYM , ANDRAE , APL , AUST_SA , BESSEL , BESS_NAM , CLRK66 , CLRK80 , CPM , DELMBR , ENGELIS , EVRST30 , EVRST48 , EVRST56 , EVRST69 , EVRSTSS , FSCHR60 , FSCHR60M , FSCHR68 , GRS67 , GRS80 , HELMERT , HOUGH , IAU76 , INTL , KAULA , KRASS , LERCH , MERIT , MPRTS , NEW_INTL , NWL9D , PLESSIS , SE_ASIA , SGS85 , WALBECK , WGS60 , WGS66 , WGS72 , WGS84 , NUM_ELLIPSOIDS }
	Available ellipsoids. More...

enum	Projection { CASSINI , EQUAL_AREA_CYLINDRICAL , COLLIGNON , CRASTER_PARABOLIC , ECKERT_I , ECKERT_II , ECKERT_III , ECKERT_IV , ECKERT_V , ECKERT_VI , EQUIDISTANT_CYLINDRICAL , FAHEY , FOUCAUT_SINUSOIDAL , GALL , GEOCENTRIC_PROJ , HATANO_ASYMMETRICAL_EQUAL_AREA , KAVRAISKY_VII , KROVAK , LAMBERT_AZIMUTHAL_EQUAL_AREA , LAT_LONG , LONG_LAT , LAMBERT_EQUAL_AREA_CONIC , LOXIMUTHAL , MCBRYDE_THOMAS_FLAT_POLE_SINE , MCBRYDE_THOMAS_FLAT_POLAR_PARABOLIC , MCBRYDE_THOMAS_FLAT_POLAR_QUARTIC , MCBRYDE_THOMAS_FLAT_POLAR_SINUSOIDAL , MERCATOR , MILLER_CYLINDRICAL , MOLLWEIDE , NELL , NELL_HAMMER , OBLIQUE_CYLINDRICAL_EQUAL_AREA , POLYCONIC , PUTNINS_P1 , PUTNINS_P2 , PUTNINS_P3_2 , PUTNINS_P4_2 , PUTNINS_P5 , PUTNINS_P5_2 , PUTNINS_P6 , PUTNINS_P6_2 , ROBINSON , SINUSOIDAL , SWISS_OBL_MERCATOR , OBLIQUE_STEREOGRAPHIC_ALTERNATIVE , TRANSVERSE_CYLINDRICAL_EQUAL_AREA , TRANSVERSE_MERCATOR , UNIVERSAL_POLAR_STEREOGRAPHIC , UNIVERSAL_TRANSVERSE_MERCATOR , VAN_DER_GRINTEN_I , WAGNER_I , WAGNER_II , WAGNER_III , WAGNER_IV , WAGNER_V , WAGNER_VI , WERENSKIOLD_I , WINKEL_I , WINKEL_TRIPEL , NUM_PROJ4_PROJECTIONS }
	Available projections. More...

Public Member Functions
	SbProj4Projection ()
	Constructor.

	SbProj4Projection (SoProjection *node)
	Constructor.

	SbProj4Projection (const SbProj4Projection &proj)
	Copy constructor.

virtual	~SbProj4Projection ()
	Destructor.

void	setEllipsoid (SbProj4Projection::PredefinedEllipsoid ellipsoid)
	Set current ellipsoid.

SbProj4Projection::PredefinedEllipsoid	getEllipsoid ()
	Get current ellipsoid.

void	setEllipsoidIn (SbProj4Projection::PredefinedEllipsoid ellipsoid)
	Set current input ellipsoid.

SbProj4Projection::PredefinedEllipsoid	getEllipsoidIn ()
	Get current input ellipsoid.

void	setCoordinateSystem (SbProj4Projection::CoordinateSystem coordinateSystem)
	Set current coordinate system.

SbProj4Projection::CoordinateSystem	getCoordinateSystem ()
	Get current coordinate system.

void	setProjection (SbProj4Projection::Projection proj)
	Set current projection.

SbProj4Projection::Projection	getProjection ()
	Get current projection .

void	setProjectionIn (SbProj4Projection::Projection proj)
	Set current input projection.

SbProj4Projection::Projection	getProjectionIn ()
	Get current input projection .

void	setUTMZone (int zone)
	Set current UTM zone.

int	getUTMZone ()
	Get current UTM zone.

void	setUTMSouth (bool south)
	Set m_south (UTM)

bool	isUTMSouth ()
	Get m_south (UTM)

void	setRevertCoord (bool revertCoordNeeded)
	Set revertCoordNeeded.

bool	isRevertCoordNeeded ()
	Get revertCoordNeeded.

virtual void	init ()
	Initialisation.

virtual void	exit ()
	Exit function.

virtual void	inverse (SbVec3f &point)
	Inverse projection of one point.

void	toGeodetic (SbVec3f &point)
	Transform the given coordinates from Geocentric coordinate system to Geodetic coordinate system .

void	toGeocentric (SbVec3f &point)
	Transform the given coordinates from Geodetic coordinate system to Geocentric coordinate system .

Public Member Functions inherited from SbProjection
	SbProjection ()
	Constructor.

	SbProjection (SoProjection *node)
	Constructor.

	SbProjection (const SbProjection &proj)
	Copy constructor.

virtual	~SbProjection ()
	Destructor.

virtual bool	getProjectedBoundingBox (SbBox3f &bbox)
	Return projected bounding box if available.

void	project (SbVec3f &point)
	Apply the complete computation (matrix, pre-projection, projection, post-projection) to one point.

void	project (int numPoints, float *points)
	Apply the complete computation to a set of points.

void	project (int32_t numCoords, const SbVec3f coords, SbVec3f projectedCoords)
	Apply the complete computation to a set of coordinates.

SoProjection *	getProjectionNode () const
	Return associated projection node.

virtual void	setParameter (int parameterId, const SbString &parameterString)
	Set string parameter.

virtual void	setParameter (int parameterId, const float &parameterFloat)
	Set float parameter.

void	setNumStringParameters (int numParameters)
	Set number of string parameters to use.

void	setNumFloatParameters (int numParameters)
	Set number of float parameters to use.

int	getNumStringParameters () const
	Get number of used string parameters.

int	getNumFloatParameters () const
	Get number of used float parameters.

SbBool	getParameter (int pos, SbString &parameter) const
	Get string parameter at position pos.

SbBool	getParameter (int pos, float &parameter) const
	Get float parameter at position pos.

Static Public Member Functions
static SbString	getEllipsoidString (SbProj4Projection::PredefinedEllipsoid ellipsoid)
	Get PROJ.4 ellipsoid string.

static SbString	getProjectionString (SbProj4Projection::Projection proj)
	Get internal PROJ.4 projection string.

static SbString	getProjectionName (SbProj4Projection::Projection proj)
	Get projection name description.

Detailed Description

Cartographic (PROJ4) projection class.

This class performs a cartographic projection using the PROJ.4 Cartographic Projections Library ( see http://proj.maptools.org/ )

To use this class as a projection, refer to the documentation of SbProjection class.

By default, input points must be defined in the geodetic coordinate system :

x coordinate : longitudes degrees from -180 to 180
y coordinate : latitudes degrees from -90 to 90
z coordinate : meters

It is possible to define the input data in the geocentric coordinate system by calling setCoordinateSystem(GEOCENTRIC). The geocentric coordinate system is the earth coordinate system, where x, y and z coordinate are expressed in meters.

The PROJ.4 library parameters are stored as SbProjection string parameters:

parameter 0 : projection name
parameter 1 : ellipsoid
parameter 2 : units
parameter 3 : longitude zero

The first SbProjection float parameter is used to specify the z coordinate scaleRatio applied to the projected shapes.

The enumeration PredefinedEllipsoid defines the list of available ellipsoid. An ellispoid definition is a mathematical representation used to approximate the earth when computing projections. Calling setEllipsoid() sets the current ellipsoid used to compute projections.

Only projections with an inverse function defined are available.

The available projections are defined with the Projection enumeration. When using an SbProj4Projection object with an SoProjection node, those projections are automatically added in the order above, and you can choose the desired projection by using the corresponding id (refer to SoProjection node).

LIMITATIONS

It can happen that vertices of a projected shape cross other ones, depending on the chosen projection. Visually it results in a flipping effect.

Member Enumeration Documentation

◆ CoordinateSystem

enum SbProj4Projection::CoordinateSystem

Available coordinate systems.

Enumerator
GEOCENTRIC
GEODETIC
NUM_COORDINATE_SYSTEMS

Definition at line 105 of file SbProj4Projection.h.

◆ PredefinedEllipsoid

enum SbProj4Projection::PredefinedEllipsoid

Available ellipsoids.

Enumerator
SPHERE
AIRY
AIRYM
ANDRAE
APL
AUST_SA
BESSEL
BESS_NAM
CLRK66
CLRK80
CPM
DELMBR
ENGELIS
EVRST30
EVRST48
EVRST56
EVRST69
EVRSTSS
FSCHR60
FSCHR60M
FSCHR68
GRS67
GRS80
HELMERT
HOUGH
IAU76
INTL
KAULA
KRASS
LERCH
MERIT
MPRTS
NEW_INTL
NWL9D
PLESSIS
SE_ASIA
SGS85
WALBECK
WGS60
WGS66
WGS72
WGS84
NUM_ELLIPSOIDS

Definition at line 115 of file SbProj4Projection.h.

◆ Projection

enum SbProj4Projection::Projection

Available projections.

Enumerator
CASSINI
EQUAL_AREA_CYLINDRICAL
COLLIGNON
CRASTER_PARABOLIC
ECKERT_I
ECKERT_II
ECKERT_III
ECKERT_IV
ECKERT_V
ECKERT_VI
EQUIDISTANT_CYLINDRICAL
FAHEY
FOUCAUT_SINUSOIDAL
GALL
GEOCENTRIC_PROJ
HATANO_ASYMMETRICAL_EQUAL_AREA
KAVRAISKY_VII
KROVAK
LAMBERT_AZIMUTHAL_EQUAL_AREA
LAT_LONG
LONG_LAT
LAMBERT_EQUAL_AREA_CONIC
LOXIMUTHAL
MCBRYDE_THOMAS_FLAT_POLE_SINE
MCBRYDE_THOMAS_FLAT_POLAR_PARABOLIC
MCBRYDE_THOMAS_FLAT_POLAR_QUARTIC
MCBRYDE_THOMAS_FLAT_POLAR_SINUSOIDAL
MERCATOR
MILLER_CYLINDRICAL
MOLLWEIDE
NELL
NELL_HAMMER
OBLIQUE_CYLINDRICAL_EQUAL_AREA
POLYCONIC
PUTNINS_P1
PUTNINS_P2
PUTNINS_P3_2
PUTNINS_P4_2
PUTNINS_P5
PUTNINS_P5_2
PUTNINS_P6
PUTNINS_P6_2
ROBINSON
SINUSOIDAL
SWISS_OBL_MERCATOR
OBLIQUE_STEREOGRAPHIC_ALTERNATIVE
TRANSVERSE_CYLINDRICAL_EQUAL_AREA
TRANSVERSE_MERCATOR
UNIVERSAL_POLAR_STEREOGRAPHIC
UNIVERSAL_TRANSVERSE_MERCATOR
VAN_DER_GRINTEN_I
WAGNER_I
WAGNER_II
WAGNER_III
WAGNER_IV
WAGNER_V
WAGNER_VI
WERENSKIOLD_I
WINKEL_I
WINKEL_TRIPEL
NUM_PROJ4_PROJECTIONS

Definition at line 165 of file SbProj4Projection.h.

Constructor & Destructor Documentation

◆ SbProj4Projection() [1/3]

SbProj4Projection::SbProj4Projection ( )

Constructor.

◆ SbProj4Projection() [2/3]

SbProj4Projection::SbProj4Projection ( SoProjection * node )

Constructor.

◆ SbProj4Projection() [3/3]

SbProj4Projection::SbProj4Projection ( const SbProj4Projection & proj )

Copy constructor.

◆ ~SbProj4Projection()

virtual SbProj4Projection::~SbProj4Projection ( )

virtual

Destructor.

Member Function Documentation

◆ exit()

virtual void SbProj4Projection::exit ( )

virtual

Exit function.

Reimplemented from SbProjection.

◆ getCoordinateSystem()

SbProj4Projection::CoordinateSystem SbProj4Projection::getCoordinateSystem ( )

Get current coordinate system.

◆ getEllipsoid()

SbProj4Projection::PredefinedEllipsoid SbProj4Projection::getEllipsoid ( )

Get current ellipsoid.

◆ getEllipsoidIn()

SbProj4Projection::PredefinedEllipsoid SbProj4Projection::getEllipsoidIn ( )

Get current input ellipsoid.

◆ getEllipsoidString()

static SbString SbProj4Projection::getEllipsoidString ( SbProj4Projection::PredefinedEllipsoid ellipsoid )

static

Get PROJ.4 ellipsoid string.

◆ getProjection()

SbProj4Projection::Projection SbProj4Projection::getProjection ( )

Get current projection .

◆ getProjectionIn()

SbProj4Projection::Projection SbProj4Projection::getProjectionIn ( )

Get current input projection .

◆ getProjectionName()

static SbString SbProj4Projection::getProjectionName ( SbProj4Projection::Projection proj )

static

Get projection name description.

◆ getProjectionString()

static SbString SbProj4Projection::getProjectionString ( SbProj4Projection::Projection proj )

static

Get internal PROJ.4 projection string.

◆ getUTMZone()

int SbProj4Projection::getUTMZone ( )

Get current UTM zone.

◆ init()

virtual void SbProj4Projection::init ( )

virtual

Initialisation.

Reimplemented from SbProjection.

◆ inverse()

virtual void SbProj4Projection::inverse ( SbVec3f & point )

virtual

Inverse projection of one point.

Reimplemented from SbProjection.

◆ isRevertCoordNeeded()

bool SbProj4Projection::isRevertCoordNeeded ( )

inline

Get revertCoordNeeded.

Definition at line 333 of file SbProj4Projection.h.

◆ isUTMSouth()

bool SbProj4Projection::isUTMSouth ( )

Get m_south (UTM)

◆ setCoordinateSystem()

void SbProj4Projection::setCoordinateSystem ( SbProj4Projection::CoordinateSystem coordinateSystem )

Set current coordinate system.

◆ setEllipsoid()

void SbProj4Projection::setEllipsoid ( SbProj4Projection::PredefinedEllipsoid ellipsoid )

Set current ellipsoid.

◆ setEllipsoidIn()

void SbProj4Projection::setEllipsoidIn ( SbProj4Projection::PredefinedEllipsoid ellipsoid )

Set current input ellipsoid.

◆ setProjection()

void SbProj4Projection::setProjection ( SbProj4Projection::Projection proj )

Set current projection.

◆ setProjectionIn()

void SbProj4Projection::setProjectionIn ( SbProj4Projection::Projection proj )

Set current input projection.

◆ setRevertCoord()

void SbProj4Projection::setRevertCoord ( bool revertCoordNeeded )

inline

Set revertCoordNeeded.

Definition at line 328 of file SbProj4Projection.h.

◆ setUTMSouth()

void SbProj4Projection::setUTMSouth ( bool south )

Set m_south (UTM)

◆ setUTMZone()

void SbProj4Projection::setUTMZone ( int zone )

Set current UTM zone.

◆ toGeocentric()

void SbProj4Projection::toGeocentric ( SbVec3f & point )

Transform the given coordinates from Geodetic coordinate system to Geocentric coordinate system .

◆ toGeodetic()

void SbProj4Projection::toGeodetic ( SbVec3f & point )

Transform the given coordinates from Geocentric coordinate system to Geodetic coordinate system .

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

Inventor/projection/SbProj4Projection.h

Open Inventor Release 2024.2.0

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

SEE ALSO

Member Enumeration Documentation

◆ CoordinateSystem

◆ PredefinedEllipsoid

◆ Projection

Constructor & Destructor Documentation

◆ SbProj4Projection() [1/3]

◆ SbProj4Projection() [2/3]

◆ SbProj4Projection() [3/3]

◆ ~SbProj4Projection()

Member Function Documentation

◆ exit()

◆ getCoordinateSystem()

◆ getEllipsoid()

◆ getEllipsoidIn()

◆ getEllipsoidString()

◆ getProjection()

◆ getProjectionIn()

◆ getProjectionName()

◆ getProjectionString()

◆ getUTMZone()

◆ init()

◆ inverse()

◆ isRevertCoordNeeded()

◆ isUTMSouth()

◆ setCoordinateSystem()

◆ setEllipsoid()

◆ setEllipsoidIn()

◆ setProjection()

◆ setProjectionIn()

◆ setRevertCoord()

◆ setUTMSouth()

◆ setUTMZone()

◆ toGeocentric()

◆ toGeodetic()