OrthographicProjection Class

Represents the orthographic map projection (the Earth seen from outer space).

Syntax

public class OrthographicProjection : Projection

Remarks

The orthographic map projection gives a perspective 2D image of the Earth, using parallel rays. In other words, the observer is very far away, so he can see exactly one hemisphere.

If you want to display a globe, it is nearly always much better to use a true 3D presentation based on a GlobeView than to use an orthographic map projection in a 2D map. However, the implementation of the orthographic map projection predates the GlobeView, and the projection can be used to simulate a spinning globe in a 2D map. This is done with a special built-in behavior of StandardTool: if this tool is used for panning with an orthographic View.Crs, and if StandardTool.UpdateMode = Live, then the tool will implement panning in a non-standard way that simulates a spinning globe in 2D. Technically, the View.Crs is replaced by a similar one where the orthographic projection parameters have been modified.

If you try this in Carmenta Explorer, note that you can switch between the two tool update modes via the drop-down menu of the "Standard Tool 2D" button, where you can check or uncheck "Use bitmap pan and zoom".

The continuous spinning requires the View to change its Crs at every mouse move during the panning operation, which is inefficient since caches have to be flushed. So, it may be best to avoid using a TileLayer, since its advantages disappear when the caches are flushed often.

The only advantage of the orthographic projection is its striking three-dimensional appearance in 2D. It not useful for cartometry, since it is neither conformal, nor equal area, nor anything else that is useful.

If you need to display one particular hemisphere in 2D - for a map of the Pacific Ocean, for example - it may be better to use the stereographic, or the azimuthal equidistant, or the Lambert azimuthal equal-area projection instead.

Inheritance Hierarchy

System.Object (not available in C#)
  EngineObject
    ResourceObject
      Projection
        OrthographicProjection

Platforms

Windows, Linux, Android

OrthographicProjection Members

The OrthographicProjection type has the following members.

Constructors

Name	Description
OrthographicProjection	Initializes a new instance of the OrthographicProjection class from parameters.

Properties

Name	Description
Authority	Gets the name of an authority, which is often "epsg". Inherited from Projection
AuthorityCode	Gets the unique code for the projection instance, according to the Authority, for example "19883". Inherited from Projection
CentralLatitude	Gets the central latitude, also known as latitude of origin.
CentralLongitude	Gets the central longitude, also known as central meridian or longitude of origin.
FalseEasting	Gets the offset added to the projected x coordinates (the eastings).
FalseNorthing	Gets the offset added to the projected y coordinates (the northings).
IsDisposed	Gets a value that tells whether the current OrthographicProjection has been disposed. Inherited from EngineObject
LengthUnit	Gets the length unit of the projected coordinates.
LongLat	Gets a pre-defined LongLatProjection instance. Inherited from Projection
Name	Gets or sets the name of the OrthographicProjection. Inherited from ResourceObject
NativeHandle	Gets the native Carmenta Engine kernel object the current OrthographicProjection represents. Inherited from EngineObject
IUserProperties.UserProperties	Gets the AttributeSet that contains the user properties. Inherited from IUserProperties

Methods

Name	Description
Clone	Creates a copy of an object. Inherited from EngineObject
Dispose	Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject
Equals	Determines whether this instance is equal to another. Inherited from EngineObject
Set	Modifies the calling OrthographicProjection, giving it a new geographic center.
Utm	Returns one of the 120 predefined instances of Universal Transverse Mercator. Inherited from Projection

OrthographicProjection Class

Represents the orthographic map projection (the Earth seen from outer space).

Syntax

C++

class OrthographicProjection : public Projection

C++ Smart Pointer Declaration

typedef Ptr<OrthographicProjection> OrthographicProjectionPtr;

Remarks

The orthographic map projection gives a perspective 2D image of the Earth, using parallel rays. In other words, the observer is very far away, so he can see exactly one hemisphere.

If you want to display a globe, it is nearly always much better to use a true 3D presentation based on a GlobeView than to use an orthographic map projection in a 2D map. However, the implementation of the orthographic map projection predates the GlobeView, and the projection can be used to simulate a spinning globe in a 2D map. This is done with a special built-in behavior of StandardTool: if this tool is used for panning with an orthographic View::crs, and if StandardTool::updateMode = Live, then the tool will implement panning in a non-standard way that simulates a spinning globe in 2D. Technically, the View::crs is replaced by a similar one where the orthographic projection parameters have been modified.

Inheritance Hierarchy

EngineObject
  ResourceObject
    Projection
      OrthographicProjection

Platforms

Windows, Linux, Android

OrthographicProjection Members

The OrthographicProjection type has the following members.

Constructors

Name	Description
OrthographicProjection	Initializes a new instance of the OrthographicProjection class from parameters.

Properties

Name	Description
authority	Gets the name of an authority, which is often "epsg". Inherited from Projection
authorityCode	Gets the unique code for the projection instance, according to the authority, for example "19883". Inherited from Projection
centralLatitude	Gets the central latitude, also known as latitude of origin.
centralLongitude	Gets the central longitude, also known as central meridian or longitude of origin.
falseEasting	Gets the offset added to the projected x coordinates (the eastings).
falseNorthing	Gets the offset added to the projected y coordinates (the northings).
lengthUnit	Gets the length unit of the projected coordinates.
longLat	Gets a pre-defined LongLatProjection instance. Inherited from Projection
name	Gets or sets the name of the OrthographicProjection. Inherited from ResourceObject
IUserProperties::userProperties	Gets the AttributeSet that contains the user properties. Inherited from IUserProperties

Methods

Name	Description
clone	Creates a copy of an object. Inherited from EngineObject
equals	Determines whether this instance is equal to another. Inherited from EngineObject
set	Modifies the calling OrthographicProjection, giving it a new geographic center.
utm	Returns one of the 120 predefined instances of Universal Transverse Mercator. Inherited from Projection

OrthographicProjection Class

Represents the orthographic map projection (the Earth seen from outer space).

Syntax

Java

public class OrthographicProjection extends Projection

Remarks

The orthographic map projection gives a perspective 2D image of the Earth, using parallel rays. In other words, the observer is very far away, so he can see exactly one hemisphere.

If you want to display a globe, it is nearly always much better to use a true 3D presentation based on a GlobeView than to use an orthographic map projection in a 2D map. However, the implementation of the orthographic map projection predates the GlobeView, and the projection can be used to simulate a spinning globe in a 2D map. This is done with a special built-in behavior of StandardTool: if this tool is used for panning with an orthographic View.crs, and if StandardTool.updateMode = Live, then the tool will implement panning in a non-standard way that simulates a spinning globe in 2D. Technically, the View.crs is replaced by a similar one where the orthographic projection parameters have been modified.

Inheritance Hierarchy

System::Object (not available in Java)
  EngineObject
    ResourceObject
      Projection
        OrthographicProjection

Platforms

Windows, Linux, Android

OrthographicProjection Members

The OrthographicProjection type has the following members.

Constructors

Name	Description
OrthographicProjection	Initializes a new instance of the OrthographicProjection class from parameters.

Properties

Name	Description
authority	Gets the name of an authority, which is often "epsg". Inherited from Projection
authorityCode	Gets the unique code for the projection instance, according to the authority, for example "19883". Inherited from Projection
centralLatitude	Gets the central latitude, also known as latitude of origin.
centralLongitude	Gets the central longitude, also known as central meridian or longitude of origin.
falseEasting	Gets the offset added to the projected x coordinates (the eastings).
falseNorthing	Gets the offset added to the projected y coordinates (the northings).
isDisposed	Gets a value that tells whether the current OrthographicProjection has been disposed. Inherited from EngineObject
lengthUnit	Gets the length unit of the projected coordinates.
longLat	Gets a pre-defined LongLatProjection instance. Inherited from Projection
name	Gets or sets the name of the OrthographicProjection. Inherited from ResourceObject
IUserProperties.userProperties	Gets the AttributeSet that contains the user properties. Inherited from IUserProperties

Methods

Name	Description
clone	Creates a copy of an object. Inherited from EngineObject
dispose	Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject
equals	Determines whether this instance is equal to another. Inherited from EngineObject
set	Modifies the calling OrthographicProjection, giving it a new geographic center.
utm	Returns one of the 120 predefined instances of Universal Transverse Mercator. Inherited from Projection

OrthographicProjection Class

Represents the orthographic map projection (the Earth seen from outer space).

Syntax

Python

class OrthographicProjection ( Projection )

Remarks

The orthographic map projection gives a perspective 2D image of the Earth, using parallel rays. In other words, the observer is very far away, so he can see exactly one hemisphere.

If you want to display a globe, it is nearly always much better to use a true 3D presentation based on a GlobeView than to use an orthographic map projection in a 2D map. However, the implementation of the orthographic map projection predates the GlobeView, and the projection can be used to simulate a spinning globe in a 2D map. This is done with a special built-in behavior of StandardTool (not available in Python): if this tool is used for panning with an orthographic View.crs, and if StandardTool.updateMode (not available in Python) = Live, then the tool will implement panning in a non-standard way that simulates a spinning globe in 2D. Technically, the View.crs is replaced by a similar one where the orthographic projection parameters have been modified.

Inheritance Hierarchy

EngineObject
  ResourceObject
    Projection
      OrthographicProjection

Platforms

Windows, Linux, Android

OrthographicProjection Members

The OrthographicProjection type has the following members.

Constructors

Name	Description
OrthographicProjection	Initializes a new instance of the OrthographicProjection class from parameters.

Properties

Name	Description
authority	Gets the name of an authority, which is often "epsg". Inherited from Projection
authorityCode	Gets the unique code for the projection instance, according to the authority, for example "19883". Inherited from Projection
centralLatitude	Gets the central latitude, also known as latitude of origin.
centralLongitude	Gets the central longitude, also known as central meridian or longitude of origin.
falseEasting	Gets the offset added to the projected x coordinates (the eastings).
falseNorthing	Gets the offset added to the projected y coordinates (the northings).
lengthUnit	Gets the length unit of the projected coordinates.
longLat	Gets a pre-defined LongLatProjection instance. Inherited from Projection
name	Gets or sets the name of the OrthographicProjection. Inherited from ResourceObject
IUserProperties.userProperties	Gets the AttributeSet that contains the user properties. Inherited from IUserProperties

Methods

Name	Description
clone	Creates a copy of an object. Inherited from EngineObject
equals	Determines whether this instance is equal to another. Inherited from EngineObject
set	Modifies the calling OrthographicProjection, giving it a new geographic center.
utm	Returns one of the 120 predefined instances of Universal Transverse Mercator. Inherited from Projection

OrthographicProjection Class

In this article

Syntax

Remarks

Inheritance Hierarchy

Platforms

See Also

Reference

OrthographicProjection Members

OrthographicProjection Class

In this article

Syntax

Remarks

Inheritance Hierarchy

Platforms

See Also

Reference

OrthographicProjection Members

OrthographicProjection Class

In this article

Syntax

Remarks

Inheritance Hierarchy

Platforms

See Also

Reference

OrthographicProjection Members

OrthographicProjection Class

In this article

Syntax

Remarks

Inheritance Hierarchy

Platforms

See Also

Reference

OrthographicProjection Members